[hibernate-commits] Hibernate SVN: r19989 - in core/trunk/documentation/manual/src/main/docbook: en-US/content and 6 other directories.

Author: steve.ebersole(a)jboss.com Date: 2010-07-21 01:44:34 -0400 (Wed, 21 Jul 2010) New Revision: 19989 Modified: core/trunk/documentation/manual/src/main/docbook/de-DE/content/session_api.po core/trunk/documentation/manual/src/main/docbook/en-US/content/session_api.xml core/trunk/documentation/manual/src/main/docbook/es-ES/content/session_api.po core/trunk/documentation/manual/src/main/docbook/fr-FR/content/session_api.po core/trunk/documentation/manual/src/main/docbook/ja-JP/content/session_api.po core/trunk/documentation/manual/src/main/docbook/pot/content/session_api.pot core/trunk/documentation/manual/src/main/docbook/pt-BR/content/session_api.po core/trunk/documentation/manual/src/main/docbook/zh-CN/content/session_api.po Log: HHH-5397 - Odds and ends from documentation merge Modified: core/trunk/documentation/manual/src/main/docbook/de-DE/content/session_api.po =================================================================== --- core/trunk/documentation/manual/src/main/docbook/de-DE/content/session_api.po 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/de-DE/content/session_api.po 2010-07-21 05:44:34 UTC (rev 19989) @@ -275,7 +275,7 @@ msgstr "" "Project-Id-Version: Collection_Mapping\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2010-07-20 21:02+0000\n" +"POT-Creation-Date: 2010-07-21 05:43+0000\n" "PO-Revision-Date: 2007-02-26 10:27+1000\n" "Last-Translator: \n" "Language-Team: <de(a)li.org&gt;\n&quot; @@ -1686,43 +1686,14 @@ "innerhalb derselben Session erfordern würde. Daher bietet Hibernate mit der " "Verwendung abgesetzter Instanzen eine alternative Vorgehensweise." -#. Tag: para -#: session_api.xml:481 -#, 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 -#: session_api.xml:497 +#: session_api.xml:483 #, no-c-format msgid "Modifying detached objects" msgstr "Änderungen an abgesetzten Objekten" #. Tag: para -#: session_api.xml:499 +#: session_api.xml:485 #, no-c-format msgid "" "Many applications need to retrieve an object in one transaction, send it to " @@ -1739,7 +1710,7 @@ "um die Isolation der \"langen\" Arbeitseinheit zu gewährleisten." #. Tag: para -#: session_api.xml:505 +#: session_api.xml:491 #, no-c-format msgid "" "Hibernate supports this model by providing for reattachment of detached " @@ -1751,7 +1722,7 @@ "Möglichkeit der Wiederanbindung abgesetzter Instanzen bietet:" #. Tag: programlisting -#: session_api.xml:509 +#: session_api.xml:495 #, fuzzy, no-c-format msgid "" "// in the first session\n" @@ -1779,7 +1750,7 @@ "secondSession.update(mate); // update mate" #. Tag: para -#: session_api.xml:511 +#: session_api.xml:497 #, no-c-format msgid "" "If the <literal>Cat</literal> with identifier <literal>catId</literal> had " @@ -1792,7 +1763,7 @@ "gemeldet worden." #. Tag: para -#: session_api.xml:516 +#: session_api.xml:502 #, fuzzy, no-c-format msgid "" "Use <literal>update()</literal> if you are certain that the session does not " @@ -1813,7 +1784,7 @@ "als erstes ausgeführte Vorgang ist." #. Tag: para -#: session_api.xml:524 +#: session_api.xml:510 #, fuzzy, no-c-format msgid "" "The application should individually <literal>update()</literal> detached " @@ -1830,7 +1801,7 @@ "<xref linkend=\"objectstate-transitive\"/>." #. Tag: para -#: session_api.xml:530 +#: session_api.xml:516 #, fuzzy, no-c-format msgid "" "The <literal>lock()</literal> method also allows an application to " @@ -1842,7 +1813,7 @@ "darf die abgesetzte Instanz in diesem Fall nicht verändert worden sein!" #. Tag: programlisting -#: session_api.xml:534 +#: session_api.xml:520 #, fuzzy, no-c-format msgid "" "//just reassociate:\n" @@ -1860,7 +1831,7 @@ "sess.lock(pk, LockMode.UPGRADE);" #. Tag: para -#: session_api.xml:536 +#: session_api.xml:522 #, fuzzy, no-c-format msgid "" "Note that <literal>lock()</literal> can be used with various " @@ -1875,7 +1846,7 @@ "<literal>lock()</literal>." #. Tag: para -#: session_api.xml:541 +#: session_api.xml:527 #, fuzzy, no-c-format msgid "" "Other models for long units of work are discussed in <xref linkend=" @@ -1885,13 +1856,13 @@ "\"transactions-optimistic\"/> erläutert." #. Tag: title -#: session_api.xml:546 +#: session_api.xml:532 #, no-c-format msgid "Automatic state detection" msgstr "Automatische Statuserkennung" #. Tag: para -#: session_api.xml:548 +#: session_api.xml:534 #, no-c-format msgid "" "Hibernate users have requested a general purpose method that either saves a " @@ -1906,7 +1877,7 @@ "<literal>saveOrUpdate()</literal>-Methode implementiert diese Funktionalität." #. Tag: programlisting -#: session_api.xml:554 +#: session_api.xml:540 #, fuzzy, no-c-format msgid "" "// in the first session\n" @@ -1936,7 +1907,7 @@ "id)" #. Tag: para -#: session_api.xml:556 +#: session_api.xml:542 #, no-c-format msgid "" "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " @@ -1954,7 +1925,7 @@ "ganze Anwendungen ohne irgendeine dieser Methoden aus." #. Tag: para -#: session_api.xml:563 +#: session_api.xml:549 #, no-c-format msgid "" "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " @@ -1964,31 +1935,31 @@ "</literal> in folgenden Situationen zum Einsatz:" #. Tag: para -#: session_api.xml:569 +#: session_api.xml:555 #, 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 -#: session_api.xml:573 +#: session_api.xml:559 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "das Objekt wird an den UI-\"Tier\" weitergegeben" #. Tag: para -#: session_api.xml:577 +#: session_api.xml:563 #, no-c-format msgid "some modifications are made to the object" msgstr "am Objekt werden einige Modifikationen vorgenommen" #. Tag: para -#: session_api.xml:581 +#: session_api.xml:567 #, 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 -#: session_api.xml:585 +#: session_api.xml:571 #, no-c-format msgid "" "the application persists these modifications by calling <literal>update()</" @@ -1998,20 +1969,20 @@ "<literal>update()</literal> in einer zweiten Session" #. Tag: para -#: session_api.xml:590 +#: session_api.xml:576 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "<literal>saveOrUpdate()</literal> tut folgendes:" #. Tag: para -#: session_api.xml:594 +#: session_api.xml:580 #, 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 -#: session_api.xml:599 +#: session_api.xml:585 #, no-c-format msgid "" "if another object associated with the session has the same identifier, throw " @@ -2021,7 +1992,7 @@ "besitzt, wird eine Ausnahme gemeldet" #. Tag: para -#: session_api.xml:604 +#: session_api.xml:590 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" @@ -2029,7 +2000,7 @@ "<literal>save()</literal>" #. Tag: para -#: session_api.xml:609 +#: session_api.xml:595 #, no-c-format msgid "" "if the object's identifier has the value assigned to a newly instantiated " @@ -2040,7 +2011,7 @@ "literal>" #. Tag: para -#: session_api.xml:614 +#: session_api.xml:600 #, fuzzy, no-c-format msgid "" "if the object is versioned by a <literal>&lt;version&gt;</literal> or " @@ -2054,20 +2025,20 @@ "speichern Sie mittels <literal>save()</literal>" #. Tag: para -#: session_api.xml:622 +#: session_api.xml:608 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "" "andernfalls aktualisieren Sie das Objekt mittels <literal>update()</literal>" #. Tag: para -#: session_api.xml:626 +#: session_api.xml:612 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "und <literal>merge()</literal> ist völlig anders:" #. Tag: para -#: session_api.xml:630 +#: session_api.xml:616 #, no-c-format msgid "" "if there is a persistent instance with the same identifier currently " @@ -2079,7 +2050,7 @@ "vorgegebenen Objekts in die persistente Instanz" #. Tag: para -#: session_api.xml:636 +#: session_api.xml:622 #, no-c-format msgid "" "if there is no persistent instance currently associated with the session, " @@ -2090,13 +2061,13 @@ "erstellen Sie eine neue persistente Instanz" #. Tag: para -#: session_api.xml:642 +#: session_api.xml:628 #, no-c-format msgid "the persistent instance is returned" msgstr "die persistente Instanz wird zurückgeschickt" #. Tag: para -#: session_api.xml:646 +#: session_api.xml:632 #, no-c-format msgid "" "the given instance does not become associated with the session, it remains " @@ -2106,13 +2077,13 @@ "abgesetzt" #. Tag: title -#: session_api.xml:653 +#: session_api.xml:639 #, no-c-format msgid "Deleting persistent objects" msgstr "Das Löschen persistenter Objekte" #. Tag: para -#: session_api.xml:655 +#: session_api.xml:641 #, fuzzy, no-c-format msgid "" "<literal>Session.delete()</literal> will remove an object's state from the " @@ -2126,13 +2097,13 @@ "literal> wird eine persistente Instanz gewissermaßen transient gemacht." #. Tag: programlisting -#: session_api.xml:660 +#: session_api.xml:646 #, fuzzy, no-c-format msgid "sess.delete(cat);" msgstr "sess.delete(cat);" #. Tag: para -#: session_api.xml:662 +#: session_api.xml:648 #, fuzzy, no-c-format msgid "" "You can delete objects in any order, without risk of foreign key constraint " @@ -2148,13 +2119,13 @@ "vergessen, dies mit den untergeordneten Objekten ebenfalls zu tun." #. Tag: title -#: session_api.xml:670 +#: session_api.xml:656 #, no-c-format msgid "Replicating object between two different datastores" msgstr "Objektreplikation zwischen zwei verschiedenen Datenspeichern" #. Tag: para -#: session_api.xml:672 +#: session_api.xml:658 #, fuzzy, no-c-format msgid "" "It is sometimes useful to be able to take a graph of persistent instances " @@ -2166,7 +2137,7 @@ "können, ohne Bezeichnerwerte erneut generieren zu müssen." #. Tag: programlisting -#: session_api.xml:676 +#: session_api.xml:662 #, fuzzy, no-c-format msgid "" "//retrieve a cat from one database\n" @@ -2198,7 +2169,7 @@ "session2.close();" #. Tag: para -#: session_api.xml:678 +#: session_api.xml:664 #, fuzzy, no-c-format msgid "" "The <literal>ReplicationMode</literal> determines how <literal>replicate()</" @@ -2208,7 +2179,7 @@ "literal> mit Konflikten mit bestehenden Reihen in der Datenbank umgeht." #. Tag: para -#: session_api.xml:684 +#: session_api.xml:670 #, fuzzy, no-c-format msgid "" "<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is " @@ -2218,7 +2189,7 @@ "bereits eine Datenbankreihe mit demselben Bezeichner existiert" #. Tag: para -#: session_api.xml:689 +#: session_api.xml:675 #, fuzzy, no-c-format msgid "" "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing " @@ -2228,7 +2199,7 @@ "Datenbankreihe mit demselben Bezeichner" #. Tag: para -#: session_api.xml:694 +#: session_api.xml:680 #, fuzzy, no-c-format msgid "" "<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there " @@ -2238,7 +2209,7 @@ "eine Datenbankreihe mit demselben Bezeichner existiert" #. Tag: para -#: session_api.xml:700 +#: session_api.xml:686 #, fuzzy, no-c-format msgid "" "<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its " @@ -2250,7 +2221,7 @@ "oder ignoriert andernfalls das Objekt" #. Tag: para -#: session_api.xml:706 +#: session_api.xml:692 #, no-c-format msgid "" "Usecases for this feature include reconciling data entered into different " @@ -2264,13 +2235,13 @@ "von während nicht-ACID Transaktionen gemachten Änderungen und mehr." #. Tag: title -#: session_api.xml:713 +#: session_api.xml:699 #, no-c-format msgid "Flushing the Session" msgstr "Das Räumen der Session" #. Tag: para -#: session_api.xml:715 +#: session_api.xml:701 #, fuzzy, no-c-format msgid "" "Sometimes the <literal>Session</literal> will execute the SQL statements " @@ -2285,31 +2256,31 @@ "emphasis>" #. Tag: para -#: session_api.xml:723 +#: session_api.xml:709 #, no-c-format msgid "before some query executions" msgstr "vor dem Ausführen einiger Anfragen" #. Tag: para -#: session_api.xml:727 +#: session_api.xml:713 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "von <literal>org.hibernate.Transaction.commit()</literal>" #. Tag: para -#: session_api.xml:732 +#: session_api.xml:718 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "von <literal>Session.flush()</literal>" #. Tag: para -#: session_api.xml:736 +#: session_api.xml:722 #, 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 -#: session_api.xml:740 +#: session_api.xml:726 #, fuzzy, no-c-format msgid "" "all entity insertions in the same order the corresponding objects were saved " @@ -2319,19 +2290,19 @@ "wurden mittels <literal>Session.save()</literal> gespeichert" #. Tag: para -#: session_api.xml:745 +#: session_api.xml:731 #, no-c-format msgid "all entity updates" msgstr "alle Entity-Aktualisierungen" #. Tag: para -#: session_api.xml:749 +#: session_api.xml:735 #, no-c-format msgid "all collection deletions" msgstr "alle Collection-Löschungen" #. Tag: para -#: session_api.xml:753 +#: session_api.xml:739 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "" @@ -2339,13 +2310,13 @@ "Collection" #. Tag: para -#: session_api.xml:757 +#: session_api.xml:743 #, no-c-format msgid "all collection insertions" msgstr "alle Einfügungen in Collections" #. Tag: para -#: session_api.xml:761 +#: session_api.xml:747 #, fuzzy, no-c-format msgid "" "all entity deletions in the same order the corresponding objects were " @@ -2356,7 +2327,7 @@ "literal>" #. Tag: para -#: session_api.xml:766 +#: session_api.xml:752 #, fuzzy, no-c-format msgid "" "An exception is that objects using <literal>native</literal> ID generation " @@ -2366,7 +2337,7 @@ "Generierung verwenden, beim Speichern eingefügt werden)." #. Tag: para -#: session_api.xml:769 +#: session_api.xml:755 #, fuzzy, no-c-format msgid "" "Except when you explicitly <literal>flush()</literal>, there are absolutely " @@ -2383,7 +2354,7 @@ "liefert." #. Tag: para -#: session_api.xml:776 +#: session_api.xml:762 #, fuzzy, no-c-format msgid "" "It is possible to change the default behavior so that flush occurs less " @@ -2407,7 +2378,7 @@ "\"transactions-optimistic-longsession\"/>)." #. Tag: programlisting -#: session_api.xml:786 +#: session_api.xml:772 #, fuzzy, no-c-format msgid "" "sess = sf.openSession();\n" @@ -2441,7 +2412,7 @@ "sess.close();" #. Tag: para -#: session_api.xml:788 +#: session_api.xml:774 #, fuzzy, no-c-format msgid "" "During flush, an exception might occur (e.g. if a DML operation violates a " @@ -2455,13 +2426,13 @@ "voraussetzt, erläutern wir es in <xref linkend=\"transactions\"/>." #. Tag: title -#: session_api.xml:795 +#: session_api.xml:781 #, no-c-format msgid "Transitive persistence" msgstr "Transitive Persistenz" #. Tag: para -#: session_api.xml:797 +#: session_api.xml:783 #, no-c-format msgid "" "It is quite cumbersome to save, delete, or reattach individual objects, " @@ -2475,7 +2446,7 @@ "Beziehung). Sehen Sie sich das folgende Beispiel an:" #. Tag: para -#: session_api.xml:802 +#: session_api.xml:788 #, fuzzy, no-c-format msgid "" "If the children in a parent/child relationship would be value typed (e.g. a " @@ -2500,7 +2471,7 @@ "wird das untergeordnete Objekt aus der Datenbank gelöscht." #. Tag: para -#: session_api.xml:812 +#: session_api.xml:798 #, fuzzy, no-c-format msgid "" "Now consider the same scenario with parent and child objects being entities, " @@ -2522,7 +2493,7 @@ "Erreichbarkeit</emphasis>." #. Tag: para -#: session_api.xml:820 +#: session_api.xml:806 #, no-c-format msgid "" "For each basic operation of the Hibernate session - including " @@ -2542,26 +2513,26 @@ "müssen Sie dass im Mapping-Dokument angeben. Zum Beispiel wie folgt aussehen:" #. Tag: programlisting -#: session_api.xml:828 +#: session_api.xml:814 #, fuzzy, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" msgstr "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" #. Tag: para -#: session_api.xml:830 +#: session_api.xml:816 #, no-c-format msgid "Cascade styles my be combined:" msgstr "" "Die Arten der Weitergabe (sog. \"Cascade Styles\") können kombiniert werden:" #. Tag: programlisting -#: session_api.xml:832 +#: session_api.xml:818 #, fuzzy, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" msgstr "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" #. Tag: para -#: session_api.xml:834 +#: session_api.xml:820 #, fuzzy, no-c-format msgid "" "You can even use <literal>cascade=\"all\"</literal> to specify that " @@ -2575,7 +2546,7 @@ "festgelegt, dass keine Vorgänge weitergegeben werden." #. Tag: para -#: session_api.xml:839 +#: session_api.xml:825 #, no-c-format msgid "" "In case you are using annotatons you probably have noticed the " @@ -2586,7 +2557,7 @@ msgstr "" #. Tag: para -#: session_api.xml:848 +#: session_api.xml:834 #, no-c-format msgid "" "<literal>CascadeType.PERSIST</literal>: cascades the persist (create) " @@ -2595,7 +2566,7 @@ msgstr "" #. Tag: para -#: session_api.xml:854 +#: session_api.xml:840 #, no-c-format msgid "" "<literal>CascadeType.MERGE</literal>: cascades the merge operation to " @@ -2603,7 +2574,7 @@ msgstr "" #. Tag: para -#: session_api.xml:860 +#: session_api.xml:846 #, no-c-format msgid "" "<literal>CascadeType.REMOVE</literal>: cascades the remove operation to " @@ -2611,7 +2582,7 @@ msgstr "" #. Tag: para -#: session_api.xml:865 +#: session_api.xml:851 #, no-c-format msgid "" "<literal>CascadeType.REFRESH:</literal> cascades the refresh operation to " @@ -2619,7 +2590,7 @@ msgstr "" #. Tag: para -#: session_api.xml:870 +#: session_api.xml:856 #, no-c-format msgid "" "<literal>CascadeType.DETACH:</literal> cascades the detach operation to " @@ -2627,13 +2598,13 @@ msgstr "" #. Tag: para -#: session_api.xml:875 +#: session_api.xml:861 #, fuzzy, no-c-format msgid "<literal>CascadeType.ALL</literal>: all of the above" msgstr "<literal>saveOrUpdate()</literal> tut folgendes:" #. Tag: para -#: session_api.xml:880 +#: session_api.xml:866 #, no-c-format msgid "" "CascadeType.ALL also covers Hibernate specific operations like save-update, " @@ -2641,7 +2612,7 @@ msgstr "" #. Tag: para -#: session_api.xml:884 +#: session_api.xml:870 #, no-c-format msgid "" "A special cascade style, <literal>delete-orphan</literal>, applies only to " @@ -2658,13 +2629,13 @@ msgstr "" #. Tag: title -#: session_api.xml:897 +#: session_api.xml:883 #, no-c-format msgid "<literal>@OneToMany</literal> with <literal>orphanRemoval</literal>" msgstr "" #. Tag: programlisting -#: session_api.xml:900 +#: session_api.xml:886 #, no-c-format msgid "" "@Entity \n" @@ -2688,13 +2659,13 @@ msgstr "" #. Tag: para -#: session_api.xml:903 +#: session_api.xml:889 #, no-c-format msgid "Recommendations:" msgstr "Empfehlungen:" #. Tag: para -#: session_api.xml:907 +#: session_api.xml:893 #, fuzzy, no-c-format msgid "" "It does not usually make sense to enable cascade on a many-to-one or many-to-" @@ -2710,7 +2681,7 @@ "Assoziationen von Nutzen." #. Tag: para -#: session_api.xml:915 +#: session_api.xml:901 #, fuzzy, no-c-format msgid "" "If the child object's lifespan is bounded by the lifespan of the parent " @@ -2724,7 +2695,7 @@ "orphan\"</literal> festlegen." #. Tag: para -#: session_api.xml:923 +#: session_api.xml:909 #, no-c-format msgid "" "Otherwise, you might not need cascade at all. But if you think that you will " @@ -2738,7 +2709,7 @@ "<literal>cascade=\"persist,merge,save-update\"</literal> verwenden." #. Tag: para -#: session_api.xml:931 +#: session_api.xml:917 #, no-c-format msgid "" "Mapping an association (either a single valued association, or a collection) " @@ -2754,7 +2725,7 @@ "untergeordneten Objekts (oder Objekte) führt." #. Tag: para -#: session_api.xml:937 +#: session_api.xml:923 #, fuzzy, no-c-format msgid "" "Furthermore, a mere reference to a child from a persistent parent will " @@ -2775,7 +2746,7 @@ "\"Parent\"/\"Child\"-Beziehung lautet wie folgt:" #. Tag: para -#: session_api.xml:948 +#: session_api.xml:934 #, no-c-format msgid "" "If a parent is passed to <literal>persist()</literal>, all children are " @@ -2785,7 +2756,7 @@ "sämtliche \"Children\" ebenfalls <literal>persist()</literal>" #. Tag: para -#: session_api.xml:953 +#: session_api.xml:939 #, no-c-format msgid "" "If a parent is passed to <literal>merge()</literal>, all children are passed " @@ -2795,7 +2766,7 @@ "sämtliche \"Children\" ebenfalls <literal>merge()</literal>" #. Tag: para -#: session_api.xml:958 +#: session_api.xml:944 #, no-c-format msgid "" "If a parent is passed to <literal>save()</literal>, <literal>update()</" @@ -2807,7 +2778,7 @@ "\"Children\" ebenfalls <literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:964 +#: session_api.xml:950 #, no-c-format msgid "" "If a transient or detached child becomes referenced by a persistent parent, " @@ -2818,7 +2789,7 @@ "</literal>" #. Tag: para -#: session_api.xml:970 +#: session_api.xml:956 #, no-c-format msgid "" "If a parent is deleted, all children are passed to <literal>delete()</" @@ -2828,7 +2799,7 @@ "<literal>delete()</literal>" #. Tag: para -#: session_api.xml:975 +#: session_api.xml:961 #, no-c-format msgid "" "If a child is dereferenced by a persistent parent, <emphasis>nothing special " @@ -2843,7 +2814,7 @@ "\" Child gelöscht wird." #. Tag: para -#: session_api.xml:983 +#: session_api.xml:969 #, fuzzy, no-c-format msgid "" "Finally, note that cascading of operations can be applied to an object graph " @@ -2863,13 +2834,13 @@ "transitiv." #. Tag: title -#: session_api.xml:993 +#: session_api.xml:979 #, no-c-format msgid "Using metadata" msgstr "Die Verwendung von Metadata" #. Tag: para -#: session_api.xml:995 +#: session_api.xml:981 #, fuzzy, no-c-format msgid "" "Hibernate requires a rich meta-level model of all entity and value types. " @@ -2888,7 +2859,7 @@ "und möglicherweise zugehörige Entities)." #. Tag: para -#: session_api.xml:1002 +#: session_api.xml:988 #, fuzzy, no-c-format msgid "" "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " @@ -2902,7 +2873,7 @@ "<literal>SessionFactory</literal> verfügbar." #. Tag: programlisting -#: session_api.xml:1007 +#: session_api.xml:993 #, fuzzy, no-c-format msgid "" "Cat fritz = ......;\n" @@ -2937,7 +2908,35 @@ " }\n" "}" +#, fuzzy #~ 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." + +#~ 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 " Modified: core/trunk/documentation/manual/src/main/docbook/en-US/content/session_api.xml =================================================================== --- core/trunk/documentation/manual/src/main/docbook/en-US/content/session_api.xml 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/en-US/content/session_api.xml 2010-07-21 05:44:34 UTC (rev 19989) @@ -633,20 +633,6 @@ and an SQL <literal>UPDATE</literal> to persist its updated state. Hibernate offers an alternate approach by using detached instances.</para> - <important> - <para>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.</para> - </important> </section> <section id="objectstate-detached" revision="2"> Modified: core/trunk/documentation/manual/src/main/docbook/es-ES/content/session_api.po =================================================================== --- core/trunk/documentation/manual/src/main/docbook/es-ES/content/session_api.po 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/es-ES/content/session_api.po 2010-07-21 05:44:34 UTC (rev 19989) @@ -14,7 +14,7 @@ msgstr "" "Project-Id-Version: session_api\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2010-07-20 21:02+0000\n" +"POT-Creation-Date: 2010-07-21 05:43+0000\n" "PO-Revision-Date: 2010-03-15 14:40+1000\n" "Last-Translator: Angela Garcia <agarcia(a)redhat.com&gt;\n&quot; "Language-Team: <en(a)li.org&gt;\n&quot; @@ -1246,42 +1246,14 @@ "sesión. Por lo tanto, Hibernate ofrece un enfoque opcional, utilizando " "instancias separadas." -#. Tag: para -#: session_api.xml:481 -#, 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 "" -"Hibernate no ofrece su propia API para ejecución directa de declaraciones " -"<literal>UPDATE</literal> o <literal>DELETE</literal>. Hibernate es un " -"servicio de <emphasis>administración de estado</emphasis>, no tiene que " -"pensar en <emphasis>declaraciones</emphasis> para poder utilizarlo. JDBC es " -"una API perfecta para ejecutar declaraciones SQL; puede obtener una " -"<literal>Connection</literal> JDBC en cualquier momento llamando a " -"<literal>session.connection()</literal>. Además, la noción de operaciones " -"masivas entra en conflicto con el mapeo objeto/relacional en aplicaciones en " -"línea orientadas al procesamiento de transacciones. Sin embargo, las " -"versiones futuras de Hibernate podrán proporcionar funciones de operación " -"masiva especiales. Consulte <xref linkend=\"batch\"/> para obtener algunos " -"trucos posibles para la operación en lote. " - #. Tag: title -#: session_api.xml:497 +#: session_api.xml:483 #, no-c-format msgid "Modifying detached objects" msgstr "Modificación de objetos separados" #. Tag: para -#: session_api.xml:499 +#: session_api.xml:485 #, no-c-format msgid "" "Many applications need to retrieve an object in one transaction, send it to " @@ -1297,7 +1269,7 @@ "versionados para asegurar el aislamiento de la unidad de trabajo \"larga\"." #. Tag: para -#: session_api.xml:505 +#: session_api.xml:491 #, no-c-format msgid "" "Hibernate supports this model by providing for reattachment of detached " @@ -1309,7 +1281,7 @@ "<literal>Session.merge()</literal>:" #. Tag: programlisting -#: session_api.xml:509 +#: session_api.xml:495 #, no-c-format msgid "" "// in the first session\n" @@ -1326,7 +1298,7 @@ msgstr "" #. Tag: para -#: session_api.xml:511 +#: session_api.xml:497 #, no-c-format msgid "" "If the <literal>Cat</literal> with identifier <literal>catId</literal> had " @@ -1338,7 +1310,7 @@ "aplicación intentó volver a unirlo, se habría lanzado una excepción." #. Tag: para -#: session_api.xml:516 +#: session_api.xml:502 #, no-c-format msgid "" "Use <literal>update()</literal> if you are certain that the session does not " @@ -1358,7 +1330,7 @@ "instancias separadas es la primera operación que se ejecuta." #. Tag: para -#: session_api.xml:524 +#: session_api.xml:510 #, fuzzy, no-c-format msgid "" "The application should individually <literal>update()</literal> detached " @@ -1375,7 +1347,7 @@ "información." #. Tag: para -#: session_api.xml:530 +#: session_api.xml:516 #, no-c-format msgid "" "The <literal>lock()</literal> method also allows an application to " @@ -1387,7 +1359,7 @@ "no puede haber sido modificada." #. Tag: programlisting -#: session_api.xml:534 +#: session_api.xml:520 #, no-c-format msgid "" "//just reassociate:\n" @@ -1399,7 +1371,7 @@ msgstr "" #. Tag: para -#: session_api.xml:536 +#: session_api.xml:522 #, no-c-format msgid "" "Note that <literal>lock()</literal> can be used with various " @@ -1413,7 +1385,7 @@ "re-unión no es el único caso de uso para <literal>lock()</literal>." #. Tag: para -#: session_api.xml:541 +#: session_api.xml:527 #, fuzzy, no-c-format msgid "" "Other models for long units of work are discussed in <xref linkend=" @@ -1423,13 +1395,13 @@ "\"transactions-optimistic\" />." #. Tag: title -#: session_api.xml:546 +#: session_api.xml:532 #, no-c-format msgid "Automatic state detection" msgstr "Detección automática de estado" #. Tag: para -#: session_api.xml:548 +#: session_api.xml:534 #, no-c-format msgid "" "Hibernate users have requested a general purpose method that either saves a " @@ -1444,7 +1416,7 @@ "funcionalidad." #. Tag: programlisting -#: session_api.xml:554 +#: session_api.xml:540 #, no-c-format msgid "" "// in the first session\n" @@ -1462,7 +1434,7 @@ msgstr "" #. Tag: para -#: session_api.xml:556 +#: session_api.xml:542 #, no-c-format msgid "" "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " @@ -1480,7 +1452,7 @@ "ninguno de estos métodos." #. Tag: para -#: session_api.xml:563 +#: session_api.xml:549 #, no-c-format msgid "" "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " @@ -1490,31 +1462,31 @@ "se utilizan en el siguiente escenario:" #. Tag: para -#: session_api.xml:569 +#: session_api.xml:555 #, no-c-format msgid "the application loads an object in the first session" msgstr "la aplicación carga un objeto en la primera sesión" #. Tag: para -#: session_api.xml:573 +#: session_api.xml:559 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "el objeto se pasa a la capa de UI" #. Tag: para -#: session_api.xml:577 +#: session_api.xml:563 #, no-c-format msgid "some modifications are made to the object" msgstr "se realizan algunas modificaciones al objeto" #. Tag: para -#: session_api.xml:581 +#: session_api.xml:567 #, no-c-format msgid "the object is passed back down to the business logic tier" msgstr "el objeto se pasa abajo de regreso a la capa lógica de negocios" #. Tag: para -#: session_api.xml:585 +#: session_api.xml:571 #, no-c-format msgid "" "the application persists these modifications by calling <literal>update()</" @@ -1524,19 +1496,19 @@ "<literal>update()</literal> en una segunda sesión" #. Tag: para -#: session_api.xml:590 +#: session_api.xml:576 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "<literal>saveOrUpdate()</literal> hace lo siguiente:" #. Tag: para -#: session_api.xml:594 +#: session_api.xml:580 #, no-c-format msgid "if the object is already persistent in this session, do nothing" msgstr "si el objeto ya es persistente en esta sesión, no haga nada" #. Tag: para -#: session_api.xml:599 +#: session_api.xml:585 #, no-c-format msgid "" "if another object associated with the session has the same identifier, throw " @@ -1546,7 +1518,7 @@ "una excepción" #. Tag: para -#: session_api.xml:604 +#: session_api.xml:590 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" @@ -1554,7 +1526,7 @@ "<literal>save()</literal>" #. Tag: para -#: session_api.xml:609 +#: session_api.xml:595 #, no-c-format msgid "" "if the object's identifier has the value assigned to a newly instantiated " @@ -1564,7 +1536,7 @@ "instanciado, guárdelo llamando a <literal>save()</literal>" #. Tag: para -#: session_api.xml:614 +#: session_api.xml:600 #, no-c-format msgid "" "if the object is versioned by a <literal>&lt;version&gt;</literal> or " @@ -1578,20 +1550,20 @@ "a <literal>save()</literal>" #. Tag: para -#: session_api.xml:622 +#: session_api.xml:608 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "" "de otra manera actualice el objeto llamando a <literal>update()</literal>" #. Tag: para -#: session_api.xml:626 +#: session_api.xml:612 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "y <literal>merge()</literal> es muy diferente:" #. Tag: para -#: session_api.xml:630 +#: session_api.xml:616 #, no-c-format msgid "" "if there is a persistent instance with the same identifier currently " @@ -1603,7 +1575,7 @@ "persistente" #. Tag: para -#: session_api.xml:636 +#: session_api.xml:622 #, no-c-format msgid "" "if there is no persistent instance currently associated with the session, " @@ -1614,13 +1586,13 @@ "persistente" #. Tag: para -#: session_api.xml:642 +#: session_api.xml:628 #, no-c-format msgid "the persistent instance is returned" msgstr "la instancia persistente es devuelta" #. Tag: para -#: session_api.xml:646 +#: session_api.xml:632 #, no-c-format msgid "" "the given instance does not become associated with the session, it remains " @@ -1628,13 +1600,13 @@ msgstr "la instancia dada no se asocia a la sesión, permanece separada" #. Tag: title -#: session_api.xml:653 +#: session_api.xml:639 #, no-c-format msgid "Deleting persistent objects" msgstr "Borrado de objetos persistentes" #. Tag: para -#: session_api.xml:655 +#: session_api.xml:641 #, no-c-format msgid "" "<literal>Session.delete()</literal> will remove an object's state from the " @@ -1648,13 +1620,13 @@ "hacer transitoria una instancia persistente." #. Tag: programlisting -#: session_api.xml:660 +#: session_api.xml:646 #, no-c-format msgid "sess.delete(cat);" msgstr "" #. Tag: para -#: session_api.xml:662 +#: session_api.xml:648 #, no-c-format msgid "" "You can delete objects in any order, without risk of foreign key constraint " @@ -1669,13 +1641,13 @@ "borrar los hijos." #. Tag: title -#: session_api.xml:670 +#: session_api.xml:656 #, no-c-format msgid "Replicating object between two different datastores" msgstr "Replicación de objetos entre dos almacenamientos de datos diferentes" #. Tag: para -#: session_api.xml:672 +#: session_api.xml:658 #, no-c-format msgid "" "It is sometimes useful to be able to take a graph of persistent instances " @@ -1687,7 +1659,7 @@ "los valores identificadores." #. Tag: programlisting -#: session_api.xml:676 +#: session_api.xml:662 #, no-c-format msgid "" "//retrieve a cat from one database\n" @@ -1706,7 +1678,7 @@ msgstr "" #. Tag: para -#: session_api.xml:678 +#: session_api.xml:664 #, no-c-format msgid "" "The <literal>ReplicationMode</literal> determines how <literal>replicate()</" @@ -1716,7 +1688,7 @@ "literal> tratará los conflictos con filas existentes en la base de datos:" #. Tag: para -#: session_api.xml:684 +#: session_api.xml:670 #, no-c-format msgid "" "<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is " @@ -1726,7 +1698,7 @@ "una fila de la base de datos con el mismo identificador" #. Tag: para -#: session_api.xml:689 +#: session_api.xml:675 #, no-c-format msgid "" "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing " @@ -1736,7 +1708,7 @@ "la base de datos existente con el mismo identificador" #. Tag: para -#: session_api.xml:694 +#: session_api.xml:680 #, no-c-format msgid "" "<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there " @@ -1746,7 +1718,7 @@ "una fila de la base de datos con el mismo identificador" #. Tag: para -#: session_api.xml:700 +#: session_api.xml:686 #, no-c-format msgid "" "<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its " @@ -1758,7 +1730,7 @@ "contrario ignora el objeto" #. Tag: para -#: session_api.xml:706 +#: session_api.xml:692 #, no-c-format msgid "" "Usecases for this feature include reconciling data entered into different " @@ -1772,13 +1744,13 @@ "producto, deshacer cambios realizados durante transacciones no-ACID y más." #. Tag: title -#: session_api.xml:713 +#: session_api.xml:699 #, no-c-format msgid "Flushing the Session" msgstr "Limpieza (flushing) de la sesión" #. Tag: para -#: session_api.xml:715 +#: session_api.xml:701 #, no-c-format msgid "" "Sometimes the <literal>Session</literal> will execute the SQL statements " @@ -1792,31 +1764,31 @@ "</emphasis>, ocurre por defecto en los siguientes puntos:" #. Tag: para -#: session_api.xml:723 +#: session_api.xml:709 #, no-c-format msgid "before some query executions" msgstr "antes de algunas ejecuciones de consulta" #. Tag: para -#: session_api.xml:727 +#: session_api.xml:713 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "desde <literal>org.hibernate.Transaction.commit()</literal>" #. Tag: para -#: session_api.xml:732 +#: session_api.xml:718 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "desde <literal>Session.flush()</literal>" #. Tag: para -#: session_api.xml:736 +#: session_api.xml:722 #, no-c-format msgid "The SQL statements are issued in the following order:" msgstr "Las declaraciones SQL se emiten en el siguiente orden:" #. Tag: para -#: session_api.xml:740 +#: session_api.xml:726 #, no-c-format msgid "" "all entity insertions in the same order the corresponding objects were saved " @@ -1827,32 +1799,32 @@ "literal>" #. Tag: para -#: session_api.xml:745 +#: session_api.xml:731 #, no-c-format msgid "all entity updates" msgstr "todas las actualizaciones de entidades" #. Tag: para -#: session_api.xml:749 +#: session_api.xml:735 #, no-c-format msgid "all collection deletions" msgstr "todas los borrados de colecciones" #. Tag: para -#: session_api.xml:753 +#: session_api.xml:739 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "" "todos los borrados, actualizaciones e inserciones de elementos de colección" #. Tag: para -#: session_api.xml:757 +#: session_api.xml:743 #, no-c-format msgid "all collection insertions" msgstr "todas las inserciones de colecciones" #. Tag: para -#: session_api.xml:761 +#: session_api.xml:747 #, no-c-format msgid "" "all entity deletions in the same order the corresponding objects were " @@ -1862,7 +1834,7 @@ "correspondientes fueron borrados usando <literal>Session.delete()</literal> " #. Tag: para -#: session_api.xml:766 +#: session_api.xml:752 #, no-c-format msgid "" "An exception is that objects using <literal>native</literal> ID generation " @@ -1872,7 +1844,7 @@ "<literal>native</literal> se insertan cuando se guardan." #. Tag: para -#: session_api.xml:769 +#: session_api.xml:755 #, no-c-format msgid "" "Except when you explicitly <literal>flush()</literal>, there are absolutely " @@ -1889,7 +1861,7 @@ "desactualizados o incorrectos." #. Tag: para -#: session_api.xml:776 +#: session_api.xml:762 #, fuzzy, no-c-format msgid "" "It is possible to change the default behavior so that flush occurs less " @@ -1912,7 +1884,7 @@ "<xref linkend=\"transactions-optimistic-longsession\"/>)." #. Tag: programlisting -#: session_api.xml:786 +#: session_api.xml:772 #, no-c-format msgid "" "sess = sf.openSession();\n" @@ -1932,7 +1904,7 @@ msgstr "" #. Tag: para -#: session_api.xml:788 +#: session_api.xml:774 #, fuzzy, no-c-format msgid "" "During flush, an exception might occur (e.g. if a DML operation violates a " @@ -1946,13 +1918,13 @@ "lo discutimos en <xref linkend=\"transactions\" />. " #. Tag: title -#: session_api.xml:795 +#: session_api.xml:781 #, no-c-format msgid "Transitive persistence" msgstr "Persistencia transitiva" #. Tag: para -#: session_api.xml:797 +#: session_api.xml:783 #, no-c-format msgid "" "It is quite cumbersome to save, delete, or reattach individual objects, " @@ -1964,7 +1936,7 @@ "una relación padre/hijo. Considere el siguiente ejemplo:" #. Tag: para -#: session_api.xml:802 +#: session_api.xml:788 #, no-c-format msgid "" "If the children in a parent/child relationship would be value typed (e.g. a " @@ -1987,7 +1959,7 @@ "referencias compartidas entonces borrará el hijo de la base de datos." #. Tag: para -#: session_api.xml:812 +#: session_api.xml:798 #, no-c-format msgid "" "Now consider the same scenario with parent and child objects being entities, " @@ -2007,7 +1979,7 @@ "no implementa por defecto la <emphasis>persistencia por alcance</emphasis>." #. Tag: para -#: session_api.xml:820 +#: session_api.xml:806 #, no-c-format msgid "" "For each basic operation of the Hibernate session - including " @@ -2028,25 +2000,25 @@ "ejemplo:" #. Tag: programlisting -#: session_api.xml:828 +#: session_api.xml:814 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:830 +#: session_api.xml:816 #, no-c-format msgid "Cascade styles my be combined:" msgstr "Los estilos de cascada pueden combinarse:" #. Tag: programlisting -#: session_api.xml:832 +#: session_api.xml:818 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:834 +#: session_api.xml:820 #, no-c-format msgid "" "You can even use <literal>cascade=\"all\"</literal> to specify that " @@ -2060,7 +2032,7 @@ "predeterminada especifica que ninguna operación se tratará en cascada. " #. Tag: para -#: session_api.xml:839 +#: session_api.xml:825 #, no-c-format msgid "" "In case you are using annotatons you probably have noticed the " @@ -2071,7 +2043,7 @@ msgstr "" #. Tag: para -#: session_api.xml:848 +#: session_api.xml:834 #, no-c-format msgid "" "<literal>CascadeType.PERSIST</literal>: cascades the persist (create) " @@ -2080,7 +2052,7 @@ msgstr "" #. Tag: para -#: session_api.xml:854 +#: session_api.xml:840 #, no-c-format msgid "" "<literal>CascadeType.MERGE</literal>: cascades the merge operation to " @@ -2088,7 +2060,7 @@ msgstr "" #. Tag: para -#: session_api.xml:860 +#: session_api.xml:846 #, no-c-format msgid "" "<literal>CascadeType.REMOVE</literal>: cascades the remove operation to " @@ -2096,7 +2068,7 @@ msgstr "" #. Tag: para -#: session_api.xml:865 +#: session_api.xml:851 #, no-c-format msgid "" "<literal>CascadeType.REFRESH:</literal> cascades the refresh operation to " @@ -2104,7 +2076,7 @@ msgstr "" #. Tag: para -#: session_api.xml:870 +#: session_api.xml:856 #, no-c-format msgid "" "<literal>CascadeType.DETACH:</literal> cascades the detach operation to " @@ -2112,13 +2084,13 @@ msgstr "" #. Tag: para -#: session_api.xml:875 +#: session_api.xml:861 #, fuzzy, no-c-format msgid "<literal>CascadeType.ALL</literal>: all of the above" msgstr "<literal>saveOrUpdate()</literal> hace lo siguiente:" #. Tag: para -#: session_api.xml:880 +#: session_api.xml:866 #, no-c-format msgid "" "CascadeType.ALL also covers Hibernate specific operations like save-update, " @@ -2126,7 +2098,7 @@ msgstr "" #. Tag: para -#: session_api.xml:884 +#: session_api.xml:870 #, no-c-format msgid "" "A special cascade style, <literal>delete-orphan</literal>, applies only to " @@ -2143,13 +2115,13 @@ msgstr "" #. Tag: title -#: session_api.xml:897 +#: session_api.xml:883 #, no-c-format msgid "<literal>@OneToMany</literal> with <literal>orphanRemoval</literal>" msgstr "" #. Tag: programlisting -#: session_api.xml:900 +#: session_api.xml:886 #, no-c-format msgid "" "@Entity \n" @@ -2173,13 +2145,13 @@ msgstr "" #. Tag: para -#: session_api.xml:903 +#: session_api.xml:889 #, no-c-format msgid "Recommendations:" msgstr "Recomendaciones:" #. Tag: para -#: session_api.xml:907 +#: session_api.xml:893 #, fuzzy, no-c-format msgid "" "It does not usually make sense to enable cascade on a many-to-one or many-to-" @@ -2195,7 +2167,7 @@ "many&gt;</literal>." #. Tag: para -#: session_api.xml:915 +#: session_api.xml:901 #, fuzzy, no-c-format msgid "" "If the child object's lifespan is bounded by the lifespan of the parent " @@ -2208,7 +2180,7 @@ "especificando <literal>cascade=\"all,delete-orphan\"</literal>. " #. Tag: para -#: session_api.xml:923 +#: session_api.xml:909 #, no-c-format msgid "" "Otherwise, you might not need cascade at all. But if you think that you will " @@ -2223,7 +2195,7 @@ "update\"</literal>." #. Tag: para -#: session_api.xml:931 +#: session_api.xml:917 #, no-c-format msgid "" "Mapping an association (either a single valued association, or a collection) " @@ -2238,7 +2210,7 @@ "hijo o hijos." #. Tag: para -#: session_api.xml:937 +#: session_api.xml:923 #, fuzzy, no-c-format msgid "" "Furthermore, a mere reference to a child from a persistent parent will " @@ -2258,7 +2230,7 @@ "una relación padre/hijo es la siguiente:" #. Tag: para -#: session_api.xml:948 +#: session_api.xml:934 #, no-c-format msgid "" "If a parent is passed to <literal>persist()</literal>, all children are " @@ -2268,7 +2240,7 @@ "<literal>persist()</literal>" #. Tag: para -#: session_api.xml:953 +#: session_api.xml:939 #, no-c-format msgid "" "If a parent is passed to <literal>merge()</literal>, all children are passed " @@ -2278,7 +2250,7 @@ "<literal>merge()</literal>" #. Tag: para -#: session_api.xml:958 +#: session_api.xml:944 #, no-c-format msgid "" "If a parent is passed to <literal>save()</literal>, <literal>update()</" @@ -2290,7 +2262,7 @@ "<literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:964 +#: session_api.xml:950 #, no-c-format msgid "" "If a transient or detached child becomes referenced by a persistent parent, " @@ -2300,7 +2272,7 @@ "persistente, le es pasado a <literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:970 +#: session_api.xml:956 #, no-c-format msgid "" "If a parent is deleted, all children are passed to <literal>delete()</" @@ -2309,7 +2281,7 @@ "Si se borra un padre, se pasan todos los hijos a <literal>delete()</literal>" #. Tag: para -#: session_api.xml:975 +#: session_api.xml:961 #, no-c-format msgid "" "If a child is dereferenced by a persistent parent, <emphasis>nothing special " @@ -2323,7 +2295,7 @@ "literal>, en cuyo caso se borra el hijo \"huérfano\"." #. Tag: para -#: session_api.xml:983 +#: session_api.xml:969 #, no-c-format msgid "" "Finally, note that cascading of operations can be applied to an object graph " @@ -2343,13 +2315,13 @@ "<literal>Session</literal>." #. Tag: title -#: session_api.xml:993 +#: session_api.xml:979 #, no-c-format msgid "Using metadata" msgstr "Utilización de metadatos" #. Tag: para -#: session_api.xml:995 +#: session_api.xml:981 #, no-c-format msgid "" "Hibernate requires a rich meta-level model of all entity and value types. " @@ -2368,7 +2340,7 @@ "las entidades asociadas)." #. Tag: para -#: session_api.xml:1002 +#: session_api.xml:988 #, no-c-format msgid "" "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " @@ -2382,7 +2354,7 @@ "metadatos se pueden obtener de la <literal>SessionFactory</literal>." #. Tag: programlisting -#: session_api.xml:1007 +#: session_api.xml:993 #, no-c-format msgid "" "Cat fritz = ......;\n" @@ -2402,7 +2374,34 @@ "}" msgstr "" +#, fuzzy #~ 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 "" +#~ "Hibernate no ofrece su propia API para ejecución directa de declaraciones " +#~ "<literal>UPDATE</literal> o <literal>DELETE</literal>. Hibernate es un " +#~ "servicio de <emphasis>administración de estado</emphasis>, no tiene que " +#~ "pensar en <emphasis>declaraciones</emphasis> para poder utilizarlo. JDBC " +#~ "es una API perfecta para ejecutar declaraciones SQL; puede obtener una " +#~ "<literal>Connection</literal> JDBC en cualquier momento llamando a " +#~ "<literal>session.connection()</literal>. Además, la noción de operaciones " +#~ "masivas entra en conflicto con el mapeo objeto/relacional en aplicaciones " +#~ "en línea orientadas al procesamiento de transacciones. Sin embargo, las " +#~ "versiones futuras de Hibernate podrán proporcionar funciones de operación " +#~ "masiva especiales. Consulte <xref linkend=\"batch\"/> para obtener " +#~ "algunos trucos posibles para la operación en lote. " + +#~ 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 " Modified: core/trunk/documentation/manual/src/main/docbook/fr-FR/content/session_api.po =================================================================== --- core/trunk/documentation/manual/src/main/docbook/fr-FR/content/session_api.po 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/fr-FR/content/session_api.po 2010-07-21 05:44:34 UTC (rev 19989) @@ -7,7 +7,7 @@ msgstr "" "Project-Id-Version: session_api\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2010-07-20 21:02+0000\n" +"POT-Creation-Date: 2010-07-21 05:43+0000\n" "PO-Revision-Date: 2010-01-05 09:57+1000\n" "Last-Translator: Corina Roe <croe(a)redhat.com&gt;\n&quot; "Language-Team: French <i18(a)redhat.com&gt;\n&quot; @@ -1245,42 +1245,14 @@ "session. Ainsi Hibernate offre une autre approche, en utilisant des " "instances détachées. " -#. Tag: para -#: session_api.xml:481 -#, 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 "" -"Notez que Hibernate n'offre par sa propre API pour l'exécution directe " -"d'expressions <literal>UPDATE</literal> ou <literal>DELETE</literal>. " -"Hibernate est un service de <emphasis>gestion d'état</emphasis>, vous n'avez " -"pas à penser aux <emphasis>expressions</emphasis> pour l'utiliser. JDBC est " -"une API parfaite pour exécuter des expressions SQL, vous pouvez obtenir une " -"<literal>Connection</literal> JDBC à tout moment en appelant " -"<literal>session.connection()</literal>. En outre, la notion d'opérations de " -"masse entre en conflit avec le mapping objet/relationnel pour les " -"applications orientées processus de transactions en ligne. Les futures " -"versions de Hibernate pourront cependant fournir des fonctions particulières " -"d'opération de masse. Voir <xref linkend=\"batch\" /> pour des astuces " -"possibles d'opérations groupées. " - #. Tag: title -#: session_api.xml:497 +#: session_api.xml:483 #, no-c-format msgid "Modifying detached objects" msgstr "Modifier des objets détachés" #. Tag: para -#: session_api.xml:499 +#: session_api.xml:485 #, no-c-format msgid "" "Many applications need to retrieve an object in one transaction, send it to " @@ -1297,7 +1269,7 @@ "versionnées pour assurer l'isolation des \"longues\" unités de travail." #. Tag: para -#: session_api.xml:505 +#: session_api.xml:491 #, no-c-format msgid "" "Hibernate supports this model by providing for reattachment of detached " @@ -1309,7 +1281,7 @@ "<literal>Session.merge()</literal> :" #. Tag: programlisting -#: session_api.xml:509 +#: session_api.xml:495 #, no-c-format msgid "" "// in the first session\n" @@ -1326,7 +1298,7 @@ msgstr "" #. Tag: para -#: session_api.xml:511 +#: session_api.xml:497 #, no-c-format msgid "" "If the <literal>Cat</literal> with identifier <literal>catId</literal> had " @@ -1338,7 +1310,7 @@ "l'application a essayé de le rattacher, une exception aurait été levée." #. Tag: para -#: session_api.xml:516 +#: session_api.xml:502 #, no-c-format msgid "" "Use <literal>update()</literal> if you are certain that the session does not " @@ -1359,7 +1331,7 @@ "exécutée. " #. Tag: para -#: session_api.xml:524 +#: session_api.xml:510 #, fuzzy, no-c-format msgid "" "The application should individually <literal>update()</literal> detached " @@ -1376,7 +1348,7 @@ "\"objectstate-transitive\" /> pour plus d'informations." #. Tag: para -#: session_api.xml:530 +#: session_api.xml:516 #, no-c-format msgid "" "The <literal>lock()</literal> method also allows an application to " @@ -1388,7 +1360,7 @@ "doit être non modifiée." #. Tag: programlisting -#: session_api.xml:534 +#: session_api.xml:520 #, no-c-format msgid "" "//just reassociate:\n" @@ -1400,7 +1372,7 @@ msgstr "" #. Tag: para -#: session_api.xml:536 +#: session_api.xml:522 #, no-c-format msgid "" "Note that <literal>lock()</literal> can be used with various " @@ -1414,7 +1386,7 @@ "n'est pas le seul cas d'utilisation pour <literal>lock()</literal>. " #. Tag: para -#: session_api.xml:541 +#: session_api.xml:527 #, fuzzy, no-c-format msgid "" "Other models for long units of work are discussed in <xref linkend=" @@ -1424,13 +1396,13 @@ "linkend=\"transactions-optimistic\" />." #. Tag: title -#: session_api.xml:546 +#: session_api.xml:532 #, no-c-format msgid "Automatic state detection" msgstr "Détection automatique d'un état" #. Tag: para -#: session_api.xml:548 +#: session_api.xml:534 #, no-c-format msgid "" "Hibernate users have requested a general purpose method that either saves a " @@ -1445,7 +1417,7 @@ "literal> implémente cette fonctionnalité." #. Tag: programlisting -#: session_api.xml:554 +#: session_api.xml:540 #, no-c-format msgid "" "// in the first session\n" @@ -1463,7 +1435,7 @@ msgstr "" #. Tag: para -#: session_api.xml:556 +#: session_api.xml:542 #, no-c-format msgid "" "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " @@ -1481,7 +1453,7 @@ "applications n'utiliseront jamais ces méthodes." #. Tag: para -#: session_api.xml:563 +#: session_api.xml:549 #, no-c-format msgid "" "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " @@ -1491,31 +1463,31 @@ "literal> sont utilisées dans le scénario suivant :" #. Tag: para -#: session_api.xml:569 +#: session_api.xml:555 #, no-c-format msgid "the application loads an object in the first session" msgstr "l'application charge un objet dans la première session" #. Tag: para -#: session_api.xml:573 +#: session_api.xml:559 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "l'objet est passé à la couche utilisateur" #. Tag: para -#: session_api.xml:577 +#: session_api.xml:563 #, no-c-format msgid "some modifications are made to the object" msgstr "certaines modifications sont effectuées sur l'objet" #. Tag: para -#: session_api.xml:581 +#: session_api.xml:567 #, no-c-format msgid "the object is passed back down to the business logic tier" msgstr "l'objet est retourné à la couche logique métier" #. Tag: para -#: session_api.xml:585 +#: session_api.xml:571 #, no-c-format msgid "" "the application persists these modifications by calling <literal>update()</" @@ -1525,19 +1497,19 @@ "literal> dans une seconde session" #. Tag: para -#: session_api.xml:590 +#: session_api.xml:576 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "<literal>saveOrUpdate()</literal> s'utilise dans le cas suivant :" #. Tag: para -#: session_api.xml:594 +#: session_api.xml:580 #, no-c-format msgid "if the object is already persistent in this session, do nothing" msgstr "si l'objet est déjà persistant dans cette session, ne rien faire" #. Tag: para -#: session_api.xml:599 +#: session_api.xml:585 #, no-c-format msgid "" "if another object associated with the session has the same identifier, throw " @@ -1547,7 +1519,7 @@ "exception" #. Tag: para -#: session_api.xml:604 +#: session_api.xml:590 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" @@ -1555,7 +1527,7 @@ "literal>" #. Tag: para -#: session_api.xml:609 +#: session_api.xml:595 #, no-c-format msgid "" "if the object's identifier has the value assigned to a newly instantiated " @@ -1565,7 +1537,7 @@ "instancié, appeler <literal>save()</literal>" #. Tag: para -#: session_api.xml:614 +#: session_api.xml:600 #, no-c-format msgid "" "if the object is versioned by a <literal>&lt;version&gt;</literal> or " @@ -1579,19 +1551,19 @@ "instancié, appeler <literal>save()</literal> " #. Tag: para -#: session_api.xml:622 +#: session_api.xml:608 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "sinon mettre à jour l'objet avec <literal>update()</literal>" #. Tag: para -#: session_api.xml:626 +#: session_api.xml:612 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "et <literal>merge()</literal> est très différent :" #. Tag: para -#: session_api.xml:630 +#: session_api.xml:616 #, no-c-format msgid "" "if there is a persistent instance with the same identifier currently " @@ -1603,7 +1575,7 @@ "persistante" #. Tag: para -#: session_api.xml:636 +#: session_api.xml:622 #, no-c-format msgid "" "if there is no persistent instance currently associated with the session, " @@ -1614,13 +1586,13 @@ "persistante" #. Tag: para -#: session_api.xml:642 +#: session_api.xml:628 #, no-c-format msgid "the persistent instance is returned" msgstr "l'instance persistante est retournée" #. Tag: para -#: session_api.xml:646 +#: session_api.xml:632 #, no-c-format msgid "" "the given instance does not become associated with the session, it remains " @@ -1629,13 +1601,13 @@ "l'instance donnée ne devient pas associée à la session, elle reste détachée" #. Tag: title -#: session_api.xml:653 +#: session_api.xml:639 #, no-c-format msgid "Deleting persistent objects" msgstr "Suppression d'objets persistants" #. Tag: para -#: session_api.xml:655 +#: session_api.xml:641 #, no-c-format msgid "" "<literal>Session.delete()</literal> will remove an object's state from the " @@ -1649,13 +1621,13 @@ "()</literal> comme rendant une instance persistante éphémère. " #. Tag: programlisting -#: session_api.xml:660 +#: session_api.xml:646 #, no-c-format msgid "sess.delete(cat);" msgstr "" #. Tag: para -#: session_api.xml:662 +#: session_api.xml:648 #, no-c-format msgid "" "You can delete objects in any order, without risk of foreign key constraint " @@ -1670,13 +1642,13 @@ "parent, mais oubliez d'effacer les enfants. " #. Tag: title -#: session_api.xml:670 +#: session_api.xml:656 #, no-c-format msgid "Replicating object between two different datastores" msgstr "Réplication d'objets entre deux entrepôts de données" #. Tag: para -#: session_api.xml:672 +#: session_api.xml:658 #, no-c-format msgid "" "It is sometimes useful to be able to take a graph of persistent instances " @@ -1688,7 +1660,7 @@ "regénérer les valeurs des identifiants. " #. Tag: programlisting -#: session_api.xml:676 +#: session_api.xml:662 #, no-c-format msgid "" "//retrieve a cat from one database\n" @@ -1707,7 +1679,7 @@ msgstr "" #. Tag: para -#: session_api.xml:678 +#: session_api.xml:664 #, no-c-format msgid "" "The <literal>ReplicationMode</literal> determines how <literal>replicate()</" @@ -1718,7 +1690,7 @@ "données. " #. Tag: para -#: session_api.xml:684 +#: session_api.xml:670 #, no-c-format msgid "" "<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is " @@ -1728,7 +1700,7 @@ "ligne existante dans la base de données avec le même identifiant " #. Tag: para -#: session_api.xml:689 +#: session_api.xml:675 #, no-c-format msgid "" "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing " @@ -1738,7 +1710,7 @@ "existante dans la base de données avec le même identifiant " #. Tag: para -#: session_api.xml:694 +#: session_api.xml:680 #, no-c-format msgid "" "<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there " @@ -1748,7 +1720,7 @@ "une ligne dans la base de données avec le même identifiant " #. Tag: para -#: session_api.xml:700 +#: session_api.xml:686 #, no-c-format msgid "" "<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its " @@ -1760,7 +1732,7 @@ "ignore l'objet " #. Tag: para -#: session_api.xml:706 +#: session_api.xml:692 #, no-c-format msgid "" "Usecases for this feature include reconciling data entered into different " @@ -1775,13 +1747,13 @@ "ACID, et plus." #. Tag: title -#: session_api.xml:713 +#: session_api.xml:699 #, no-c-format msgid "Flushing the Session" msgstr "Flush de la session" #. Tag: para -#: session_api.xml:715 +#: session_api.xml:701 #, no-c-format msgid "" "Sometimes the <literal>Session</literal> will execute the SQL statements " @@ -1795,32 +1767,32 @@ "survient par défaut aux points suivants : " #. Tag: para -#: session_api.xml:723 +#: session_api.xml:709 #, no-c-format msgid "before some query executions" msgstr "avant certaines exécutions de requête" #. Tag: para -#: session_api.xml:727 +#: session_api.xml:713 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "" "lors d'un appel à <literal>org.hibernate.Transaction.commit()</literal>" #. Tag: para -#: session_api.xml:732 +#: session_api.xml:718 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "lors d'un appel à <literal>Session.flush()</literal>" #. Tag: para -#: session_api.xml:736 +#: session_api.xml:722 #, no-c-format msgid "The SQL statements are issued in the following order:" msgstr "Les expressions SQL sont effectuées dans l'ordre suivant : " #. Tag: para -#: session_api.xml:740 +#: session_api.xml:726 #, no-c-format msgid "" "all entity insertions in the same order the corresponding objects were saved " @@ -1830,31 +1802,31 @@ "correspondants sauvegardés par l'appel à <literal>Session.save()</literal> " #. Tag: para -#: session_api.xml:745 +#: session_api.xml:731 #, no-c-format msgid "all entity updates" msgstr "mise à jour des entités" #. Tag: para -#: session_api.xml:749 +#: session_api.xml:735 #, no-c-format msgid "all collection deletions" msgstr "suppression des collections" #. Tag: para -#: session_api.xml:753 +#: session_api.xml:739 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "suppression, mise à jour et insertion des éléments des collections" #. Tag: para -#: session_api.xml:757 +#: session_api.xml:743 #, no-c-format msgid "all collection insertions" msgstr "insertion des collections" #. Tag: para -#: session_api.xml:761 +#: session_api.xml:747 #, no-c-format msgid "" "all entity deletions in the same order the corresponding objects were " @@ -1865,7 +1837,7 @@ "</literal> " #. Tag: para -#: session_api.xml:766 +#: session_api.xml:752 #, no-c-format msgid "" "An exception is that objects using <literal>native</literal> ID generation " @@ -1875,7 +1847,7 @@ "literal> d'identifiants sont insérés lorsqu'ils sont sauvegardés." #. Tag: para -#: session_api.xml:769 +#: session_api.xml:755 #, no-c-format msgid "" "Except when you explicitly <literal>flush()</literal>, there are absolutely " @@ -1892,7 +1864,7 @@ "jamais de données périmées, ni des données fausses. " #. Tag: para -#: session_api.xml:776 +#: session_api.xml:762 #, fuzzy, no-c-format msgid "" "It is possible to change the default behavior so that flush occurs less " @@ -1915,7 +1887,7 @@ "moment (voir <xref linkend=\"transactions-optimistic-longsession\" />)." #. Tag: programlisting -#: session_api.xml:786 +#: session_api.xml:772 #, no-c-format msgid "" "sess = sf.openSession();\n" @@ -1935,7 +1907,7 @@ msgstr "" #. Tag: para -#: session_api.xml:788 +#: session_api.xml:774 #, fuzzy, no-c-format msgid "" "During flush, an exception might occur (e.g. if a DML operation violates a " @@ -1949,13 +1921,13 @@ "Hibernate, le sujet sera donc abordé dans <xref linkend=\"transactions\" />." #. Tag: title -#: session_api.xml:795 +#: session_api.xml:781 #, no-c-format msgid "Transitive persistence" msgstr "Persistance transitive" #. Tag: para -#: session_api.xml:797 +#: session_api.xml:783 #, no-c-format msgid "" "It is quite cumbersome to save, delete, or reattach individual objects, " @@ -1967,7 +1939,7 @@ "est une relation parent/enfant. Considérez l'exemple suivant :" #. Tag: para -#: session_api.xml:802 +#: session_api.xml:788 #, no-c-format msgid "" "If the children in a parent/child relationship would be value typed (e.g. a " @@ -1991,7 +1963,7 @@ "de données. " #. Tag: para -#: session_api.xml:812 +#: session_api.xml:798 #, no-c-format msgid "" "Now consider the same scenario with parent and child objects being entities, " @@ -2012,7 +1984,7 @@ "accessibilité</emphasis> par défaut. " #. Tag: para -#: session_api.xml:820 +#: session_api.xml:806 #, no-c-format msgid "" "For each basic operation of the Hibernate session - including " @@ -2032,25 +2004,25 @@ "l'indiquer dans le document de mappage. Par exemple :" #. Tag: programlisting -#: session_api.xml:828 +#: session_api.xml:814 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:830 +#: session_api.xml:816 #, no-c-format msgid "Cascade styles my be combined:" msgstr "Les styles de cascade peuvent être combinés :" #. Tag: programlisting -#: session_api.xml:832 +#: session_api.xml:818 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:834 +#: session_api.xml:820 #, no-c-format msgid "" "You can even use <literal>cascade=\"all\"</literal> to specify that " @@ -2064,7 +2036,7 @@ "literal> spécifie qu'aucune opération ne sera cascadée. " #. Tag: para -#: session_api.xml:839 +#: session_api.xml:825 #, no-c-format msgid "" "In case you are using annotatons you probably have noticed the " @@ -2075,7 +2047,7 @@ msgstr "" #. Tag: para -#: session_api.xml:848 +#: session_api.xml:834 #, no-c-format msgid "" "<literal>CascadeType.PERSIST</literal>: cascades the persist (create) " @@ -2084,7 +2056,7 @@ msgstr "" #. Tag: para -#: session_api.xml:854 +#: session_api.xml:840 #, no-c-format msgid "" "<literal>CascadeType.MERGE</literal>: cascades the merge operation to " @@ -2092,7 +2064,7 @@ msgstr "" #. Tag: para -#: session_api.xml:860 +#: session_api.xml:846 #, no-c-format msgid "" "<literal>CascadeType.REMOVE</literal>: cascades the remove operation to " @@ -2100,7 +2072,7 @@ msgstr "" #. Tag: para -#: session_api.xml:865 +#: session_api.xml:851 #, no-c-format msgid "" "<literal>CascadeType.REFRESH:</literal> cascades the refresh operation to " @@ -2108,7 +2080,7 @@ msgstr "" #. Tag: para -#: session_api.xml:870 +#: session_api.xml:856 #, no-c-format msgid "" "<literal>CascadeType.DETACH:</literal> cascades the detach operation to " @@ -2116,13 +2088,13 @@ msgstr "" #. Tag: para -#: session_api.xml:875 +#: session_api.xml:861 #, fuzzy, no-c-format msgid "<literal>CascadeType.ALL</literal>: all of the above" msgstr "<literal>saveOrUpdate()</literal> s'utilise dans le cas suivant :" #. Tag: para -#: session_api.xml:880 +#: session_api.xml:866 #, no-c-format msgid "" "CascadeType.ALL also covers Hibernate specific operations like save-update, " @@ -2130,7 +2102,7 @@ msgstr "" #. Tag: para -#: session_api.xml:884 +#: session_api.xml:870 #, no-c-format msgid "" "A special cascade style, <literal>delete-orphan</literal>, applies only to " @@ -2147,13 +2119,13 @@ msgstr "" #. Tag: title -#: session_api.xml:897 +#: session_api.xml:883 #, no-c-format msgid "<literal>@OneToMany</literal> with <literal>orphanRemoval</literal>" msgstr "" #. Tag: programlisting -#: session_api.xml:900 +#: session_api.xml:886 #, no-c-format msgid "" "@Entity \n" @@ -2177,13 +2149,13 @@ msgstr "" #. Tag: para -#: session_api.xml:903 +#: session_api.xml:889 #, no-c-format msgid "Recommendations:" msgstr "Recommandations :" #. Tag: para -#: session_api.xml:907 +#: session_api.xml:893 #, fuzzy, no-c-format msgid "" "It does not usually make sense to enable cascade on a many-to-one or many-to-" @@ -2199,7 +2171,7 @@ "literal>. " #. Tag: para -#: session_api.xml:915 +#: session_api.xml:901 #, fuzzy, no-c-format msgid "" "If the child object's lifespan is bounded by the lifespan of the parent " @@ -2212,7 +2184,7 @@ "spécifiant <literal>cascade=\"all,delete-orphan\"</literal>. " #. Tag: para -#: session_api.xml:923 +#: session_api.xml:909 #, no-c-format msgid "" "Otherwise, you might not need cascade at all. But if you think that you will " @@ -2227,7 +2199,7 @@ "literal>. " #. Tag: para -#: session_api.xml:931 +#: session_api.xml:917 #, no-c-format msgid "" "Mapping an association (either a single valued association, or a collection) " @@ -2242,7 +2214,7 @@ "jour/suppression de l'enfant ou des enfants." #. Tag: para -#: session_api.xml:937 +#: session_api.xml:923 #, fuzzy, no-c-format msgid "" "Furthermore, a mere reference to a child from a persistent parent will " @@ -2262,7 +2234,7 @@ "opérations de cascade pour une relation parent/enfant est la suivante : " #. Tag: para -#: session_api.xml:948 +#: session_api.xml:934 #, no-c-format msgid "" "If a parent is passed to <literal>persist()</literal>, all children are " @@ -2272,7 +2244,7 @@ "passés à <literal>persist()</literal>" #. Tag: para -#: session_api.xml:953 +#: session_api.xml:939 #, no-c-format msgid "" "If a parent is passed to <literal>merge()</literal>, all children are passed " @@ -2282,7 +2254,7 @@ "passés à <literal>merge()</literal>" #. Tag: para -#: session_api.xml:958 +#: session_api.xml:944 #, no-c-format msgid "" "If a parent is passed to <literal>save()</literal>, <literal>update()</" @@ -2294,7 +2266,7 @@ "à <literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:964 +#: session_api.xml:950 #, no-c-format msgid "" "If a transient or detached child becomes referenced by a persistent parent, " @@ -2304,7 +2276,7 @@ "il est passé à <literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:970 +#: session_api.xml:956 #, no-c-format msgid "" "If a parent is deleted, all children are passed to <literal>delete()</" @@ -2314,7 +2286,7 @@ "literal>" #. Tag: para -#: session_api.xml:975 +#: session_api.xml:961 #, no-c-format msgid "" "If a child is dereferenced by a persistent parent, <emphasis>nothing special " @@ -2328,7 +2300,7 @@ "literal> soit paramétré, auquel cas l'enfant \"orphelin\" est supprimé." #. Tag: para -#: session_api.xml:983 +#: session_api.xml:969 #, no-c-format msgid "" "Finally, note that cascading of operations can be applied to an object graph " @@ -2347,13 +2319,13 @@ "associées accessibles lors du flush de la <literal>Session</literal>. " #. Tag: title -#: session_api.xml:993 +#: session_api.xml:979 #, no-c-format msgid "Using metadata" msgstr "Utilisation des méta-données" #. Tag: para -#: session_api.xml:995 +#: session_api.xml:981 #, no-c-format msgid "" "Hibernate requires a rich meta-level model of all entity and value types. " @@ -2372,7 +2344,7 @@ "les types de valeurs immutables et, éventuellement, les entités associées). " #. Tag: para -#: session_api.xml:1002 +#: session_api.xml:988 #, no-c-format msgid "" "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " @@ -2386,7 +2358,7 @@ "peuvent être obtenues à partir de la <literal>SessionFactory</literal>. " #. Tag: programlisting -#: session_api.xml:1007 +#: session_api.xml:993 #, no-c-format msgid "" "Cat fritz = ......;\n" @@ -2406,7 +2378,34 @@ "}" msgstr "" +#, fuzzy #~ 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 "" +#~ "Notez que Hibernate n'offre par sa propre API pour l'exécution directe " +#~ "d'expressions <literal>UPDATE</literal> ou <literal>DELETE</literal>. " +#~ "Hibernate est un service de <emphasis>gestion d'état</emphasis>, vous " +#~ "n'avez pas à penser aux <emphasis>expressions</emphasis> pour l'utiliser. " +#~ "JDBC est une API parfaite pour exécuter des expressions SQL, vous pouvez " +#~ "obtenir une <literal>Connection</literal> JDBC à tout moment en appelant " +#~ "<literal>session.connection()</literal>. En outre, la notion d'opérations " +#~ "de masse entre en conflit avec le mapping objet/relationnel pour les " +#~ "applications orientées processus de transactions en ligne. Les futures " +#~ "versions de Hibernate pourront cependant fournir des fonctions " +#~ "particulières d'opération de masse. Voir <xref linkend=\"batch\" /> pour " +#~ "des astuces possibles d'opérations groupées. " + +#~ 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 " Modified: core/trunk/documentation/manual/src/main/docbook/ja-JP/content/session_api.po =================================================================== --- core/trunk/documentation/manual/src/main/docbook/ja-JP/content/session_api.po 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/ja-JP/content/session_api.po 2010-07-21 05:44:34 UTC (rev 19989) @@ -4,7 +4,7 @@ msgstr "" "Project-Id-Version: Collection_Mapping\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2010-07-20 21:02+0000\n" +"POT-Creation-Date: 2010-07-21 05:43+0000\n" "PO-Revision-Date: 2010-01-07 14:56+1000\n" "Last-Translator: Xi HUANG <xhuang(a)redhat.com&gt;\n&quot; "Language-Team: <en(a)li.org&gt;\n&quot; @@ -1385,41 +1385,14 @@ "ます。そのため、 Hibernate は別の方法を用意しています。それは、 detached イン" "スタンスを使用する方法です。" -#. Tag: para -#: session_api.xml:481 -#, 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 "" -"Hibernate は、 <literal>UPDATE</literal> 文や <literal>DELETE</literal> 文を" -"直接実行する API を用意していません。 Hibernate は、 <emphasis>ステートマネー" -"ジメント</emphasis> サービスであり、それを使うのに <emphasis>ステートメント</" -"emphasis> のことを開発者が考える必要はありません。 JDBC は SQL 文を実行する完" -"璧な API であり、 <literal>session.connection()</literal> を呼ぶことでいつで" -"も、 JDBC <literal>Connection</literal> を開発者は取得できます。さらに、大量" -"のデータ操作の考え方は、オンライントランザクション処理向きアプリケーションの" -"オブジェクト/リレーショナルマッピングと衝突します。しかし、 Hibernate の今後" -"のバージョンでは、大量データを処理する特別な機能を提供するかもしれません。" -"バッチ操作に利用できるいくつかの工夫については、 <xref linkend=\"batch\"/> を" -"参照してください。" - #. Tag: title -#: session_api.xml:497 +#: session_api.xml:483 #, no-c-format msgid "Modifying detached objects" msgstr "detached オブジェクトの修正" #. Tag: para -#: session_api.xml:499 +#: session_api.xml:485 #, no-c-format msgid "" "Many applications need to retrieve an object in one transaction, send it to " @@ -1435,7 +1408,7 @@ "離性を保証するために、バージョンデータが通常使われます。" #. Tag: para -#: session_api.xml:505 +#: session_api.xml:491 #, no-c-format msgid "" "Hibernate supports this model by providing for reattachment of detached " @@ -1447,7 +1420,7 @@ "モデルに対応します。" #. Tag: programlisting -#: session_api.xml:509 +#: session_api.xml:495 #, fuzzy, no-c-format msgid "" "// in the first session\n" @@ -1475,7 +1448,7 @@ "secondSession.update(mate); // update mate" #. Tag: para -#: session_api.xml:511 +#: session_api.xml:497 #, no-c-format msgid "" "If the <literal>Cat</literal> with identifier <literal>catId</literal> had " @@ -1487,7 +1460,7 @@ "ときに、例外が投げられます。" #. Tag: para -#: session_api.xml:516 +#: session_api.xml:502 #, no-c-format msgid "" "Use <literal>update()</literal> if you are certain that the session does not " @@ -1506,7 +1479,7 @@ "のなかで最初に呼ばれるメソッドになります。" #. Tag: para -#: session_api.xml:524 +#: session_api.xml:510 #, fuzzy, no-c-format msgid "" "The application should individually <literal>update()</literal> detached " @@ -1522,7 +1495,7 @@ "を参照してください。" #. Tag: para -#: session_api.xml:530 +#: session_api.xml:516 #, no-c-format msgid "" "The <literal>lock()</literal> method also allows an application to " @@ -1534,7 +1507,7 @@ "ん。" #. Tag: programlisting -#: session_api.xml:534 +#: session_api.xml:520 #, fuzzy, no-c-format msgid "" "//just reassociate:\n" @@ -1552,7 +1525,7 @@ "sess.lock(pk, LockMode.UPGRADE);" #. Tag: para -#: session_api.xml:536 +#: session_api.xml:522 #, no-c-format msgid "" "Note that <literal>lock()</literal> can be used with various " @@ -1566,7 +1539,7 @@ "はありません。" #. Tag: para -#: session_api.xml:541 +#: session_api.xml:527 #, fuzzy, no-c-format msgid "" "Other models for long units of work are discussed in <xref linkend=" @@ -1576,13 +1549,13 @@ "optimistic\"/> で述べています。" #. Tag: title -#: session_api.xml:546 +#: session_api.xml:532 #, no-c-format msgid "Automatic state detection" msgstr "自動的な状態検出" #. Tag: para -#: session_api.xml:548 +#: session_api.xml:534 #, no-c-format msgid "" "Hibernate users have requested a general purpose method that either saves a " @@ -1597,7 +1570,7 @@ "機能を実現したメソッドです。" #. Tag: programlisting -#: session_api.xml:554 +#: session_api.xml:540 #, fuzzy, no-c-format msgid "" "// in the first session\n" @@ -1627,7 +1600,7 @@ "id)" #. Tag: para -#: session_api.xml:556 +#: session_api.xml:542 #, no-c-format msgid "" "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " @@ -1645,7 +1618,7 @@ "もあります。" #. Tag: para -#: session_api.xml:563 +#: session_api.xml:549 #, no-c-format msgid "" "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " @@ -1655,31 +1628,31 @@ "のシナリオで使われます:" #. Tag: para -#: session_api.xml:569 +#: session_api.xml:555 #, no-c-format msgid "the application loads an object in the first session" msgstr "アプリケーションが最初のセッションでオブジェクトをロードします。" #. Tag: para -#: session_api.xml:573 +#: session_api.xml:559 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "オブジェクトが UI 層に送られます。" #. Tag: para -#: session_api.xml:577 +#: session_api.xml:563 #, no-c-format msgid "some modifications are made to the object" msgstr "オブジェクトに対して変更が加えられます。" #. Tag: para -#: session_api.xml:581 +#: session_api.xml:567 #, no-c-format msgid "the object is passed back down to the business logic tier" msgstr "オブジェクトがビジネスロジック層に送られます。" #. Tag: para -#: session_api.xml:585 +#: session_api.xml:571 #, no-c-format msgid "" "the application persists these modifications by calling <literal>update()</" @@ -1689,20 +1662,20 @@ "とで、これらの変更を永続化します。" #. Tag: para -#: session_api.xml:590 +#: session_api.xml:576 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "<literal>saveOrUpdate()</literal> は以下のことを行います:" #. Tag: para -#: session_api.xml:594 +#: session_api.xml:580 #, no-c-format msgid "if the object is already persistent in this session, do nothing" msgstr "" "オブジェクトがこのセッションで、すでに永続化されていれば、何もしません。" #. Tag: para -#: session_api.xml:599 +#: session_api.xml:585 #, no-c-format msgid "" "if another object associated with the session has the same identifier, throw " @@ -1712,14 +1685,14 @@ "例外を投げます。" #. Tag: para -#: session_api.xml:604 +#: session_api.xml:590 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" "オブジェクトの識別子が値を持たないならば、 <literal>save()</literal> します。" #. Tag: para -#: session_api.xml:609 +#: session_api.xml:595 #, no-c-format msgid "" "if the object's identifier has the value assigned to a newly instantiated " @@ -1729,7 +1702,7 @@ "トのための値である場合、そのオブジェクトを <literal>save()</literal> します。" #. Tag: para -#: session_api.xml:614 +#: session_api.xml:600 #, no-c-format msgid "" "if the object is versioned by a <literal>&lt;version&gt;</literal> or " @@ -1743,20 +1716,20 @@ "ある場合、そのオブジェクトを <literal>save()</literal> します。" #. Tag: para -#: session_api.xml:622 +#: session_api.xml:608 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "" "そうでない場合は、そのオブジェクトを <literal>update()</literal> します。" #. Tag: para -#: session_api.xml:626 +#: session_api.xml:612 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "そして、 <literal>merge()</literal> は以下のように非常に異なります:" #. Tag: para -#: session_api.xml:630 +#: session_api.xml:616 #, no-c-format msgid "" "if there is a persistent instance with the same identifier currently " @@ -1767,7 +1740,7 @@ "ば、引数で受け取ったオブジェクトの状態を永続化インスタンスにコピーします。" #. Tag: para -#: session_api.xml:636 +#: session_api.xml:622 #, no-c-format msgid "" "if there is no persistent instance currently associated with the session, " @@ -1777,13 +1750,13 @@ "からそれをロードするか、あるいは、新しい永続化インスタンスを作成します。" #. Tag: para -#: session_api.xml:642 +#: session_api.xml:628 #, no-c-format msgid "the persistent instance is returned" msgstr "永続化インスタンスが返されます。" #. Tag: para -#: session_api.xml:646 +#: session_api.xml:632 #, no-c-format msgid "" "the given instance does not become associated with the session, it remains " @@ -1793,13 +1766,13 @@ "のままです。" #. Tag: title -#: session_api.xml:653 +#: session_api.xml:639 #, no-c-format msgid "Deleting persistent objects" msgstr "永続オブジェクトの削除" #. Tag: para -#: session_api.xml:655 +#: session_api.xml:641 #, no-c-format msgid "" "<literal>Session.delete()</literal> will remove an object's state from the " @@ -1813,13 +1786,13 @@ "transient にするものと考えるのが一番です。" #. Tag: programlisting -#: session_api.xml:660 +#: session_api.xml:646 #, fuzzy, no-c-format msgid "sess.delete(cat);" msgstr "sess.delete(cat);" #. Tag: para -#: session_api.xml:662 +#: session_api.xml:648 #, no-c-format msgid "" "You can delete objects in any order, without risk of foreign key constraint " @@ -1833,13 +1806,13 @@ "ジェクトを削除したときに、子供オブジェクトを削除し忘れた場合です。" #. Tag: title -#: session_api.xml:670 +#: session_api.xml:656 #, no-c-format msgid "Replicating object between two different datastores" msgstr "異なる二つのデータストア間でのオブジェクトのレプリケーション" #. Tag: para -#: session_api.xml:672 +#: session_api.xml:658 #, no-c-format msgid "" "It is sometimes useful to be able to take a graph of persistent instances " @@ -1850,7 +1823,7 @@ "生成せずにすむと便利な場合があります。" #. Tag: programlisting -#: session_api.xml:676 +#: session_api.xml:662 #, fuzzy, no-c-format msgid "" "//retrieve a cat from one database\n" @@ -1882,7 +1855,7 @@ "session2.close();" #. Tag: para -#: session_api.xml:678 +#: session_api.xml:664 #, no-c-format msgid "" "The <literal>ReplicationMode</literal> determines how <literal>replicate()</" @@ -1893,7 +1866,7 @@ "します。" #. Tag: para -#: session_api.xml:684 +#: session_api.xml:670 #, no-c-format msgid "" "<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is " @@ -1903,7 +1876,7 @@ "に存在するなら、そのオブジェクトを無視します。" #. Tag: para -#: session_api.xml:689 +#: session_api.xml:675 #, no-c-format msgid "" "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing " @@ -1913,7 +1886,7 @@ "て上書きします。" #. Tag: para -#: session_api.xml:694 +#: session_api.xml:680 #, no-c-format msgid "" "<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there " @@ -1923,7 +1896,7 @@ "スに存在するなら、例外を投げます。" #. Tag: para -#: session_api.xml:700 +#: session_api.xml:686 #, no-c-format msgid "" "<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its " @@ -1935,7 +1908,7 @@ "きします。" #. Tag: para -#: session_api.xml:706 +#: session_api.xml:692 #, no-c-format msgid "" "Usecases for this feature include reconciling data entered into different " @@ -1948,13 +1921,13 @@ "ンザクションのなかで加えられた変更のロールバックなどです。" #. Tag: title -#: session_api.xml:713 +#: session_api.xml:699 #, no-c-format msgid "Flushing the Session" msgstr "セッションのフラッシュ" #. Tag: para -#: session_api.xml:715 +#: session_api.xml:701 #, no-c-format msgid "" "Sometimes the <literal>Session</literal> will execute the SQL statements " @@ -1967,31 +1940,31 @@ "処理 <emphasis>flush</emphasis> は、デフォルトでは次のときに起こります。" #. Tag: para -#: session_api.xml:723 +#: session_api.xml:709 #, no-c-format msgid "before some query executions" msgstr "クエリを実行する前" #. Tag: para -#: session_api.xml:727 +#: session_api.xml:713 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "<literal>org.hibernate.Transaction.commit()</literal> を実行したとき" #. Tag: para -#: session_api.xml:732 +#: session_api.xml:718 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "<literal>Session.flush()</literal> を実行したとき" #. Tag: para -#: session_api.xml:736 +#: session_api.xml:722 #, no-c-format msgid "The SQL statements are issued in the following order:" msgstr "SQL 文は以下の順番で発行されます。" #. Tag: para -#: session_api.xml:740 +#: session_api.xml:726 #, no-c-format msgid "" "all entity insertions in the same order the corresponding objects were saved " @@ -2001,31 +1974,31 @@ "てセーブしたオブジェクトの順に実行していきます。" #. Tag: para -#: session_api.xml:745 +#: session_api.xml:731 #, no-c-format msgid "all entity updates" msgstr "すべてのエンティティの更新" #. Tag: para -#: session_api.xml:749 +#: session_api.xml:735 #, no-c-format msgid "all collection deletions" msgstr "すべてのコレクションの削除" #. Tag: para -#: session_api.xml:753 +#: session_api.xml:739 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "すべてのコレクションの要素に対する削除、更新、挿入" #. Tag: para -#: session_api.xml:757 +#: session_api.xml:743 #, no-c-format msgid "all collection insertions" msgstr "すべてのコレクションの挿入" #. Tag: para -#: session_api.xml:761 +#: session_api.xml:747 #, no-c-format msgid "" "all entity deletions in the same order the corresponding objects were " @@ -2035,7 +2008,7 @@ "使って削除したオブジェクトの順に実行していきます。" #. Tag: para -#: session_api.xml:766 +#: session_api.xml:752 #, no-c-format msgid "" "An exception is that objects using <literal>native</literal> ID generation " @@ -2045,7 +2018,7 @@ "は、それらがセーブされたときに挿入されます。）" #. Tag: para -#: session_api.xml:769 +#: session_api.xml:755 #, no-c-format msgid "" "Except when you explicitly <literal>flush()</literal>, there are absolutely " @@ -2061,7 +2034,7 @@ "データや間違ったデータ返さないことを保証しています。" #. Tag: para -#: session_api.xml:776 +#: session_api.xml:762 #, fuzzy, no-c-format msgid "" "It is possible to change the default behavior so that flush occurs less " @@ -2083,7 +2056,7 @@ "してください)。" #. Tag: programlisting -#: session_api.xml:786 +#: session_api.xml:772 #, fuzzy, no-c-format msgid "" "sess = sf.openSession();\n" @@ -2117,7 +2090,7 @@ "sess.close();" #. Tag: para -#: session_api.xml:788 +#: session_api.xml:774 #, fuzzy, no-c-format msgid "" "During flush, an exception might occur (e.g. if a DML operation violates a " @@ -2131,13 +2104,13 @@ "明します。" #. Tag: title -#: session_api.xml:795 +#: session_api.xml:781 #, no-c-format msgid "Transitive persistence" msgstr "連鎖的な永続化" #. Tag: para -#: session_api.xml:797 +#: session_api.xml:783 #, no-c-format msgid "" "It is quite cumbersome to save, delete, or reattach individual objects, " @@ -2149,7 +2122,7 @@ "は、親子関係を扱うケースです。以下の例を考えてみましょう:" #. Tag: para -#: session_api.xml:802 +#: session_api.xml:788 #, no-c-format msgid "" "If the children in a parent/child relationship would be value typed (e.g. a " @@ -2170,7 +2143,7 @@ "を共有できないので、データベースからその子供を削除します。" #. Tag: para -#: session_api.xml:812 +#: session_api.xml:798 #, no-c-format msgid "" "Now consider the same scenario with parent and child objects being entities, " @@ -2190,7 +2163,7 @@ "よる永続化</emphasis> をデフォルトでは実行しません。" #. Tag: para -#: session_api.xml:820 +#: session_api.xml:806 #, no-c-format msgid "" "For each basic operation of the Hibernate session - including " @@ -2210,25 +2183,25 @@ "ばなりません。例えば、以下のようにします:" #. Tag: programlisting -#: session_api.xml:828 +#: session_api.xml:814 #, fuzzy, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" msgstr "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" #. Tag: para -#: session_api.xml:830 +#: session_api.xml:816 #, no-c-format msgid "Cascade styles my be combined:" msgstr "カスケードスタイルは、組み合わせることができます:" #. Tag: programlisting -#: session_api.xml:832 +#: session_api.xml:818 #, fuzzy, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" msgstr "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" #. Tag: para -#: session_api.xml:834 +#: session_api.xml:820 #, no-c-format msgid "" "You can even use <literal>cascade=\"all\"</literal> to specify that " @@ -2242,7 +2215,7 @@ "します。" #. Tag: para -#: session_api.xml:839 +#: session_api.xml:825 #, no-c-format msgid "" "In case you are using annotatons you probably have noticed the " @@ -2253,7 +2226,7 @@ msgstr "" #. Tag: para -#: session_api.xml:848 +#: session_api.xml:834 #, no-c-format msgid "" "<literal>CascadeType.PERSIST</literal>: cascades the persist (create) " @@ -2262,7 +2235,7 @@ msgstr "" #. Tag: para -#: session_api.xml:854 +#: session_api.xml:840 #, no-c-format msgid "" "<literal>CascadeType.MERGE</literal>: cascades the merge operation to " @@ -2270,7 +2243,7 @@ msgstr "" #. Tag: para -#: session_api.xml:860 +#: session_api.xml:846 #, no-c-format msgid "" "<literal>CascadeType.REMOVE</literal>: cascades the remove operation to " @@ -2278,7 +2251,7 @@ msgstr "" #. Tag: para -#: session_api.xml:865 +#: session_api.xml:851 #, no-c-format msgid "" "<literal>CascadeType.REFRESH:</literal> cascades the refresh operation to " @@ -2286,7 +2259,7 @@ msgstr "" #. Tag: para -#: session_api.xml:870 +#: session_api.xml:856 #, no-c-format msgid "" "<literal>CascadeType.DETACH:</literal> cascades the detach operation to " @@ -2294,13 +2267,13 @@ msgstr "" #. Tag: para -#: session_api.xml:875 +#: session_api.xml:861 #, fuzzy, no-c-format msgid "<literal>CascadeType.ALL</literal>: all of the above" msgstr "<literal>saveOrUpdate()</literal> は以下のことを行います:" #. Tag: para -#: session_api.xml:880 +#: session_api.xml:866 #, no-c-format msgid "" "CascadeType.ALL also covers Hibernate specific operations like save-update, " @@ -2308,7 +2281,7 @@ msgstr "" #. Tag: para -#: session_api.xml:884 +#: session_api.xml:870 #, no-c-format msgid "" "A special cascade style, <literal>delete-orphan</literal>, applies only to " @@ -2325,13 +2298,13 @@ msgstr "" #. Tag: title -#: session_api.xml:897 +#: session_api.xml:883 #, no-c-format msgid "<literal>@OneToMany</literal> with <literal>orphanRemoval</literal>" msgstr "" #. Tag: programlisting -#: session_api.xml:900 +#: session_api.xml:886 #, no-c-format msgid "" "@Entity \n" @@ -2355,13 +2328,13 @@ msgstr "" #. Tag: para -#: session_api.xml:903 +#: session_api.xml:889 #, no-c-format msgid "Recommendations:" msgstr "おすすめ：" #. Tag: para -#: session_api.xml:907 +#: session_api.xml:893 #, fuzzy, no-c-format msgid "" "It does not usually make sense to enable cascade on a many-to-one or many-to-" @@ -2376,7 +2349,7 @@ "literal> 関連に対しては、カスケードが役に立つことがあります。" #. Tag: para -#: session_api.xml:915 +#: session_api.xml:901 #, fuzzy, no-c-format msgid "" "If the child object's lifespan is bounded by the lifespan of the parent " @@ -2389,7 +2362,7 @@ "を <emphasis>ライフサイクルオブジェクト</emphasis> にします。" #. Tag: para -#: session_api.xml:923 +#: session_api.xml:909 #, no-c-format msgid "" "Otherwise, you might not need cascade at all. But if you think that you will " @@ -2403,7 +2376,7 @@ "literal> を使うことを考えましょう。" #. Tag: para -#: session_api.xml:931 +#: session_api.xml:917 #, no-c-format msgid "" "Mapping an association (either a single valued association, or a collection) " @@ -2416,7 +2389,7 @@ "のセーブ/更新/削除が、子のセーブ/更新/削除を引き起こす関係のことです。" #. Tag: para -#: session_api.xml:937 +#: session_api.xml:923 #, fuzzy, no-c-format msgid "" "Furthermore, a mere reference to a child from a persistent parent will " @@ -2435,7 +2408,7 @@ "なります:" #. Tag: para -#: session_api.xml:948 +#: session_api.xml:934 #, no-c-format msgid "" "If a parent is passed to <literal>persist()</literal>, all children are " @@ -2445,7 +2418,7 @@ "<literal>persist()</literal> に渡されます。" #. Tag: para -#: session_api.xml:953 +#: session_api.xml:939 #, no-c-format msgid "" "If a parent is passed to <literal>merge()</literal>, all children are passed " @@ -2455,7 +2428,7 @@ "literal> に渡されます。" #. Tag: para -#: session_api.xml:958 +#: session_api.xml:944 #, no-c-format msgid "" "If a parent is passed to <literal>save()</literal>, <literal>update()</" @@ -2467,7 +2440,7 @@ "<literal>saveOrUpdate()</literal> に渡されます。" #. Tag: para -#: session_api.xml:964 +#: session_api.xml:950 #, no-c-format msgid "" "If a transient or detached child becomes referenced by a persistent parent, " @@ -2477,7 +2450,7 @@ "<literal>saveOrUpdate()</literal> に渡されます。" #. Tag: para -#: session_api.xml:970 +#: session_api.xml:956 #, no-c-format msgid "" "If a parent is deleted, all children are passed to <literal>delete()</" @@ -2487,7 +2460,7 @@ "す。" #. Tag: para -#: session_api.xml:975 +#: session_api.xml:961 #, no-c-format msgid "" "If a child is dereferenced by a persistent parent, <emphasis>nothing special " @@ -2501,7 +2474,7 @@ "きます。この場合、「親のない」子は削除されます。" #. Tag: para -#: session_api.xml:983 +#: session_api.xml:969 #, no-c-format msgid "" "Finally, note that cascading of operations can be applied to an object graph " @@ -2520,13 +2493,13 @@ "エンティティに伝播します。" #. Tag: title -#: session_api.xml:993 +#: session_api.xml:979 #, no-c-format msgid "Using metadata" msgstr "メタデータの使用" #. Tag: para -#: session_api.xml:995 +#: session_api.xml:981 #, no-c-format msgid "" "Hibernate requires a rich meta-level model of all entity and value types. " @@ -2545,7 +2518,7 @@ "るものです。" #. Tag: para -#: session_api.xml:1002 +#: session_api.xml:988 #, no-c-format msgid "" "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " @@ -2559,7 +2532,7 @@ "スタンスは、 <literal>SessionFactory</literal> から得られます。" #. Tag: programlisting -#: session_api.xml:1007 +#: session_api.xml:993 #, fuzzy, no-c-format msgid "" "Cat fritz = ......;\n" @@ -2594,7 +2567,33 @@ " }\n" "}" +#, fuzzy #~ 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 "" +#~ "Hibernate は、 <literal>UPDATE</literal> 文や <literal>DELETE</literal> 文" +#~ "を直接実行する API を用意していません。 Hibernate は、 <emphasis>ステート" +#~ "マネージメント</emphasis> サービスであり、それを使うのに <emphasis>ステー" +#~ "トメント</emphasis> のことを開発者が考える必要はありません。 JDBC は SQL " +#~ "文を実行する完璧な API であり、 <literal>session.connection()</literal> を" +#~ "呼ぶことでいつでも、 JDBC <literal>Connection</literal> を開発者は取得でき" +#~ "ます。さらに、大量のデータ操作の考え方は、オンライントランザクション処理向" +#~ "きアプリケーションのオブジェクト/リレーショナルマッピングと衝突します。し" +#~ "かし、 Hibernate の今後のバージョンでは、大量データを処理する特別な機能を" +#~ "提供するかもしれません。バッチ操作に利用できるいくつかの工夫については、 " +#~ "<xref linkend=\"batch\"/> を参照してください。" + +#~ 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 " Modified: core/trunk/documentation/manual/src/main/docbook/pot/content/session_api.pot =================================================================== --- core/trunk/documentation/manual/src/main/docbook/pot/content/session_api.pot 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/pot/content/session_api.pot 2010-07-21 05:44:34 UTC (rev 19989) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2010-07-20 21:02+0000\n" +"POT-Creation-Date: 2010-07-21 05:43+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&gt;\n&quot; @@ -783,32 +783,26 @@ 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:481 -#, 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 "" - #. Tag: title -#: session_api.xml:497 +#: session_api.xml:483 #, no-c-format msgid "Modifying detached objects" msgstr "" #. Tag: para -#: session_api.xml:499 +#: session_api.xml:485 #, 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:505 +#: session_api.xml:491 #, 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:509 +#: session_api.xml:495 #, no-c-format msgid "" "// in the first session\n" @@ -825,31 +819,31 @@ msgstr "" #. Tag: para -#: session_api.xml:511 +#: session_api.xml:497 #, 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:516 +#: session_api.xml:502 #, 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:524 +#: session_api.xml:510 #, 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 "" #. Tag: para -#: session_api.xml:530 +#: session_api.xml:516 #, 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:534 +#: session_api.xml:520 #, no-c-format msgid "" "//just reassociate:\n" @@ -861,31 +855,31 @@ msgstr "" #. Tag: para -#: session_api.xml:536 +#: session_api.xml:522 #, 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:541 +#: session_api.xml:527 #, no-c-format msgid "Other models for long units of work are discussed in <xref linkend=\"transactions-optimistic\"/>." msgstr "" #. Tag: title -#: session_api.xml:546 +#: session_api.xml:532 #, no-c-format msgid "Automatic state detection" msgstr "" #. Tag: para -#: session_api.xml:548 +#: session_api.xml:534 #, 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:554 +#: session_api.xml:540 #, no-c-format msgid "" "// in the first session\n" @@ -901,157 +895,157 @@ msgstr "" #. Tag: para -#: session_api.xml:556 +#: session_api.xml:542 #, 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:563 +#: session_api.xml:549 #, no-c-format msgid "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are used in the following scenario:" msgstr "" #. Tag: para -#: session_api.xml:569 +#: session_api.xml:555 #, no-c-format msgid "the application loads an object in the first session" msgstr "" #. Tag: para -#: session_api.xml:573 +#: session_api.xml:559 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "" #. Tag: para -#: session_api.xml:577 +#: session_api.xml:563 #, no-c-format msgid "some modifications are made to the object" msgstr "" #. Tag: para -#: session_api.xml:581 +#: session_api.xml:567 #, no-c-format msgid "the object is passed back down to the business logic tier" msgstr "" #. Tag: para -#: session_api.xml:585 +#: session_api.xml:571 #, no-c-format msgid "the application persists these modifications by calling <literal>update()</literal> in a second session" msgstr "" #. Tag: para -#: session_api.xml:590 +#: session_api.xml:576 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "" #. Tag: para -#: session_api.xml:594 +#: session_api.xml:580 #, no-c-format msgid "if the object is already persistent in this session, do nothing" msgstr "" #. Tag: para -#: session_api.xml:599 +#: session_api.xml:585 #, no-c-format msgid "if another object associated with the session has the same identifier, throw an exception" msgstr "" #. Tag: para -#: session_api.xml:604 +#: session_api.xml:590 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" #. Tag: para -#: session_api.xml:609 +#: session_api.xml:595 #, 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:614 +#: session_api.xml:600 #, no-c-format msgid "if the object is versioned by a <literal>&lt;version&gt;</literal> or <literal>&lt;timestamp&gt;</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:622 +#: session_api.xml:608 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "" #. Tag: para -#: session_api.xml:626 +#: session_api.xml:612 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "" #. Tag: para -#: session_api.xml:630 +#: session_api.xml:616 #, 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:636 +#: session_api.xml:622 #, 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:642 +#: session_api.xml:628 #, no-c-format msgid "the persistent instance is returned" msgstr "" #. Tag: para -#: session_api.xml:646 +#: session_api.xml:632 #, no-c-format msgid "the given instance does not become associated with the session, it remains detached" msgstr "" #. Tag: title -#: session_api.xml:653 +#: session_api.xml:639 #, no-c-format msgid "Deleting persistent objects" msgstr "" #. Tag: para -#: session_api.xml:655 +#: session_api.xml:641 #, 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:660 +#: session_api.xml:646 #, no-c-format msgid "sess.delete(cat);" msgstr "" #. Tag: para -#: session_api.xml:662 +#: session_api.xml:648 #, 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:670 +#: session_api.xml:656 #, no-c-format msgid "Replicating object between two different datastores" msgstr "" #. Tag: para -#: session_api.xml:672 +#: session_api.xml:658 #, 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:676 +#: session_api.xml:662 #, no-c-format msgid "" "//retrieve a cat from one database\n" @@ -1070,133 +1064,133 @@ msgstr "" #. Tag: para -#: session_api.xml:678 +#: session_api.xml:664 #, 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:684 +#: session_api.xml:670 #, 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:689 +#: session_api.xml:675 #, no-c-format msgid "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing database row with the same identifier" msgstr "" #. Tag: para -#: session_api.xml:694 +#: session_api.xml:680 #, 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:700 +#: session_api.xml:686 #, 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:706 +#: session_api.xml:692 #, 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:713 +#: session_api.xml:699 #, no-c-format msgid "Flushing the Session" msgstr "" #. Tag: para -#: session_api.xml:715 +#: session_api.xml:701 #, 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:723 +#: session_api.xml:709 #, no-c-format msgid "before some query executions" msgstr "" #. Tag: para -#: session_api.xml:727 +#: session_api.xml:713 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "" #. Tag: para -#: session_api.xml:732 +#: session_api.xml:718 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "" #. Tag: para -#: session_api.xml:736 +#: session_api.xml:722 #, no-c-format msgid "The SQL statements are issued in the following order:" msgstr "" #. Tag: para -#: session_api.xml:740 +#: session_api.xml:726 #, 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:745 +#: session_api.xml:731 #, no-c-format msgid "all entity updates" msgstr "" #. Tag: para -#: session_api.xml:749 +#: session_api.xml:735 #, no-c-format msgid "all collection deletions" msgstr "" #. Tag: para -#: session_api.xml:753 +#: session_api.xml:739 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "" #. Tag: para -#: session_api.xml:757 +#: session_api.xml:743 #, no-c-format msgid "all collection insertions" msgstr "" #. Tag: para -#: session_api.xml:761 +#: session_api.xml:747 #, 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:766 +#: session_api.xml:752 #, 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:769 +#: session_api.xml:755 #, 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:776 +#: session_api.xml:762 #, 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 "" #. Tag: programlisting -#: session_api.xml:786 +#: session_api.xml:772 #, no-c-format msgid "" "sess = sf.openSession();\n" @@ -1216,127 +1210,127 @@ msgstr "" #. Tag: para -#: session_api.xml:788 +#: session_api.xml:774 #, 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 "" #. Tag: title -#: session_api.xml:795 +#: session_api.xml:781 #, no-c-format msgid "Transitive persistence" msgstr "" #. Tag: para -#: session_api.xml:797 +#: session_api.xml:783 #, 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:802 +#: session_api.xml:788 #, 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:812 +#: session_api.xml:798 #, 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:820 +#: session_api.xml:806 #, 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:828 +#: session_api.xml:814 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:830 +#: session_api.xml:816 #, no-c-format msgid "Cascade styles my be combined:" msgstr "" #. Tag: programlisting -#: session_api.xml:832 +#: session_api.xml:818 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:834 +#: session_api.xml:820 #, 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:839 +#: session_api.xml:825 #, no-c-format msgid "In case you are using annotatons you probably have noticed the <literal>cascade</literal> attribute taking an array of <classname>CascadeType</classname> as a value. The cascade concept in JPA is very is similar to the transitive persistence and cascading of operations as described above, but with slightly different semantics and cascading types:" msgstr "" #. Tag: para -#: session_api.xml:848 +#: session_api.xml:834 #, no-c-format msgid "<literal>CascadeType.PERSIST</literal>: cascades the persist (create) operation to associated entities persist() is called or if the entity is managed" msgstr "" #. Tag: para -#: session_api.xml:854 +#: session_api.xml:840 #, no-c-format msgid "<literal>CascadeType.MERGE</literal>: cascades the merge operation to associated entities if merge() is called or if the entity is managed" msgstr "" #. Tag: para -#: session_api.xml:860 +#: session_api.xml:846 #, no-c-format msgid "<literal>CascadeType.REMOVE</literal>: cascades the remove operation to associated entities if delete() is called" msgstr "" #. Tag: para -#: session_api.xml:865 +#: session_api.xml:851 #, no-c-format msgid "<literal>CascadeType.REFRESH:</literal> cascades the refresh operation to associated entities if refresh() is called" msgstr "" #. Tag: para -#: session_api.xml:870 +#: session_api.xml:856 #, no-c-format msgid "<literal>CascadeType.DETACH:</literal> cascades the detach operation to associated entities if detach() is called" msgstr "" #. Tag: para -#: session_api.xml:875 +#: session_api.xml:861 #, no-c-format msgid "<literal>CascadeType.ALL</literal>: all of the above" msgstr "" #. Tag: para -#: session_api.xml:880 +#: session_api.xml:866 #, no-c-format msgid "CascadeType.ALL also covers Hibernate specific operations like save-update, lock etc..." msgstr "" #. Tag: para -#: session_api.xml:884 +#: session_api.xml:870 #, 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. Using annotations there is no <literal>CascadeType.DELETE-ORPHAN</literal> equivalent. Instead you can use the attribute <literal>orphanRemoval as seen in </literal><xref linkend=\"example-one-to-many-with-orphan-removal\"/>. If an entity is removed from a <classname>@OneToMany</classname> collection or an associated entity is dereferenced from a <classname>@OneToOne</classname> association, this associated entity can be marked for deletion if <literal>orphanRemoval</literal> is set to true." msgstr "" #. Tag: title -#: session_api.xml:897 +#: session_api.xml:883 #, no-c-format msgid "<literal>@OneToMany</literal> with <literal>orphanRemoval</literal>" msgstr "" #. Tag: programlisting -#: session_api.xml:900 +#: session_api.xml:886 #, no-c-format msgid "" "@Entity \n" @@ -1360,103 +1354,103 @@ msgstr "" #. Tag: para -#: session_api.xml:903 +#: session_api.xml:889 #, no-c-format msgid "Recommendations:" msgstr "" #. Tag: para -#: session_api.xml:907 +#: session_api.xml:893 #, no-c-format msgid "It does not usually make sense to enable cascade on a many-to-one or many-to-many association. In fact the <literal>@ManyToOne</literal> and <literal>@ManyToMany</literal> don't even offer a <literal>orphanRemoval</literal> attribute. Cascading is often useful for one-to-one and one-to-many associations." msgstr "" #. Tag: para -#: session_api.xml:915 +#: session_api.xml:901 #, 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&gt;cascade=\&quot;all,delete-orphan\&quot;(&lt;literal&gt;(a)OneToMany(cascade=CascadeType.ALL, orphanRemoval=true)</literal>)</literal>." msgstr "" #. Tag: para -#: session_api.xml:923 +#: session_api.xml:909 #, 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:931 +#: session_api.xml:917 #, 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:937 +#: session_api.xml:923 #, 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 one-to-many 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:948 +#: session_api.xml:934 #, 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:953 +#: session_api.xml:939 #, 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:958 +#: session_api.xml:944 #, 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:964 +#: session_api.xml:950 #, 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:970 +#: session_api.xml:956 #, no-c-format msgid "If a parent is deleted, all children are passed to <literal>delete()</literal>" msgstr "" #. Tag: para -#: session_api.xml:975 +#: session_api.xml:961 #, 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:983 +#: session_api.xml:969 #, 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:993 +#: session_api.xml:979 #, no-c-format msgid "Using metadata" msgstr "" #. Tag: para -#: session_api.xml:995 +#: session_api.xml:981 #, 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:1002 +#: session_api.xml:988 #, 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:1007 +#: session_api.xml:993 #, no-c-format msgid "" "Cat fritz = ......;\n" Modified: core/trunk/documentation/manual/src/main/docbook/pt-BR/content/session_api.po =================================================================== --- core/trunk/documentation/manual/src/main/docbook/pt-BR/content/session_api.po 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/pt-BR/content/session_api.po 2010-07-21 05:44:34 UTC (rev 19989) @@ -108,7 +108,7 @@ msgstr "" "Project-Id-Version: session_api\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2010-07-20 21:02+0000\n" +"POT-Creation-Date: 2010-07-21 05:43+0000\n" "PO-Revision-Date: 2010-03-19 10:25+1000\n" "Last-Translator: \n" "Language-Team: <en(a)li.org&gt;\n&quot; @@ -1333,42 +1333,14 @@ "sessão. Por isso, o Hibernate oferece uma abordagem alternativa, usando " "instâncias desanexadas." -#. Tag: para -#: session_api.xml:481 -#, 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 "" -"Note que o Hibernate não oferece seu próprio API para execução direta de " -"instruções <literal>UPDATE</literal> ou <literal>DELETE</literal>. O " -"Hibernate é um serviço de <emphasis>gerenciamento de estado</emphasis> que " -"você nem precisa se preocupar com <emphasis>instruções</emphasis> para " -"utilizá-lo. O JDBC é um API perfeito para executar instruções SQL, você pode " -"ter uma <literal>Connection</literal> JDBC a qualquer momento, chamando " -"<literal>session.connection()</literal>. Além disso, a noção de operações em " -"massa conflitua com o mapeamento de objeto/relacional para aplicativos de " -"transações online com processamento. No entanto, versões futuras do " -"Hibernate poderão oferecer funções especiais de operação em massa. Veja " -"<xref linkend=\"batch\" /> para alguns possíveis truques de operação em " -"lote. " - #. Tag: title -#: session_api.xml:497 +#: session_api.xml:483 #, no-c-format msgid "Modifying detached objects" msgstr "Modificando objetos desacoplados" #. Tag: para -#: session_api.xml:499 +#: session_api.xml:485 #, no-c-format msgid "" "Many applications need to retrieve an object in one transaction, send it to " @@ -1384,7 +1356,7 @@ "durante a \"longa\" unidade de trabalho." #. Tag: para -#: session_api.xml:505 +#: session_api.xml:491 #, no-c-format msgid "" "Hibernate supports this model by providing for reattachment of detached " @@ -1396,7 +1368,7 @@ "merge()</literal>:" #. Tag: programlisting -#: session_api.xml:509 +#: session_api.xml:495 #, no-c-format msgid "" "// in the first session\n" @@ -1413,7 +1385,7 @@ msgstr "" #. Tag: para -#: session_api.xml:511 +#: session_api.xml:497 #, no-c-format msgid "" "If the <literal>Cat</literal> with identifier <literal>catId</literal> had " @@ -1425,7 +1397,7 @@ "aplicação tentou re-acoplá-lo, teria surgido uma exceção." #. Tag: para -#: session_api.xml:516 +#: session_api.xml:502 #, no-c-format msgid "" "Use <literal>update()</literal> if you are certain that the session does not " @@ -1445,7 +1417,7 @@ "executada. " #. Tag: para -#: session_api.xml:524 +#: session_api.xml:510 #, fuzzy, no-c-format msgid "" "The application should individually <literal>update()</literal> detached " @@ -1462,7 +1434,7 @@ "para maiores informações. " #. Tag: para -#: session_api.xml:530 +#: session_api.xml:516 #, no-c-format msgid "" "The <literal>lock()</literal> method also allows an application to " @@ -1474,7 +1446,7 @@ "não pode ser modificada." #. Tag: programlisting -#: session_api.xml:534 +#: session_api.xml:520 #, no-c-format msgid "" "//just reassociate:\n" @@ -1486,7 +1458,7 @@ msgstr "" #. Tag: para -#: session_api.xml:536 +#: session_api.xml:522 #, no-c-format msgid "" "Note that <literal>lock()</literal> can be used with various " @@ -1500,7 +1472,7 @@ "único caso de uso para <literal>lock()</literal>. " #. Tag: para -#: session_api.xml:541 +#: session_api.xml:527 #, fuzzy, no-c-format msgid "" "Other models for long units of work are discussed in <xref linkend=" @@ -1510,13 +1482,13 @@ "linkend=\"transactions-optimistic\" />." #. Tag: title -#: session_api.xml:546 +#: session_api.xml:532 #, no-c-format msgid "Automatic state detection" msgstr "Detecção automática de estado" #. Tag: para -#: session_api.xml:548 +#: session_api.xml:534 #, no-c-format msgid "" "Hibernate users have requested a general purpose method that either saves a " @@ -1530,7 +1502,7 @@ "O método <literal>saveOrUpdate()</literal> implementa esta funcionalidade." #. Tag: programlisting -#: session_api.xml:554 +#: session_api.xml:540 #, no-c-format msgid "" "// in the first session\n" @@ -1548,7 +1520,7 @@ msgstr "" #. Tag: para -#: session_api.xml:556 +#: session_api.xml:542 #, no-c-format msgid "" "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " @@ -1566,7 +1538,7 @@ "métodos." #. Tag: para -#: session_api.xml:563 +#: session_api.xml:549 #, no-c-format msgid "" "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " @@ -1576,31 +1548,31 @@ "literal>são utilizados nos seguintes cenários:" #. Tag: para -#: session_api.xml:569 +#: session_api.xml:555 #, no-c-format msgid "the application loads an object in the first session" msgstr "a aplicação carrega um objeto na primeira sessão" #. Tag: para -#: session_api.xml:573 +#: session_api.xml:559 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "o objeto é passado para a camada UI" #. Tag: para -#: session_api.xml:577 +#: session_api.xml:563 #, no-c-format msgid "some modifications are made to the object" msgstr "algumas modificações são feitas ao objeto" #. Tag: para -#: session_api.xml:581 +#: session_api.xml:567 #, no-c-format msgid "the object is passed back down to the business logic tier" msgstr "o objeto é retornado à camada lógica de negócios" #. Tag: para -#: session_api.xml:585 +#: session_api.xml:571 #, no-c-format msgid "" "the application persists these modifications by calling <literal>update()</" @@ -1610,19 +1582,19 @@ "literal> em uma segunda sessão." #. Tag: para -#: session_api.xml:590 +#: session_api.xml:576 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "<literal>saveOrUpdate()</literal> faz o seguinte:" #. Tag: para -#: session_api.xml:594 +#: session_api.xml:580 #, no-c-format msgid "if the object is already persistent in this session, do nothing" msgstr "se o objeto já estiver persistente nesta sessão, não faça nada" #. Tag: para -#: session_api.xml:599 +#: session_api.xml:585 #, no-c-format msgid "" "if another object associated with the session has the same identifier, throw " @@ -1632,7 +1604,7 @@ "uma exceção" #. Tag: para -#: session_api.xml:604 +#: session_api.xml:590 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" @@ -1640,7 +1612,7 @@ "literal> " #. Tag: para -#: session_api.xml:609 +#: session_api.xml:595 #, no-c-format msgid "" "if the object's identifier has the value assigned to a newly instantiated " @@ -1650,7 +1622,7 @@ "recentemente instanciado, <literal>salve-o()</literal> " #. Tag: para -#: session_api.xml:614 +#: session_api.xml:600 #, no-c-format msgid "" "if the object is versioned by a <literal>&lt;version&gt;</literal> or " @@ -1664,19 +1636,19 @@ "</literal> o mesmo" #. Tag: para -#: session_api.xml:622 +#: session_api.xml:608 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "do contrário <literal>atualize()</literal> o objeto" #. Tag: para -#: session_api.xml:626 +#: session_api.xml:612 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "e a <literal>mesclagem()</literal> é bastante diferente:" #. Tag: para -#: session_api.xml:630 +#: session_api.xml:616 #, no-c-format msgid "" "if there is a persistent instance with the same identifier currently " @@ -1688,7 +1660,7 @@ "persistente." #. Tag: para -#: session_api.xml:636 +#: session_api.xml:622 #, no-c-format msgid "" "if there is no persistent instance currently associated with the session, " @@ -1699,13 +1671,13 @@ "persistente" #. Tag: para -#: session_api.xml:642 +#: session_api.xml:628 #, no-c-format msgid "the persistent instance is returned" msgstr "a instância persistente é retornada" #. Tag: para -#: session_api.xml:646 +#: session_api.xml:632 #, no-c-format msgid "" "the given instance does not become associated with the session, it remains " @@ -1715,13 +1687,13 @@ "desanexada" #. Tag: title -#: session_api.xml:653 +#: session_api.xml:639 #, no-c-format msgid "Deleting persistent objects" msgstr "Apagando objetos persistentes" #. Tag: para -#: session_api.xml:655 +#: session_api.xml:641 #, no-c-format msgid "" "<literal>Session.delete()</literal> will remove an object's state from the " @@ -1735,13 +1707,13 @@ "uma instância persistente se tornar transiente. " #. Tag: programlisting -#: session_api.xml:660 +#: session_api.xml:646 #, no-c-format msgid "sess.delete(cat);" msgstr "" #. Tag: para -#: session_api.xml:662 +#: session_api.xml:648 #, no-c-format msgid "" "You can delete objects in any order, without risk of foreign key constraint " @@ -1756,13 +1728,13 @@ "filho. " #. Tag: title -#: session_api.xml:670 +#: session_api.xml:656 #, no-c-format msgid "Replicating object between two different datastores" msgstr "Replicando objeto entre dois armazenamentos de dados diferentes." #. Tag: para -#: session_api.xml:672 +#: session_api.xml:658 #, no-c-format msgid "" "It is sometimes useful to be able to take a graph of persistent instances " @@ -1774,7 +1746,7 @@ "novamente valores de identificador. " #. Tag: programlisting -#: session_api.xml:676 +#: session_api.xml:662 #, no-c-format msgid "" "//retrieve a cat from one database\n" @@ -1793,7 +1765,7 @@ msgstr "" #. Tag: para -#: session_api.xml:678 +#: session_api.xml:664 #, no-c-format msgid "" "The <literal>ReplicationMode</literal> determines how <literal>replicate()</" @@ -1803,7 +1775,7 @@ "literal> irá lidar com conflitos em linhas existentes no banco de dados: " #. Tag: para -#: session_api.xml:684 +#: session_api.xml:670 #, no-c-format msgid "" "<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is " @@ -1813,7 +1785,7 @@ "linha de banco de dados existente com o mesmo identificador." #. Tag: para -#: session_api.xml:689 +#: session_api.xml:675 #, no-c-format msgid "" "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing " @@ -1823,7 +1795,7 @@ "de dados existente com um mesmo identificador." #. Tag: para -#: session_api.xml:694 +#: session_api.xml:680 #, no-c-format msgid "" "<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there " @@ -1833,7 +1805,7 @@ "uma linha de banco de dados existente com o mesmo identificador. " #. Tag: para -#: session_api.xml:700 +#: session_api.xml:686 #, no-c-format msgid "" "<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its " @@ -1845,7 +1817,7 @@ "ignore o objeto." #. Tag: para -#: session_api.xml:706 +#: session_api.xml:692 #, no-c-format msgid "" "Usecases for this feature include reconciling data entered into different " @@ -1859,13 +1831,13 @@ "durante transações não ACID entre outras funções." #. Tag: title -#: session_api.xml:713 +#: session_api.xml:699 #, no-c-format msgid "Flushing the Session" msgstr "Limpando a Sessão" #. Tag: para -#: session_api.xml:715 +#: session_api.xml:701 #, no-c-format msgid "" "Sometimes the <literal>Session</literal> will execute the SQL statements " @@ -1879,31 +1851,31 @@ "ocorre por padrão nos seguintes pontos: " #. Tag: para -#: session_api.xml:723 +#: session_api.xml:709 #, no-c-format msgid "before some query executions" msgstr "antes de algumas execuções de consultas" #. Tag: para -#: session_api.xml:727 +#: session_api.xml:713 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "a partir de<literal>org.hibernate.Transaction.commit()</literal>" #. Tag: para -#: session_api.xml:732 +#: session_api.xml:718 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "a partir de <literal>Session.flush()</literal>" #. Tag: para -#: session_api.xml:736 +#: session_api.xml:722 #, no-c-format msgid "The SQL statements are issued in the following order:" msgstr "As instruções SQL são editadas na seguinte ordem:" #. Tag: para -#: session_api.xml:740 +#: session_api.xml:726 #, no-c-format msgid "" "all entity insertions in the same order the corresponding objects were saved " @@ -1913,31 +1885,31 @@ "correspondentes foram salvos usando <literal>Session.save()</literal> " #. Tag: para -#: session_api.xml:745 +#: session_api.xml:731 #, no-c-format msgid "all entity updates" msgstr "todas as atualizações de entidades" #. Tag: para -#: session_api.xml:749 +#: session_api.xml:735 #, no-c-format msgid "all collection deletions" msgstr "todas as deleções de coleções" #. Tag: para -#: session_api.xml:753 +#: session_api.xml:739 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "todas as deleções, atualizações e inserções de elementos de coleção." #. Tag: para -#: session_api.xml:757 +#: session_api.xml:743 #, no-c-format msgid "all collection insertions" msgstr "todas as inserções de coleção" #. Tag: para -#: session_api.xml:761 +#: session_api.xml:747 #, no-c-format msgid "" "all entity deletions in the same order the corresponding objects were " @@ -1947,7 +1919,7 @@ "foram deletados usando <literal>Session.delete()</literal> " #. Tag: para -#: session_api.xml:766 +#: session_api.xml:752 #, no-c-format msgid "" "An exception is that objects using <literal>native</literal> ID generation " @@ -1957,7 +1929,7 @@ "literal> é inserido quando salvo." #. Tag: para -#: session_api.xml:769 +#: session_api.xml:755 #, no-c-format msgid "" "Except when you explicitly <literal>flush()</literal>, there are absolutely " @@ -1974,7 +1946,7 @@ "retornará dados errados. " #. Tag: para -#: session_api.xml:776 +#: session_api.xml:762 #, fuzzy, no-c-format msgid "" "It is possible to change the default behavior so that flush occurs less " @@ -1997,7 +1969,7 @@ "optimistic-longsession\"/>). " #. Tag: programlisting -#: session_api.xml:786 +#: session_api.xml:772 #, no-c-format msgid "" "sess = sf.openSession();\n" @@ -2017,7 +1989,7 @@ msgstr "" #. Tag: para -#: session_api.xml:788 +#: session_api.xml:774 #, fuzzy, no-c-format msgid "" "During flush, an exception might occur (e.g. if a DML operation violates a " @@ -2031,13 +2003,13 @@ "isso em <xref linkend=\"transactions\" />." #. Tag: title -#: session_api.xml:795 +#: session_api.xml:781 #, no-c-format msgid "Transitive persistence" msgstr "Persistência Transitiva" #. Tag: para -#: session_api.xml:797 +#: session_api.xml:783 #, no-c-format msgid "" "It is quite cumbersome to save, delete, or reattach individual objects, " @@ -2049,7 +2021,7 @@ "um relacionamento pai/filho. Considere o seguinte exemplo: " #. Tag: para -#: session_api.xml:802 +#: session_api.xml:788 #, no-c-format msgid "" "If the children in a parent/child relationship would be value typed (e.g. a " @@ -2071,7 +2043,7 @@ "deletar o filho do banco de dados. " #. Tag: para -#: session_api.xml:812 +#: session_api.xml:798 #, no-c-format msgid "" "Now consider the same scenario with parent and child objects being entities, " @@ -2091,7 +2063,7 @@ "<emphasis>persistência por alcance</emphasis> por padrão. " #. Tag: para -#: session_api.xml:820 +#: session_api.xml:806 #, no-c-format msgid "" "For each basic operation of the Hibernate session - including " @@ -2111,25 +2083,25 @@ "indicar isto no documento de mapeamento. Por exemplo:" #. Tag: programlisting -#: session_api.xml:828 +#: session_api.xml:814 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:830 +#: session_api.xml:816 #, no-c-format msgid "Cascade styles my be combined:" msgstr "Estilo cascata pode ser combinado:" #. Tag: programlisting -#: session_api.xml:832 +#: session_api.xml:818 #, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" msgstr "" #. Tag: para -#: session_api.xml:834 +#: session_api.xml:820 #, no-c-format msgid "" "You can even use <literal>cascade=\"all\"</literal> to specify that " @@ -2143,7 +2115,7 @@ "nenhuma operação deve estar em cascata. " #. Tag: para -#: session_api.xml:839 +#: session_api.xml:825 #, no-c-format msgid "" "In case you are using annotatons you probably have noticed the " @@ -2154,7 +2126,7 @@ msgstr "" #. Tag: para -#: session_api.xml:848 +#: session_api.xml:834 #, no-c-format msgid "" "<literal>CascadeType.PERSIST</literal>: cascades the persist (create) " @@ -2163,7 +2135,7 @@ msgstr "" #. Tag: para -#: session_api.xml:854 +#: session_api.xml:840 #, no-c-format msgid "" "<literal>CascadeType.MERGE</literal>: cascades the merge operation to " @@ -2171,7 +2143,7 @@ msgstr "" #. Tag: para -#: session_api.xml:860 +#: session_api.xml:846 #, no-c-format msgid "" "<literal>CascadeType.REMOVE</literal>: cascades the remove operation to " @@ -2179,7 +2151,7 @@ msgstr "" #. Tag: para -#: session_api.xml:865 +#: session_api.xml:851 #, no-c-format msgid "" "<literal>CascadeType.REFRESH:</literal> cascades the refresh operation to " @@ -2187,7 +2159,7 @@ msgstr "" #. Tag: para -#: session_api.xml:870 +#: session_api.xml:856 #, no-c-format msgid "" "<literal>CascadeType.DETACH:</literal> cascades the detach operation to " @@ -2195,13 +2167,13 @@ msgstr "" #. Tag: para -#: session_api.xml:875 +#: session_api.xml:861 #, fuzzy, no-c-format msgid "<literal>CascadeType.ALL</literal>: all of the above" msgstr "<literal>saveOrUpdate()</literal> faz o seguinte:" #. Tag: para -#: session_api.xml:880 +#: session_api.xml:866 #, no-c-format msgid "" "CascadeType.ALL also covers Hibernate specific operations like save-update, " @@ -2209,7 +2181,7 @@ msgstr "" #. Tag: para -#: session_api.xml:884 +#: session_api.xml:870 #, no-c-format msgid "" "A special cascade style, <literal>delete-orphan</literal>, applies only to " @@ -2226,13 +2198,13 @@ msgstr "" #. Tag: title -#: session_api.xml:897 +#: session_api.xml:883 #, no-c-format msgid "<literal>@OneToMany</literal> with <literal>orphanRemoval</literal>" msgstr "" #. Tag: programlisting -#: session_api.xml:900 +#: session_api.xml:886 #, no-c-format msgid "" "@Entity \n" @@ -2256,13 +2228,13 @@ msgstr "" #. Tag: para -#: session_api.xml:903 +#: session_api.xml:889 #, no-c-format msgid "Recommendations:" msgstr "Recomendações:" #. Tag: para -#: session_api.xml:907 +#: session_api.xml:893 #, fuzzy, no-c-format msgid "" "It does not usually make sense to enable cascade on a many-to-one or many-to-" @@ -2277,7 +2249,7 @@ "<literal>&lt;one-to-many&gt;</literal>." #. Tag: para -#: session_api.xml:915 +#: session_api.xml:901 #, fuzzy, no-c-format msgid "" "If the child object's lifespan is bounded by the lifespan of the parent " @@ -2290,7 +2262,7 @@ "especificando um <literal>cascade=\"all,delete-orphan\"</literal>." #. Tag: para -#: session_api.xml:923 +#: session_api.xml:909 #, no-c-format msgid "" "Otherwise, you might not need cascade at all. But if you think that you will " @@ -2304,7 +2276,7 @@ "\"persistir,mesclar,salvar-atualizar\"</literal>." #. Tag: para -#: session_api.xml:931 +#: session_api.xml:917 #, no-c-format msgid "" "Mapping an association (either a single valued association, or a collection) " @@ -2319,7 +2291,7 @@ "filho(s)." #. Tag: para -#: session_api.xml:937 +#: session_api.xml:923 #, fuzzy, no-c-format msgid "" "Furthermore, a mere reference to a child from a persistent parent will " @@ -2339,7 +2311,7 @@ "pai/filho, são como as que se seguem: " #. Tag: para -#: session_api.xml:948 +#: session_api.xml:934 #, no-c-format msgid "" "If a parent is passed to <literal>persist()</literal>, all children are " @@ -2349,7 +2321,7 @@ "passados para <literal>persist()</literal>" #. Tag: para -#: session_api.xml:953 +#: session_api.xml:939 #, no-c-format msgid "" "If a parent is passed to <literal>merge()</literal>, all children are passed " @@ -2359,7 +2331,7 @@ "passados para <literal>merge()</literal>" #. Tag: para -#: session_api.xml:958 +#: session_api.xml:944 #, no-c-format msgid "" "If a parent is passed to <literal>save()</literal>, <literal>update()</" @@ -2371,7 +2343,7 @@ "<literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:964 +#: session_api.xml:950 #, no-c-format msgid "" "If a transient or detached child becomes referenced by a persistent parent, " @@ -2381,7 +2353,7 @@ "persistente, ele será passado para <literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:970 +#: session_api.xml:956 #, no-c-format msgid "" "If a parent is deleted, all children are passed to <literal>delete()</" @@ -2391,7 +2363,7 @@ "</literal>" #. Tag: para -#: session_api.xml:975 +#: session_api.xml:961 #, no-c-format msgid "" "If a child is dereferenced by a persistent parent, <emphasis>nothing special " @@ -2405,7 +2377,7 @@ "literal>, nos quais casos o filho \"órfão\" é deletado." #. Tag: para -#: session_api.xml:983 +#: session_api.xml:969 #, no-c-format msgid "" "Finally, note that cascading of operations can be applied to an object graph " @@ -2424,13 +2396,13 @@ "associadas atingíveis durante a limpeza da <literal>Sessão</literal>. " #. Tag: title -#: session_api.xml:993 +#: session_api.xml:979 #, no-c-format msgid "Using metadata" msgstr "Usando metadados" #. Tag: para -#: session_api.xml:995 +#: session_api.xml:981 #, no-c-format msgid "" "Hibernate requires a rich meta-level model of all entity and value types. " @@ -2449,7 +2421,7 @@ "associadas). " #. Tag: para -#: session_api.xml:1002 +#: session_api.xml:988 #, no-c-format msgid "" "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " @@ -2463,7 +2435,7 @@ "obtidas a partir do <literal>SessionFactory</literal>. " #. Tag: programlisting -#: session_api.xml:1007 +#: session_api.xml:993 #, no-c-format msgid "" "Cat fritz = ......;\n" @@ -2483,7 +2455,34 @@ "}" msgstr "" +#, fuzzy #~ 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 "" +#~ "Note que o Hibernate não oferece seu próprio API para execução direta de " +#~ "instruções <literal>UPDATE</literal> ou <literal>DELETE</literal>. O " +#~ "Hibernate é um serviço de <emphasis>gerenciamento de estado</emphasis> " +#~ "que você nem precisa se preocupar com <emphasis>instruções</emphasis> " +#~ "para utilizá-lo. O JDBC é um API perfeito para executar instruções SQL, " +#~ "você pode ter uma <literal>Connection</literal> JDBC a qualquer momento, " +#~ "chamando <literal>session.connection()</literal>. Além disso, a noção de " +#~ "operações em massa conflitua com o mapeamento de objeto/relacional para " +#~ "aplicativos de transações online com processamento. No entanto, versões " +#~ "futuras do Hibernate poderão oferecer funções especiais de operação em " +#~ "massa. Veja <xref linkend=\"batch\" /> para alguns possíveis truques de " +#~ "operação em lote. " + +#~ 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 " Modified: core/trunk/documentation/manual/src/main/docbook/zh-CN/content/session_api.po =================================================================== --- core/trunk/documentation/manual/src/main/docbook/zh-CN/content/session_api.po 2010-07-21 05:39:40 UTC (rev 19988) +++ core/trunk/documentation/manual/src/main/docbook/zh-CN/content/session_api.po 2010-07-21 05:44:34 UTC (rev 19989) @@ -6,7 +6,7 @@ msgstr "" "Project-Id-Version: session_api\n" "Report-Msgid-Bugs-To: http://bugs.kde.org\n" -"POT-Creation-Date: 2010-07-20 21:02+0000\n" +"POT-Creation-Date: 2010-07-21 05:43+0000\n" "PO-Revision-Date: 2010-03-16 09:58+1000\n" "Last-Translator: Xi HUANG <xhuang(a)redhat.com&gt;\n&quot; "Language-Team: <en(a)li.org&gt;\n&quot; @@ -1360,39 +1360,14 @@ "literal> 语句（持久化更新的状态）。为此 Hibernate 提供了另一种途径，使用脱管" "（detached）实例。 " -#. Tag: para -#: session_api.xml:481 -#, 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 "" -"请注意 Hibernate 本身不提供直接执行 <literal>UPDATE</literal> 或 " -"<literal>DELETE</literal> 语句的 API。Hibernate 提供的是 <emphasis>state " -"management</emphasis> 服务，你不必考虑要使用的 <emphasis>statements</" -"emphasis>。JDBC 是出色的执行 SQL 语句的 API，任何时候调用 <literal>session." -"connection()</literal> 你都可以得到一个 <literal>Connection</literal> 对象。 " -"此外，在联机事务处理（OLTP）程序中，大量操作（mass operations）与对象/关系映" -"射的观点是相冲突的。Hibernate 的将来版本可能会提供专门的进行大量操作（mass " -"operation）的功能。参考 <xref linkend=\"batch\"/>，寻找一些可用的批量" -"（batch）操作技巧。" - #. Tag: title -#: session_api.xml:497 +#: session_api.xml:483 #, no-c-format msgid "Modifying detached objects" msgstr "修改脱管（Detached）对象" #. Tag: para -#: session_api.xml:499 +#: session_api.xml:485 #, no-c-format msgid "" "Many applications need to retrieve an object in one transaction, send it to " @@ -1406,7 +1381,7 @@ "的数据来保证这些“长“工作单元之间的隔离。" #. Tag: para -#: session_api.xml:505 +#: session_api.xml:491 #, no-c-format msgid "" "Hibernate supports this model by providing for reattachment of detached " @@ -1417,7 +1392,7 @@ "merge()</literal> 重新关联脱管实例的办法来支持这种模型。" #. Tag: programlisting -#: session_api.xml:509 +#: session_api.xml:495 #, fuzzy, no-c-format msgid "" "// in the first session\n" @@ -1445,7 +1420,7 @@ "secondSession.update(mate); // update mate]]>" #. Tag: para -#: session_api.xml:511 +#: session_api.xml:497 #, no-c-format msgid "" "If the <literal>Cat</literal> with identifier <literal>catId</literal> had " @@ -1457,7 +1432,7 @@ "联操作（reattach）的时候会抛出一个异常。" #. Tag: para -#: session_api.xml:516 +#: session_api.xml:502 #, no-c-format msgid "" "Use <literal>update()</literal> if you are certain that the session does not " @@ -1475,7 +1450,7 @@ "象的操作首先被执行。 " #. Tag: para -#: session_api.xml:524 +#: session_api.xml:510 #, fuzzy, no-c-format msgid "" "The application should individually <literal>update()</literal> detached " @@ -1491,7 +1466,7 @@ "\"objectstate-transitive\"/>。" #. Tag: para -#: session_api.xml:530 +#: session_api.xml:516 #, no-c-format msgid "" "The <literal>lock()</literal> method also allows an application to " @@ -1502,7 +1477,7 @@ "不过，该脱管（detached）的对象必须是没有修改过的。" #. Tag: programlisting -#: session_api.xml:534 +#: session_api.xml:520 #, fuzzy, no-c-format msgid "" "//just reassociate:\n" @@ -1520,7 +1495,7 @@ "sess.lock(pk, LockMode.UPGRADE);]]>" #. Tag: para -#: session_api.xml:536 +#: session_api.xml:522 #, no-c-format msgid "" "Note that <literal>lock()</literal> can be used with various " @@ -1533,7 +1508,7 @@ "联不是 <literal>lock()</literal> 的唯一用途。 " #. Tag: para -#: session_api.xml:541 +#: session_api.xml:527 #, fuzzy, no-c-format msgid "" "Other models for long units of work are discussed in <xref linkend=" @@ -1543,13 +1518,13 @@ "中讨论。" #. Tag: title -#: session_api.xml:546 +#: session_api.xml:532 #, no-c-format msgid "Automatic state detection" msgstr "自动状态检测" #. Tag: para -#: session_api.xml:548 +#: session_api.xml:534 #, no-c-format msgid "" "Hibernate users have requested a general purpose method that either saves a " @@ -1562,7 +1537,7 @@ "<literal>saveOrUpdate()</literal> 方法实现了这个功能。" #. Tag: programlisting -#: session_api.xml:554 +#: session_api.xml:540 #, fuzzy, no-c-format msgid "" "// in the first session\n" @@ -1592,7 +1567,7 @@ "id)]]>" #. Tag: para -#: session_api.xml:556 +#: session_api.xml:542 #, no-c-format msgid "" "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " @@ -1608,7 +1583,7 @@ "<literal>merge()</literal>。有些程序从来不用这些方法。" #. Tag: para -#: session_api.xml:563 +#: session_api.xml:549 #, no-c-format msgid "" "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " @@ -1618,31 +1593,31 @@ "literal>：" #. Tag: para -#: session_api.xml:569 +#: session_api.xml:555 #, no-c-format msgid "the application loads an object in the first session" msgstr "程序在第一个 session 中加载对象" #. Tag: para -#: session_api.xml:573 +#: session_api.xml:559 #, no-c-format msgid "the object is passed up to the UI tier" msgstr "该对象被传递到表现层" #. Tag: para -#: session_api.xml:577 +#: session_api.xml:563 #, no-c-format msgid "some modifications are made to the object" msgstr "对象发生了一些改动" #. Tag: para -#: session_api.xml:581 +#: session_api.xml:567 #, no-c-format msgid "the object is passed back down to the business logic tier" msgstr "该对象被返回到业务逻辑层" #. Tag: para -#: session_api.xml:585 +#: session_api.xml:571 #, no-c-format msgid "" "the application persists these modifications by calling <literal>update()</" @@ -1650,19 +1625,19 @@ msgstr "程序调用第二个 session 的 <literal>update()</literal> 方法持久这些改动" #. Tag: para -#: session_api.xml:590 +#: session_api.xml:576 #, no-c-format msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "<literal>saveOrUpdate()</literal> 做下面的事：" #. Tag: para -#: session_api.xml:594 +#: session_api.xml:580 #, no-c-format msgid "if the object is already persistent in this session, do nothing" msgstr "如果对象已经在本 session 中持久化了，不做任何事" #. Tag: para -#: session_api.xml:599 +#: session_api.xml:585 #, no-c-format msgid "" "if another object associated with the session has the same identifier, throw " @@ -1672,14 +1647,14 @@ "异常" #. Tag: para -#: session_api.xml:604 +#: session_api.xml:590 #, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" msgstr "" "如果对象没有持久化标识（identifier）属性，对其调用 <literal>save()</literal>" #. Tag: para -#: session_api.xml:609 +#: session_api.xml:595 #, no-c-format msgid "" "if the object's identifier has the value assigned to a newly instantiated " @@ -1689,7 +1664,7 @@ "<literal>save()</literal>。" #. Tag: para -#: session_api.xml:614 +#: session_api.xml:600 #, no-c-format msgid "" "if the object is versioned by a <literal>&lt;version&gt;</literal> or " @@ -1702,19 +1677,19 @@ "对象，<literal>save()</literal> 它。 " #. Tag: para -#: session_api.xml:622 +#: session_api.xml:608 #, no-c-format msgid "otherwise <literal>update()</literal> the object" msgstr "否则 <literal>update()</literal> 这个对象" #. Tag: para -#: session_api.xml:626 +#: session_api.xml:612 #, no-c-format msgid "and <literal>merge()</literal> is very different:" msgstr "<literal>merge()</literal> 可非常不同：" #. Tag: para -#: session_api.xml:630 +#: session_api.xml:616 #, no-c-format msgid "" "if there is a persistent instance with the same identifier currently " @@ -1725,7 +1700,7 @@ "覆盖旧有的持久实例" #. Tag: para -#: session_api.xml:636 +#: session_api.xml:622 #, no-c-format msgid "" "if there is no persistent instance currently associated with the session, " @@ -1734,13 +1709,13 @@ "如果 session 没有相应的持久实例，则尝试从数据库中加载，或创建新的持久化实例" #. Tag: para -#: session_api.xml:642 +#: session_api.xml:628 #, no-c-format msgid "the persistent instance is returned" msgstr "最后返回该持久实例" #. Tag: para -#: session_api.xml:646 +#: session_api.xml:632 #, no-c-format msgid "" "the given instance does not become associated with the session, it remains " @@ -1748,13 +1723,13 @@ msgstr "用户给出的这个对象没有被关联到 session 上，它依旧是脱管的" #. Tag: title -#: session_api.xml:653 +#: session_api.xml:639 #, no-c-format msgid "Deleting persistent objects" msgstr "删除持久对象" #. Tag: para -#: session_api.xml:655 +#: session_api.xml:641 #, no-c-format msgid "" "<literal>Session.delete()</literal> will remove an object's state from the " @@ -1768,13 +1743,13 @@ "例。 " #. Tag: programlisting -#: session_api.xml:660 +#: session_api.xml:646 #, fuzzy, no-c-format msgid "sess.delete(cat);" msgstr "<![CDATA[sess.delete(cat);]]>" #. Tag: para -#: session_api.xml:662 +#: session_api.xml:648 #, no-c-format msgid "" "You can delete objects in any order, without risk of foreign key constraint " @@ -1787,13 +1762,13 @@ "你删除了父对象，但是忘记删除其子对象。" #. Tag: title -#: session_api.xml:670 +#: session_api.xml:656 #, no-c-format msgid "Replicating object between two different datastores" msgstr "在两个不同数据库间复制对象" #. Tag: para -#: session_api.xml:672 +#: session_api.xml:658 #, no-c-format msgid "" "It is sometimes useful to be able to take a graph of persistent instances " @@ -1804,7 +1779,7 @@ "到不同的数据库中的操作。 " #. Tag: programlisting -#: session_api.xml:676 +#: session_api.xml:662 #, fuzzy, no-c-format msgid "" "//retrieve a cat from one database\n" @@ -1836,7 +1811,7 @@ "session2.close();]]>" #. Tag: para -#: session_api.xml:678 +#: session_api.xml:664 #, no-c-format msgid "" "The <literal>ReplicationMode</literal> determines how <literal>replicate()</" @@ -1846,7 +1821,7 @@ "<literal>replicate()</literal> 如何处理。 " #. Tag: para -#: session_api.xml:684 +#: session_api.xml:670 #, no-c-format msgid "" "<literal>ReplicationMode.IGNORE</literal>: ignores the object when there is " @@ -1856,7 +1831,7 @@ "时忽略它" #. Tag: para -#: session_api.xml:689 +#: session_api.xml:675 #, no-c-format msgid "" "<literal>ReplicationMode.OVERWRITE</literal>: overwrites any existing " @@ -1866,7 +1841,7 @@ "录" #. Tag: para -#: session_api.xml:694 +#: session_api.xml:680 #, no-c-format msgid "" "<literal>ReplicationMode.EXCEPTION</literal>: throws an exception if there " @@ -1876,7 +1851,7 @@ "识符时抛出异常" #. Tag: para -#: session_api.xml:700 +#: session_api.xml:686 #, no-c-format msgid "" "<literal>ReplicationMode.LATEST_VERSION</literal>: overwrites the row if its " @@ -1887,7 +1862,7 @@ "盖，否则忽略" #. Tag: para -#: session_api.xml:706 +#: session_api.xml:692 #, no-c-format msgid "" "Usecases for this feature include reconciling data entered into different " @@ -1900,13 +1875,13 @@ "Consistent，Isolated and Durable 的缩写）" #. Tag: title -#: session_api.xml:713 +#: session_api.xml:699 #, no-c-format msgid "Flushing the Session" msgstr "Session 刷出（flush）" #. Tag: para -#: session_api.xml:715 +#: session_api.xml:701 #, no-c-format msgid "" "Sometimes the <literal>Session</literal> will execute the SQL statements " @@ -1919,31 +1894,31 @@ "emphasis>，默认会在下面的时间点执行： " #. Tag: para -#: session_api.xml:723 +#: session_api.xml:709 #, no-c-format msgid "before some query executions" msgstr "在某些查询执行之前" #. Tag: para -#: session_api.xml:727 +#: session_api.xml:713 #, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" msgstr "在调用 <literal>org.hibernate.Transaction.commit()</literal> 的时候" #. Tag: para -#: session_api.xml:732 +#: session_api.xml:718 #, no-c-format msgid "from <literal>Session.flush()</literal>" msgstr "在调用 <literal>Session.flush()</literal> 的时候" #. Tag: para -#: session_api.xml:736 +#: session_api.xml:722 #, no-c-format msgid "The SQL statements are issued in the following order:" msgstr "涉及的 SQL 语句会按照下面的顺序发出执行： " #. Tag: para -#: session_api.xml:740 +#: session_api.xml:726 #, no-c-format msgid "" "all entity insertions in the same order the corresponding objects were saved " @@ -1953,31 +1928,31 @@ "literal> 的时间顺序 " #. Tag: para -#: session_api.xml:745 +#: session_api.xml:731 #, no-c-format msgid "all entity updates" msgstr "所有对实体进行更新的语句" #. Tag: para -#: session_api.xml:749 +#: session_api.xml:735 #, no-c-format msgid "all collection deletions" msgstr "所有进行集合删除的语句" #. Tag: para -#: session_api.xml:753 +#: session_api.xml:739 #, no-c-format msgid "all collection element deletions, updates and insertions" msgstr "所有对集合元素进行删除，更新或者插入的语句" #. Tag: para -#: session_api.xml:757 +#: session_api.xml:743 #, no-c-format msgid "all collection insertions" msgstr "所有进行集合插入的语句" #. Tag: para -#: session_api.xml:761 +#: session_api.xml:747 #, no-c-format msgid "" "all entity deletions in the same order the corresponding objects were " @@ -1987,7 +1962,7 @@ "literal> 的时间顺序 " #. Tag: para -#: session_api.xml:766 +#: session_api.xml:752 #, no-c-format msgid "" "An exception is that objects using <literal>native</literal> ID generation " @@ -1997,7 +1972,7 @@ "识）的话，它们一执行 save 就会被插入。" #. Tag: para -#: session_api.xml:769 +#: session_api.xml:755 #, no-c-format msgid "" "Except when you explicitly <literal>flush()</literal>, there are absolutely " @@ -2012,7 +1987,7 @@ "失效的数据，也不会返回错误数据。 " #. Tag: para -#: session_api.xml:776 +#: session_api.xml:762 #, fuzzy, no-c-format msgid "" "It is possible to change the default behavior so that flush occurs less " @@ -2033,7 +2008,7 @@ "longsession\"/>）。" #. Tag: programlisting -#: session_api.xml:786 +#: session_api.xml:772 #, fuzzy, no-c-format msgid "" "sess = sf.openSession();\n" @@ -2067,7 +2042,7 @@ "sess.close();]]>" #. Tag: para -#: session_api.xml:788 +#: session_api.xml:774 #, fuzzy, no-c-format msgid "" "During flush, an exception might occur (e.g. if a DML operation violates a " @@ -2080,13 +2055,13 @@ "\"/> 中讨论。 " #. Tag: title -#: session_api.xml:795 +#: session_api.xml:781 #, no-c-format msgid "Transitive persistence" msgstr "传播性持久化（transitive persistence）" #. Tag: para -#: session_api.xml:797 +#: session_api.xml:783 #, no-c-format msgid "" "It is quite cumbersome to save, delete, or reattach individual objects, " @@ -2097,7 +2072,7 @@ "彼此关联的对象的时候。一个常见的例子是父子关系。考虑下面的例子：" #. Tag: para -#: session_api.xml:802 +#: session_api.xml:788 #, no-c-format msgid "" "If the children in a parent/child relationship would be value typed (e.g. a " @@ -2117,7 +2092,7 @@ "所以 Hibernate 会在数据库中删除这个子对象。 " #. Tag: para -#: session_api.xml:812 +#: session_api.xml:798 #, no-c-format msgid "" "Now consider the same scenario with parent and child objects being entities, " @@ -2135,7 +2110,7 @@ "久化（persistence by reachability）</emphasis>的策略。 " #. Tag: para -#: session_api.xml:820 +#: session_api.xml:806 #, no-c-format msgid "" "For each basic operation of the Hibernate session - including " @@ -2154,26 +2129,26 @@ "件中指出这一点。例如：" #. Tag: programlisting -#: session_api.xml:828 +#: session_api.xml:814 #, fuzzy, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist\"/&gt;" msgstr "<![CDATA[<one-to-one name=\"person\" cascade=\"persist\"/>]]>" #. Tag: para -#: session_api.xml:830 +#: session_api.xml:816 #, no-c-format msgid "Cascade styles my be combined:" msgstr "级联风格（cascade style）是可组合的：" #. Tag: programlisting -#: session_api.xml:832 +#: session_api.xml:818 #, fuzzy, no-c-format msgid "&lt;one-to-one name=\"person\" cascade=\"persist,delete,lock\"/&gt;" msgstr "" "<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" #. Tag: para -#: session_api.xml:834 +#: session_api.xml:820 #, no-c-format msgid "" "You can even use <literal>cascade=\"all\"</literal> to specify that " @@ -2186,7 +2161,7 @@ "literal>，即任何操作都不会被级联（cascaded）。 " #. Tag: para -#: session_api.xml:839 +#: session_api.xml:825 #, no-c-format msgid "" "In case you are using annotatons you probably have noticed the " @@ -2197,7 +2172,7 @@ msgstr "" #. Tag: para -#: session_api.xml:848 +#: session_api.xml:834 #, no-c-format msgid "" "<literal>CascadeType.PERSIST</literal>: cascades the persist (create) " @@ -2206,7 +2181,7 @@ msgstr "" #. Tag: para -#: session_api.xml:854 +#: session_api.xml:840 #, no-c-format msgid "" "<literal>CascadeType.MERGE</literal>: cascades the merge operation to " @@ -2214,7 +2189,7 @@ msgstr "" #. Tag: para -#: session_api.xml:860 +#: session_api.xml:846 #, no-c-format msgid "" "<literal>CascadeType.REMOVE</literal>: cascades the remove operation to " @@ -2222,7 +2197,7 @@ msgstr "" #. Tag: para -#: session_api.xml:865 +#: session_api.xml:851 #, no-c-format msgid "" "<literal>CascadeType.REFRESH:</literal> cascades the refresh operation to " @@ -2230,7 +2205,7 @@ msgstr "" #. Tag: para -#: session_api.xml:870 +#: session_api.xml:856 #, no-c-format msgid "" "<literal>CascadeType.DETACH:</literal> cascades the detach operation to " @@ -2238,13 +2213,13 @@ msgstr "" #. Tag: para -#: session_api.xml:875 +#: session_api.xml:861 #, fuzzy, no-c-format msgid "<literal>CascadeType.ALL</literal>: all of the above" msgstr "<literal>saveOrUpdate()</literal> 做下面的事：" #. Tag: para -#: session_api.xml:880 +#: session_api.xml:866 #, no-c-format msgid "" "CascadeType.ALL also covers Hibernate specific operations like save-update, " @@ -2252,7 +2227,7 @@ msgstr "" #. Tag: para -#: session_api.xml:884 +#: session_api.xml:870 #, no-c-format msgid "" "A special cascade style, <literal>delete-orphan</literal>, applies only to " @@ -2269,13 +2244,13 @@ msgstr "" #. Tag: title -#: session_api.xml:897 +#: session_api.xml:883 #, no-c-format msgid "<literal>@OneToMany</literal> with <literal>orphanRemoval</literal>" msgstr "" #. Tag: programlisting -#: session_api.xml:900 +#: session_api.xml:886 #, no-c-format msgid "" "@Entity \n" @@ -2299,13 +2274,13 @@ msgstr "" #. Tag: para -#: session_api.xml:903 +#: session_api.xml:889 #, no-c-format msgid "Recommendations:" msgstr "建议：" #. Tag: para -#: session_api.xml:907 +#: session_api.xml:893 #, fuzzy, no-c-format msgid "" "It does not usually make sense to enable cascade on a many-to-one or many-to-" @@ -2320,7 +2295,7 @@ "literal> 关系中比较有用。 " #. Tag: para -#: session_api.xml:915 +#: session_api.xml:901 #, fuzzy, no-c-format msgid "" "If the child object's lifespan is bounded by the lifespan of the parent " @@ -2333,7 +2308,7 @@ "（lifecycle object）</emphasis>。 " #. Tag: para -#: session_api.xml:923 +#: session_api.xml:909 #, no-c-format msgid "" "Otherwise, you might not need cascade at all. But if you think that you will " @@ -2346,7 +2321,7 @@ "\"persist,merge,save-update\"</literal>。" #. Tag: para -#: session_api.xml:931 +#: session_api.xml:917 #, no-c-format msgid "" "Mapping an association (either a single valued association, or a collection) " @@ -2360,7 +2335,7 @@ "操作。" #. Tag: para -#: session_api.xml:937 +#: session_api.xml:923 #, fuzzy, no-c-format msgid "" "Furthermore, a mere reference to a child from a persistent parent will " @@ -2379,7 +2354,7 @@ "下： " #. Tag: para -#: session_api.xml:948 +#: session_api.xml:934 #, no-c-format msgid "" "If a parent is passed to <literal>persist()</literal>, all children are " @@ -2389,7 +2364,7 @@ "<literal>persist()</literal>" #. Tag: para -#: session_api.xml:953 +#: session_api.xml:939 #, no-c-format msgid "" "If a parent is passed to <literal>merge()</literal>, all children are passed " @@ -2399,7 +2374,7 @@ "()</literal>" #. Tag: para -#: session_api.xml:958 +#: session_api.xml:944 #, no-c-format msgid "" "If a parent is passed to <literal>save()</literal>, <literal>update()</" @@ -2411,7 +2386,7 @@ "()</literal>" #. Tag: para -#: session_api.xml:964 +#: session_api.xml:950 #, no-c-format msgid "" "If a transient or detached child becomes referenced by a persistent parent, " @@ -2421,7 +2396,7 @@ "子对象将会被 <literal>saveOrUpdate()</literal>" #. Tag: para -#: session_api.xml:970 +#: session_api.xml:956 #, no-c-format msgid "" "If a parent is deleted, all children are passed to <literal>delete()</" @@ -2429,7 +2404,7 @@ msgstr "如果父对象被删除，那么所有子对象也会被 <literal>delete()</literal>" #. Tag: para -#: session_api.xml:975 +#: session_api.xml:961 #, no-c-format msgid "" "If a child is dereferenced by a persistent parent, <emphasis>nothing special " @@ -2443,7 +2418,7 @@ "调用 delete() 删除子对象。" #. Tag: para -#: session_api.xml:983 +#: session_api.xml:969 #, no-c-format msgid "" "Finally, note that cascading of operations can be applied to an object graph " @@ -2460,13 +2435,13 @@ "flush 的时候才作用到所有可触及的被关联对象上的。 " #. Tag: title -#: session_api.xml:993 +#: session_api.xml:979 #, no-c-format msgid "Using metadata" msgstr "使用元数据" #. Tag: para -#: session_api.xml:995 +#: session_api.xml:981 #, no-c-format msgid "" "Hibernate requires a rich meta-level model of all entity and value types. " @@ -2483,7 +2458,7 @@ "某些被关联的实体）。 " #. Tag: para -#: session_api.xml:1002 +#: session_api.xml:988 #, no-c-format msgid "" "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " @@ -2497,7 +2472,7 @@ "例。 " #. Tag: programlisting -#: session_api.xml:1007 +#: session_api.xml:993 #, fuzzy, no-c-format msgid "" "Cat fritz = ......;\n" @@ -2532,7 +2507,31 @@ " }\n" "}]]>" +#, fuzzy #~ 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 "" +#~ "请注意 Hibernate 本身不提供直接执行 <literal>UPDATE</literal> 或 " +#~ "<literal>DELETE</literal> 语句的 API。Hibernate 提供的是 <emphasis>state " +#~ "management</emphasis> 服务，你不必考虑要使用的 <emphasis>statements</" +#~ "emphasis>。JDBC 是出色的执行 SQL 语句的 API，任何时候调用 " +#~ "<literal>session.connection()</literal> 你都可以得到一个 " +#~ "<literal>Connection</literal> 对象。 此外，在联机事务处理（OLTP）程序中，" +#~ "大量操作（mass operations）与对象/关系映射的观点是相冲突的。Hibernate 的将" +#~ "来版本可能会提供专门的进行大量操作（mass operation）的功能。参考 <xref " +#~ "linkend=\"batch\"/>，寻找一些可用的批量（batch）操作技巧。" + +#~ 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 "