[hibernate-commits] Hibernate SVN: r14114 - in core/trunk/documentation/manual/fr-FR/src/main/docbook: content and 1 other directory.

Author: steve.ebersole(a)jboss.com Date: 2007-10-19 00:36:47 -0400 (Fri, 19 Oct 2007) New Revision: 14114 Removed: core/trunk/documentation/manual/fr-FR/src/main/docbook/translators.xml Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/Hibernate_Reference.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/architecture.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/association_mapping.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/basic_mapping.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/batch.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/best_practices.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/collection_mapping.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/component_mapping.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/configuration.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/events.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_mappings.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_parentchild.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_weblog.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/filters.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/inheritance_mapping.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/performance.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/persistent_classes.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/preface.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_criteria.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_hql.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_sql.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/session_api.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/toolset_guide.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/transactions.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/tutorial.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/content/xml.xml core/trunk/documentation/manual/fr-FR/src/main/docbook/legal_notice.xml Log: prep for gettext conversion Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/Hibernate_Reference.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/Hibernate_Reference.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/Hibernate_Reference.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,4 +1,4 @@ -<?xml version='1.0' encoding="iso-8859-1"?> +<?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ <!ENTITY versionNumber "3.3.0.alpha1"> <!ENTITY copyrightYear "2004"> @@ -9,7 +9,7 @@ <bookinfo> <title>HIBERNATE - Persistance relationnelle en Java standard</title> - <subtitle>Documentation de r�f�rence d'Hibernate</subtitle> + <subtitle>Documentation de référence d'Hibernate</subtitle> <releaseinfo>&versionNumber;</releaseinfo> <productnumber>&versionNumber;</productnumber> <issuenum>1</issuenum> @@ -25,7 +25,6 @@ <year>&copyrightYear;</year> <holder>&copyrightHolder;</holder> </copyright> - <xi:include href="translators.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="legal_notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </bookinfo> @@ -33,13 +32,13 @@ <xi:include href="content/preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/architecture.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/architecture.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="content/persistent_classes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/persistent_classes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="content/basic_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="content/collection_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/architecture.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/architecture.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/architecture.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,28 +1,15 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- - ~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved. - ~ - ~ This copyrighted material is made available to anyone wishing to use, modify, - ~ copy, or redistribute it subject to the terms and conditions of the GNU - ~ Lesser General Public License, v. 2.1. This program is distributed in the - ~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied - ~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - ~ Lesser General Public License for more details. You should have received a - ~ copy of the GNU Lesser General Public License, v.2.1 along with this - ~ distribution; if not, write to the Free Software Foundation, Inc., - ~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - ~ - ~ Red Hat Author(s): Steve Ebersole - --> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="architecture"> <title>Architecture</title> <sect1 id="architecture-overview" revision="1"> - <title>G�n�ralit�s</title> + <title>Généralités</title> <para> - Voici une vue (tr�s) haut niveau de l'architecture d'Hibernate : + Voici une vue (très) haut niveau de l'architecture d'Hibernate : </para> <mediaobject> @@ -35,16 +22,16 @@ </mediaobject> <para> - Ce diagramme montre Hibernate utilisant une base de donn�es et des donn�es + Ce diagramme montre Hibernate utilisant une base de données et des données de configuration pour fournir un service de persistance (et des objets - persistants) � l'application. + persistants) à l'application. </para> <para> - Nous aimerions d�crire une vue plus d�taill�e de l'architecture. Malheureusement, - Hibernate est flexible et supporte diff�rentes approches. Nous allons en - montrer les deux extr�mes. L'architecture l�g�re laisse l'application fournir - ses propres connexions JDBC et g�rer ses propres transactions. Cette approche + Nous aimerions décrire une vue plus détaillée de l'architecture. Malheureusement, + Hibernate est flexible et supporte différentes approches. Nous allons en + montrer les deux extrêmes. L'architecture légère laisse l'application fournir + ses propres connexions JDBC et gérer ses propres transactions. Cette approche utilise le minimum des APIs Hibernate : </para> @@ -58,8 +45,8 @@ </mediaobject> <para> - L'architecture la plus compl�te abstrait l'application des APIs JDBC/JTA - sous-jacentes et laisse Hibernate s'occuper des d�tails. + L'architecture la plus complète abstrait l'application des APIs JDBC/JTA + sous-jacentes et laisse Hibernate s'occuper des détails. </para> <mediaobject> @@ -72,7 +59,7 @@ </mediaobject> <para> - Voici quelques d�finitions des objets des diagrammes : + Voici quelques définitions des objets des diagrammes : <variablelist spacing="compact"> <varlistentry> @@ -80,10 +67,10 @@ <listitem> <para> Un cache threadsafe (immuable) des mappings vers une (et une seule) base - de donn�es. Une factory (fabrique) de <literal>Session</literal> et un client + de données. Une factory (fabrique) de <literal>Session</literal> et un client de <literal>ConnectionProvider</literal>. Peut contenir un cache optionnel de - donn�es (de second niveau) qui est r�utilisable entre les diff�rentes transactions - que cela soit au sein du m�me processus (JVLM) ou par plusieurs n�uds d'un cluster. + données (de second niveau) qui est réutilisable entre les différentes transactions + que cela soit au sein du même processus (JVLM) ou par plusieurs nœuds d'un cluster. </para> </listitem> </varlistentry> @@ -91,11 +78,11 @@ <term>Session (<literal>org.hibernate.Session</literal>)</term> <listitem> <para> - Un objet mono-thread�, � dur�e de vie courte, qui repr�sente une conversation - entre l'application et l'entrep�t de persistance. Encapsule une connexion JDBC. + Un objet mono-threadé, à durée de vie courte, qui représente une conversation + entre l'application et l'entrepôt de persistance. Encapsule une connexion JDBC. Factory (fabrique) des objets <literal>Transaction</literal>. Contient un cache (de premier niveau) des objets persistants, ce cache est obligatoire. Il est - utilis� lors de la navigation dans le graphe d'objets ou lors de la r�cup�ration + utilisé lors de la navigation dans le graphe d'objets ou lors de la récupération d'objets par leur identifiant. </para> </listitem> @@ -104,13 +91,13 @@ <term>Objets et Collections persistants</term> <listitem> <para> - Objets mono-thread�s � vie courte contenant l'�tat de persistance - et la fonction m�tier. Ceux-ci sont en g�n�ral les objets de type JavaBean - (ou POJOs) ; la seule particularit� est qu'ils sont associ�s avec une (et - une seule) <literal>Session</literal>. D�s que la <literal>Session</literal> - est ferm�e, ils seront d�tach�s et libres d'�tre utilis�s par n'importe laquelle - des couches de l'application (ie. de et vers la pr�sentation en tant que Data - Transfer Objects - DTO : objet de transfert de donn�es). + Objets mono-threadés à vie courte contenant l'état de persistance + et la fonction métier. Ceux-ci sont en général les objets de type JavaBean + (ou POJOs) ; la seule particularité est qu'ils sont associés avec une (et + une seule) <literal>Session</literal>. Dès que la <literal>Session</literal> + est fermée, ils seront détachés et libres d'être utilisés par n'importe laquelle + des couches de l'application (ie. de et vers la présentation en tant que Data + Transfer Objects - DTO : objet de transfert de données). </para> </listitem> </varlistentry> @@ -118,10 +105,10 @@ <term>Objets et collections transients</term> <listitem> <para> - Instances de classes persistantes qui ne sont actuellement pas associ�es � - une <literal>Session</literal>. Elles ont pu �tre instanci�es par l'application - et ne pas avoir (encore) �t� persist�es ou elle ont pu �tre instanci�es par - une <literal>Session</literal> ferm�e. + Instances de classes persistantes qui ne sont actuellement pas associées à + une <literal>Session</literal>. Elles ont pu être instanciées par l'application + et ne pas avoir (encore) été persistées ou elle ont pu être instanciées par + une <literal>Session</literal> fermée. </para> </listitem> </varlistentry> @@ -129,11 +116,11 @@ <term>Transaction (<literal>org.hibernate.Transaction</literal>)</term> <listitem> <para> - (Optionnel) Un objet mono-thread� � vie courte utilis� par l'application - pour d�finir une unit� de travail atomique. Abstrait l'application des + (Optionnel) Un objet mono-threadé à vie courte utilisé par l'application + pour définir une unité de travail atomique. Abstrait l'application des transactions sous-jacentes qu'elles soient JDBC, JTA ou CORBA. Une <literal>Session</literal> peut fournir plusieurs <literal>Transaction</literal>s - dans certains cas. Toutefois, la d�limitation des transactions, via l'API d'Hibernate + dans certains cas. Toutefois, la délimitation des transactions, via l'API d'Hibernate ou par la <literal>Transaction</literal> sous-jacente, n'est jamais optionnelle! </para> </listitem> @@ -144,7 +131,7 @@ <para> (Optionnel) Une fabrique de (pool de) connexions JDBC. Abstrait l'application de la <literal>Datasource</literal> ou du <literal>DriverManager</literal> sous-jacent. - Non expos� � l'application, mais peut �tre �tendu/impl�ment� par le d�veloppeur. + Non exposé à l'application, mais peut être étendu/implémenté par le développeur. </para> </listitem> </varlistentry> @@ -153,7 +140,7 @@ <listitem> <para> (Optionnel) Une fabrique d'instances de <literal>Transaction</literal>. Non - expos� � l'application, mais peut �tre �tendu/impl�ment� par le d�veloppeur. + exposé à l'application, mais peut être étendu/implémenté par le développeur. </para> </listitem> </varlistentry> @@ -162,8 +149,8 @@ <listitem> <para> Hibernate fournit de nombreuses interfaces d'extensions optionnelles que - vous pouvez impl�menter pour personnaliser le comportement de votre couche de persistance. - Reportez vous � la documentation de l'API pour plus de d�tails. + vous pouvez implémenter pour personnaliser le comportement de votre couche de persistance. + Reportez vous à la documentation de l'API pour plus de détails. </para> </listitem> </varlistentry> @@ -171,7 +158,7 @@ </para> <para> - Dans une architecture l�g�re, l'application n'aura pas � utiliser les APIs + Dans une architecture légère, l'application n'aura pas à utiliser les APIs <literal>Transaction</literal>/<literal>TransactionFactory</literal> et/ou n'utilisera pas les APIs <literal>ConnectionProvider</literal> pour utiliser JTA ou JDBC. @@ -181,9 +168,9 @@ <sect1 id="architecture-states" revision="1"> <title>Etats des instances</title> <para> - Une instance d'une classe persistante peut �tre dans l'un des trois �tats suivants, - d�finis par rapport � un <emphasis>contexte de persistance</emphasis>. - L'objet <literal>Session</literal> d'hibernate correspond � ce concept de + Une instance d'une classe persistante peut être dans l'un des trois états suivants, + définis par rapport à un <emphasis>contexte de persistance</emphasis>. + L'objet <literal>Session</literal> d'hibernate correspond à ce concept de contexte de persistance : </para> @@ -192,8 +179,8 @@ <term>passager (transient)</term> <listitem> <para> - L'instance n'est pas et n'a jamais �t� associ�e � un contexte - de persistance. Elle ne poss�de pas d'identit� persistante (valeur de cl� primaire) + L'instance n'est pas et n'a jamais été associée à un contexte + de persistance. Elle ne possède pas d'identité persistante (valeur de clé primaire) </para> </listitem> </varlistentry> @@ -201,26 +188,26 @@ <term>persistant</term> <listitem> <para> - L'instance est associ�e au contexte de persistance. - Elle poss�de une identit� persistante (valeur de cl� primaire) - et, peut-�tre, un enregistrement correspondant dans la base. + L'instance est associée au contexte de persistance. + Elle possède une identité persistante (valeur de clé primaire) + et, peut-être, un enregistrement correspondant dans la base. Pour un contexte de persistance particulier, Hibernate - <emphasis>garantit</emphasis> que l'identit� persistante - est �quivalente � l'identit� Java (emplacement m�moire de l'objet) + <emphasis>garantit</emphasis> que l'identité persistante + est équivalente à l'identité Java (emplacement mémoire de l'objet) </para> </listitem> </varlistentry> <varlistentry> - <term>d�tach�</term> + <term>détaché</term> <listitem> <para> - L'instance a �t� associ�e au contexte de persistance mais ce - contexte a �t� ferm�, ou l'instance a �t� s�rialis�e vers un - autre processus. Elle poss�de une identit� persistante et - peut-�tre un enregistrement correspondant dans la base. - Pour des instances d�tach�es, Hibernate ne donne aucune - garantie sur la relation entre l'identit� persistante et - l'identit� Java. + L'instance a été associée au contexte de persistance mais ce + contexte a été fermé, ou l'instance a été sérialisée vers un + autre processus. Elle possède une identité persistante et + peut-être un enregistrement correspondant dans la base. + Pour des instances détachées, Hibernate ne donne aucune + garantie sur la relation entre l'identité persistante et + l'identité Java. </para> </listitem> </varlistentry> @@ -228,39 +215,39 @@ </sect1> <sect1 id="architecture-jmx" revision="1"> - <title>Int�gration JMX</title> + <title>Intégration JMX</title> <para> JMX est le standard J2EE de gestion des composants Java. - Hibernate peut �tre g�r� via un service JMX standard. Nous fournissons une impl�mentation + Hibernate peut être géré via un service JMX standard. Nous fournissons une implémentation d'un MBean dans la distribution : <literal>org.hibernate.jmx.HibernateService</literal>. </para> <para> - Pour avoir un exemple sur la mani�re de d�ployer Hibernate en tant que service JMX dans le - serveur d'application JBoss Application Server, r�f�rez vous au guide utilisateur JBoss (JBoss User Guide). - Si vous d�ployez Hibernate via JMX sur JBoss AS, vous aurez �galement les b�n�fices suivants : + Pour avoir un exemple sur la manière de déployer Hibernate en tant que service JMX dans le + serveur d'application JBoss Application Server, référez vous au guide utilisateur JBoss (JBoss User Guide). + Si vous déployez Hibernate via JMX sur JBoss AS, vous aurez également les bénéfices suivants : </para> <itemizedlist> <listitem> <para> <emphasis>Gestion de la session :</emphasis> Le cycle de vie de la <literal>Session</literal> - Hibernate peut �tre automatiquement limit�e � la port�e d'une transaction JTA. + Hibernate peut être automatiquement limitée à la portée d'une transaction JTA. Cela signifie que vous n'avez plus besoin d'ouvrir et de fermer la <literal>Session</literal> manuellement, cela devient le travail de l'intercepteur EJB de JBoss. Vous n'avez - pas non plus � vous occuper des d�marcations des transactions dans votre code (sauf - si vous voulez �crire une couche de persistance qui soit portable, dans ce cas vous + pas non plus à vous occuper des démarcations des transactions dans votre code (sauf + si vous voulez écrire une couche de persistance qui soit portable, dans ce cas vous pouvez utiliser l'API optionnelle <literal>Transaction</literal> d'Hibernate). - Vous appelez l'<literal>HibernateContext</literal> pour acc�der � la <literal>Session</literal>. + Vous appelez l'<literal>HibernateContext</literal> pour accéder à la <literal>Session</literal>. </para> </listitem> <listitem> <para> - <emphasis>D�ploiement HAR :</emphasis> Habituellement vous d�ployez le service JMX - Hibernate en utilisant le descripteur de d�ploiement de JBoss (dans un fichier EAR et/ou un SAR), + <emphasis>Déploiement HAR :</emphasis> Habituellement vous déployez le service JMX + Hibernate en utilisant le descripteur de déploiement de JBoss (dans un fichier EAR et/ou un SAR), il supporte toutes les options de configuration usuelles d'une <literal>SessionFactory</literal> Hibernate. Cependant, vous devez toujours nommer tous vos fichiers de mapping dans le - descripteur de d�ploiement. Si vous d�cidez d'utiliser le d�ploiement optionnel sous forme - de HAR, JBoss d�tectera automatiquement tous vos fichiers de mapping dans votre fichier HAR. + descripteur de déploiement. Si vous décidez d'utiliser le déploiement optionnel sous forme + de HAR, JBoss détectera automatiquement tous vos fichiers de mapping dans votre fichier HAR. </para> </listitem> </itemizedlist> @@ -270,8 +257,8 @@ </para> <para> - Les statistiques pendant l'ex�cution d'Hibernate (au runtime) sont une - autre fonctionnalit� disponible en tant que service JMX. Voyez pour cela + Les statistiques pendant l'exécution d'Hibernate (au runtime) sont une + autre fonctionnalité disponible en tant que service JMX. Voyez pour cela <xref linkend="configuration-optional-statistics"/>. </para> </sect1> @@ -279,46 +266,46 @@ <sect1 id="architecture-jca" revision="1"> <title>Support JCA</title> <para> - Hibernate peut aussi �tre configur� en tant que connecteur JCA. R�f�rez-vous au site - web pour de plus amples d�tails. Il est important de noter que le support JCA d'Hibernate - est encore consid�r� comme exp�rimental. + Hibernate peut aussi être configuré en tant que connecteur JCA. Référez-vous au site + web pour de plus amples détails. Il est important de noter que le support JCA d'Hibernate + est encore considéré comme expérimental. </para> </sect1> <sect1 id="architecture-current-session" revision="1"> <title>Sessions Contextuelles</title> <para> - Certaines applications utilisant Hibernate ont besoin d'une sorte de session "contextuelle", o� - une session est li�e � la port�e d'un contexte particulier. Cependant, les applications ne d�finissent - pas toutes la notion de contexte de la m�me mani�re, et diff�rents contextes d�finissent diff�rentes - port�es � la notion de "courant". Les applications � base d'Hibernate, versions pr�c�dentes � la 3.0 - utilisaient g�n�ralement un principe maison de sessions contextuelles bas�es sur le <literal>ThreadLocal</literal>, + Certaines applications utilisant Hibernate ont besoin d'une sorte de session "contextuelle", où + une session est liée à la portée d'un contexte particulier. Cependant, les applications ne définissent + pas toutes la notion de contexte de la même manière, et différents contextes définissent différentes + portées à la notion de "courant". Les applications à base d'Hibernate, versions précédentes à la 3.0 + utilisaient généralement un principe maison de sessions contextuelles basées sur le <literal>ThreadLocal</literal>, ainsi que sur des classes utilitaires comme <literal>HibernateUtil</literal>, ou utilisaient des - framework tiers (comme Spring ou Pico) qui fournissaient des sessions contextuelles bas�es sur + framework tiers (comme Spring ou Pico) qui fournissaient des sessions contextuelles basées sur l'utilisation de proxy/interception. </para> <para> - A partir de la version 3.0.1, Hibernate a ajout� la m�thode <literal>SessionFactory.getCurrentSession()</literal>. - Initialement, cela demandait l'usage de transactions <literal>JTA</literal>, o� la - transaction <literal>JTA</literal> d�finissait la port�e et le contexte de la session courante. - L'�quipe Hibernate pense que, �tant donn�e la maturit� des impl�mentations de <literal>JTA TransactionManager</literal> , + A partir de la version 3.0.1, Hibernate a ajouté la méthode <literal>SessionFactory.getCurrentSession()</literal>. + Initialement, cela demandait l'usage de transactions <literal>JTA</literal>, où la + transaction <literal>JTA</literal> définissait la portée et le contexte de la session courante. + L'équipe Hibernate pense que, étant donnée la maturité des implémentations de <literal>JTA TransactionManager</literal> , la plupart (sinon toutes) des applications devraient utiliser la gestion des transactions par <literal>JTA</literal> - qu'elles soient ou non d�ploy�es dans un conteneur <literal>J2EE</literal>. Par cons�quent, - vous devriez toujours contextualiser vos sessions, si vous en avez besoin, via la m�thode bas�e sur JTA. + qu'elles soient ou non déployées dans un conteneur <literal>J2EE</literal>. Par conséquent, + vous devriez toujours contextualiser vos sessions, si vous en avez besoin, via la méthode basée sur JTA. </para> <para> - Cependant, depuis la version 3.1, la logique derri�re - <literal>SessionFactory.getCurrentSession()</literal> est d�sormais branchable. + Cependant, depuis la version 3.1, la logique derrière + <literal>SessionFactory.getCurrentSession()</literal> est désormais branchable. A cette fin, une nouvelle interface d'extension (<literal>org.hibernate.context.CurrentSessionContext</literal>) - et un nouveau param�tre de configuration (<literal>hibernate.current_session_context_class</literal>) - ont �t� ajout�s pour permettre de configurer d'autres moyens de d�finir la port�e et le contexte des + et un nouveau paramètre de configuration (<literal>hibernate.current_session_context_class</literal>) + ont été ajoutés pour permettre de configurer d'autres moyens de définir la portée et le contexte des sessions courantes. </para> <para> Allez voir les Javadocs de l'interface <literal>org.hibernate.context.CurrentSessionContext</literal> - pour une description d�taill�e de son contrat. Elle d�finit une seule m�thode, - <literal>currentSession()</literal>, depuis laquelle l'impl�mentation est responsable - de traquer la session courante du contexte. Hibernate fournit deux impl�mentation + pour une description détaillée de son contrat. Elle définit une seule méthode, + <literal>currentSession()</literal>, depuis laquelle l'implémentation est responsable + de traquer la session courante du contexte. Hibernate fournit deux implémentation de cette interface. </para> @@ -326,38 +313,38 @@ <listitem> <para> <literal>org.hibernate.context.JTASessionContext</literal> - les sessions courantes sont - associ�es � une transaction <literal>JTA</literal>. La logique est la m�me que - l'ancienne approche bas�e sur JTA. Voir les javadocs pour les d�tails. + associées à une transaction <literal>JTA</literal>. La logique est la même que + l'ancienne approche basée sur JTA. Voir les javadocs pour les détails. </para> </listitem> <listitem> <para> <literal>org.hibernate.context.ThreadLocalSessionContext</literal> - les sessions - courantes sont associ�es au thread d'ex�cution. Voir les javadocs pour les d�tails. + courantes sont associées au thread d'exécution. Voir les javadocs pour les détails. </para> </listitem> </itemizedlist> <para> - Les deux impl�mentations fournissent un mod�le de programmation de type "une session - une transaction - � la base de donn�es", aussi connu sous le nom de <emphasis>session-per-request</emphasis>. - Le d�but et la fin d'une session Hibernate sont d�finis par la dur�e d'une transaction de base de donn�es. - Si vous utilisez une d�marcation programmatique de la transaction (par exemple sous J2SE ou JTA/UserTransaction/BMT), - nous vous conseillons d'utiliser l'API Hibernate <literal>Transaction</literal> pour masquer le syst�me - de transaction utilis�. Si vous ex�cutez sous un conteneur EJB qui supporte CMT, vous n'avez besoin d'aucune - op�rations de d�marcations de session ou transaction dans votre code puisque tout - est g�r� de mani�re d�clarative. R�f�rez vous � <xref linkend="transactions"/> pour plus d'informations + Les deux implémentations fournissent un modèle de programmation de type "une session - une transaction + à la base de données", aussi connu sous le nom de <emphasis>session-per-request</emphasis>. + Le début et la fin d'une session Hibernate sont définis par la durée d'une transaction de base de données. + Si vous utilisez une démarcation programmatique de la transaction (par exemple sous J2SE ou JTA/UserTransaction/BMT), + nous vous conseillons d'utiliser l'API Hibernate <literal>Transaction</literal> pour masquer le système + de transaction utilisé. Si vous exécutez sous un conteneur EJB qui supporte CMT, vous n'avez besoin d'aucune + opérations de démarcations de session ou transaction dans votre code puisque tout + est géré de manière déclarative. Référez vous à <xref linkend="transactions"/> pour plus d'informations et des exemples de code. </para> <para> - Le param�tre de configuration <literal>hibernate.current_session_context_class</literal> - d�finit quelle impl�mentation de <literal>org.hibernate.context.CurrentSessionContext</literal> - doit �tre utilis�e. Notez que pour assurer la compatibilit� avec les versions pr�c�dentes, si - ce param�tre n'est pas d�fini mais qu'un <literal>org.hibernate.transaction.TransactionManagerLookup</literal> - est configur�, Hibernate utilisera le <literal>org.hibernate.context.JTASessionContext</literal>. - La valeur de ce param�tre devrait juste nommer la classe d'impl�mentation � utiliser, - pour les deux impl�mentations fournies, il y a cependant deux alias correspondant: "jta" et "thread". + Le paramètre de configuration <literal>hibernate.current_session_context_class</literal> + définit quelle implémentation de <literal>org.hibernate.context.CurrentSessionContext</literal> + doit être utilisée. Notez que pour assurer la compatibilité avec les versions précédentes, si + ce paramètre n'est pas défini mais qu'un <literal>org.hibernate.transaction.TransactionManagerLookup</literal> + est configuré, Hibernate utilisera le <literal>org.hibernate.context.JTASessionContext</literal>. + La valeur de ce paramètre devrait juste nommer la classe d'implémentation à utiliser, + pour les deux implémentations fournies, il y a cependant deux alias correspondant: "jta" et "thread". </para> </sect1> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/association_mapping.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/association_mapping.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/association_mapping.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,4 +1,6 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="associations"> <title>Mapper les associations</title> @@ -7,27 +9,27 @@ <title>Introduction</title> <para> - Correctement mapper les associations est souvent la t�che la plus difficile. - Dans cette section nous traiterons les cas classiques les uns apr�s les autres. + Correctement mapper les associations est souvent la tâche la plus difficile. + Dans cette section nous traiterons les cas classiques les uns après les autres. Nous commencerons d'abbord par les mappings unidirectionnels, puis nous aborderons la question des mappings bidirectionnels. Nous illustrerons tous nos exemples avec les classes <literal>Person</literal> et <literal>Address</literal>. </para> <para> - Nous utiliserons deux crit�res pour classer les associations : le premier - sera de savoir si l'association est b�ti sur une table suppl�mentaire d'association - et le deuxieme sera bas� sur la multiplicit� de cette association. + Nous utiliserons deux critères pour classer les associations : le premier + sera de savoir si l'association est bâti sur une table supplémentaire d'association + et le deuxieme sera basé sur la multiplicité de cette association. </para> <para> - Autoriser une cl� �trang�re nulle est consid�r� comme un mauvais choix dans - la construction d'un mod�le de donn�es. Nous supposerons donc que dans tous - les exemples qui vont suivre on aura interdit la valeur nulle pour les cl�s - �trang�res. Attention, ceci ne veut pas dire que Hibernate ne supporte pas - les cl�s �trang�res pouvant prendre des valeurs nulles, les exemples qui suivent - continueront de fonctionner si vous d�cidiez ne plus imposer la contrainte - de non-nullit� sur les cl�s �trang�res. + Autoriser une clé étrangère nulle est considéré comme un mauvais choix dans + la construction d'un modèle de données. Nous supposerons donc que dans tous + les exemples qui vont suivre on aura interdit la valeur nulle pour les clés + étrangères. Attention, ceci ne veut pas dire que Hibernate ne supporte pas + les clés étrangères pouvant prendre des valeurs nulles, les exemples qui suivent + continueront de fonctionner si vous décidiez ne plus imposer la contrainte + de non-nullité sur les clés étrangères. </para> </sect1> @@ -36,10 +38,10 @@ <title>Association unidirectionnelle</title> <sect2 id="assoc-unidirectional-m21" > - <title>plusieurs � un</title> + <title>plusieurs à un</title> <para> - Une <emphasis>association plusieurs-�-un (many-to-one) unidirectionnelle </emphasis> + Une <emphasis>association plusieurs-à-un (many-to-one) unidirectionnelle </emphasis> est le type que l'on rencontre le plus souvent dans les associations unidirectionnelles. </para> @@ -66,12 +68,12 @@ </sect2> <sect2 id="assoc-unidirectional-121"> - <title>un � un</title> + <title>un à un</title> <para> - une <emphasis>association un-�-un (one-to-one) sur une cl� �trang�re</emphasis> - est presque identique. La seule diff�rence est sur la contrainte d'unicit� que - l'on impose � cette colonne. + une <emphasis>association un-à-un (one-to-one) sur une clé étrangère</emphasis> + est presque identique. La seule différence est sur la contrainte d'unicité que + l'on impose à cette colonne. </para> <programlisting><![CDATA[<class name="Person"> @@ -95,8 +97,8 @@ ]]></programlisting> <para> - Une <emphasis>association un-�-un (one-to-one) unidirectionnelle sur une cl� primaire</emphasis> - utilise un g�n�rateur d'identifiant particulier. (Remarquez que nous avons invers� le sens de cette + Une <emphasis>association un-à-un (one-to-one) unidirectionnelle sur une clé primaire</emphasis> + utilise un générateur d'identifiant particulier. (Remarquez que nous avons inversé le sens de cette association dans cet exemple.) </para> @@ -122,11 +124,11 @@ </sect2> <sect2 id="assoc-unidirectional-12m"> - <title>un � plusieurs</title> + <title>un à plusieurs</title> <para> - Une <emphasis>association un-�-plusieurs (one-to-many) unidirectionnelle sur une - cl� �trang�re</emphasis> est vraiment inhabituelle, et n'est pas vraiment recommand�e. + Une <emphasis>association un-à-plusieurs (one-to-many) unidirectionnelle sur une + clé étrangère</emphasis> est vraiment inhabituelle, et n'est pas vraiment recommandée. </para> <programlisting><![CDATA[<class name="Person"> @@ -151,7 +153,7 @@ ]]></programlisting> <para> - Nous pensons qu'il est pr�f�rable d'utiliser une table de jointure pour ce type d'association. + Nous pensons qu'il est préférable d'utiliser une table de jointure pour ce type d'association. </para> </sect2> @@ -162,14 +164,14 @@ <title>Associations unidirectionnelles avec tables de jointure</title> <sect2 id="assoc-unidirectional-join-12m"> - <title>un � plusieurs</title> + <title>un à plusieurs</title> <para> - Une <emphasis>association unidirectionnelle un-�-plusieurs (one-to-many) avec + Une <emphasis>association unidirectionnelle un-à-plusieurs (one-to-many) avec une table de jointure</emphasis> est un bien meilleur choix. - Remarquez qu'en sp�cifiant <literal>unique="true"</literal>, - on a chang� la multiplicit� plusieurs-�-plusieurs (many-to-many) pour - un-�-plusieurs (one-to-many). + Remarquez qu'en spécifiant <literal>unique="true"</literal>, + on a changé la multiplicité plusieurs-à-plusieurs (many-to-many) pour + un-à-plusieurs (one-to-many). </para> <programlisting><![CDATA[<class name="Person"> @@ -198,11 +200,11 @@ </sect2> <sect2 id="assoc-unidirectional-join-m21"> - <title>plusieurs � un</title> + <title>plusieurs à un</title> <para> - Une <emphasis>assiociation plusieurs-�-un (many-to-one) unidirectionnelle sur - une table de jointure</emphasis> est tr�s fr�quente quand l'association est optionnelle. + Une <emphasis>assiociation plusieurs-à-un (many-to-one) unidirectionnelle sur + une table de jointure</emphasis> est très fréquente quand l'association est optionnelle. </para> <programlisting><![CDATA[<class name="Person"> @@ -232,11 +234,11 @@ </sect2> <sect2 id="assoc-unidirectional-join-121"> - <title>un � un</title> + <title>un à un</title> <para> - Une <emphasis>association unidirectionnelle un-�-un (one-to-one) sur une table - de jointure</emphasis> est extr�mement rare mais envisageable. + Une <emphasis>association unidirectionnelle un-à-un (one-to-one) sur une table + de jointure</emphasis> est extrèmement rare mais envisageable. </para> <programlisting><![CDATA[<class name="Person"> @@ -268,10 +270,10 @@ </sect2> <sect2 id="assoc-unidirectional-join-m2m"> - <title>plusieurs � plusieurs</title> + <title>plusieurs à plusieurs</title> <para> - Finallement, nous avons <emphasis>l'association unidirectionnelle plusieurs-�-plusieurs (many-to-many)</emphasis>. + Finallement, nous avons <emphasis>l'association unidirectionnelle plusieurs-à-plusieurs (many-to-many)</emphasis>. </para> <programlisting><![CDATA[<class name="Person"> @@ -304,11 +306,11 @@ <title>Associations bidirectionnelles</title> <sect2 id="assoc-bidirectional-m21" revision="2"> - <title>un � plusieurs / plusieurs � un</title> + <title>un à plusieurs / plusieurs à un</title> <para> - Une <emphasis>association bidirectionnelle plusieurs � un (many-to-one)</emphasis> - est le type d'association que l'on rencontre le plus souvent. (c'est la fa�on standard de cr�er + Une <emphasis>association bidirectionnelle plusieurs à un (many-to-one)</emphasis> + est le type d'association que l'on rencontre le plus souvent. (c'est la façon standard de créer des relations parents/enfants.) </para> @@ -337,10 +339,10 @@ ]]></programlisting> <para> - Si vous utilisez une <literal>List</literal> (ou toute autre collection index�e) vous devez - param�trer la colonne <literal>key</literal> de la cl� �trang�re � <literal>not null</literal>, - et laisser Hibernate g�rer l'association depuis l'extr�mit� collection pour maintenir l'index - de chaque �l�ment (rendant l'autre extr�mit� virtuellement inverse en param�trant + Si vous utilisez une <literal>List</literal> (ou toute autre collection indexée) vous devez + paramétrer la colonne <literal>key</literal> de la clé étrangère à <literal>not null</literal>, + et laisser Hibernate gérer l'association depuis l'extrémité collection pour maintenir l'index + de chaque élément (rendant l'autre extrémité virtuellement inverse en paramétrant <literal>update="false"</literal> et <literal>insert="false"</literal>): </para> @@ -367,11 +369,11 @@ </sect2> <sect2 id="assoc-bidirectional-121"> - <title>Un � un</title> + <title>Un à un</title> <para> - Une <emphasis>association bidirectionnelle un � un (one-to-one) sur une cl� �trang�re</emphasis> - est aussi tr�s fr�quente. + Une <emphasis>association bidirectionnelle un à un (one-to-one) sur une clé étrangère</emphasis> + est aussi très fréquente. </para> <programlisting><![CDATA[<class name="Person"> @@ -397,8 +399,8 @@ ]]></programlisting> <para> - Une <emphasis>association bidirectionnelle un-�-un (one-to-one) sur une cl� primaire</emphasis> - utilise un g�n�rateur particulier d'id. + Une <emphasis>association bidirectionnelle un-à-un (one-to-one) sur une clé primaire</emphasis> + utilise un générateur particulier d'id. </para> <programlisting><![CDATA[<class name="Person"> @@ -430,11 +432,11 @@ <title>Associations bidirectionnelles avec table de jointure</title> <sect2 id="assoc-bidirectional-join-12m"> - <title>un � plusieurs / plusieurs � un</title> + <title>un à plusieurs / plusieurs à un</title> <para> - Une <emphasis>association bidirectionnelle un-�-plusieurs (one-to-many) sur une table de jointure </emphasis>. - Remarquez que <literal>inverse="true"</literal> peut s'appliquer sur les deux extr�mit�s de l' + Une <emphasis>association bidirectionnelle un-à-plusieurs (one-to-many) sur une table de jointure </emphasis>. + Remarquez que <literal>inverse="true"</literal> peut s'appliquer sur les deux extrémités de l' association, sur la collection, ou sur la jointure. </para> @@ -473,11 +475,11 @@ </sect2> <sect2 id="assoc-bidirectional-join-121"> - <title>Un � un</title> + <title>Un à un</title> <para> - Une <emphasis>association bidirectionnelle un-�-un (one-to-one) sur une table de jointure</emphasis> - est extr�mement rare mais envisageable. + Une <emphasis>association bidirectionnelle un-à-un (one-to-one) sur une table de jointure</emphasis> + est extrèmement rare mais envisageable. </para> <programlisting><![CDATA[<class name="Person"> @@ -519,10 +521,10 @@ </sect2> <sect2 id="assoc-bidirectional-join-m2m" revision="1"> - <title>plusieurs � plusieurs</title> + <title>plusieurs à plusieurs</title> <para> - Finallement nous avons <emphasis>l'association bidirectionnelle plusieurs � plusieurs</emphasis>. + Finallement nous avons <emphasis>l'association bidirectionnelle plusieurs à plusieurs</emphasis>. </para> <programlisting><![CDATA[<class name="Person"> @@ -561,12 +563,12 @@ <title>Des mappings plus complexes</title> <para> - Des associations encore plus complexes sont <emphasis>extr�mement</emphasis> rares. - Hibernate permet de g�rer des situations plus complexes en utilisant des + Des associations encore plus complexes sont <emphasis>extrêmement</emphasis> rares. + Hibernate permet de gérer des situations plus complexes en utilisant des parties SQL dans les fichiers de mapping. Par exemple, si une table - avec l'historiques des informations d'un compte d�finit les colonnes + avec l'historiques des informations d'un compte définit les colonnes <literal>accountNumber</literal>, <literal>effectiveEndDate</literal> - et <literal>effectiveStartDate</literal>, mapp�es de telle sorte: + et <literal>effectiveStartDate</literal>, mappées de telle sorte: </para> <programlisting><![CDATA[<properties name="currentAccountKey"> @@ -579,7 +581,7 @@ <property name="effectiveStateDate" type="date" not-null="true"/>]]></programlisting> <para> - alors nous pouvons mapper une association � l'instance <emphasis>courante</emphasis> + alors nous pouvons mapper une association à l'instance <emphasis>courante</emphasis> (celle avec une <literal>effectiveEndDate</literal>) nulle en utilisant: </para> @@ -592,10 +594,10 @@ <para> Dans un exemple plus complexe, imaginez qu'une association entre - <literal>Employee</literal> et <literal>Organization</literal> est g�r�e - dans une table <literal>Employment</literal> pleines de donn�es historiques. - Dans ce cas, une association vers l'employeur <emphasis>le plus r�cent</emphasis> - (celui avec la <literal>startDate</literal> la plus r�cente) pourrait �tre mapp�e comme cela: + <literal>Employee</literal> et <literal>Organization</literal> est gérée + dans une table <literal>Employment</literal> pleines de données historiques. + Dans ce cas, une association vers l'employeur <emphasis>le plus récent</emphasis> + (celui avec la <literal>startDate</literal> la plus récente) pourrait être mappée comme cela: </para> <programlisting><![CDATA[<join> @@ -612,8 +614,8 @@ </join>]]></programlisting> <para> - Vous pouvez �tre cr�atif grace � ces possibilit�s, mais il est g�n�ralement plus pratique - d'utiliser des requ�tes HQL ou criteria dans ce genre de situation. + Vous pouvez être créatif grace à ces possibilités, mais il est généralement plus pratique + d'utiliser des requêtes HQL ou criteria dans ce genre de situation. </para> </sect1> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/basic_mapping.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/basic_mapping.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/basic_mapping.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,20 +1,22 @@ -<?xml version='1.0' encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="mapping"> <title>Mapping O/R basique</title> <sect1 id="mapping-declaration" revision="1"> - <title>D�claration de Mapping</title> + <title>Déclaration de Mapping</title> <para> - Les mappings Objet/relationnel sont g�n�ralement d�finis dans un document XML. - Le document de mapping est con�u pour �tre lisible et �ditable � la main. - Le langage de mapping est Java-centrique, c'est � dire que les mappings sont construits - � partir des d�clarations des classes persistantes et non des d�clarations des tables. + Les mappings Objet/relationnel sont généralement définis dans un document XML. + Le document de mapping est conçu pour être lisible et éditable à la main. + Le langage de mapping est Java-centrique, c'est à dire que les mappings sont construits + à partir des déclarations des classes persistantes et non des déclarations des tables. </para> <para> - Remarquez que m�me si beaucoup d'utilisateurs de Hibernate pr�f�rent �crire les - fichiers de mappings � la main, plusieurs outils existent pour g�n�rer ce document, + Remarquez que même si beaucoup d'utilisateurs de Hibernate préfèrent écrire les + fichiers de mappings à la main, plusieurs outils existent pour générer ce document, notamment XDoclet, Middlegen et AndroMDA. </para> - <para>D�marrons avec un exemple de mapping :</para> + <para>Démarrons avec un exemple de mapping :</para> <programlisting id="mapping-declaration-ex1" revision="1"><![CDATA[<?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" @@ -80,33 +82,33 @@ </hibernate-mapping>]]></programlisting> <para> - Etudions le contenu du document de mapping. Nous d�crirons uniquement - les �l�ments et attributs du document utilis�s par Hibernate � l'ex�cution. - Le document de mapping contient aussi des attributs et �l�ments optionnels - qui agissent sur le sch�ma de base de donn�es export� par l'outil de - g�n�ration de sch�ma. (Par exemple l'attribut <literal>not-null</literal>.) + Etudions le contenu du document de mapping. Nous décrirons uniquement + les éléments et attributs du document utilisés par Hibernate à l'exécution. + Le document de mapping contient aussi des attributs et éléments optionnels + qui agissent sur le schéma de base de données exporté par l'outil de + génération de schéma. (Par exemple l'attribut <literal>not-null</literal>.) </para> <sect2 id="mapping-declaration-doctype" revision="2"> <title>Doctype</title> <para> - Tous les mappings XML devraient utiliser le doctype indiqu�. - Ce fichier est pr�sent � l'URL ci-dessus, dans le r�pertoire + Tous les mappings XML devraient utiliser le doctype indiqué. + Ce fichier est présent à l'URL ci-dessus, dans le répertoire <literal>hibernate-x.x.x/src/org/hibernate</literal> ou dans <literal>hibernate3.jar</literal>. Hibernate va toujours chercher la DTD dans son classpath en premier lieu. Si vous constatez - des recherches de la DTD sur Internet, v�rifiez votre d�claration de DTD par rapport + des recherches de la DTD sur Internet, vérifiez votre déclaration de DTD par rapport au contenu de votre classpath. </para> </sect2> <sect2 id="mapping-declaration-mapping" revision="3"> <title>hibernate-mapping</title> <para> - Cet �l�ment a plusieurs attributs optionnels. Les attributs <literal>schema</literal> et <literal>catalog</literal> - indiquent que les tables r�f�renc�es par ce mapping appartiennent au sch�ma nomm� et/ou au catalogue. - S'ils sont sp�cifi�s, les noms de tables seront qualifi�s par les noms de sch�ma et catalogue. - L'attribut <literal>default-cascade</literal> indique quel type de cascade sera utlis� par d�faut - pour les propri�t�s et collections qui ne pr�cisent pas l'attribut <literal>cascade</literal>. - L'attribut <literal>auto-import</literal> nous permet d'utiliser par d�faut des noms de classes - non qualifi�s dans le langage de requ�te. + Cet élément a plusieurs attributs optionnels. Les attributs <literal>schema</literal> et <literal>catalog</literal> + indiquent que les tables référencées par ce mapping appartiennent au schéma nommé et/ou au catalogue. + S'ils sont spécifiés, les noms de tables seront qualifiés par les noms de schéma et catalogue. + L'attribut <literal>default-cascade</literal> indique quel type de cascade sera utlisé par défaut + pour les propriétés et collections qui ne précisent pas l'attribut <literal>cascade</literal>. + L'attribut <literal>auto-import</literal> nous permet d'utiliser par défaut des noms de classes + non qualifiés dans le langage de requête. </para> <programlistingco> <areaspec> @@ -130,69 +132,69 @@ <calloutlist> <callout arearefs="hm1"> <para> - <literal>schema</literal> (optionnel) : Le nom d'un sch�ma de base de donn�es. + <literal>schema</literal> (optionnel) : Le nom d'un schéma de base de données. </para> </callout> <callout arearefs="hm2"> <para> - <literal>catalog</literal> (optionnel) : Le nom d'un catalogue de base de donn�es. + <literal>catalog</literal> (optionnel) : Le nom d'un catalogue de base de données. </para> </callout> <callout arearefs="hm3"> <para> - <literal>default-cascade</literal> (optionnel - par d�faut vaut : <literal>none</literal>) : - Un type de cascade par d�faut. + <literal>default-cascade</literal> (optionnel - par défaut vaut : <literal>none</literal>) : + Un type de cascade par défaut. </para> </callout> <callout arearefs="hm4"> <para> - <literal>default-access</literal> (optionnel - par d�faut vaut : <literal>property</literal>) : - Comment hibernate acc�dera aux propri�t�s. On peut aussi - red�finir sa propre impl�mentation de <literal>PropertyAccessor</literal>. + <literal>default-access</literal> (optionnel - par défaut vaut : <literal>property</literal>) : + Comment hibernate accèdera aux propriétés. On peut aussi + redéfinir sa propre implémentation de <literal>PropertyAccessor</literal>. </para> </callout> <callout arearefs="hm5"> <para> - <literal>default-lazy</literal> (optionnel - par d�faut vaut : <literal>true</literal>) : - Valeur par d�faut pour un attribut <literal>lazy</literal> - non sp�cifi� : celui des mappings de classes et de collection. + <literal>default-lazy</literal> (optionnel - par défaut vaut : <literal>true</literal>) : + Valeur par défaut pour un attribut <literal>lazy</literal> + non spécifié : celui des mappings de classes et de collection. </para> </callout> <callout arearefs="hm6"> <para> - <literal>auto-import</literal> (optionnel - par d�faut vaut : <literal>true</literal>) : - Sp�cifie si l'on peut utiliser des noms de classes - non qualifi�s (des classes de ce mapping) dans le langage de requ�te. + <literal>auto-import</literal> (optionnel - par défaut vaut : <literal>true</literal>) : + Spécifie si l'on peut utiliser des noms de classes + non qualifiés (des classes de ce mapping) dans le langage de requête. </para> </callout> <callout arearefs="hm7"> <para> - <literal>package</literal> (optionnel) : Pr�fixe de package par d�faut pour - les noms de classe non qualifi�s du document de mapping. + <literal>package</literal> (optionnel) : Préfixe de package par défaut pour + les noms de classe non qualifiés du document de mapping. </para> </callout> </calloutlist> </programlistingco> <para> - Si deux classes poss�dent le m�me nom de classe (non qualifi�), vous devez indiquer + Si deux classes possèdent le même nom de classe (non qualifié), vous devez indiquer <literal>auto-import="false"</literal>. Hibernate lancera une exception - si vous essayez d'assigner � deux classes le m�me nom import�. + si vous essayez d'assigner à deux classes le même nom importé. </para> <para> - Notez que l'�l�ment <literal>hibernate-mapping</literal> vous permet d'imbriquer plusieurs mappings de + Notez que l'élément <literal>hibernate-mapping</literal> vous permet d'imbriquer plusieurs mappings de <literal>&lt;class&gt;</literal> persistantes, comme dans l'exemple ci-dessus. Cependant la bonne pratique (ce qui est attendu par certains outils) est - de mapper une seule classe (ou une seule hi�rarchie de classes) - par fichier de mapping et de nommer ce fichier d'apr�s le nom de la superclasse, par exemple - <literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, ou en cas d'h�ritage, + de mapper une seule classe (ou une seule hiérarchie de classes) + par fichier de mapping et de nommer ce fichier d'après le nom de la superclasse, par exemple + <literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, ou en cas d'héritage, <literal>Animal.hbm.xml</literal>. </para> </sect2> <sect2 id="mapping-declaration-class" revision="3"> <title>class</title> <para> - D�clarez une classe persistante avec l'�l�ment <literal>class</literal> : + Déclarez une classe persistante avec l'élément <literal>class</literal> : </para> <programlistingco> <areaspec> @@ -247,111 +249,111 @@ <callout arearefs="class1"> <para> <literal>name</literal> (optionnel) : Le nom Java complet de la classe (ou interface) persistante. - Si cet attribut est absent, il est suppos� que ce mapping ne se rapporte pas � une entit� POJO. + Si cet attribut est absent, il est supposé que ce mapping ne se rapporte pas à une entité POJO. </para> </callout> <callout arearefs="class2"> <para> - <literal>table</literal> (optionnel - par d�faut le nom (non-qualifi�) de la classe) : Le - nom de sa table en base de donn�es. + <literal>table</literal> (optionnel - par défaut le nom (non-qualifié) de la classe) : Le + nom de sa table en base de données. </para> </callout> <callout arearefs="class3"> <para> - <literal>discriminator-value</literal> (optionnel - par d�faut le nom de la classe) : + <literal>discriminator-value</literal> (optionnel - par défaut le nom de la classe) : Une valeur permettant de distinguer les sous-classes dans le cas de l'utilisation du polymorphisme. - Les valeurs <literal>null</literal> et <literal>not null</literal> sont autoris�es. + Les valeurs <literal>null</literal> et <literal>not null</literal> sont autorisées. </para> </callout> <callout arearefs="class4"> <para> - <literal>mutable</literal> (optionnel, vaut <literal>true</literal> par d�faut) : Sp�cifie + <literal>mutable</literal> (optionnel, vaut <literal>true</literal> par défaut) : Spécifie que des instances de la classe sont (ou non) immuables. </para> </callout> <callout arearefs="class5"> <para> - <literal>schema</literal> (optionnel) : Surcharge le nom de sch�ma sp�cifi� par - l'�l�ment racine <literal>&lt;hibernate-mapping&gt;</literal>. + <literal>schema</literal> (optionnel) : Surcharge le nom de schéma spécifié par + l'élément racine <literal>&lt;hibernate-mapping&gt;</literal>. </para> </callout> <callout arearefs="class6"> <para> - <literal>catalog</literal> (optionnel) : Surcharge le nom du catalogue sp�cifi� par - l'�l�ment racine <literal>&lt;hibernate-mapping&gt;</literal>. + <literal>catalog</literal> (optionnel) : Surcharge le nom du catalogue spécifié par + l'élément racine <literal>&lt;hibernate-mapping&gt;</literal>. </para> </callout> <callout arearefs="class7"> <para> - <literal>proxy</literal> (optionnel) : Sp�cifie une interface � utiliser pour l'initialisation diff�r�e (lazy loading) - des proxies. Vous pouvez indiquer le nom de la classe elle-m�me. + <literal>proxy</literal> (optionnel) : Spécifie une interface à utiliser pour l'initialisation différée (lazy loading) + des proxies. Vous pouvez indiquer le nom de la classe elle-même. </para> </callout> <callout arearefs="class8"> <para> - <literal>dynamic-update</literal> (optionnel, par d�faut � <literal>false</literal>) : - Sp�cifie que les <literal>UPDATE</literal> SQL doivent �tre g�n�r�s � l'ex�cution et contenir - uniquement les colonnes dont les valeurs ont �t� modifi�es. + <literal>dynamic-update</literal> (optionnel, par défaut à <literal>false</literal>) : + Spécifie que les <literal>UPDATE</literal> SQL doivent être générés à l'exécution et contenir + uniquement les colonnes dont les valeurs ont été modifiées. </para> </callout> <callout arearefs="class9"> <para> - <literal>dynamic-insert</literal> (optionnel, par d�faut � <literal>false</literal>): - Sp�cifie que les <literal>INSERT</literal> SQL doivent �tre g�n�r�s � l'ex�cution et ne contenir + <literal>dynamic-insert</literal> (optionnel, par défaut à <literal>false</literal>): + Spécifie que les <literal>INSERT</literal> SQL doivent être générés à l'exécution et ne contenir que les colonnes dont les valeurs sont non nulles. </para> </callout> <callout arearefs="class10"> <para> - <literal>select-before-update</literal> (optionnel, par d�faut � <literal>false</literal>): - Sp�cifie que Hibernate ne doit <emphasis>jamais</emphasis> ex�cuter un <literal>UPDATE</literal> SQL - sans �tre certain qu'un objet a �t� r�ellement modifi�. Dans certains cas, (en r�alit�, seulement - quand un objet transient a �t� associ� � une nouvelle session par <literal>update()</literal>), - cela signifie que Hibernate ex�cutera un <literal>SELECT</literal> SQL pour s'assurer qu'un - <literal>UPDATE</literal> SQL est v�ritablement n�cessaire. + <literal>select-before-update</literal> (optionnel, par défaut à <literal>false</literal>): + Spécifie que Hibernate ne doit <emphasis>jamais</emphasis> exécuter un <literal>UPDATE</literal> SQL + sans être certain qu'un objet a été réellement modifié. Dans certains cas, (en réalité, seulement + quand un objet transient a été associé à une nouvelle session par <literal>update()</literal>), + cela signifie que Hibernate exécutera un <literal>SELECT</literal> SQL pour s'assurer qu'un + <literal>UPDATE</literal> SQL est véritablement nécessaire. </para> </callout> <callout arearefs="class11"> <para> - <literal>polymorphism</literal> (optionnel, vaut <literal>implicit</literal> par d�faut) : - D�termine si, pour cette classe, une requ�te polymorphique implicite ou explicite est utilis�e. + <literal>polymorphism</literal> (optionnel, vaut <literal>implicit</literal> par défaut) : + Détermine si, pour cette classe, une requête polymorphique implicite ou explicite est utilisée. </para> </callout> <callout arearefs="class12"> <para> - <literal>where</literal> (optionnel) sp�cifie une clause SQL <literal>WHERE</literal> - � utiliser lorsque l'on r�cup�re des objets de cette classe. + <literal>where</literal> (optionnel) spécifie une clause SQL <literal>WHERE</literal> + à utiliser lorsque l'on récupère des objets de cette classe. </para> </callout> <callout arearefs="class13"> <para> - <literal>persister</literal> (optionnel) : Sp�cifie un <literal>ClassPersister</literal> particulier. + <literal>persister</literal> (optionnel) : Spécifie un <literal>ClassPersister</literal> particulier. </para> </callout> <callout arearefs="class14"> <para> - <literal>batch-size</literal> (optionnel, par d�faut = <literal>1</literal>) : sp�cifie une taille de batch - pour remplir les instances de cette classe par identifiant en une seule requ�te. + <literal>batch-size</literal> (optionnel, par défaut = <literal>1</literal>) : spécifie une taille de batch + pour remplir les instances de cette classe par identifiant en une seule requête. </para> </callout> <callout arearefs="class15"> <para> - <literal>optimistic-lock</literal> (optionnel, par d�faut = <literal>version</literal>) : - D�termine la strat�gie de verrou optimiste. + <literal>optimistic-lock</literal> (optionnel, par défaut = <literal>version</literal>) : + Détermine la stratégie de verrou optimiste. </para> </callout> <callout arearefs="class16"> <para> - <literal>lazy</literal> (optionnel) : D�clarer <literal>lazy="true"</literal> est un raccourci - pour sp�cifier le nom de la classe comme �tant l'interface <literal>proxy</literal>. + <literal>lazy</literal> (optionnel) : Déclarer <literal>lazy="true"</literal> est un raccourci + pour spécifier le nom de la classe comme étant l'interface <literal>proxy</literal>. </para> </callout> <callout arearefs="class17"> <para> - <literal>entity-name</literal> (optionnel) : Hibernate3 permet � une classe d'�tre - mapp�e plusieurs fois (potentiellement � plusieurs tables), et permet aux mappings d'entit� d'�tre - repr�sent�s par des Maps ou du XML au niveau Java. Dans ces cas, vous devez indiquer un nom explicite arbitraire pour - les entit�s. Voir <xref linkend="persistent-classes-dynamicmodels"/> et <xref linkend="xml"/> + <literal>entity-name</literal> (optionnel) : Hibernate3 permet à une classe d'être + mappée plusieurs fois (potentiellement à plusieurs tables), et permet aux mappings d'entité d'être + représentés par des Maps ou du XML au niveau Java. Dans ces cas, vous devez indiquer un nom explicite arbitraire pour + les entités. Voir <xref linkend="persistent-classes-dynamicmodels"/> et <xref linkend="xml"/> pour plus d'informations. </para> </callout> @@ -363,112 +365,112 @@ </callout> <callout arearefs="class19"> <para> - <literal>check</literal> (optionnel) : expression SQL utilis�e pour g�n�rer une contrainte - de v�rification multi-lignes pour la g�n�ration automatique de sch�ma. + <literal>check</literal> (optionnel) : expression SQL utilisée pour générer une contrainte + de vérification multi-lignes pour la génération automatique de schéma. </para> </callout> <callout arearefs="class20"> <para> <literal>rowid</literal> (optionnel) : Hibernate peut utiliser des ROWID sur les bases de - donn�es qui utilisent ce m�canisme. Par exemple avec Oracle, Hibernate peut utiliser la colonne additionnelle - <literal>rowid</literal> pour des mises � jour rapides si cette option vaut <literal>rowid</literal>. Un ROWID repr�sente - la localisation physique d'un tuple enregistr�. + données qui utilisent ce mécanisme. Par exemple avec Oracle, Hibernate peut utiliser la colonne additionnelle + <literal>rowid</literal> pour des mises à jour rapides si cette option vaut <literal>rowid</literal>. Un ROWID représente + la localisation physique d'un tuple enregistré. </para> </callout> <callout arearefs="class21"> <para> - <literal>subselect</literal> (optionnel) : Permet de mapper une entit� immuable en lecture-seule - sur un sous-select de base de donn�es. Utile pour avoir une vue au lieu d'une table en base, mais � �viter. Voir plus bas + <literal>subselect</literal> (optionnel) : Permet de mapper une entité immuable en lecture-seule + sur un sous-select de base de données. Utile pour avoir une vue au lieu d'une table en base, mais à éviter. Voir plus bas pour plus d'information. </para> </callout> <callout arearefs="class22"> <para> - <literal>abstract</literal> (optionnel) : Utilis� pour marquer des superclasses abstraites dans - des hi�rarchies de <literal>&lt;union-subclass&gt;</literal>. + <literal>abstract</literal> (optionnel) : Utilisé pour marquer des superclasses abstraites dans + des hiérarchies de <literal>&lt;union-subclass&gt;</literal>. </para> </callout> </calloutlist> </programlistingco> <para> - Il est tout � fait possible d'utiliser une interface comme nom - de classe persistante. Vous devez alors d�clarer les classes impl�mentant - cette interface en utilisant l'�l�ment <literal>&lt;subclass&gt;</literal>. + Il est tout à fait possible d'utiliser une interface comme nom + de classe persistante. Vous devez alors déclarer les classes implémentant + cette interface en utilisant l'élément <literal>&lt;subclass&gt;</literal>. Vous pouvez faire persister toute classe interne <emphasis>static</emphasis>. - Vous devez alors sp�cifier le nom de la classe par la notation habituelle - des classes internes c'est � dire <literal>eg.Foo$Bar</literal>. + Vous devez alors spécifier le nom de la classe par la notation habituelle + des classes internes c'est à dire <literal>eg.Foo$Bar</literal>. </para> <para> Les classes immuables, <literal>mutable="false"</literal>, ne peuvent - pas �tre modifi�es ou supprim�es par l'application. Cela permet - � Hibernate de faire quelques optimisations mineures sur les performances. + pas être modifiées ou supprimées par l'application. Cela permet + à Hibernate de faire quelques optimisations mineures sur les performances. </para> <para> L'attribut optionnnel <literal>proxy</literal> permet les intialisations - diff�r�es des instances persistantes de la classe. Hibernate retournera - initialement des proxies CGLIB qui impl�mentent l'interface nomm�e. - Le v�ritable objet persistant ne sera charg� que lorsque une m�thode du proxy - sera appel�e. Voir plus bas le paragraphe abordant les proxies et le chargement diff�r� (lazy initialization). + différées des instances persistantes de la classe. Hibernate retournera + initialement des proxies CGLIB qui implémentent l'interface nommée. + Le véritable objet persistant ne sera chargé que lorsque une méthode du proxy + sera appelée. Voir plus bas le paragraphe abordant les proxies et le chargement différé (lazy initialization). </para> <para> Le polymorphisme <emphasis>implicite</emphasis> - signifie que les instances de la classe seront retourn�es par une - requ�te qui utilise les noms de la classe ou de chacune de ses - superclasses ou encore des interfaces impl�ment�es par cette classe - ou ses superclasses. Les instances des classes filles seront retourn�es - par une requ�te qui utilise le nom de la classe elle m�me. Le polymorphisme + signifie que les instances de la classe seront retournées par une + requête qui utilise les noms de la classe ou de chacune de ses + superclasses ou encore des interfaces implémentées par cette classe + ou ses superclasses. Les instances des classes filles seront retournées + par une requête qui utilise le nom de la classe elle même. Le polymorphisme <emphasis>explicite</emphasis> signifie que les instances de la classe - ne seront retourn�es que par une requ�te qui utilise explicitement - son nom et que seules les instances des classes filles d�clar�es dans les �l�ments + ne seront retournées que par une requête qui utilise explicitement + son nom et que seules les instances des classes filles déclarées dans les éléments <literal>&lt;subclass&gt;</literal> ou <literal>&lt;joined-subclass&gt;</literal> - seront retourn�es. Dans la majorit�s des cas la valeur par d�faut, + seront retournées. Dans la majorités des cas la valeur par défaut, <literal>polymorphism="implicit"</literal>, - est appropri�e. Le polymorphisme explicite est utile lorsque deux - classes diff�rentes sont mapp�es � la m�me table (ceci permet d'�crire - une classe "l�g�re" qui ne contient qu'une partie des colonnes de + est appropriée. Le polymorphisme explicite est utile lorsque deux + classes différentes sont mappées à la même table (ceci permet d'écrire + une classe "légère" qui ne contient qu'une partie des colonnes de la table - voir la partie design pattern du site communautaire). </para> <para> L'attribut <literal>persister</literal> vous permet de customiser - la strat�gie utilis�e pour la classe. Vous pouvez, par exemple, sp�cifier + la stratégie utilisée pour la classe. Vous pouvez, par exemple, spécifier votre propre sous-classe de <literal>org.hibernate.persister.EntityPersister</literal> ou - vous pourriez aussi cr�er une nouvelle impl�mentation de l'interface <literal>org.hibernate.persister.ClassPersister</literal> - qui proposerait une persistance via, par exemple, des appels de proc�dures - stock�es, de la s�rialisation vers des fichiers plats ou un annuaire LDAP. + vous pourriez aussi créer une nouvelle implémentation de l'interface <literal>org.hibernate.persister.ClassPersister</literal> + qui proposerait une persistance via, par exemple, des appels de procédures + stockées, de la sérialisation vers des fichiers plats ou un annuaire LDAP. Voir <literal>org.hibernate.test.CustomPersister</literal> pour un exemple simple (d'une "persistance" vers une <literal>Hashtable</literal>). </para> <para> - Notez que les param�tres <literal>dynamic-update</literal> et <literal>dynamic-insert</literal> - ne sont pas h�rit�s par les sous-classes et peuvent donc �tre sp�cifi�s - pour les �l�ments <literal>&lt;subclass&gt;</literal> ou <literal>&lt;joined-subclass&gt;</literal> - Ces param�tres peuvent am�liorer les performances dans certains cas, + Notez que les paramètres <literal>dynamic-update</literal> et <literal>dynamic-insert</literal> + ne sont pas hérités par les sous-classes et peuvent donc être spécifiés + pour les éléments <literal>&lt;subclass&gt;</literal> ou <literal>&lt;joined-subclass&gt;</literal> + Ces paramètres peuvent améliorer les performances dans certains cas, mais peuvent aussi les amoindrir. A utiliser en connaissance de causes. </para> <para> - L'utilisation de <literal>select-before-update</literal> va g�n�ralement - faire baisser les performances. Ce param�tre est pratique - pour pr�venir l'appel inutile d'un trigger sur modification quand on - r�attache un graphe d'instances � une <literal>Session</literal>. + L'utilisation de <literal>select-before-update</literal> va généralement + faire baisser les performances. Ce paramètre est pratique + pour prévenir l'appel inutile d'un trigger sur modification quand on + réattache un graphe d'instances à une <literal>Session</literal>. </para> <para> - Si vous utilisez le <literal>dynamic-update</literal>, les diff�rentes - strat�gies de verrouillage optimiste (optimistic locking) sont les suivantes: + Si vous utilisez le <literal>dynamic-update</literal>, les différentes + stratégies de verrouillage optimiste (optimistic locking) sont les suivantes: </para> <itemizedlist> <listitem> <para> - <literal>version</literal> v�rifie les colonnes version/timestamp + <literal>version</literal> vérifie les colonnes version/timestamp </para> </listitem> <listitem> <para> - <literal>all</literal> v�rifie toutes les colonnes + <literal>all</literal> vérifie toutes les colonnes </para> </listitem> <listitem> <para> - <literal>dirty</literal> v�rifie les colonnes modifi�es, permettant des updates concurrents + <literal>dirty</literal> vérifie les colonnes modifiées, permettant des updates concurrents </para> </listitem> <listitem> @@ -478,20 +480,20 @@ </listitem> </itemizedlist> <para> - Nous encourageons <emphasis>tr�s</emphasis> fortement l'utilisation + Nous encourageons <emphasis>très</emphasis> fortement l'utilisation de colonnes de version/timestamp pour le verrouillage optimiste - avec Hibernate. C'est la meilleure strat�gie en regard des performances - et la seule qui g�re correctement les modifications sur les objets d�tach�s - (c'est � dire lorsqu'on utilise <literal>Session.merge()</literal>). + avec Hibernate. C'est la meilleure stratégie en regard des performances + et la seule qui gère correctement les modifications sur les objets détachés + (c'est à dire lorsqu'on utilise <literal>Session.merge()</literal>). </para> <para> - Il n'y a pas de diff�rence entre table et vue pour le mapping Hibernate, - tant que c'est transparent au niveau base de donn�es (remarquez + Il n'y a pas de différence entre table et vue pour le mapping Hibernate, + tant que c'est transparent au niveau base de données (remarquez que certaines BDD ne supportent pas les vues correctement, notamment - pour les updates). Vous rencontrerez peut-�tre des cas o� vous - souhaitez utiliser une vue mais ne pouvez pas en cr�er sur votre BDD - (par exemple � cause de sch�mas anciens et fig�s). Dans ces cas, - vous pouvez mapper une entit� immuable en lecture seule sur un sous-select SQL donn�: + pour les updates). Vous rencontrerez peut-être des cas où vous + souhaitez utiliser une vue mais ne pouvez pas en créer sur votre BDD + (par exemple à cause de schémas anciens et figés). Dans ces cas, + vous pouvez mapper une entité immuable en lecture seule sur un sous-select SQL donné: </para> <programlisting><![CDATA[<class name="Summary"> <subselect> @@ -506,22 +508,22 @@ ... </class>]]></programlisting> <para> - D�clarez les tables � synchroniser avec cette entit� pour assurer + Déclarez les tables à synchroniser avec cette entité pour assurer que le flush automatique se produise correctement, - et pour que les requ�tes sur l'entit� d�riv�e ne renvoient pas des donn�es p�rim�es. - Le lit�ral <literal>&lt;subselect&gt;</literal> est disponible - comme attribut ou comme �l�ment de mapping. + et pour que les requêtes sur l'entité dérivée ne renvoient pas des données périmées. + Le litéral <literal>&lt;subselect&gt;</literal> est disponible + comme attribut ou comme élément de mapping. </para> </sect2> <sect2 id="mapping-declaration-id" revision="4"> <title>id</title> <para> - Les classes mapp�es <emphasis>doivent</emphasis> d�clarer la - clef primaire de la table en base de donn�es. - La plupart des classes auront aussi une propri�t� de type - javabean pr�sentant l'identifiant unique d'une instance. - L'�l�ment <literal>&lt;id&gt;</literal> sert � d�finir le - mapping entre cette propri�t� et la clef primaire en base. + Les classes mappées <emphasis>doivent</emphasis> déclarer la + clef primaire de la table en base de données. + La plupart des classes auront aussi une propriété de type + javabean présentant l'identifiant unique d'une instance. + L'élément <literal>&lt;id&gt;</literal> sert à définir le + mapping entre cette propriété et la clef primaire en base. </para> <programlistingco> <areaspec> @@ -543,7 +545,7 @@ <calloutlist> <callout arearefs="id1"> <para> - <literal>name</literal> (optionnel) : Nom de la propri�t� qui sert d'identifiant. + <literal>name</literal> (optionnel) : Nom de la propriété qui sert d'identifiant. </para> </callout> <callout arearefs="id2"> @@ -553,44 +555,44 @@ </callout> <callout arearefs="id3"> <para> - <literal>column</literal> (optionnel - le nom de la propri�t� est pris par d�faut) : Nom de la clef primaire. + <literal>column</literal> (optionnel - le nom de la propriété est pris par défaut) : Nom de la clef primaire. </para> </callout> <callout arearefs="id4"> <para> - <literal>unsaved-value</literal> (optionnel - par d�faut une valeur "bien choisie") : - Une valeur de la propri�t� d'identifiant qui indique que l'instance est nouvellement - instanci�e (non sauvegard�e), et qui la distingue des instances <literal>transient</literal>s qui ont - �t� sauvegard�es ou charg�es dans une session pr�c�dente. + <literal>unsaved-value</literal> (optionnel - par défaut une valeur "bien choisie") : + Une valeur de la propriété d'identifiant qui indique que l'instance est nouvellement + instanciée (non sauvegardée), et qui la distingue des instances <literal>transient</literal>s qui ont + été sauvegardées ou chargées dans une session précédente. </para> </callout> <callout arearefs="id5"> <para> - <literal>access</literal> (optionnel - par d�faut <literal>property</literal>) : La strat�gie que doit utiliser Hibernate - pour acc�der aux valeurs des propri�t�s. + <literal>access</literal> (optionnel - par défaut <literal>property</literal>) : La stratégie que doit utiliser Hibernate + pour accéder aux valeurs des propriétés. </para> </callout> </calloutlist> </programlistingco> <para> - Si l'attribut <literal>name</literal> est absent, Hibernate consid�re que la classe ne poss�de pas de propri�t� identifiant. + Si l'attribut <literal>name</literal> est absent, Hibernate considère que la classe ne possède pas de propriété identifiant. </para> <para> L'attribut <literal>unsaved-value</literal> est important ! Si - l'identifiant de votre classe n'a pas une valeur par d�faut compatible avec - le comportement standard de Java (z�ro ou null), vous devez alors pr�ciser la valeur par d�faut. + l'identifiant de votre classe n'a pas une valeur par défaut compatible avec + le comportement standard de Java (zéro ou null), vous devez alors préciser la valeur par défaut. </para> <para> - La d�claration alternative <literal>&lt;composite-id&gt;</literal> - permet l'accc�s aux donn�es d'anciens syst�mes qui utilisent des - clefs compos�es. Son utilisation est fortement d�conseill�e pour d'autres cas. + La déclaration alternative <literal>&lt;composite-id&gt;</literal> + permet l'acccès aux données d'anciens systèmes qui utilisent des + clefs composées. Son utilisation est fortement déconseillée pour d'autres cas. </para> <sect3 id="mapping-declaration-id-generator" revision="2"> <title>Generator</title> <para> - L'�l�ment fils <literal>&lt;generator&gt;</literal> nomme une classe Java utilis�e pour g�n�rer - les identifiants uniques pour les instances des classes persistantes. Si des param�tres sont requis - pour configurer ou initialiser l'instance du g�n�rateur, ils sont pass�s en utilisant l'�l�ment <literal>&lt;param&gt;</literal>. + L'élément fils <literal>&lt;generator&gt;</literal> nomme une classe Java utilisée pour générer + les identifiants uniques pour les instances des classes persistantes. Si des paramètres sont requis + pour configurer ou initialiser l'instance du générateur, ils sont passés en utilisant l'élément <literal>&lt;param&gt;</literal>. </para> <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> <generator class="org.hibernate.id.TableHiLoGenerator"> @@ -599,9 +601,9 @@ </generator> </id>]]></programlisting> <para> - Tous les g�n�rateurs doivent impl�menter l'interface <literal>org.hibernate.id.IdentifierGenerator</literal>. - C'est une interface tr�s simple ; certaines applications peuvent proposer leur propre impl�mentations sp�cialis�es. - Cependant, Hibernate propose une s�rie d'impl�mentations int�gr�es. Il existe des noms raccourcis pour les g�n�rateurs int�gr�s : + Tous les générateurs doivent implémenter l'interface <literal>org.hibernate.id.IdentifierGenerator</literal>. + C'est une interface très simple ; certaines applications peuvent proposer leur propre implémentations spécialisées. + Cependant, Hibernate propose une série d'implémentations intégrées. Il existe des noms raccourcis pour les générateurs intégrés : <variablelist> <varlistentry> <term> @@ -609,9 +611,9 @@ </term> <listitem> <para> - G�n�re des identifiants de type <literal>long</literal>, <literal>short</literal> ou - <literal>int</literal> qui ne sont uniques que si aucun autre processus n'ins�re de donn�es dans la m�me table. - <emphasis>Ne pas utiliser en environnement clusteris�.</emphasis> + Génère des identifiants de type <literal>long</literal>, <literal>short</literal> ou + <literal>int</literal> qui ne sont uniques que si aucun autre processus n'insère de données dans la même table. + <emphasis>Ne pas utiliser en environnement clusterisé.</emphasis> </para> </listitem> </varlistentry> @@ -622,7 +624,7 @@ <listitem> <para> Utilisation de la colonne identity de DB2, MySQL, MS SQL Server, Sybase et - HypersonicSQL. L'identifiant renvoy� est de type <literal>long</literal>, + HypersonicSQL. L'identifiant renvoyé est de type <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>. </para> </listitem> @@ -633,8 +635,8 @@ </term> <listitem> <para> - Utilisation des s�quences dans DB2, PostgreSQL, Oracle, SAP DB, McKoi ou d'un g�n�rateur dans Interbase. - L'identifiant renvoy� est de type <literal>long</literal>, + Utilisation des séquences dans DB2, PostgreSQL, Oracle, SAP DB, McKoi ou d'un générateur dans Interbase. + L'identifiant renvoyé est de type <literal>long</literal>, <literal>short</literal> ou <literal>int</literal> </para> </listitem> @@ -645,12 +647,12 @@ </term> <listitem> <para id="mapping-declaration-id-hilodescription" revision="1"> - Utilise un algorithme hi/lo pour g�n�rer de fa�on efficace des identifiants de type + Utilise un algorithme hi/lo pour générer de façon efficace des identifiants de type <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>, - en prenant comme source de valeur "hi" une table et une colonne (par d�faut + en prenant comme source de valeur "hi" une table et une colonne (par défaut <literal>hibernate_unique_key</literal> et - <literal>next_hi</literal> respectivement). L'algorithme hi/lo g�n�re des identifiants uniques - pour une base de donn�es particuli�re seulement. + <literal>next_hi</literal> respectivement). L'algorithme hi/lo génère des identifiants uniques + pour une base de données particulière seulement. </para> </listitem> </varlistentry> @@ -660,8 +662,8 @@ </term> <listitem> <para> - Utilise un algorithme hi/lo pour g�n�rer efficacement des identifiants de type <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>, - �tant donn� un nom de s�quence en base. + Utilise un algorithme hi/lo pour générer efficacement des identifiants de type <literal>long</literal>, <literal>short</literal> ou <literal>int</literal>, + étant donné un nom de séquence en base. </para> </listitem> </varlistentry> @@ -671,9 +673,9 @@ </term> <listitem> <para> - Utilise un algorithme de type UUID 128 bits pour g�n�rer des identifiants de - type string, unique au sein d'un r�seau (l'adresse IP est utilis�e). - Le UUID en cod� en une cha�ne de nombre h�xad�cimaux de longueur 32. + Utilise un algorithme de type UUID 128 bits pour générer des identifiants de + type string, unique au sein d'un réseau (l'adresse IP est utilisée). + Le UUID en codé en une chaîne de nombre héxadécimaux de longueur 32. </para> </listitem> </varlistentry> @@ -683,7 +685,7 @@ </term> <listitem> <para> - Utilise une cha�ne GUID g�n�r�e par la base pour MS SQL Server et MySQL. + Utilise une chaîne GUID générée par la base pour MS SQL Server et MySQL. </para> </listitem> </varlistentry> @@ -694,7 +696,7 @@ <listitem> <para> Choisit <literal>identity</literal>, <literal>sequence</literal> ou - <literal>hilo</literal> selon les possibilit�s offertes par la base de donn�es sous-jacente. + <literal>hilo</literal> selon les possibilités offertes par la base de données sous-jacente. </para> </listitem> </varlistentry> @@ -704,9 +706,9 @@ </term> <listitem> <para> - Laisse l'application affecter un identifiant � l'objet avant que la m�tode - <literal>save()</literal> soit appel�e. Il s'agit de la strat�gie par d�faut - si aucun <literal>&lt;generator&gt;</literal> n'est sp�cifi�. + Laisse l'application affecter un identifiant à l'objet avant que la métode + <literal>save()</literal> soit appelée. Il s'agit de la stratégie par défaut + si aucun <literal>&lt;generator&gt;</literal> n'est spécifié. </para> </listitem> </varlistentry> @@ -716,7 +718,7 @@ </term> <listitem> <para> - R�cup�re une clef primaire assign�e par un trigger en s�lectionnant + Récupère une clef primaire assignée par un trigger en sélectionnant la ligne par une clef unique quelconque. </para> </listitem> @@ -727,7 +729,7 @@ </term> <listitem> <para> - Utilise l'identifiant d'un objet associ�. Habituellement utilis� en conjonction + Utilise l'identifiant d'un objet associé. Habituellement utilisé en conjonction avec une association <literal>&lt;one-to-one&gt;</literal> sur la clef primaire. </para> </listitem> @@ -738,10 +740,10 @@ <sect3 id="mapping-declaration-id-hilo" revision="1"> <title>algorithme Hi/lo</title> <para> - Les g�n�rateurs <literal>hilo</literal> et <literal>seqhilo</literal> proposent deux impl�mentations - alternatives de l'algorithme hi/lo, une approche largement utilis�e pour g�n�rer des identifiants. La - premi�re impl�mentation n�cessite une table "sp�ciale" en base pour h�berger la prochaine valeur "hi" disponible. - La seconde utilise une s�quence de type Oracle (quand la base sous-jacente le propose). + Les générateurs <literal>hilo</literal> et <literal>seqhilo</literal> proposent deux implémentations + alternatives de l'algorithme hi/lo, une approche largement utilisée pour générer des identifiants. La + première implémentation nécessite une table "spéciale" en base pour héberger la prochaine valeur "hi" disponible. + La seconde utilise une séquence de type Oracle (quand la base sous-jacente le propose). </para> <programlisting><![CDATA[<id name="id" type="long" column="cat_id"> <generator class="hilo"> @@ -758,7 +760,7 @@ </id>]]></programlisting> <para> Malheureusement, vous ne pouvez pas utilisez <literal>hilo</literal> quand vous apportez - votre propre <literal>Connection</literal> � Hibernate. Quand Hibernate utilise une datasource du serveur + votre propre <literal>Connection</literal> à Hibernate. Quand Hibernate utilise une datasource du serveur d'application pour obtenir des connexions inscrites avec JTA, vous devez correctement configurer <literal>hibernate.transaction.manager_lookup_class</literal>. </para> @@ -766,19 +768,19 @@ <sect3 id="mapping-declaration-id-uuid"> <title>UUID algorithm</title> <para> - Le contenu du UUID est : adresse IP, date de d�marrage de la JVM (pr�cis au quart de seconde), - l'heure syst�me et un compteur (unique au sein de la JVM). Il n'est pas possible d'obtenir l'adresse - MAC ou une adresse m�moire � partir de Java, c'est donc le mieux que l'on puisse faire sans utiliser JNI. + Le contenu du UUID est : adresse IP, date de démarrage de la JVM (précis au quart de seconde), + l'heure système et un compteur (unique au sein de la JVM). Il n'est pas possible d'obtenir l'adresse + MAC ou une adresse mémoire à partir de Java, c'est donc le mieux que l'on puisse faire sans utiliser JNI. </para> </sect3> <sect3 id="mapping-declaration-id-sequences"> - <title>Colonnes identifiantes et s�quences</title> + <title>Colonnes identifiantes et séquences</title> <para> - Pour les bases qui impl�mentent les colonnes "identit�" (DB2, MySQL, Sybase, MS SQL), - vous pouvez utiliser la g�n�ration de clef par <literal>identity</literal>. - Pour les bases qui impl�mentent les s�quences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) - vous pouvez utiliser la g�n�ration de clef par <literal>sequence</literal>. Ces deux m�thodes n�cessitent - deux requ�tes SQL pour ins�rer un objet. + Pour les bases qui implémentent les colonnes "identité" (DB2, MySQL, Sybase, MS SQL), + vous pouvez utiliser la génération de clef par <literal>identity</literal>. + Pour les bases qui implémentent les séquences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) + vous pouvez utiliser la génération de clef par <literal>sequence</literal>. Ces deux méthodes nécessitent + deux requêtes SQL pour insérer un objet. </para> <programlisting><![CDATA[<id name="id" type="long" column="person_id"> <generator class="sequence"> @@ -788,32 +790,32 @@ <programlisting><![CDATA[<id name="id" type="long" column="person_id" unsaved-value="0"> <generator class="identity"/> </id>]]></programlisting> - <para>Pour le d�veloppement multi-plateformes, la strat�gie <literal>native</literal> choisira - entre les m�thodes <literal>identity</literal>, <literal>sequence</literal> et - <literal>hilo</literal>, selon les possibilit�s offertes par la base sous-jacente. + <para>Pour le développement multi-plateformes, la stratégie <literal>native</literal> choisira + entre les méthodes <literal>identity</literal>, <literal>sequence</literal> et + <literal>hilo</literal>, selon les possibilités offertes par la base sous-jacente. </para> </sect3> <sect3 id="mapping-declaration-id-assigned"> - <title>Identifiants assign�s</title> + <title>Identifiants assignés</title> <para> Si vous souhaitez que l'application assigne des identifiants (par opposition - � la g�n�ration par Hibernate), vous pouvez utiliser le g�n�rateur <literal>assigned</literal>. - Ce g�n�rateur sp�cial utilisera une valeur d'identifiant d�j� utilis� par la propri�t� identifiant l'objet. - Ce g�n�rateur est utilis� quand la clef primaire est une clef naturelle plut�t qu'une clef secondaire. - C'est le comportement par d�faut si vous ne pr�cisez pas d'�l�ment <literal>&lt;generator&gt;</literal>. + à la génération par Hibernate), vous pouvez utiliser le générateur <literal>assigned</literal>. + Ce générateur spécial utilisera une valeur d'identifiant déjà utilisé par la propriété identifiant l'objet. + Ce générateur est utilisé quand la clef primaire est une clef naturelle plutôt qu'une clef secondaire. + C'est le comportement par défaut si vous ne précisez pas d'élément <literal>&lt;generator&gt;</literal>. </para> <para> - Choisir le g�n�rateur <literal>assigned</literal> fait utiliser - <literal>unsaved-value="undefined"</literal> par Hibernate, le for�ant � interroger - la base pour d�terminer si l'instance est transiente ou d�tach�e, � moins d'utiliser - une propri�t� version ou timestamp, ou alors de d�finir + Choisir le générateur <literal>assigned</literal> fait utiliser + <literal>unsaved-value="undefined"</literal> par Hibernate, le forçant à interroger + la base pour déterminer si l'instance est transiente ou détachée, à moins d'utiliser + une propriété version ou timestamp, ou alors de définir <literal>Interceptor.isUnsaved()</literal>. </para> </sect3> <sect3 id="mapping-declaration-id-select"> - <title>Clefs primaires assign�es par trigger</title> + <title>Clefs primaires assignées par trigger</title> <para> - Pour les sch�mas de base h�rit�s d'anciens syst�mes uniquement (Hibernate ne g�n�re pas de DDL avec des triggers) + Pour les schémas de base hérités d'anciens systèmes uniquement (Hibernate ne génère pas de DDL avec des triggers) </para> <programlisting><![CDATA[<id name="id" type="long" column="person_id"> <generator class="select"> @@ -822,8 +824,8 @@ </id>]]></programlisting> <para> Dans l'exemple ci-dessus, <literal>socialSecurityNumber</literal> a une - valeur unique d�finie par la classe en tant que clef naturelle et <literal>person_id</literal> - est une clef secondaire dont la valeur est g�n�r�e par trigger. + valeur unique définie par la classe en tant que clef naturelle et <literal>person_id</literal> + est une clef secondaire dont la valeur est générée par trigger. </para> </sect3> </sect2> @@ -841,9 +843,9 @@ ...... </composite-id>]]></programlisting> <para> - Pour une table avec clef compos�e, vous pouvez mapper plusieurs attributs de la classe - comme propri�t�s identifiantes. L'�lement <literal>&lt;composite-id&gt;</literal> accepte - les mappings de propri�t�s <literal>&lt;key-property&gt;</literal> et les mappings + Pour une table avec clef composée, vous pouvez mapper plusieurs attributs de la classe + comme propriétés identifiantes. L'élement <literal>&lt;composite-id&gt;</literal> accepte + les mappings de propriétés <literal>&lt;key-property&gt;</literal> et les mappings <literal>&lt;key-many-to-one&gt;</literal> comme fils. </para> <programlisting><![CDATA[<composite-id> @@ -851,23 +853,23 @@ <key-property name="dependent"/> </composite-id>]]></programlisting> <para> - Vos classes persistantes <emphasis>doivent</emphasis> surcharger les m�thodes <literal>equals()</literal> - et <literal>hashCode()</literal> pour impl�menter l'�galit� d'identifiant compos�. Elles doivent aussi + Vos classes persistantes <emphasis>doivent</emphasis> surcharger les méthodes <literal>equals()</literal> + et <literal>hashCode()</literal> pour implémenter l'égalité d'identifiant composé. Elles doivent aussi implenter l'interface <literal>Serializable</literal>. </para> <para> - Malheureusement cette approche sur les identifiants compos�s signifie qu'un objet persistant - est son propre identifiant. Il n'y a pas d'autre moyen pratique de manipuler l'objet que par l'objet lui-m�me. - Vous devez instancier une instance de la classe persistante elle-m�me et peupler ses attributs identifiants - avant de pouvoir appeler la m�thode <literal>load()</literal> pour charger son �tat persistant associ� - � une clef compos�e. Nous appelons cette approche "identifiant compos� <emphasis>embarqu�</emphasis>" + Malheureusement cette approche sur les identifiants composés signifie qu'un objet persistant + est son propre identifiant. Il n'y a pas d'autre moyen pratique de manipuler l'objet que par l'objet lui-même. + Vous devez instancier une instance de la classe persistante elle-même et peupler ses attributs identifiants + avant de pouvoir appeler la méthode <literal>load()</literal> pour charger son état persistant associé + à une clef composée. Nous appelons cette approche "identifiant composé <emphasis>embarqué</emphasis>" et ne la recommandons pas pour des applications complexes. </para> <para> - Une seconde approche, appel�e identifiant compos� <emphasis>mapp�</emphasis>, - consiste � encapsuler les propri�t�s identifiantes (celles contenues dans <literal>&lt;composite-id&gt;</literal>) - dans une classe particuli�re. + Une seconde approche, appelée identifiant composé <emphasis>mappé</emphasis>, + consiste à encapsuler les propriétés identifiantes (celles contenues dans <literal>&lt;composite-id&gt;</literal>) + dans une classe particulière. </para> <programlisting><![CDATA[<composite-id class="MedicareId" mapped="true"> @@ -876,71 +878,71 @@ </composite-id>]]></programlisting> <para> - Dans cet exemple, la classe d'identifiant compos�e,<literal>MedicareId</literal> et la classe mapp�e elle-m�me, - poss�dent les propri�t�s <literal>medicareNumber</literal> - et <literal>dependent</literal>. La classe identifiante doit red�finir - <literal>equals()</literal> et <literal>hashCode()</literal> et impl�menter - <literal>Serializable</literal>. Le d�savantage de cette approche est la + Dans cet exemple, la classe d'identifiant composée,<literal>MedicareId</literal> et la classe mappée elle-même, + possèdent les propriétés <literal>medicareNumber</literal> + et <literal>dependent</literal>. La classe identifiante doit redéfinir + <literal>equals()</literal> et <literal>hashCode()</literal> et implémenter + <literal>Serializable</literal>. Le désavantage de cette approche est la duplication du code. </para> <para> - Les attributs suivants servent � configurer un identifiant compos� mapp� : + Les attributs suivants servent à configurer un identifiant composé mappé : </para> <itemizedlist spacing="compact"> <listitem> <para> - <literal>mapped</literal> (optionnel, d�faut � <literal>false</literal>) : - indique qu'un identifiant compos� mapp� est utilis�, et que les propri�t�s - contenues font r�f�rence aux deux classes (celle mapp�e et la classe identifiante). + <literal>mapped</literal> (optionnel, défaut à <literal>false</literal>) : + indique qu'un identifiant composé mappé est utilisé, et que les propriétés + contenues font référence aux deux classes (celle mappée et la classe identifiante). </para> </listitem> <listitem> <para> - <literal>class</literal> (optionnel, mais requis pour un identifiant compos� mapp�) : - La classe composant utilis�e comme identifiant compos�. + <literal>class</literal> (optionnel, mais requis pour un identifiant composé mappé) : + La classe composant utilisée comme identifiant composé. </para> </listitem> </itemizedlist> <para> - Nous d�crirons une troisi�me approche beaucoup plus efficace ou l'identifiant compos� - est impl�ment� comme une classe composant dans <xref linkend="components-compositeid"/>. - Les attributs d�crits ci dessous, ne s'appliquent que pour cette derni�re approche : + Nous décrirons une troisième approche beaucoup plus efficace ou l'identifiant composé + est implémenté comme une classe composant dans <xref linkend="components-compositeid"/>. + Les attributs décrits ci dessous, ne s'appliquent que pour cette dernière approche : </para> <itemizedlist spacing="compact"> <listitem> <para> - <literal>name</literal> (optionnel, requis pour cette approche) : une propri�t� de type - composant qui contient l'identifiant compos� (voir chapitre 9). + <literal>name</literal> (optionnel, requis pour cette approche) : une propriété de type + composant qui contient l'identifiant composé (voir chapitre 9). </para> </listitem> <listitem> <para> - <literal>access</literal> (optionnel - d�faut � <literal>property</literal>) : - La strat�gie qu'Hibernate utilisera pour acc�der � la valeur de la propri�t�. + <literal>access</literal> (optionnel - défaut à <literal>property</literal>) : + La stratégie qu'Hibernate utilisera pour accéder à la valeur de la propriété. </para> </listitem> <listitem> <para> - <literal>class</literal> (optionnel - d�faut au type de la propri�t� d�termin� par r�flexion) : - La classe composant utilis�e comme identifiant (voir prochaine section). + <literal>class</literal> (optionnel - défaut au type de la propriété déterminé par réflexion) : + La classe composant utilisée comme identifiant (voir prochaine section). </para> </listitem> </itemizedlist> <para> - Cette derni�re approche est celle que nous recommandons pour toutes vos applications. + Cette dernière approche est celle que nous recommandons pour toutes vos applications. </para> </sect2> <sect2 id="mapping-declaration-discriminator" revision="3"> <title>discriminator</title> <para> - L'�l�ment <literal>&lt;discriminator&gt;</literal> est n�cessaire pour la persistance polymorphique - qui utilise la strat�gie de mapping de table par hi�rarchie de classe. La colonne discriminante contient - une valeur marqueur qui permet � la couche de persistance de savoir quelle - sous-classe instancier pour une ligne particuli�re de table en base. Un nombre restreint de types - peuvent �tre utilis�s : + L'élément <literal>&lt;discriminator&gt;</literal> est nécessaire pour la persistance polymorphique + qui utilise la stratégie de mapping de table par hiérarchie de classe. La colonne discriminante contient + une valeur marqueur qui permet à la couche de persistance de savoir quelle + sous-classe instancier pour une ligne particulière de table en base. Un nombre restreint de types + peuvent être utilisés : <literal>string</literal>, <literal>character</literal>, <literal>integer</literal>, <literal>byte</literal>, <literal>short</literal>, <literal>boolean</literal>, <literal>yes_no</literal>, <literal>true_false</literal>. @@ -963,51 +965,51 @@ <calloutlist> <callout arearefs="discriminator1"> <para> - <literal>column</literal> (optionnel - par d�faut � <literal>class</literal>) le + <literal>column</literal> (optionnel - par défaut à <literal>class</literal>) le nom de la colonne discriminante. </para> </callout> <callout arearefs="discriminator2"> <para> - <literal>type</literal> (optionnel - par d�faut � <literal>string</literal>) un nom + <literal>type</literal> (optionnel - par défaut à <literal>string</literal>) un nom indiquant le type Hibernate. </para> </callout> <callout arearefs="discriminator3"> <para> - <literal>force</literal> (optionnel - par d�faut � <literal>false</literal>) - "oblige" Hibernate � sp�cifier une valeur discriminante autoris�e m�me quand on r�cup�re + <literal>force</literal> (optionnel - par défaut à <literal>false</literal>) + "oblige" Hibernate à spécifier une valeur discriminante autorisée même quand on récupère toutes les instances de la classe de base. </para> </callout> <callout arearefs="discriminator4"> <para> - <literal>insert</literal> (optionnel - par d�faut � <literal>true</literal>) - � passer � <literal>false</literal> si la colonne discriminante fait aussi partie - d'un identifiant compos� mapp� (Indique � Hibernate de ne pas inclure la colonne + <literal>insert</literal> (optionnel - par défaut à <literal>true</literal>) + à passer à <literal>false</literal> si la colonne discriminante fait aussi partie + d'un identifiant composé mappé (Indique à Hibernate de ne pas inclure la colonne dans les <literal>INSERT</literal> SQL). </para> </callout> <callout arearefs="discriminator5"> <para> - <literal>formula</literal> (optionnel) une expression SQL arbitraire qui est ex�cut�e - quand un type doit �tre �valu�. Permet la discrimination bas�e sur le contenu. + <literal>formula</literal> (optionnel) une expression SQL arbitraire qui est exécutée + quand un type doit être évalué. Permet la discrimination basée sur le contenu. </para> </callout> </calloutlist> </programlistingco> <para> - Les v�ritables valeurs de la colonne discriminante sont sp�cifi�es par l'attribut - <literal>discriminator-value</literal> des �l�ments <literal>&lt;class&gt;</literal> et + Les véritables valeurs de la colonne discriminante sont spécifiées par l'attribut + <literal>discriminator-value</literal> des éléments <literal>&lt;class&gt;</literal> et <literal>&lt;subclass&gt;</literal>. </para> <para> L'attribut <literal>force</literal> n'est utile que si la table contient des lignes avec des - valeurs "extra" discriminantes qui ne sont pas mapp�es � une classe persistante. Ce ne sera g�n�ralement pas le cas. + valeurs "extra" discriminantes qui ne sont pas mappées à une classe persistante. Ce ne sera généralement pas le cas. </para> <para> - En utilisant l'attribut <literal>formula</literal> vous pouvez d�clarer une expression SQL arbitraire - qui sera utilis�e pour �valuer le type d'une ligne : + En utilisant l'attribut <literal>formula</literal> vous pouvez déclarer une expression SQL arbitraire + qui sera utilisée pour évaluer le type d'une ligne : </para> <programlisting><![CDATA[<discriminator formula="case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end" @@ -1016,8 +1018,8 @@ <sect2 id="mapping-declaration-version" revision="4"> <title>version (optionnel)</title> <para> - L'�l�ment <literal>&lt;version&gt;</literal> est optionnel et indique que la table contient - des donn�es versionn�es. C'est particuli�rement utile si vous avez l'intention d'utiliser + L'élément <literal>&lt;version&gt;</literal> est optionnel et indique que la table contient + des données versionnées. C'est particulièrement utile si vous avez l'intention d'utiliser des <emphasis>transactions longues</emphasis> (voir plus-bas). </para> <programlistingco> @@ -1043,8 +1045,8 @@ <calloutlist> <callout arearefs="version1"> <para> - <literal>column</literal> (optionnel - par d�faut �gal au nom de la propri�t�) : Le nom de la colonne - contenant le num�ro de version. + <literal>column</literal> (optionnel - par défaut égal au nom de la propriété) : Le nom de la colonne + contenant le numéro de version. </para> </callout> <callout arearefs="version2"> @@ -1054,62 +1056,62 @@ </callout> <callout arearefs="version3"> <para> - <literal>type</literal> (optionnel - par d�faut � <literal>integer</literal>) : - Le type du num�ro de version. + <literal>type</literal> (optionnel - par défaut à <literal>integer</literal>) : + Le type du numéro de version. </para> </callout> <callout arearefs="version4"> <para> - <literal>access</literal> (optionnel - par d�faut � <literal>property</literal>) : La strat�gie - � utiliser par Hibernate pour acc�der � la valeur de la propri�t�. + <literal>access</literal> (optionnel - par défaut à <literal>property</literal>) : La stratégie + à utiliser par Hibernate pour accéder à la valeur de la propriété. </para> </callout> <callout arearefs="version5"> <para> - <literal>unsaved-value</literal> (optionnel - par d�faut � <literal>undefined</literal>) : - Une valeur de la propri�t� d'identifiant qui indique que l'instance est nouvellement - instanci�e (non sauvegard�e), et qui la distingue des instances d�tach�es qui ont - �t� sauvegard�es ou charg�es dans une session pr�c�dente (<literal>undefined</literal> indique - que la valeur de l'atribut identifiant devrait �tre utilis�). + <literal>unsaved-value</literal> (optionnel - par défaut à <literal>undefined</literal>) : + Une valeur de la propriété d'identifiant qui indique que l'instance est nouvellement + instanciée (non sauvegardée), et qui la distingue des instances détachées qui ont + été sauvegardées ou chargées dans une session précédente (<literal>undefined</literal> indique + que la valeur de l'atribut identifiant devrait être utilisé). </para> </callout> <callout arearefs="version6"> <para> - <literal>generated</literal> (optional - d�faut � <literal>never</literal>) : - Indique que la valeur de la propri�t� version est g�n�r�e par la base de donn�es + <literal>generated</literal> (optional - défaut à <literal>never</literal>) : + Indique que la valeur de la propriété version est générée par la base de données cf. <xref linkend="mapping-generated">generated properties</xref>. </para> </callout> <callout arearefs="version7"> <para> - <literal>insert</literal> (optionnel - d�faut � <literal>true</literal>) : - Indique si la colonne de version doit �tre incluse dans les ordres insert. - Peut �tre � <literal>false</literal> si et seulement si la colonne de la - base de donn�es est d�finie avec une valeur par d�faut � <literal>0</literal>. + <literal>insert</literal> (optionnel - défaut à <literal>true</literal>) : + Indique si la colonne de version doit être incluse dans les ordres insert. + Peut être à <literal>false</literal> si et seulement si la colonne de la + base de données est définie avec une valeur par défaut à <literal>0</literal>. </para> </callout> </calloutlist> </programlistingco> <para> - Les num�ros de version doivent avoir les types Hibernate <literal>long</literal>, <literal>integer</literal>, + Les numéros de version doivent avoir les types Hibernate <literal>long</literal>, <literal>integer</literal>, <literal>short</literal>, <literal>timestamp</literal> ou <literal>calendar</literal>. </para> <para> - Une propri�t� de version ou un timestamp ne doit jamais �tre null pour une instance - d�tach�e, ainsi Hibernate pourra d�tecter toute instance ayant une version ou un timestamp null - comme transient, quelles que soient les strat�gies <literal>unsaved-value</literal> sp�cifi�es. - <emphasis>D�clarer un num�ro de version ou un timestamp "nullable" est un moyen pratique d'�viter - tout probl�me avec les r�attachements transitifs dans Hibernate, particuli�rement utile pour ceux qui - utilisent des identifiants assign�s ou des clefs compos�es !</emphasis> + Une propriété de version ou un timestamp ne doit jamais être null pour une instance + détachée, ainsi Hibernate pourra détecter toute instance ayant une version ou un timestamp null + comme transient, quelles que soient les stratégies <literal>unsaved-value</literal> spécifiées. + <emphasis>Déclarer un numéro de version ou un timestamp "nullable" est un moyen pratique d'éviter + tout problème avec les réattachements transitifs dans Hibernate, particulièrement utile pour ceux qui + utilisent des identifiants assignés ou des clefs composées !</emphasis> </para> </sect2> <sect2 id="mapping-declaration-timestamp" revision="3" > <title>timestamp (optionnel)</title> <para> - L'�l�ment optionnel <literal>&lt;timestamp&gt;</literal> indique que la table contient des donn�es - horodat�es (timestamp). Cela sert d'alternative � l'utilisation de num�ros de version. Les timestamps (ou horodatage) - sont par nature une impl�mentation moins fiable pour l'optimistic locking. Cependant, l'application - peut parfois utiliser l'horodatage � d'autres fins. + L'élément optionnel <literal>&lt;timestamp&gt;</literal> indique que la table contient des données + horodatées (timestamp). Cela sert d'alternative à l'utilisation de numéros de version. Les timestamps (ou horodatage) + sont par nature une implémentation moins fiable pour l'optimistic locking. Cependant, l'application + peut parfois utiliser l'horodatage à d'autres fins. </para> <programlistingco> <areaspec> @@ -1132,60 +1134,60 @@ <calloutlist> <callout arearefs="timestamp1"> <para> - <literal>column</literal> (optionnel - par d�faut � le nom de la propri�t�) : Le nom d'une colonne + <literal>column</literal> (optionnel - par défaut à le nom de la propriété) : Le nom d'une colonne contenant le timestamp. </para> </callout> <callout arearefs="timestamp2"> <para> - <literal>name</literal> : Le nom d'une propri�t� au sens JavaBean de type + <literal>name</literal> : Le nom d'une propriété au sens JavaBean de type <literal>Date</literal> ou <literal>Timestamp</literal> de la classe persistante. </para> </callout> <callout arearefs="timestamp3"> <para> - <literal>access</literal> (optionnel - par d�faut � <literal>property</literal>) : La strat�gie - � utiliser par Hibernate pour acc�der � la valeur de la propri�t�. + <literal>access</literal> (optionnel - par défaut à <literal>property</literal>) : La stratégie + à utiliser par Hibernate pour accéder à la valeur de la propriété. </para> </callout> <callout arearefs="timestamp4"> <para> - <literal>unsaved-value</literal> (optionnel - par d�faut � <literal>null</literal>) : - Propri�t� dont la valeur est un num�ro de version qui indique que l'instance est nouvellement - instanci�e (non sauvegard�e), et qui la distingue des instances d�tach�es qui ont - �t� sauvegard�es ou charg�es dans une session pr�c�dente (<literal>undefined</literal> indique - que la valeur de l'attribut identifiant devrait �tre utilis�e). + <literal>unsaved-value</literal> (optionnel - par défaut à <literal>null</literal>) : + Propriété dont la valeur est un numéro de version qui indique que l'instance est nouvellement + instanciée (non sauvegardée), et qui la distingue des instances détachées qui ont + été sauvegardées ou chargées dans une session précédente (<literal>undefined</literal> indique + que la valeur de l'attribut identifiant devrait être utilisée). </para> </callout> <callout arearefs="timestamp5"> <para> - <literal>source</literal> (optionnel - par d�faut � <literal>vm</literal>) : - D'o� Hibernate doit-il r�cup�rer la valeur du timestamp? Depuis la base de donn�es - ou depuis la JVM d'ex�cution? Les valeurs de timestamp de la base de donn�es provoquent - une surcharge puisque Hibernate doit interroger la base pour d�terminer la prochaine valeur - mais cela est plus s�r lorsque vous fonctionnez dans un cluster. Remarquez aussi que - certains des dialectes ne supportent pas cette fonction, et que d'autres l'impl�mentent - mal, provoquant des erreurs de pr�cision (Oracle 8 par exemple). + <literal>source</literal> (optionnel - par défaut à <literal>vm</literal>) : + D'où Hibernate doit-il récupérer la valeur du timestamp? Depuis la base de données + ou depuis la JVM d'exécution? Les valeurs de timestamp de la base de données provoquent + une surcharge puisque Hibernate doit interroger la base pour déterminer la prochaine valeur + mais cela est plus sûr lorsque vous fonctionnez dans un cluster. Remarquez aussi que + certains des dialectes ne supportent pas cette fonction, et que d'autres l'implémentent + mal, provoquant des erreurs de précision (Oracle 8 par exemple). </para> </callout> <callout arearefs="timestamp6"> <para> - <literal>generated</literal> (optional - d�faut � <literal>never</literal>) : - Indique que la valeur de ce timestamp est g�n�r�e par la base de donn�es + <literal>generated</literal> (optional - défaut à <literal>never</literal>) : + Indique que la valeur de ce timestamp est générée par la base de données cf. <xref linkend="mapping-generated">generated properties</xref>. </para> </callout> </calloutlist> </programlistingco> <para> - Notez que <literal>&lt;timestamp&gt;</literal> est �quivalent � + Notez que <literal>&lt;timestamp&gt;</literal> est équivalent à <literal>&lt;version type="timestamp"&gt;</literal>. </para> </sect2> <sect2 id="mapping-declaration-property" revision="4"> <title>property</title> <para> - L'�l�ment <literal>&lt;property&gt;</literal> d�clare une propri�t� de la classe au sens JavaBean. + L'élément <literal>&lt;property&gt;</literal> déclare une propriété de la classe au sens JavaBean. </para> <programlistingco> <areaspec> @@ -1227,13 +1229,13 @@ <calloutlist> <callout arearefs="property1"> <para> - <literal>name</literal> : nom de la propri�t�, avec une lettre initiale en minuscule. + <literal>name</literal> : nom de la propriété, avec une lettre initiale en minuscule. </para> </callout> <callout arearefs="property2"> <para> - <literal>column</literal> (optionnel - par d�faut au nom de la propri�t�) : le nom - de la colonne mapp�e. Cela peut aussi �tre indiqu� dans le(s) sous-�l�ment(s) + <literal>column</literal> (optionnel - par défaut au nom de la propriété) : le nom + de la colonne mappée. Cela peut aussi être indiqué dans le(s) sous-élément(s) <literal>&lt;column&gt;</literal>. </para> </callout> @@ -1244,61 +1246,61 @@ </callout> <callout arearefs="property4-5"> <para> - <literal>update, insert</literal> (optionnel - par d�faut � <literal>true</literal>) : - indique que les colonnes mapp�es devraient �tre incluses dans des <literal>UPDATE</literal> SQL - et/ou des <literal>INSERT</literal>. Mettre les deux � <literal>false</literal> - emp�che la propagation en base de donn�es (utile si vous savez qu'un trigger affectera la valeur � la colonne). + <literal>update, insert</literal> (optionnel - par défaut à <literal>true</literal>) : + indique que les colonnes mappées devraient être incluses dans des <literal>UPDATE</literal> SQL + et/ou des <literal>INSERT</literal>. Mettre les deux à <literal>false</literal> + empêche la propagation en base de données (utile si vous savez qu'un trigger affectera la valeur à la colonne). </para> </callout> <callout arearefs="property6"> <para> - <literal>formula</literal> (optionnel) : une expression SQL qui d�finit la valeur pour une propri�t� - <emphasis>calcul�e</emphasis>. Les propri�t�s calcul�es ne poss�de pas leur propre mapping. + <literal>formula</literal> (optionnel) : une expression SQL qui définit la valeur pour une propriété + <emphasis>calculée</emphasis>. Les propriétés calculées ne possède pas leur propre mapping. </para> </callout> <callout arearefs="property7"> <para> - <literal>access</literal> (optionnel - par d�faut � <literal>property</literal>): Strat�gie que Hibernate - doit utiliser pour acc�der � cette valeur. + <literal>access</literal> (optionnel - par défaut à <literal>property</literal>): Stratégie que Hibernate + doit utiliser pour accéder à cette valeur. </para> </callout> <callout arearefs="property8"> <para> - <literal>lazy</literal> (optionnel - par d�faut � <literal>false</literal>): Indique - que cette propri�t� devrait �tre charg�e en diff�r� (lazy loading) quand on acc�de � la variable - d'instance pour la premi�re fois. + <literal>lazy</literal> (optionnel - par défaut à <literal>false</literal>): Indique + que cette propriété devrait être chargée en différé (lazy loading) quand on accède à la variable + d'instance pour la première fois. </para> </callout> <callout arearefs="property9"> <para> - <literal>unique</literal> (optionnel): G�n�re le DDL d'une contrainte d'unicit� pour les colonnes. + <literal>unique</literal> (optionnel): Génère le DDL d'une contrainte d'unicité pour les colonnes. Permet aussi d'en faire la cible d'un <literal>property-ref</literal>. </para> </callout> <callout arearefs="property10"> <para> - <literal>not-null</literal> (optionnel): G�n�re le DDL d'une contrainte de non nullit� pour les colonnes. + <literal>not-null</literal> (optionnel): Génère le DDL d'une contrainte de non nullité pour les colonnes. </para> </callout> <callout arearefs="property11"> <para> - <literal>optimistic-lock</literal> (optionnel - par d�faut � <literal>true</literal>): - Indique que les mises � jour de cette propri�t� peuvent ou non n�cessiter l'acquisition - d'un verrou optimiste. En d'autres termes, cela d�termine s'il est n�cessaire d'incr�menter - un num�ro de version quand cette propri�t� est marqu�e obsol�te (dirty). + <literal>optimistic-lock</literal> (optionnel - par défaut à <literal>true</literal>): + Indique que les mises à jour de cette propriété peuvent ou non nécessiter l'acquisition + d'un verrou optimiste. En d'autres termes, cela détermine s'il est nécessaire d'incrémenter + un numéro de version quand cette propriété est marquée obsolète (dirty). </para> </callout> <callout arearefs="property12"> <para> - <literal>generated</literal> (optional - d�faut �<literal>never</literal>): - Indique que la valeur de ce timestamp est g�n�r�e par la base de donn�es + <literal>generated</literal> (optional - défaut à<literal>never</literal>): + Indique que la valeur de ce timestamp est générée par la base de données cf. <xref linkend="mapping-generated">generated properties</xref>. </para> </callout> </calloutlist> </programlistingco> <para> - <emphasis>typename</emphasis> peut �tre: + <emphasis>typename</emphasis> peut être: </para> <orderedlist spacing="compact"> <listitem> @@ -1309,43 +1311,43 @@ </listitem> <listitem> <para> - Nom d'une classe Java avec un type basique par d�faut (ex: <literal>int, float, + Nom d'une classe Java avec un type basique par défaut (ex: <literal>int, float, char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal>). </para> </listitem> <listitem> <para> - Nom d'une classe Java s�rialisable. + Nom d'une classe Java sérialisable. </para> </listitem> <listitem> <para> - Nom d'une classe ayant un type sp�cifique (ex: <literal>com.illflow.type.MyCustomType</literal>). + Nom d'une classe ayant un type spécifique (ex: <literal>com.illflow.type.MyCustomType</literal>). </para> </listitem> </orderedlist> <para> - Si vous n'indiquez pas un type, Hibernate utlisera la r�flexion sur le nom de la propri�t� - pour tenter de trouver le type Hibernate correct. Hibernate essayera d'interpr�ter - le nom de la classe retourn�e par le getter de la propri�t� en utilisant les r�gles 2, 3, + Si vous n'indiquez pas un type, Hibernate utlisera la réflexion sur le nom de la propriété + pour tenter de trouver le type Hibernate correct. Hibernate essayera d'interprêter + le nom de la classe retournée par le getter de la propriété en utilisant les régles 2, 3, 4 dans cet ordre. Cependant, ce n'est pas toujours suffisant. Dans certains cas vous aurez encore besoin de l'attribut <literal>type</literal> (Par exemple, pour distinguer - <literal>Hibernate.DATE</literal> et <literal>Hibernate.TIMESTAMP</literal>, ou pour pr�ciser - un type sp�cifique). + <literal>Hibernate.DATE</literal> et <literal>Hibernate.TIMESTAMP</literal>, ou pour préciser + un type spécifique). </para> <para> - L'attribut <literal>access</literal> permet de contr�ler comment Hibernate acc�dera - � la propri�t� � l'ex�cution. Par d�faut, Hibernate utilisera les m�thodes set/get. + L'attribut <literal>access</literal> permet de contrôler comment Hibernate accèdera + à la propriété à l'exécution. Par défaut, Hibernate utilisera les méthodes set/get. Si vous indiquez <literal>access="field"</literal>, Hibernate ignorera les getter/setter - et acc�dera � la propri�t� directement en utilisant la r�flexion. Vous pouvez sp�cifier - votre propre strat�gie d'acc�s aux propri�t� en donnant une classe qui impl�mente l'interface + et accèdera à la propriété directement en utilisant la réflexion. Vous pouvez spécifier + votre propre stratégie d'accès aux propriété en donnant une classe qui implémente l'interface <literal>org.hibernate.property.PropertyAccessor</literal>. </para> <para> - Une fonctionnalit� particuli�rement int�ressante est les propri�t�s d�riv�es. - Ces propri�t�s sont par d�finition en lecture seule, la valeur de la propri�t� est calcul�e au chargement. - Le calcul est d�clar� comme une expression SQL, qui se traduit par une sous-requ�te <literal>SELECT</literal> - dans la requ�te SQL qui charge une instance : + Une fonctionnalité particulièrement intéressante est les propriétés dérivées. + Ces propriétés sont par définition en lecture seule, la valeur de la propriété est calculée au chargement. + Le calcul est déclaré comme une expression SQL, qui se traduit par une sous-requête <literal>SELECT</literal> + dans la requête SQL qui charge une instance : </para> <programlisting><![CDATA[ <property name="totalPrice" @@ -1354,17 +1356,17 @@ AND li.customerId = customerId AND li.orderNumber = orderNumber )"/>]]></programlisting> <para> - Remarquez que vous pouvez r�f�rencer la propre table des entit�s en ne d�clarant pas un - alias sur une colonne particuli�re (<literal>customerId</literal> dans l'exemple donn�). - Notez aussi que vous pouvez utiliser le sous-�l�ment de mapping <literal>&lt;formula&gt;</literal> - plut�t que d'utiliser l'attribut si vous le souhaitez. + Remarquez que vous pouvez référencer la propre table des entités en ne déclarant pas un + alias sur une colonne particulière (<literal>customerId</literal> dans l'exemple donné). + Notez aussi que vous pouvez utiliser le sous-élément de mapping <literal>&lt;formula&gt;</literal> + plutôt que d'utiliser l'attribut si vous le souhaitez. </para> </sect2> <sect2 id="mapping-declaration-manytoone" revision="5"> <title>many-to-one</title> - <para> Une association ordinaire vers une autre classe persistante est d�clar�e en utilisant - un �l�ment <literal>many-to-one</literal>. Le mod�le relationnel est une association - de type many-to-one : une clef �trang�re dans une table r�f�rence la ou les clef(s) primaire(s) dans la table cible. + <para> Une association ordinaire vers une autre classe persistante est déclarée en utilisant + un élément <literal>many-to-one</literal>. Le modèle relationnel est une association + de type many-to-one : une clef étrangère dans une table référence la ou les clef(s) primaire(s) dans la table cible. </para> <programlistingco> <areaspec> @@ -1414,128 +1416,128 @@ <calloutlist> <callout arearefs="manytoone1"> <para> - <literal>name</literal> : Nom de la propri�t�. + <literal>name</literal> : Nom de la propriété. </para> </callout> <callout arearefs="manytoone2"> <para> - <literal>column</literal> (optionnel) : Le nom de la clef �trang�re. Cela peut �tre - aussi indiqu� avec le sous-�l�ment <literal>&lt;column&gt;</literal>. + <literal>column</literal> (optionnel) : Le nom de la clef étrangère. Cela peut être + aussi indiqué avec le sous-élément <literal>&lt;column&gt;</literal>. </para> </callout> <callout arearefs="manytoone3"> <para> - <literal>class</literal> (optionnel - par d�faut le type de la propri�t� d�termin� - par r�flexion) : Le nom de la classe associ�e. + <literal>class</literal> (optionnel - par défaut le type de la propriété déterminé + par réflexion) : Le nom de la classe associée. </para> </callout> <callout arearefs="manytoone4"> <para> - <literal>cascade</literal> (optionnel) : Indique quelles op�rations doivent - �tre propag�es de l'objet p�re vers les objets associ�s. + <literal>cascade</literal> (optionnel) : Indique quelles opérations doivent + être propagées de l'objet père vers les objets associés. </para> </callout> <callout arearefs="manytoone5"> <para> - <literal>fetch</literal> (optionnel - par d�faut � <literal>select</literal>) : + <literal>fetch</literal> (optionnel - par défaut à <literal>select</literal>) : Choisit entre le chargement de type outer-join ou le chargement par select successifs. </para> </callout> <callout arearefs="manytoone6-7"> <para> - <literal>update, insert</literal> (optionnel - par d�faut � <literal>true</literal>) : - indique que les colonnes mapp�es devraient �tre incluses dans des <literal>UPDATE</literal> SQL - et/ou des <literal>INSERT</literal>. Mettre les deux � <literal>false</literal> - emp�che la propagation en base de donn�es (utile si vous savez qu'un trigger affectera la valeur � la colonne). + <literal>update, insert</literal> (optionnel - par défaut à <literal>true</literal>) : + indique que les colonnes mappées devraient être incluses dans des <literal>UPDATE</literal> SQL + et/ou des <literal>INSERT</literal>. Mettre les deux à <literal>false</literal> + empêche la propagation en base de données (utile si vous savez qu'un trigger affectera la valeur à la colonne). </para> </callout> <callout arearefs="manytoone8"> <para> - <literal>property-ref</literal> : (optionnel) Le nom d'une propri�t� de la classe - associ�e qui est li�e � cette clef �trang�re. Si ce n'est pas sp�cifi�, la clef primaire de la - classe associ�e est utilis�e. + <literal>property-ref</literal> : (optionnel) Le nom d'une propriété de la classe + associée qui est liée à cette clef étrangère. Si ce n'est pas spécifié, la clef primaire de la + classe associée est utilisée. </para> </callout> <callout arearefs="manytoone9"> <para> - <literal>access</literal> (optionnel - par d�faut � <literal>property</literal>) : La - strat�gie � utiliser par Hibernate pour acc�der � la valeur de cette propri�t�. + <literal>access</literal> (optionnel - par défaut à <literal>property</literal>) : La + stratégie à utiliser par Hibernate pour accéder à la valeur de cette propriété. </para> </callout> <callout arearefs="manytoone10"> <para> - <literal>unique</literal> (optionnel) : G�n�re le DDL d'une contrainte d'unicit� pour la clef �trang�re. - Permet aussi d'en faire la cible d'un <literal>property-ref</literal>. Cela permet de cr�er une v�ritable + <literal>unique</literal> (optionnel) : Génère le DDL d'une contrainte d'unicité pour la clef étrangère. + Permet aussi d'en faire la cible d'un <literal>property-ref</literal>. Cela permet de créer une véritable association one-to-one. </para> </callout> <callout arearefs="manytoone11"> <para> - <literal>not-null</literal> (optionnel) : G�n�re le DDL pour une contrainte de non nullit� pour la clef �trang�re. + <literal>not-null</literal> (optionnel) : Génère le DDL pour une contrainte de non nullité pour la clef étrangère. </para> </callout> <callout arearefs="manytoone12"> <para> - <literal>optimistic-lock</literal> (optionnel - par d�faut � <literal>true</literal>) : - Indique que les mises � jour de cette propri�t� requi�rent ou non l'acquisition - d'un verrou optimiste. En d'autres termes, d�termine si un incr�ment de version doit - avoir lieu quand la propri�t� est marqu�e obsol�te (dirty). + <literal>optimistic-lock</literal> (optionnel - par défaut à <literal>true</literal>) : + Indique que les mises à jour de cette propriété requièrent ou non l'acquisition + d'un verrou optimiste. En d'autres termes, détermine si un incrément de version doit + avoir lieu quand la propriété est marquée obsolète (dirty). </para> </callout> <callout arearefs="manytoone13"> <para> - <literal>lazy</literal> (optionnel - par d�faut � <literal>false</literal>) : Indique - que cette propri�t� doit �tre charg�e en diff�r� (lazy loading) au premier acc�s - � la variable d'instance (n�cessite une instrumentation du bytecode lors de la phase + <literal>lazy</literal> (optionnel - par défaut à <literal>false</literal>) : Indique + que cette propriété doit être chargée en différé (lazy loading) au premier accès + à la variable d'instance (nécessite une instrumentation du bytecode lors de la phase de construction). Remarquez que cela n'influence pas le comportement du proxy Hibernate - comme l'attribut <literal>lazy</literal> sur des classes ou des mappings - de collections, mais utilise l'interception pour le chargement diff�r�. - <literal>lazy="false"</literal> indique que l'association sera toujours charg�e. + de collections, mais utilise l'interception pour le chargement différé. + <literal>lazy="false"</literal> indique que l'association sera toujours chargée. </para> </callout> <callout arearefs="manytoone14"> <para> - <literal>not-found</literal> (optionnel - par d�faut � <literal>exception</literal>) : - Indique comment les clefs �trang�res qui r�f�rencent des lignes manquantes doivent �tre manipul�es : + <literal>not-found</literal> (optionnel - par défaut à <literal>exception</literal>) : + Indique comment les clefs étrangères qui référencent des lignes manquantes doivent être manipulées : <literal>ignore</literal> traitera une ligne manquante comme une association nulle. </para> </callout> <callout arearefs="manytoone15"> <para> - <literal>entity-name</literal> (optionnel) : Le nom de l'entit� de la classe associ�e. + <literal>entity-name</literal> (optionnel) : Le nom de l'entité de la classe associée. </para> </callout> <callout arearefs="manytoone16"> <para> - <literal>formula</literal> (optionnel) : une expression SQL qui d�finit la valeur - pour une cl� �trang�re calcul�e. + <literal>formula</literal> (optionnel) : une expression SQL qui définit la valeur + pour une clé étrangère calculée. </para> </callout> </calloutlist> </programlistingco> <para> - Donner une valeur significative � l'attribut <literal>cascade</literal> autre que - <literal>none</literal> propagera certaines op�rations � l'objet associ�. Les valeurs - significatives sont les noms des op�rations Hibernate basiques, + Donner une valeur significative à l'attribut <literal>cascade</literal> autre que + <literal>none</literal> propagera certaines opérations à l'objet associé. Les valeurs + significatives sont les noms des opérations Hibernate basiques, <literal>persist, merge, delete, save-update, evict, replicate, lock, - refresh</literal>, ainsi que les valeurs sp�ciales <literal>delete-orphan</literal> - et <literal>all</literal> et des combinaisons de noms d'op�rations s�par�es par des virgules, + refresh</literal>, ainsi que les valeurs spéciales <literal>delete-orphan</literal> + et <literal>all</literal> et des combinaisons de noms d'opérations séparées par des virgules, comme par exemple <literal>cascade="persist,merge,evict"</literal> ou <literal>cascade="all,delete-orphan"</literal>. Voir <xref linkend="objectstate-transitive"/> - pour une explication compl�te. + pour une explication complète. Notez que les assocations many-to-one et one-to-one ne supportent pas orphan delete. </para> <para> - Une d�claration <literal>many-to-one</literal> typique est aussi simple que : + Une déclaration <literal>many-to-one</literal> typique est aussi simple que : </para> <programlisting><![CDATA[<many-to-one name="product" class="Product" column="PRODUCT_ID"/>]]></programlisting> <para> - L'attribut <literal>property-ref</literal> devrait �tre utilis� pour mapper seulement des donn�es - provenant d'un ancien syst�me o� les clefs �trang�res font r�f�rence � une clef unique de la table associ�e + L'attribut <literal>property-ref</literal> devrait être utilisé pour mapper seulement des données + provenant d'un ancien système où les clefs étrangères font référence à une clef unique de la table associée et qui n'est pas la clef primaire. C'est un cas de mauvaise conception relationnelle. - Par exemple, supposez que la classe <literal>Product</literal> a un num�ro de s�rie unique qui n'est pas - la clef primaire. (L'attribut <literal>unique</literal> contr�le la g�n�ration DDL par Hibernate avec + Par exemple, supposez que la classe <literal>Product</literal> a un numéro de série unique qui n'est pas + la clef primaire. (L'attribut <literal>unique</literal> contrôle la génération DDL par Hibernate avec l'outil SchemaExport.) </para> <programlisting><![CDATA[<property name="serialNumber" unique="true" type="string" column="SERIAL_NUMBER"/>]]></programlisting> @@ -1544,17 +1546,17 @@ </para> <programlisting><![CDATA[<many-to-one name="product" property-ref="serialNumber" column="PRODUCT_SERIAL_NUMBER"/>]]></programlisting> <para> - bien que ce ne soit certainement pas encourag�. + bien que ce ne soit certainement pas encouragé. </para> <para> - Si la clef unique r�f�renc�e comprend des propri�t�s multiples de l'entit� associ�e, vous devez mapper - ces propri�t�s � l'int�rieur d'un �l�ment <literal>&lt;properties&gt;</literal>. + Si la clef unique référencée comprend des propriétés multiples de l'entité associée, vous devez mapper + ces propriétés à l'intérieur d'un élément <literal>&lt;properties&gt;</literal>. </para> </sect2> <sect2 id="mapping-declaration-onetoone" revision="3"> <title>one-to-one</title> <para> - Une association one-to-one vers une autre classe persistante est d�clar�e avec l'�l�ment + Une association one-to-one vers une autre classe persistante est déclarée avec l'élément <literal>one-to-one</literal>. </para> <programlistingco> @@ -1584,62 +1586,62 @@ <calloutlist> <callout arearefs="onetoone1"> <para> - <literal>name</literal> : Le nom de la propri�t�. + <literal>name</literal> : Le nom de la propriété. </para> </callout> <callout arearefs="onetoone2"> <para> - <literal>class</literal> (optionnel - par d�faut du type de la propri�t� - d�termin� par r�flexion) : Le nom de la classe associ�e. + <literal>class</literal> (optionnel - par défaut du type de la propriété + déterminé par réflexion) : Le nom de la classe associée. </para> </callout> <callout arearefs="onetoone3"> <para> - <literal>cascade</literal> (optionnel) : Indique quelles op�rations doivent - �tre cascad�es de l'objet p�re vers l'objet associ�. + <literal>cascade</literal> (optionnel) : Indique quelles opérations doivent + être cascadées de l'objet père vers l'objet associé. </para> </callout> <callout arearefs="onetoone4"> <para> - <literal>constrained</literal> (optionnel) : Indique qu'une contrainte de clef �trang�re - sur la clef primaire de la table mapp�e r�f�rence la table de la classe associ�e. + <literal>constrained</literal> (optionnel) : Indique qu'une contrainte de clef étrangère + sur la clef primaire de la table mappée référence la table de la classe associée. Cette option affecte l'ordre dans lequel chaque <literal>save()</literal> et chaque - <literal>delete()</literal> sont cascad�s et d�termine si l'association peut utiliser un proxy - (aussi utilis� par l'outil d'export de sch�ma). + <literal>delete()</literal> sont cascadés et détermine si l'association peut utiliser un proxy + (aussi utilisé par l'outil d'export de schéma). </para> </callout> <callout arearefs="onetoone5"> <para> - <literal>fetch</literal> (optionnel - par d�faut � <literal>select</literal>) : - Choisit entre r�cup�ration par jointure externe ou select s�quentiel. + <literal>fetch</literal> (optionnel - par défaut à <literal>select</literal>) : + Choisit entre récupération par jointure externe ou select séquentiel. </para> </callout> <callout arearefs="onetoone6"> <para> - <literal>property-ref</literal> (optionnel) : Le nom de la propri�t� de la classe associ�e qui est jointe � la clef - primaire de cette classe. Si ce n'est pas sp�cifi�, la clef primaire de la classe associ�e est utilis�e. + <literal>property-ref</literal> (optionnel) : Le nom de la propriété de la classe associée qui est jointe à la clef + primaire de cette classe. Si ce n'est pas spécifié, la clef primaire de la classe associée est utilisée. </para> </callout> <callout arearefs="onetoone7"> <para> - <literal>access</literal> (optionnel - par d�faut � <literal>property</literal>) : - La strat�gie � utiliser par Hibernate pour acc�der � la valeur de la propri�t�. + <literal>access</literal> (optionnel - par défaut à <literal>property</literal>) : + La stratégie à utiliser par Hibernate pour accéder à la valeur de la propriété. </para> </callout> <callout arearefs="onetoone8"> <para> <literal>formula</literal> (optionnel) : Presque toutes les associations one-to-one pointent sur la clef primaire - de l'entit� propri�taire. Dans les rares cas diff�rents, vous devez donner une ou plusieurs - autres colonnes ou expression � joindre par une formule SQL (voir <literal>org.hibernate.test.onetooneformula</literal> pour un exemple). + de l'entité propriétaire. Dans les rares cas différents, vous devez donner une ou plusieurs + autres colonnes ou expression à joindre par une formule SQL (voir <literal>org.hibernate.test.onetooneformula</literal> pour un exemple). </para> </callout> <callout arearefs="onetoone9"> <para> - <literal>lazy</literal> (optionnel - par d�faut <literal>proxy</literal>) : - Par d�faut, les associations simples sont soumise � proxy. <literal>lazy="no-proxy"</literal> - sp�cifie que la propri�t� doit �tre charg�e � la demande au premier acc�s � l'instance. - (n�cessite l'intrumentation du bytecode � la construction). - <literal>lazy="false"</literal> indique que l'association sera toujours charg�e + <literal>lazy</literal> (optionnel - par défaut <literal>proxy</literal>) : + Par défaut, les associations simples sont soumise à proxy. <literal>lazy="no-proxy"</literal> + spécifie que la propriété doit être chargée à la demande au premier accès à l'instance. + (nécessite l'intrumentation du bytecode à la construction). + <literal>lazy="false"</literal> indique que l'association sera toujours chargée agressivement. <emphasis>Notez que si <literal>constrained="false"</literal>, l'utilisation de proxy est impossible et Hibernate chargera automatiquement l'association !</emphasis> </para> @@ -1662,25 +1664,25 @@ </listitem> <listitem> <para> - association par clef �trang�re unique + association par clef étrangère unique </para> </listitem> </itemizedlist> <para> - Les associations par clef primaire ne n�cessitent pas une colonne suppl�mentaire en table ; si deux lignes sont - li�s par l'association alors les deux lignes de la table partagent la m�me valeur de clef primaire. Donc si vous - voulez que deux objets soient li�s par une association par clef primaire, vous devez faire en sorte qu'on leur - assigne la m�me valeur d'identifiant ! + Les associations par clef primaire ne nécessitent pas une colonne supplémentaire en table ; si deux lignes sont + liés par l'association alors les deux lignes de la table partagent la même valeur de clef primaire. Donc si vous + voulez que deux objets soient liés par une association par clef primaire, vous devez faire en sorte qu'on leur + assigne la même valeur d'identifiant ! </para> <para> - Pour une association par clef primaire, ajoutez les mappings suivants � <literal>Employee</literal> et + Pour une association par clef primaire, ajoutez les mappings suivants à <literal>Employee</literal> et <literal>Person</literal>, respectivement. </para> <programlisting><![CDATA[<one-to-one name="person" class="Person"/>]]></programlisting> <programlisting><![CDATA[<one-to-one name="employee" class="Employee" constrained="true"/>]]></programlisting> <para> - Maintenant, vous devez faire en sorte que les clefs primaires des lignes li�es dans les tables PERSON et EMPLOYEE - sont �gales. On utilise une strat�gie Hibernate sp�ciale de g�n�ration d'identifiants appel�e + Maintenant, vous devez faire en sorte que les clefs primaires des lignes liées dans les tables PERSON et EMPLOYEE + sont égales. On utilise une stratégie Hibernate spéciale de génération d'identifiants appelée <literal>foreign</literal> : </para> <programlisting><![CDATA[<class name="person" table="PERSON"> @@ -1695,17 +1697,17 @@ constrained="true"/> </class>]]></programlisting> <para> - Une instance fra�chement enregistr�e de <literal>Person</literal> se voit alors assign�e la m�me valeur - de clef primaire que l'instance de <literal>Employee</literal> r�f�renc�e par la propri�t� <literal>employee</literal> + Une instance fraîchement enregistrée de <literal>Person</literal> se voit alors assignée la même valeur + de clef primaire que l'instance de <literal>Employee</literal> référencée par la propriété <literal>employee</literal> de cette <literal>Person</literal>. </para> <para> - Alternativement, une clef �trang�re avec contrainte d'unicit� de <literal>Employee</literal> vers - <literal>Person</literal> peut �tre indiqu�e ainsi : + Alternativement, une clef étrangère avec contrainte d'unicité de <literal>Employee</literal> vers + <literal>Person</literal> peut être indiquée ainsi : </para> <programlisting><![CDATA[<many-to-one name="person" class="Person" column="PERSON_ID" unique="true"/>]]></programlisting> <para> - Et cette association peut �tre rendue bidirectionnelle en ajoutant ceci au mapping de <literal>Person</literal> : + Et cette association peut être rendue bidirectionnelle en ajoutant ceci au mapping de <literal>Person</literal> : </para> <programlisting><![CDATA[<one-to-one name="employee" class="Employee" property-ref="person"/>]]></programlisting> </sect2> @@ -1720,28 +1722,28 @@ </natural-id>]]></programlisting> <para> - Bien que nous recommandions l'utilisation de cl� primaire g�n�r�e, vous devriez toujours - essayer d'identifier des cl� m�tier (naturelles) pour toutes vos entit�s. Une cl� naturelle - est une propri�t� ou une combinaison de propri�t�s uniques et non nulles. Si elle est aussi - immuable, c'est encore mieux. Mappez les propri�t�s de la cl� naturelle dans l'�l�ment - <literal>&lt;natural-id&gt;</literal>. Hibernate g�n�rera la cl� unique n�cessaire et les contraintes - de non-nullit�, et votre mapping s'auto-documentera. + Bien que nous recommandions l'utilisation de clé primaire générée, vous devriez toujours + essayer d'identifier des clé métier (naturelles) pour toutes vos entités. Une clé naturelle + est une propriété ou une combinaison de propriétés uniques et non nulles. Si elle est aussi + immuable, c'est encore mieux. Mappez les propriétés de la clé naturelle dans l'élément + <literal>&lt;natural-id&gt;</literal>. Hibernate générera la clé unique nécessaire et les contraintes + de non-nullité, et votre mapping s'auto-documentera. </para> <para> - Nous vous recommandons fortement d'impl�menter <literal>equals()</literal> et - <literal>hashCode()</literal> pour comparer les cl�s naturelles de l'entit�. + Nous vous recommandons fortement d'implémenter <literal>equals()</literal> et + <literal>hashCode()</literal> pour comparer les clés naturelles de l'entité. </para> <para> - Ce mapping n'est pas destin� � �tre utilis� avec des entit�s qui ont des cl�s naturelles. + Ce mapping n'est pas destiné à être utilisé avec des entités qui ont des clés naturelles. </para> <itemizedlist spacing="compact"> <listitem> <para> - <literal>mutable</literal> (optionel, par d�faut � <literal>false</literal>) : - Par d�faut, les identifiants naturels sont suppos�s �tre immuable (constants). + <literal>mutable</literal> (optionel, par défaut à <literal>false</literal>) : + Par défaut, les identifiants naturels sont supposés être immuable (constants). </para> </listitem> </itemizedlist> @@ -1750,9 +1752,9 @@ <sect2 id="mapping-declaration-component" revision="2"> <title>component, dynamic-component</title> <para> - L'�l�ment <literal>&lt;component&gt;</literal> mappe les propri�t�s d'un objet fils - aux colonnes d'une classe parente. Les composants peuvent en retour d�clarer leurs propres - propri�t�s, composants ou collections. Voir "Components" plus bas. + L'élément <literal>&lt;component&gt;</literal> mappe les propriétés d'un objet fils + aux colonnes d'une classe parente. Les composants peuvent en retour déclarer leurs propres + propriétés, composants ou collections. Voir "Components" plus bas. </para> <programlistingco> <areaspec> @@ -1783,77 +1785,77 @@ <calloutlist> <callout arearefs="component1"> <para> - <literal>name</literal> : Nom de la propri�t� + <literal>name</literal> : Nom de la propriété </para> </callout> <callout arearefs="component2"> <para> - <literal>class</literal> (optionnel - par d�faut au type de la propri�t� d�termin� par r�flexion) : + <literal>class</literal> (optionnel - par défaut au type de la propriété déterminé par réflexion) : le nom de la classe (fille) du composant. </para> </callout> <callout arearefs="component3"> <para> - <literal>insert</literal> : Est ce que les colonnes mapp�es apparaissent dans les + <literal>insert</literal> : Est ce que les colonnes mappées apparaissent dans les <literal>INSERT</literal>s ? </para> </callout> <callout arearefs="component4"> <para> - <literal>update</literal>: Est ce que les colonnes mapp�es apparaissent dans les + <literal>update</literal>: Est ce que les colonnes mappées apparaissent dans les <literal>UPDATE</literal>s ? </para> </callout> <callout arearefs="component5"> <para> - <literal>access</literal> (optionnel - par d�faut � <literal>property</literal>) : - La strat�gie que Hibernate doit utiliser pour acc�der � la valeur de cette propri�t�. + <literal>access</literal> (optionnel - par défaut à <literal>property</literal>) : + La stratégie que Hibernate doit utiliser pour accéder à la valeur de cette propriété. </para> </callout> <callout arearefs="component6"> <para> - <literal>lazy</literal> (optionnel - par d�faut � <literal>false</literal>) : - Indique que ce composant doit �tre charg� au premier acc�s - � la variable d'instance (n�cessite une instrumentation du bytecode au moment du build). + <literal>lazy</literal> (optionnel - par défaut à <literal>false</literal>) : + Indique que ce composant doit être chargé au premier accès + à la variable d'instance (nécessite une instrumentation du bytecode au moment du build). </para> </callout> <callout arearefs="component7"> <para> - <literal>optimistic-lock</literal> (optionnel - par d�faut � <literal>true</literal>) : - Indique que les mises � jour sur ce composant n�cessitent ou non l'acquisition d'un - verrou optimiste. En d'autres termes, cela d�termine si une incr�mentation de version - doit avoir lieu quand la propri�t� est marqu�e obsol�te (dirty). + <literal>optimistic-lock</literal> (optionnel - par défaut à <literal>true</literal>) : + Indique que les mises à jour sur ce composant nécessitent ou non l'acquisition d'un + verrou optimiste. En d'autres termes, cela détermine si une incrémentation de version + doit avoir lieu quand la propriété est marquée obsolète (dirty). </para> </callout> <callout arearefs="component8"> <para> - <literal>unique</literal> (optionnel - par d�faut � <literal>false</literal>) : - Indique qu'une contrainte d'unicit� existe sur toutes les colonnes mapp�es de ce composant. + <literal>unique</literal> (optionnel - par défaut à <literal>false</literal>) : + Indique qu'une contrainte d'unicité existe sur toutes les colonnes mappées de ce composant. </para> </callout> </calloutlist> </programlistingco> <para> - Les tags fils <literal>&lt;property&gt;</literal> mappent les propri�t�s + Les tags fils <literal>&lt;property&gt;</literal> mappent les propriétés de la classe fille sur les colonnes de la table. </para> <para> - L'�l�ment <literal>&lt;component&gt;</literal> permet de d�clarer sous-�l�ment <literal>&lt;parent&gt;</literal> qui associe une propri�t� - de la classe composant comme une r�f�rence arri�re vers l'entit� contenante. + L'élément <literal>&lt;component&gt;</literal> permet de déclarer sous-élément <literal>&lt;parent&gt;</literal> qui associe une propriété + de la classe composant comme une référence arrière vers l'entité contenante. </para> <para> - L'�l�ment <literal>&lt;dynamic-component&gt;</literal> permet � une <literal>Map</literal> d'�tre mapp�e - comme un composant, quand les noms de la propri�t� font r�f�rence aux clefs de cette Map, voir + L'élément <literal>&lt;dynamic-component&gt;</literal> permet à une <literal>Map</literal> d'être mappée + comme un composant, quand les noms de la propriété font référence aux clefs de cette Map, voir <xref linkend="components-dynamic"/>. </para> </sect2> <sect2 id="mapping-declaration-properties" revision="2"> <title>properties</title> <para> - L'�l�ment <literal>&lt;properties&gt;</literal> permet la d�finition d'un groupement logique nomm� - des propri�t�s d'une classe. L'utilisation la plus importante de cette construction est la possibilit� - pour une combinaison de propri�t�s d'�tre la cible d'un <literal>property-ref</literal>. C'est aussi - un moyen pratique de d�finir une contrainte d'unicit� multi-colonnes. + L'élément <literal>&lt;properties&gt;</literal> permet la définition d'un groupement logique nommé + des propriétés d'une classe. L'utilisation la plus importante de cette construction est la possibilité + pour une combinaison de propriétés d'être la cible d'un <literal>property-ref</literal>. C'est aussi + un moyen pratique de définir une contrainte d'unicité multi-colonnes. </para> <programlistingco> <areaspec> @@ -1879,33 +1881,33 @@ <callout arearefs="properties1"> <para> <literal>name</literal> : Le nom logique d'un regroupement et - <emphasis>non</emphasis> le v�ritable nom d'une propri�t�. + <emphasis>non</emphasis> le véritable nom d'une propriété. </para> </callout> <callout arearefs="properties2"> <para> - <literal>insert</literal> : Est-ce que les colonnes mapp�es apparaissent dans les + <literal>insert</literal> : Est-ce que les colonnes mappées apparaissent dans les <literal>INSERT</literal>s ? </para> </callout> <callout arearefs="properties3"> <para> - <literal>update</literal> : Est-ce que les colonnes mapp�es apparaissent dans les + <literal>update</literal> : Est-ce que les colonnes mappées apparaissent dans les <literal>UPDATE</literal>s ? </para> </callout> <callout arearefs="properties4"> <para> - <literal>optimistic-lock</literal> (optionnel - par d�faut � <literal>true</literal>) : - Indique que les mises � jour sur ce composant n�cessitent ou non l'acquisition d'un - verrou optimiste. En d'autres termes, cela d�termine si une incr�mentation - de version doit avoir lieu quand la propri�t� est marqu�e obsol�te (dirty). + <literal>optimistic-lock</literal> (optionnel - par défaut à <literal>true</literal>) : + Indique que les mises à jour sur ce composant nécessitent ou non l'acquisition d'un + verrou optimiste. En d'autres termes, cela détermine si une incrémentation + de version doit avoir lieu quand la propriété est marquée obsolète (dirty). </para> </callout> <callout arearefs="properties5"> <para> - <literal>unique</literal> (optionnel - par d�faut � <literal>false</literal>) : - Indique qu'une contrainte d'unicit� existe sur toutes les colonnes mapp�es de ce composant. + <literal>unique</literal> (optionnel - par défaut à <literal>false</literal>) : + Indique qu'une contrainte d'unicité existe sur toutes les colonnes mappées de ce composant. </para> </callout> </calloutlist> @@ -1924,8 +1926,8 @@ </properties> </class>]]></programlisting> <para> - Alors nous pourrions avoir une association sur des donn�es d'un ancien syst�me (legacy) qui font r�f�rence - � cette clef unique de la table <literal>Person</literal> au lieu de la clef primaire : + Alors nous pourrions avoir une association sur des données d'un ancien système (legacy) qui font référence + à cette clef unique de la table <literal>Person</literal> au lieu de la clef primaire : </para> <programlisting><![CDATA[<many-to-one name="person" class="Person" property-ref="name"> @@ -1934,15 +1936,15 @@ <column name="lastName"/> </many-to-one>]]></programlisting> <para> - Nous ne recommandons pas l'utilisation de ce genre de chose en dehors du contexte de mapping de donn�es h�rit�es - d'anciens syst�mes. + Nous ne recommandons pas l'utilisation de ce genre de chose en dehors du contexte de mapping de données héritées + d'anciens systèmes. </para> </sect2> <sect2 id="mapping-declaration-subclass" revision="4"> <title>subclass</title> <para> - Pour finir, la persistance polymorphique n�cessite la d�claration de chaque sous-classe de la classe persistante de base. - pour la strat�gie de mapping de type table-per-class-hierarchy, on utilise la d�claration + Pour finir, la persistance polymorphique nécessite la déclaration de chaque sous-classe de la classe persistante de base. + pour la stratégie de mapping de type table-per-class-hierarchy, on utilise la déclaration <literal>&lt;subclass&gt;</literal>. </para> <programlistingco> @@ -1974,33 +1976,33 @@ </callout> <callout arearefs="subclass2"> <para> - <literal>discriminator-value</literal> (optionnel - par d�faut le nom de la classe) : - une valeur qui distingue les diff�rentes sous-classes. + <literal>discriminator-value</literal> (optionnel - par défaut le nom de la classe) : + une valeur qui distingue les différentes sous-classes. </para> </callout> <callout arearefs="subclass3"> <para> - <literal>proxy</literal> (optionnel) : Indique une classe ou interface � utiliser pour les chargements - � la demande des proxies (lazy). + <literal>proxy</literal> (optionnel) : Indique une classe ou interface à utiliser pour les chargements + à la demande des proxies (lazy). </para> </callout> <callout arearefs="subclass4"> <para> - <literal>lazy</literal> (optionnel, par d�faut � <literal>true</literal>) : Sp�cifier - <literal>lazy="false"</literal> d�sactive l'utilisation du chargement � la demande (lazy). + <literal>lazy</literal> (optionnel, par défaut à <literal>true</literal>) : Spécifier + <literal>lazy="false"</literal> désactive l'utilisation du chargement à la demande (lazy). </para> </callout> </calloutlist> </programlistingco> <para> - Chaque sous-classe devrait d�clarer ses propres propri�t�s persistantes et sous-classes. - Les propri�t�s <literal>&lt;version&gt;</literal> et <literal>&lt;id&gt;</literal> - sont implicitement h�rit�s de la classe de base. Chaque sous-classe dans une hi�rarchie doit - d�finir une unique <literal>discriminator-value</literal>. Si aucune n'est sp�cifi�e, - le nom complet de la classe Java est utilis�. + Chaque sous-classe devrait déclarer ses propres propriétés persistantes et sous-classes. + Les propriétés <literal>&lt;version&gt;</literal> et <literal>&lt;id&gt;</literal> + sont implicitement hérités de la classe de base. Chaque sous-classe dans une hiérarchie doit + définir une unique <literal>discriminator-value</literal>. Si aucune n'est spécifiée, + le nom complet de la classe Java est utilisé. </para> <para> - Pour plus d'infos sur le mapping d'h�ritage, voir <xref linkend="inheritance"/>. + Pour plus d'infos sur le mapping d'héritage, voir <xref linkend="inheritance"/>. </para> <programlisting><![CDATA[ <hibernate-mapping> @@ -2009,15 +2011,15 @@ </subclass> </hibernate-mapping>]]></programlisting> <para> - Pour des informations sur les mappings d'h�ritage, voir <xref linkend="inheritance"/>. + Pour des informations sur les mappings d'héritage, voir <xref linkend="inheritance"/>. </para> </sect2> <sect2 id="mapping-declaration-joinedsubclass" revision="3"> <title>joined-subclass</title> <para> - Une autre fa�on possible de faire est la suivante, chaque sous-classe peut �tre mapp�e vers sa propre table (strat�gie - de mapping de type table-per-subclass). L'�tat h�rit� est r�cup�r� en joignant la table de la super-classe. - L'�l�ment <literal>&lt;joined-subclass&gt;</literal> est utilis�. + Une autre façon possible de faire est la suivante, chaque sous-classe peut être mappée vers sa propre table (stratégie + de mapping de type table-per-subclass). L'état hérité est récupéré en joignant la table de la super-classe. + L'élément <literal>&lt;joined-subclass&gt;</literal> est utilisé. </para> <programlistingco> <areaspec> @@ -2058,21 +2060,21 @@ </callout> <callout arearefs="joinedsubclass3"> <para> - <literal>proxy</literal> (optionnel) : Indique une classe ou interface pour le chargement diff�r� des proxies. + <literal>proxy</literal> (optionnel) : Indique une classe ou interface pour le chargement différé des proxies. </para> </callout> <callout arearefs="joinedsubclass4"> <para> - <literal>lazy</literal> (optionnel, par d�faut � <literal>true</literal>) : Indiquer - <literal>lazy="false"</literal> d�sactive l'utilisation du chargement � la demande. + <literal>lazy</literal> (optionnel, par défaut à <literal>true</literal>) : Indiquer + <literal>lazy="false"</literal> désactive l'utilisation du chargement à la demande. </para> </callout> </calloutlist> </programlistingco> <para> - Aucune colonne discriminante n'est n�cessaire pour cette strat�gie de mapping. Cependant, - chaque sous-classe doit d�clarer une colonne de table contenant l'objet identifiant qui utilise l'�l�ment - <literal>&lt;key&gt;</literal>. Le mapping au d�but de ce chapitre serait r�-�crit ainsi : + Aucune colonne discriminante n'est nécessaire pour cette stratégie de mapping. Cependant, + chaque sous-classe doit déclarer une colonne de table contenant l'objet identifiant qui utilise l'élément + <literal>&lt;key&gt;</literal>. Le mapping au début de ce chapitre serait ré-écrit ainsi : </para> <programlisting><![CDATA[<?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC @@ -2106,19 +2108,19 @@ </hibernate-mapping>]]></programlisting> <para> - Pour des informations sur les mappings d'h�ritage, voir <xref linkend="inheritance"/>. + Pour des informations sur les mappings d'héritage, voir <xref linkend="inheritance"/>. </para> </sect2> <sect2 id="mapping-declaration-unionsubclass" revision="2"> <title>union-subclass</title> <para> - Une troisi�me option est de seulement mapper vers des tables les classes concr�tes - d'une hi�rarchie d'h�ritage, (strat�gie de type table-per-concrete-class) o� - chaque table d�finit tous les �tats persistants de la classe, y compris les �tats h�rit�s. - Dans Hibernate il n'est absolument pas n�cessaire de mapper explicitement de telles hi�rarchies - d'h�ritage. Vous pouvez simplement mapper chaque classe avec une d�claration <literal>&lt;class&gt;</literal> - diff�rente. Cependant, si vous souhaitez utiliser des associations polymorphiques (c�d une association - vers la superclasse de la hi�rarchie), vous devez utiliser le mapping <literal>&lt;union-subclass&gt;</literal>. + Une troisième option est de seulement mapper vers des tables les classes concrètes + d'une hiérarchie d'héritage, (stratégie de type table-per-concrete-class) où + chaque table définit tous les états persistants de la classe, y compris les états hérités. + Dans Hibernate il n'est absolument pas nécessaire de mapper explicitement de telles hiérarchies + d'héritage. Vous pouvez simplement mapper chaque classe avec une déclaration <literal>&lt;class&gt;</literal> + différente. Cependant, si vous souhaitez utiliser des associations polymorphiques (càd une association + vers la superclasse de la hiérarchie), vous devez utiliser le mapping <literal>&lt;union-subclass&gt;</literal>. </para> <programlistingco> <areaspec> @@ -2158,30 +2160,30 @@ </callout> <callout arearefs="unionsubclass3"> <para> - <literal>proxy</literal> (optionnel) : Indique une classe ou interface pour le chargement diff�r� des proxies. + <literal>proxy</literal> (optionnel) : Indique une classe ou interface pour le chargement différé des proxies. </para> </callout> <callout arearefs="unionsubclass4"> <para> - <literal>lazy</literal> (optionnel, par d�faut � <literal>true</literal>) : Indiquer - <literal>lazy="false"</literal> d�sactive l'utilisation du chargement � la demande. + <literal>lazy</literal> (optionnel, par défaut à <literal>true</literal>) : Indiquer + <literal>lazy="false"</literal> désactive l'utilisation du chargement à la demande. </para> </callout> </calloutlist> </programlistingco> <para> - Aucune colonne discriminante ou colonne clef n'est requise pour cette strat�gie de mapping. + Aucune colonne discriminante ou colonne clef n'est requise pour cette stratégie de mapping. </para> <para> - Pour des informations sur les mappings d'h�ritage, voir <xref linkend="inheritance"/>. + Pour des informations sur les mappings d'héritage, voir <xref linkend="inheritance"/>. </para> </sect2> <sect2 id="mapping-declaration-join" revision="3"> <title>join</title> <para> - En utilisant l'�l�ment <literal>&lt;join&gt;</literal>, il est possible de mapper - des propri�t�s d'une classe sur plusieurs tables. + En utilisant l'élément <literal>&lt;join&gt;</literal>, il est possible de mapper + des propriétés d'une classe sur plusieurs tables. </para> <programlistingco> <areaspec> @@ -2213,47 +2215,47 @@ </callout> <callout arearefs="join2"> <para> - <literal>schema</literal> (optionnel) : court-circuite le nom de sch�ma sp�cifi� par l'�l�ment de base + <literal>schema</literal> (optionnel) : court-circuite le nom de schéma spécifié par l'élément de base <literal>&lt;hibernate-mapping&gt;</literal>. </para> </callout> <callout arearefs="join3"> <para> - <literal>catalog</literal> (optionnel) : court-circuite le nom de catalogue sp�cifi� par l'�l�ment de base + <literal>catalog</literal> (optionnel) : court-circuite le nom de catalogue spécifié par l'élément de base <literal>&lt;hibernate-mapping&gt;</literal>. </para> </callout> <callout arearefs="join4"> <para> - <literal>fetch</literal> (optionnel - par d�faut � <literal>join</literal>) : - Si positionn� � <literal>join</literal>, Hibernate utilisera une jointure interne pour charger - une <literal>jointure</literal> d�finie par une classe ou ses super-classes et une jointure externe - pour une <literal>&lt;jointure&gt;</literal> d�finie par une sous-classe. - Si positionn� � <literal>select</literal> alors Hibernate utilisera un select s�quentiel - pour une <literal>&lt;jointure&gt;</literal> d�finie sur une sous-classe, qui ne sera d�livr�e que - si une ligne se repr�sente une instance de la sous-classe. Les jointures internes seront quand m�me - utilis�es pour charger une <literal>&lt;jointure&gt;</literal> d�finie par une classe et ses super-classes. + <literal>fetch</literal> (optionnel - par défaut à <literal>join</literal>) : + Si positionné à <literal>join</literal>, Hibernate utilisera une jointure interne pour charger + une <literal>jointure</literal> définie par une classe ou ses super-classes et une jointure externe + pour une <literal>&lt;jointure&gt;</literal> définie par une sous-classe. + Si positionné à <literal>select</literal> alors Hibernate utilisera un select séquentiel + pour une <literal>&lt;jointure&gt;</literal> définie sur une sous-classe, qui ne sera délivrée que + si une ligne se représente une instance de la sous-classe. Les jointures internes seront quand même + utilisées pour charger une <literal>&lt;jointure&gt;</literal> définie par une classe et ses super-classes. </para> </callout> <callout arearefs="join5"> <para> - <literal>inverse</literal> (optionnel - par d�faut � <literal>false</literal>) : - Si positionn� � true, Hibernate n'essaiera pas d'ins�rer ou de mettre � jour les - propri�t�s d�finies par cette jointure. + <literal>inverse</literal> (optionnel - par défaut à <literal>false</literal>) : + Si positionné à true, Hibernate n'essaiera pas d'insérer ou de mettre à jour les + propriétés définies par cette jointure. </para> </callout> <callout arearefs="join6"> <para> - <literal>optionnel</literal> (optionnel - par d�faut � <literal>false</literal>) : - Si positionn� � true, Hibernate ins�rera une ligne seulement si les propri�t�s d�finies - par cette jointure sont non-nulles et utilisera toujours une jointure externe pour charger les propri�t�s. + <literal>optionnel</literal> (optionnel - par défaut à <literal>false</literal>) : + Si positionné à true, Hibernate insèrera une ligne seulement si les propriétés définies + par cette jointure sont non-nulles et utilisera toujours une jointure externe pour charger les propriétés. </para> </callout> </calloutlist> </programlistingco> <para> - Par exemple, les informations d'adresse pour une personne peuvent �tre mapp�es vers une table - s�par�e (tout en pr�servant des s�mantiques de type valeur pour toutes ses propri�t�s) : + Par exemple, les informations d'adresse pour une personne peuvent être mappées vers une table + séparée (tout en préservant des sémantiques de type valeur pour toutes ses propriétés) : </para> <programlisting><![CDATA[<class name="Person" table="PERSON"> @@ -2268,19 +2270,19 @@ </join> ...]]></programlisting> <para> - Cette fonctionnalit� est souvent seulement utile pour les mod�les de donn�es - h�rit�s d'anciens syst�mes (legacy), nous recommandons d'utiliser moins de tables que de classes - et un mod�le de domaine � granularit� fine. Cependant, c'est utile - pour passer d'une strat�gie de mapping d'h�ritage � une autre dans une hi�rarchie simple ainsi qu'il est - expliqu� plus tard. + Cette fonctionnalité est souvent seulement utile pour les modèles de données + hérités d'anciens systèmes (legacy), nous recommandons d'utiliser moins de tables que de classes + et un modèle de domaine à granularité fine. Cependant, c'est utile + pour passer d'une stratégie de mapping d'héritage à une autre dans une hiérarchie simple ainsi qu'il est + expliqué plus tard. </para> </sect2> <sect2 id="mapping-declaration-key"> <title>key</title> <para> - Nous avons rencontr� l'�l�ment <literal>&lt;key&gt;</literal> � plusieurs reprises maintenant. - Il appara�t partout que l'�l�ment de mapping parent d�finit une jointure sur une nouvele table, et - d�finit la clef �trang�re dans la table jointe, ce qui r�f�rence la clef primaire de la table d'origine. + Nous avons rencontré l'élément <literal>&lt;key&gt;</literal> à plusieurs reprises maintenant. + Il apparaît partout que l'élément de mapping parent définit une jointure sur une nouvele table, et + définit la clef étrangère dans la table jointe, ce qui référence la clef primaire de la table d'origine. </para> <programlistingco> <areaspec> @@ -2302,64 +2304,64 @@ <calloutlist> <callout arearefs="key1"> <para> - <literal>column</literal> (optionnel) : Le nom de la colonne de la clef �trang�re - Cela peut aussi �tre sp�cifi� par l'�l�ment(s) int�gr�(s) <literal>&lt;column&gt;</literal>. + <literal>column</literal> (optionnel) : Le nom de la colonne de la clef étrangère + Cela peut aussi être spécifié par l'élément(s) intégré(s) <literal>&lt;column&gt;</literal>. </para> </callout> <callout arearefs="key2"> <para> - <literal>on-delete</literal> (optionnel, par d�faut � <literal>noaction</literal>) : - Indique si la contrainte de clef �trang�re poss�de la possibilit� au niveau base de donn�es + <literal>on-delete</literal> (optionnel, par défaut à <literal>noaction</literal>) : + Indique si la contrainte de clef étrangère possède la possibilité au niveau base de données de suppression en cascade. </para> </callout> <callout arearefs="key3"> <para> - <literal>property-ref</literal> (optionnel) : Indique que la clef �trang�re fait - r�f�rence � des colonnes qui ne sont pas la clef primaire de la table d'origine - (Pour les donn�es de syst�mes legacy). + <literal>property-ref</literal> (optionnel) : Indique que la clef étrangère fait + référence à des colonnes qui ne sont pas la clef primaire de la table d'origine + (Pour les données de systèmes legacy). </para> </callout> <callout arearefs="key4"> <para> - <literal>not-null</literal> (optionnel) : Indique que les colonnes des clefs �trang�res ne - peuvent pas �tre nulles (c'est implicite si la clef �trang�re fait partie de la clef primaire). + <literal>not-null</literal> (optionnel) : Indique que les colonnes des clefs étrangères ne + peuvent pas être nulles (c'est implicite si la clef étrangère fait partie de la clef primaire). </para> </callout> <callout arearefs="key5"> <para> - <literal>update</literal> (optionnel) : Indique que la clef �trang�re ne devrait jamais �tre mise � jour + <literal>update</literal> (optionnel) : Indique que la clef étrangère ne devrait jamais être mise à jour (implicite si celle-ci fait partie de la clef primaire). </para> </callout> <callout arearefs="key6"> <para> - <literal>unique</literal> (optionnel) : Indique que la clef �trang�re doit poss�der une contrainte - d'unicit� (implicite si la clef �trang�re est aussi la clef primaire). + <literal>unique</literal> (optionnel) : Indique que la clef étrangère doit posséder une contrainte + d'unicité (implicite si la clef étrangère est aussi la clef primaire). </para> </callout> </calloutlist> </programlistingco> <para> - Nous recommandons pour les syst�mes o� les suppressions doivent �tre performantes de d�finir toutes + Nous recommandons pour les systèmes où les suppressions doivent être performantes de définir toutes les clefs <literal>on-delete="cascade"</literal>, ainsi Hibernate utilisera une contrainte - <literal>ON CASCADE DELETE</literal> au niveau base de donn�es, plut�t que de nombreux - <literal>DELETE</literal> individuels. Attention, cette fonctionnalit� court-circuite la strat�gie - habituelle de verrou optimiste pour les donn�es versionn�es. + <literal>ON CASCADE DELETE</literal> au niveau base de données, plutôt que de nombreux + <literal>DELETE</literal> individuels. Attention, cette fonctionnalité court-circuite la stratégie + habituelle de verrou optimiste pour les données versionnées. </para> <para> Les attributs <literal>not-null</literal> et <literal>update</literal> sont utiles pour mapper une association one-to-many unidirectionnelle. Si vous mappez un one-to-many unidirectionnel - vers une clef �trang�re non nulle, vous <emphasis>devez</emphasis> d�clarer la colonne de la clef + vers une clef étrangère non nulle, vous <emphasis>devez</emphasis> déclarer la colonne de la clef en utilisant <literal>&lt;key not-null="true"&gt;</literal>. </para> </sect2> <sect2 id="mapping-column" revision="4"> - <title>�l�ments column et formula</title> + <title>éléments column et formula</title> <para> - Tout �l�ment de mapping qui accepte un attribut <literal>column</literal> acceptera alternativement - un sous-�l�ment <literal>&lt;column&gt;</literal>. De fa�on identique, <literal>&lt;formula&gt;</literal> - est une alternative � l'attribut <literal>formula</literal>. + Tout élément de mapping qui accepte un attribut <literal>column</literal> acceptera alternativement + un sous-élément <literal>&lt;column&gt;</literal>. De façon identique, <literal>&lt;formula&gt;</literal> + est une alternative à l'attribut <literal>formula</literal>. </para> <programlisting><![CDATA[<column name="column_name" @@ -2374,8 +2376,8 @@ check="SQL expression"/>]]></programlisting> <programlisting><![CDATA[<formula>SQL expression</formula>]]></programlisting> <para> - Les attributs <literal>column</literal> et <literal>formula</literal> peuvent m�me �tre combin�s - au sein d'une m�me propri�t� ou mapping d'association pour exprimer, par exemple, des conditions + Les attributs <literal>column</literal> et <literal>formula</literal> peuvent même être combinés + au sein d'une même propriété ou mapping d'association pour exprimer, par exemple, des conditions de jointure exotiques. </para> <programlisting><![CDATA[<many-to-one name="homeAddress" class="Address" @@ -2387,10 +2389,10 @@ <sect2 id="mapping-declaration-import"> <title>import</title> <para> - Supposez que votre application poss�de deux classes persistantes du m�me nom, et vous ne voulez pas pr�ciser - le nom Java complet (packages inclus) dans les queries Hibernate. Les classes peuvent alors �tre "import�es" - explicitement plut�t que de compter sur <literal>auto-import="true"</literal>.Vous pouvez m�me importer - des classes et interfaces qui ne sont pas mapp�es explicitement. + Supposez que votre application possède deux classes persistantes du même nom, et vous ne voulez pas préciser + le nom Java complet (packages inclus) dans les queries Hibernate. Les classes peuvent alors être "importées" + explicitement plutôt que de compter sur <literal>auto-import="true"</literal>.Vous pouvez même importer + des classes et interfaces qui ne sont pas mappées explicitement. </para> <programlisting><![CDATA[<import class="java.lang.Object" rename="Universe"/>]]></programlisting> <programlistingco> @@ -2410,8 +2412,8 @@ </callout> <callout arearefs="import2"> <para> - <literal>rename</literal> (optionnel - par d�faut vaut le nom de la classe Java (sans package)) : - Nom pouvant �tre utilis� dans le langage de requ�te. + <literal>rename</literal> (optionnel - par défaut vaut le nom de la classe Java (sans package)) : + Nom pouvant être utilisé dans le langage de requête. </para> </callout> </calloutlist> @@ -2420,19 +2422,19 @@ <sect2 id="mapping-types-anymapping" revision="2"> <title>any</title> <para> - Il existe encore un type de mapping de propri�t�. L'�l�ment de mapping <literal>&lt;any&gt;</literal> - d�finit une association polymorphique vers des classes de tables multiples. Ce type de mapping requiert - toujours plus d'une colonne. La premi�re colonne contient le type de l'entit� associ�e. Les colonnes - restantes contiennent l'identifiant. il est impossible de sp�cifier une contrainte de clef �trang�re - pour ce type d'association, donc ce n'est certainement pas consid�r� comme le moyen habituel de mapper + Il existe encore un type de mapping de propriété. L'élément de mapping <literal>&lt;any&gt;</literal> + définit une association polymorphique vers des classes de tables multiples. Ce type de mapping requiert + toujours plus d'une colonne. La première colonne contient le type de l'entité associée. Les colonnes + restantes contiennent l'identifiant. il est impossible de spécifier une contrainte de clef étrangère + pour ce type d'association, donc ce n'est certainement pas considéré comme le moyen habituel de mapper des associations (polymorphiques). Vous devriez utiliser cela uniquement dans des cas particuliers - (par exemple des logs d'audit, des donn�es de session utilisateur, etc...). + (par exemple des logs d'audit, des données de session utilisateur, etc...). </para> <para> - L'attribut <literal>meta-type</literal> permet � l'application de sp�cifier un type personnalis� qui mappe - des valeurs de colonnes de le base de donn�es sur des classes persistantes qui ont un attribut identifiant - du type sp�cifi� par <literal>id-type</literal>. Vous devez sp�cifier le mapping � partir de valeurs du - m�ta-type sur les noms des classes. + L'attribut <literal>meta-type</literal> permet à l'application de spécifier un type personnalisé qui mappe + des valeurs de colonnes de le base de données sur des classes persistantes qui ont un attribut identifiant + du type spécifié par <literal>id-type</literal>. Vous devez spécifier le mapping à partir de valeurs du + méta-type sur les noms des classes. </para> <programlisting><![CDATA[<any name="being" id-type="long" meta-type="string"> <meta-value value="TBL_ANIMAL" class="Animal"/> @@ -2468,7 +2470,7 @@ <calloutlist> <callout arearefs="any1"> <para> - <literal>name</literal> : le nom de la propri�t�. + <literal>name</literal> : le nom de la propriété. </para> </callout> <callout arearefs="any2"> @@ -2478,28 +2480,28 @@ </callout> <callout arearefs="any3"> <para> - <literal>meta-type</literal> (optionnel - par d�faut � <literal>string</literal>) : + <literal>meta-type</literal> (optionnel - par défaut à <literal>string</literal>) : Tout type permis pour un mapping par discriminateur. </para> </callout> <callout arearefs="any4"> <para> - <literal>cascade</literal> (optionnel - par d�faut � <literal>none</literal>) : + <literal>cascade</literal> (optionnel - par défaut à <literal>none</literal>) : le style de cascade. </para> </callout> <callout arearefs="any5"> <para> - <literal>access</literal> (optionnel - par d�faut � <literal>property</literal>) : La strat�gie - � utiliser par Hibernate pour acc�der � cette propri�t�. + <literal>access</literal> (optionnel - par défaut à <literal>property</literal>) : La stratégie + à utiliser par Hibernate pour accéder à cette propriété. </para> </callout> <callout arearefs="any6"> <para> - <literal>optimistic-lock</literal> (optionnel - par d�faut � <literal>true</literal>) : - Indique que les mises � jour sur cette propri�t� n�cessitent ou non l'acquisition d'un - verrou optimiste. En d'autres termes, d�finit si un incr�ment de version doit avoir lieu - quand cette propri�t� est marqu�e dirty. + <literal>optimistic-lock</literal> (optionnel - par défaut à <literal>true</literal>) : + Indique que les mises à jour sur cette propriété nécessitent ou non l'acquisition d'un + verrou optimiste. En d'autres termes, définit si un incrément de version doit avoir lieu + quand cette propriété est marquée dirty. </para> </callout> </calloutlist> @@ -2509,42 +2511,42 @@ <sect1 id="mapping-types"> <title>Hibernate Types</title> <sect2 id="mapping-types-entitiesvalues" revision="1"> - <title>Entit�s et valeurs</title> + <title>Entités et valeurs</title> <para> - Pour comprendre le comportement des diff�rents objets Java par rapport au service + Pour comprendre le comportement des différents objets Java par rapport au service de persistance, nous avons besoin de les classer en deux groupes : </para> <para> - Une <emphasis>entit�</emphasis> existe ind�pendamment de tout autre objet poss�dant - une r�f�rence vers l'entit�. Comparez cela avec le mod�le Java habituel o� un objet - est supprim� par le garbage collector d�s qu'il n'est plus r�f�renc�. Les entit�s - doivent �tre explicitement enregistr�es et supprim�es (sauf dans les cas o� - sauvegardes et suppressions sont <emphasis>cascad�es</emphasis> d'une entit� m�re - vers ses enfants). C'est diff�rent du mod�le ODMG de persistance par - atteignabilit� - et correspond mieux � la fa�on dont les objets sont - habituellement utilis�s dans des grands syst�mes. Les entit�s permettent les r�f�rences - circulaires et partag�es. Elles peuvent aussi �tre versionn�es. + Une <emphasis>entité</emphasis> existe indépendamment de tout autre objet possédant + une référence vers l'entité. Comparez cela avec le modèle Java habituel où un objet + est supprimé par le garbage collector dès qu'il n'est plus référencé. Les entités + doivent être explicitement enregistrées et supprimées (sauf dans les cas où + sauvegardes et suppressions sont <emphasis>cascadées</emphasis> d'une entité mère + vers ses enfants). C'est différent du modèle ODMG de persistance par + atteignabilité - et correspond mieux à la façon dont les objets sont + habituellement utilisés dans des grands systèmes. Les entités permettent les références + circulaires et partagées. Elles peuvent aussi être versionnées. </para> <para> - L'�tat persistant d'une entit� consiste en des r�f�rences vers d'autres entit�s et + L'état persistant d'une entité consiste en des références vers d'autres entités et instances de types <emphasis>valeurs</emphasis>. Ces valeurs sont des types primitifs, des collections (et non le contenu d'une collection), des composants de certains objets - immuables. Contrairement aux entit�s, les valeurs (et en particulier les collections et - composants) <emphasis>sont</emphasis> persist�s par atteignabiliit�. Comme les - valeurs (et types primitifs) sont persist�s et supprim�s avec l'entit� qui les contient, - ils ne peuvent pas poss�der leurs propres versions. Les valeurs n'ont pas d'identit� - ind�pendantes, ainsi elles ne peuvent pas �tre partag�es par deux entit�s ou collections. + immuables. Contrairement aux entités, les valeurs (et en particulier les collections et + composants) <emphasis>sont</emphasis> persistés par atteignabiliité. Comme les + valeurs (et types primitifs) sont persistés et supprimés avec l'entité qui les contient, + ils ne peuvent pas posséder leurs propres versions. Les valeurs n'ont pas d'identité + indépendantes, ainsi elles ne peuvent pas être partagées par deux entités ou collections. </para> <para> - Jusqu'� pr�sent nous avons utilis� le terme "classe persistante" pour parler d'entit�s. - Nous allons continuer � faire ainsi. Cependant, au sens strict, toutes - les classes d�finies par un utilisateur poss�dant un �tat persistant ne sont pas des - entit�s. Un <emphasis>composant</emphasis> est une classe d�finie par un utilisateur - avec les caract�ristiques d'une valeur. Une propri�t� Java de type <literal>java.lang.String</literal> - a aussi les caract�ristiques d'une valeur. + Jusqu'à présent nous avons utilisé le terme "classe persistante" pour parler d'entités. + Nous allons continuer à faire ainsi. Cependant, au sens strict, toutes + les classes définies par un utilisateur possédant un état persistant ne sont pas des + entités. Un <emphasis>composant</emphasis> est une classe définie par un utilisateur + avec les caractéristiques d'une valeur. Une propriété Java de type <literal>java.lang.String</literal> + a aussi les caractéristiques d'une valeur. - <!-- FIXME Baptiste MATHUS : J'ai remis le texte anglais pour que si la version est publi�e - comme �a, au moins le lecteur puisse essayer lui aussi de comprendre la version anglaise... --> + <!-- FIXME Baptiste MATHUS : J'ai remis le texte anglais pour que si la version est publiée + comme ça, au moins le lecteur puisse essayer lui aussi de comprendre la version anglaise... --> Given this definition, we can say that all types (classes) provided by the JDK have value type semantics in Java, while user-defined types may @@ -2557,26 +2559,26 @@ Nous nous pencherons sur ces deux concepts tout au long de la documentation. </para> <para> - Le d�fi est de mapper les type Javas (et la d�finition des d�veloppeurs des - entit�s et valeurs types) sur les types du SQL ou des bases de donn�es. Le pont - entre les deux syst�mes est propos� par Hibernate : pour les entit�s nous utilisons + Le défi est de mapper les type Javas (et la définition des développeurs des + entités et valeurs types) sur les types du SQL ou des bases de données. Le pont + entre les deux systèmes est proposé par Hibernate : pour les entités nous utilisons <literal>&lt;class&gt;</literal>, <literal>&lt;subclass&gt;</literal> et ainsi de suite. Pour les types valeurs nous utilisons <literal>&lt;property&gt;</literal>, <literal>&lt;component&gt;</literal>, etc., habituellement avec un attribut <literal>type</literal>. La valeur de cet attribut est le nom d'un <emphasis>type de mapping</emphasis> Hibernate. Hibernate propose de base de nombreux mappings (pour les types de valeurs standards du JDK). - Vous pouvez �crire vos propres types de mappings et impl�menter aussi vos propres strat�gies + Vous pouvez écrire vos propres types de mappings et implémenter aussi vos propres stratégies de conversion, nous le verrons plus tard. </para> <para> - Tous les types propos�s de base par Hibernate � part les collections autorisent la valeur null. + Tous les types proposés de base par Hibernate à part les collections autorisent la valeur null. </para> </sect2> <sect2 id="mapping-types-basictypes" revision="3"> <title>Basic value types</title> <para> - Les <emphasis>types basiques de mapping</emphasis> propos�s de base peuvent grossi�rement �tre - rang�s dans les cat�gories suivantes : + Les <emphasis>types basiques de mapping</emphasis> proposés de base peuvent grossièrement être + rangés dans les catégories suivantes : <variablelist> <varlistentry> <term> @@ -2586,7 +2588,7 @@ <listitem> <para> Les mappings de type des primitives Java ou leurs classes wrappers (ex: Integer - pour int) vers les types SQL (propri�taires) appropri�s. <literal>boolean, + pour int) vers les types SQL (propriétaires) appropriés. <literal>boolean, yes_no</literal>et <literal>true_false</literal> sont tous des alternatives pour les types Java <literal>boolean</literal> ou <literal>java.lang.Boolean</literal>. </para> @@ -2611,7 +2613,7 @@ <para> Mappings de type pour <literal>java.util.Date</literal> et ses sous-classes vers les types SQL <literal>DATE</literal>, <literal>TIME</literal> et - <literal>TIMESTAMP</literal> (ou �quivalent). + <literal>TIMESTAMP</literal> (ou équivalent). </para> </listitem> </varlistentry> @@ -2623,7 +2625,7 @@ <para> Mappings de type pour <literal>java.util.Calendar</literal> vers les types SQL <literal>TIMESTAMP</literal> et <literal>DATE</literal> - (ou �quivalent). + (ou équivalent). </para> </listitem> </varlistentry> @@ -2650,8 +2652,8 @@ <literal>java.util.Currency</literal> vers <literal>VARCHAR</literal> (ou le <literal>VARCHAR2</literal> Oracle). Les instances de <literal>Locale</literal> et <literal>Currency</literal> sont - mapp�es sur leurs codes ISO. Les instances de <literal>TimeZone</literal> sont - mapp�es sur leur <literal>ID</literal>. + mappées sur leurs codes ISO. Les instances de <literal>TimeZone</literal> sont + mappées sur leur <literal>ID</literal>. </para> </listitem> </varlistentry> @@ -2663,7 +2665,7 @@ <para> Un type de mapping pour <literal>java.lang.Class</literal> vers <literal>VARCHAR</literal> (ou le <literal>VARCHAR2</literal> Oracle). - Un objet <literal>Class</literal> est mapp� sur son nom Java complet. + Un objet <literal>Class</literal> est mappé sur son nom Java complet. </para> </listitem> </varlistentry> @@ -2673,7 +2675,7 @@ </term> <listitem> <para> - Mappe les tableaux de bytes vers le type binaire SQL appropri�. + Mappe les tableaux de bytes vers le type binaire SQL approprié. </para> </listitem> </varlistentry> @@ -2683,7 +2685,7 @@ </term> <listitem> <para> - Mappe les longues cha�nes de caract�res Java vers les types SQL + Mappe les longues chaînes de caractères Java vers les types SQL <literal>CLOB</literal> ou <literal>TEXT</literal>. </para> </listitem> @@ -2694,9 +2696,9 @@ </term> <listitem> <para> - Mappe les types Java s�rialisables vers le type SQL binaire appropri�. Vous pouvez + Mappe les types Java sérialisables vers le type SQL binaire approprié. Vous pouvez aussi indiquer le type Hibernate <literal>serializable</literal> avec le nom - d'une classe Java s�rialisable ou une interface qui ne soit pas par d�faut un type de base. + d'une classe Java sérialisable ou une interface qui ne soit pas par défaut un type de base. </para> </listitem> </varlistentry> @@ -2708,8 +2710,8 @@ <para> Mappings de type pour les classes JDBC <literal>java.sql.Clob</literal> and <literal>java.sql.Blob</literal>. Ces types peuvent ne pas convenir pour certaines - applications car un objet blob ou clob peut ne pas �tre r�utilisable en dehors - d'une transaction (de plus l'impl�mentation par les pilotes est moyennement bonne). + applications car un objet blob ou clob peut ne pas être réutilisable en dehors + d'une transaction (de plus l'implémentation par les pilotes est moyennement bonne). </para> </listitem> </varlistentry> @@ -2724,40 +2726,40 @@ Hibernate effectue certains optimisations convenant seulement aux types Java immuables, et l'application les traite comme immuable. Par exemple, vous ne devriez pas appeler <literal>Date.setTime()</literal> sur une instance - mapp�e sur un <literal>imm_timestamp</literal>. Pour changer la valeur - de la propri�t�, et faire que cette modification soit persist�e, l'application - doit assigner un nouvel (non identique) objet � la propri�t�. + mappée sur un <literal>imm_timestamp</literal>. Pour changer la valeur + de la propriété, et faire que cette modification soit persistée, l'application + doit assigner un nouvel (non identique) objet à la propriété. </para> </listitem> </varlistentry> </variablelist> </para> <para> - Les identifiants uniques des entit�s et collections peuvent �tre de n'importe quel type de base except� + Les identifiants uniques des entités et collections peuvent être de n'importe quel type de base excepté <literal>binary</literal>, <literal>blob</literal> et <literal>clob</literal> (les identifiants composites sont aussi permis, voir plus bas). </para> <para> - Les types de base des valeurs ont des <literal>Type</literal> constants correspondants d�finis + Les types de base des valeurs ont des <literal>Type</literal> constants correspondants définis dans <literal>org.hibernate.Hibernate</literal>. Par exemple, <literal>Hibernate.STRING</literal> - repr�sent� le type <literal>string</literal>. + représenté le type <literal>string</literal>. </para> </sect2> <sect2 id="mapping-types-custom" revision="2"> - <title>Types de valeur d�finis par l'utilisateur</title> + <title>Types de valeur définis par l'utilisateur</title> <para> - Il est assez facile pour les d�veloppeurs de cr�er leurs propres types de valeurs. Par exemple, - vous pourriez vouloir persister des propri�t�s du type <literal>java.lang.BigInteger</literal> - dans des colonnnes <literal>VARCHAR</literal>. Hibernate ne procure pas par d�faut un type pour cela. - Mais les types que vous pouvez cr�er ne se limitent pas � mapper des propri�t�s (ou �l�ment collection) - � une simple colonne d'une table. Donc, par exemple, vous pourriez avoir une propri�t� Java + Il est assez facile pour les développeurs de créer leurs propres types de valeurs. Par exemple, + vous pourriez vouloir persister des propriétés du type <literal>java.lang.BigInteger</literal> + dans des colonnnes <literal>VARCHAR</literal>. Hibernate ne procure pas par défaut un type pour cela. + Mais les types que vous pouvez créer ne se limitent pas à mapper des propriétés (ou élément collection) + à une simple colonne d'une table. Donc, par exemple, vous pourriez avoir une propriété Java <literal>getName()</literal>/<literal>setName()</literal> de type - <literal>java.lang.String</literal> persist�e dans les colonnes + <literal>java.lang.String</literal> persistée dans les colonnes <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, <literal>SURNAME</literal>. </para> <para> - Pour impl�menter votre propre type, vous pouvez soit impl�menter <literal>org.hibernate.UserType</literal> - soit <literal>org.hibernate.CompositeUserType</literal> et d�clarer des propri�t�s utilisant des + Pour implémenter votre propre type, vous pouvez soit implémenter <literal>org.hibernate.UserType</literal> + soit <literal>org.hibernate.CompositeUserType</literal> et déclarer des propriétés utilisant des noms de classes complets du type. Regardez <literal>org.hibernate.test.DoubleStringType</literal> pour voir ce qu'il est possible de faire. </para> @@ -2766,19 +2768,19 @@ <column name="second_string"/> </property>]]></programlisting> <para> - Remarquez l'utilisation des tags <literal>&lt;column&gt;</literal> pour mapper une propri�t� sur des colonnes + Remarquez l'utilisation des tags <literal>&lt;column&gt;</literal> pour mapper une propriété sur des colonnes multiples. </para> <para> Les interfaces <literal>CompositeUserType</literal>, <literal>EnhancedUserType</literal>, <literal>UserCollectionType</literal>, et <literal>UserVersionType</literal> permettent des utilisations - plus sp�cialis�es. + plus spécialisées. </para> <para> - Vous pouvez m�me donner des param�tres en indiquant <literal>UserType</literal> dans le fichier - de mapping ; Pour cela, votre <literal>UserType</literal> doit impl�menter l'interface - <literal>org.hibernate.usertype.ParameterizedType</literal>. Pour sp�cifier des param�tres dans - votre type propre, vous pouvez utiliser l'�l�ment <literal>&lt;type&gt;</literal> dans vos fichiers de mapping. + Vous pouvez même donner des paramètres en indiquant <literal>UserType</literal> dans le fichier + de mapping ; Pour cela, votre <literal>UserType</literal> doit implémenter l'interface + <literal>org.hibernate.usertype.ParameterizedType</literal>. Pour spécifier des paramètres dans + votre type propre, vous pouvez utiliser l'élément <literal>&lt;type&gt;</literal> dans vos fichiers de mapping. </para> <programlisting><![CDATA[<property name="priority"> <type name="com.mycompany.usertypes.DefaultValueIntegerType"> @@ -2786,32 +2788,32 @@ </type> </property>]]></programlisting> <para> - Le <literal>UserType</literal> permet maintenant de r�cup�rer la valeur pour le param�tre nomm� - <literal>default</literal> � partir de l'objet <literal>Properties</literal> qui lui est pass�. + Le <literal>UserType</literal> permet maintenant de récupérer la valeur pour le paramètre nommé + <literal>default</literal> à partir de l'objet <literal>Properties</literal> qui lui est passé. </para> <para> - Si vous utilisez fr�quemment un <literal>UserType</literal>, cela peut �tre utile de lui d�finir un - nom plus court. Vous pouvez faire cela en utilisant l'�l�ment <literal>&lt;typedef&gt;</literal>. - Les typedefs permettent d'assigner un nom � votre type propre et peuvent aussi contenir une liste de - valeurs de param�tres par d�faut si ce type est param�tr�. + Si vous utilisez fréquemment un <literal>UserType</literal>, cela peut être utile de lui définir un + nom plus court. Vous pouvez faire cela en utilisant l'élément <literal>&lt;typedef&gt;</literal>. + Les typedefs permettent d'assigner un nom à votre type propre et peuvent aussi contenir une liste de + valeurs de paramètres par défaut si ce type est paramétré. </para> <programlisting><![CDATA[<typedef class="com.mycompany.usertypes.DefaultValueIntegerType" name="default_zero"> <param name="default">0</param> </typedef>]]></programlisting> <programlisting><![CDATA[<property name="priority" type="default_zero"/>]]></programlisting> <para> - Il est aussi possible de red�finir les param�tres par d�faut du typedef au cas par cas en - utilisant des param�tres type sur le mapping de la propri�t�. + Il est aussi possible de redéfinir les paramètres par défaut du typedef au cas par cas en + utilisant des paramètres type sur le mapping de la propriété. </para> <para> - Bien que le fait que Hibernate propose de base une riche vari�t� de types, et qu'il supporte les composants - signifie que vous aurez tr�s rarement <emphasis>besoin</emphasis> d'utiliser un nouveau type propre, - il est n�anmoins de bonne pratique d'utiliser des types propres pour les classes (non entit�s) qui - apparaissent fr�quemment dans votre application. Par exemple une classe <literal>MonetaryAmount</literal> - est un bon candidat pour un <literal>CompositeUserType</literal> m�me s'il pourrait facilement - �tre mapp� comme un composant. Une motivation pour cela est l'abstraction. Avec un type propre - vos documents de mapping sont � l'abri des changements futurs dans votre fa�on de repr�senter des - valeurs mon�taires. + Bien que le fait que Hibernate propose de base une riche variété de types, et qu'il supporte les composants + signifie que vous aurez très rarement <emphasis>besoin</emphasis> d'utiliser un nouveau type propre, + il est néanmoins de bonne pratique d'utiliser des types propres pour les classes (non entités) qui + apparaissent fréquemment dans votre application. Par exemple une classe <literal>MonetaryAmount</literal> + est un bon candidat pour un <literal>CompositeUserType</literal> même s'il pourrait facilement + être mappé comme un composant. Une motivation pour cela est l'abstraction. Avec un type propre + vos documents de mapping sont à l'abri des changements futurs dans votre façon de représenter des + valeurs monétaires. </para> </sect2> </sect1> @@ -2820,10 +2822,10 @@ <title>Mapper une classe plus d'une fois</title> <para> Il est possible de proposer plus d'un mapping par classe persistante. Dans ce cas, vous - devez sp�cifier un <emphasis>nom d'entit�</emphasis> pour lever l'ambiguit� entre les instances - des entit�s mapp�es (par d�faut, le nom de l'entit� est celui de la classe). Hibernate - vous permet de sp�cifier le nom de l'entit� lorsque vous utilisez des objets persistants, lorsque - vous �crivez des requ�tes ou quand vous mappez des associations vers les entit�s nomm�es. + devez spécifier un <emphasis>nom d'entité</emphasis> pour lever l'ambiguité entre les instances + des entités mappées (par défaut, le nom de l'entité est celui de la classe). Hibernate + vous permet de spécifier le nom de l'entité lorsque vous utilisez des objets persistants, lorsque + vous écrivez des requêtes ou quand vous mappez des associations vers les entités nommées. </para> <programlisting><![CDATA[<class name="Contract" table="Contracts" @@ -2845,7 +2847,7 @@ </class>]]></programlisting> <para> - Remarquez comment les associations sont d�sormais sp�cifi�es en utilisant + Remarquez comment les associations sont désormais spécifiées en utilisant <literal>entity-name</literal> au lieu de <literal>class</literal>. </para> @@ -2854,10 +2856,10 @@ <sect1 id="mapping-quotedidentifiers"> <title>SQL quoted identifiers</title> <para> - Vous pouvez forcer Hibernate � mettre un identifiant entre quotes dans le SQL g�n�r� en mettant le nom + Vous pouvez forcer Hibernate à mettre un identifiant entre quotes dans le SQL généré en mettant le nom de la table ou de la colonne entre backticks dans le document de mapping. Hibernate utilisera les bons styles de quotes pour le <literal>Dialect</literal> SQL - (habituellement des doubles quotes, mais des parenth�ses pour SQL server et des backticks pour MySQL). + (habituellement des doubles quotes, mais des parenthèses pour SQL server et des backticks pour MySQL). </para> <programlisting><![CDATA[<class name="LineItem" table="`Line Item`"> <id name="id" column="`Item Id`"/><generator class="assigned"/></id> @@ -2868,16 +2870,16 @@ <sect1 id="mapping-alternatives"> <title>alternatives Metadata</title> <para> - XML ne convient pas � tout le monde, il y a donc des moyens alternatifs pour d�finir des metatda + XML ne convient pas à tout le monde, il y a donc des moyens alternatifs pour définir des metatda de mappings O/R dans Hibernate. </para> <sect2 id="mapping-xdoclet"> <title>utilisation de XDoclet</title> <para> - De nombreux utilisateurs de Hibernate pr�f�rent embarquer les informations de mappings + De nombreux utilisateurs de Hibernate préfèrent embarquer les informations de mappings directement au sein du code source en utilisant les tags XDoclet <literal&gt;(a)hibernate.tags&lt;/literal&gt;. - Nous ne couvrons pas cette approche dans ce document cependant, puisque c'est consid�r� comme faisant partie - de XDoclet. Cependant, nous pr�sentons l'exemple suivant de la classe <literal>Cat</literal> avec + Nous ne couvrons pas cette approche dans ce document cependant, puisque c'est considéré comme faisant partie + de XDoclet. Cependant, nous présentons l'exemple suivant de la classe <literal>Cat</literal> avec des mappings XDoclet. </para> <programlisting><![CDATA[package eg; @@ -2992,16 +2994,16 @@ <title>Utilisation des annotations JDK 5.0</title> <para> Le JDK 5.0 introduit des annotations proches de celles de XDoclet au niveau java, qui sont - type-safe et v�rifi�es � la compilation. Ce m�canisme est plus puissant que XDoclet et mieux - support� par les outils et IDE. IntelliJ IDEA, par exemple, supporte l'auto-compl�tion et le - surlignement syntaxique des annotations JDK 5.0. La nouvelle r�vision des sp�cifications des EJB - (JSR-220) utilise les annotations JDK 5.0 comme m�canisme primaire pour les meta-donn�es des beans entit�s. - Hibernate3 impl�mente l'<literal>EntityManager</literal> de la JSR-220 (API de persistance), - le support du mapping de meta-donn�es est disponible via le package <emphasis>Hibernate Annotations</emphasis>, - en tant que module s�par� � t�l�charger. EJB3 (JSR-220) et les m�tadata Hibernate3 sont support�s. + type-safe et vérifiées à la compilation. Ce mécanisme est plus puissant que XDoclet et mieux + supporté par les outils et IDE. IntelliJ IDEA, par exemple, supporte l'auto-complétion et le + surlignement syntaxique des annotations JDK 5.0. La nouvelle révision des spécifications des EJB + (JSR-220) utilise les annotations JDK 5.0 comme mécanisme primaire pour les meta-données des beans entités. + Hibernate3 implémente l'<literal>EntityManager</literal> de la JSR-220 (API de persistance), + le support du mapping de meta-données est disponible via le package <emphasis>Hibernate Annotations</emphasis>, + en tant que module séparé à télécharger. EJB3 (JSR-220) et les métadata Hibernate3 sont supportés. </para> <para> - Ceci est un exemple d'une classe POJO annot�e comme un EJB entit� : + Ceci est un exemple d'une classe POJO annotée comme un EJB entité : </para> <programlisting><![CDATA[@Entity(access = AccessType.FIELD) public class Customer implements Serializable { @@ -3026,58 +3028,58 @@ // Getter/setter and business methods }]]></programlisting> <para> - Notez que le support des annotations JDK 5.0 (et de la JSR-220) est encore en cours et n'est pas termin�. - R�f�rez vous au module Hibernate Annotation pour plus de d�tails. + Notez que le support des annotations JDK 5.0 (et de la JSR-220) est encore en cours et n'est pas terminé. + Référez vous au module Hibernate Annotation pour plus de détails. </para> </sect2> </sect1> <sect1 id="mapping-generated" revision="1"> - <title>Propri�t�s g�n�r�es</title> + <title>Propriétés générées</title> <para> - Les propri�t�s g�n�r�es sont des propri�t�s dont les valeurs sont g�n�r�es par - la base de donn�es. Typiquement, les applications Hibernate avaient besoin d'invoquer - <literal>refresh</literal> sur les instances qui contenaient des propri�t�s pour lesquelles - la base de donn�es g�n�rait des valeurs. Marquer les propri�t�s comme g�n�r�es permet � - l'application de d�l�guer cette responsabilit� � Hibernate. Principalement, � chaque fois - qu'Hibernate r�alise une insertion ou une mise � jour en base de donn�es pour une entit� - marqu�e comme telle, cela provoque imm�diatement un select pour r�cup�rer les valeurs g�n�r�es. + Les propriétés générées sont des propriétés dont les valeurs sont générées par + la base de données. Typiquement, les applications Hibernate avaient besoin d'invoquer + <literal>refresh</literal> sur les instances qui contenaient des propriétés pour lesquelles + la base de données générait des valeurs. Marquer les propriétés comme générées permet à + l'application de déléguer cette responsabilité à Hibernate. Principalement, à chaque fois + qu'Hibernate réalise une insertion ou une mise à jour en base de données pour une entité + marquée comme telle, cela provoque immédiatement un select pour récupérer les valeurs générées. </para> <para> - Les propri�t�s marqu�es comme g�n�r�es doivent de plus ne pas �tre ins�rables et modifiables + Les propriétés marquées comme générées doivent de plus ne pas être insérables et modifiables Seuls <xref linkend="mapping-declaration-version">versions</xref>, <xref linkend="mapping-declaration-timestamp">timestamps</xref>, et - <xref linkend="mapping-declaration-property">simple properties</xref> peuvent �tre marqu�s comme - g�n�r�es. + <xref linkend="mapping-declaration-property">simple properties</xref> peuvent être marqués comme + générées. </para> <para> - <literal>never</literal> (par d�faut) - indique la valeur de la propri�t� n'est pas g�n�r�e - dans la base de donn�es. + <literal>never</literal> (par défaut) - indique la valeur de la propriété n'est pas générée + dans la base de données. </para> <para> - <literal>insert</literal> - indique que la valeur de la propri�t� donn�e est - g�n�r�e � l'insertion mais pas lors des futures mises � jour de l'enregistrement. - Les colonnes de type "date de cr�ation" sont le cas d'utilisation typique de cette option. - Notez que m�me les propri�t�s <xref linkend="mapping-declaration-version">version</xref> et - <xref linkend="mapping-declaration-timestamp">timestamp</xref> peuvent �tre - d�clar�es comme g�n�r�es, cette option n'est pas disponible � cet endroit... + <literal>insert</literal> - indique que la valeur de la propriété donnée est + générée à l'insertion mais pas lors des futures mises à jour de l'enregistrement. + Les colonnes de type "date de création" sont le cas d'utilisation typique de cette option. + Notez que même les propriétés <xref linkend="mapping-declaration-version">version</xref> et + <xref linkend="mapping-declaration-timestamp">timestamp</xref> peuvent être + déclarées comme générées, cette option n'est pas disponible à cet endroit... </para> <para> - <literal>always</literal> - indique que la valeur de la propri�t� est g�n�r�e � l'insert + <literal>always</literal> - indique que la valeur de la propriété est générée à l'insert comme aux updates. </para> </sect1> <sect1 id="mapping-database-object"> - <title>Objets auxiliaires de la base de donn�es</title> + <title>Objets auxiliaires de la base de données</title> <para> - Permettent les ordres CREATE et DROP d'objets arbitraire de la base de donn��es, en conjonction avec - les outils Hibernate d'�volutions de sch�ma, pour permettre de d�finir compl�tement - un sch�ma utilisateur au sein des fichiers de mapping Hibernate. Bien que con�u sp�cifiquement - pour cr�er et supprimer des objets tels que des triggers et des proc�dures stock�es, - ou toute commande pouvant �tre ex�cut�e via une m�thode de <literal>java.sql.Statement.execute()</literal> - (ALTERs, INSERTS, etc). Il y a principalement deux modes pour d�finir les objets auxiliaires de base de donn�es... + Permettent les ordres CREATE et DROP d'objets arbitraire de la base de donnéées, en conjonction avec + les outils Hibernate d'évolutions de schéma, pour permettre de définir complètement + un schéma utilisateur au sein des fichiers de mapping Hibernate. Bien que conçu spécifiquement + pour créer et supprimer des objets tels que des triggers et des procédures stockées, + ou toute commande pouvant être exécutée via une méthode de <literal>java.sql.Statement.execute()</literal> + (ALTERs, INSERTS, etc). Il y a principalement deux modes pour définir les objets auxiliaires de base de données... </para> <para> Le premier mode est de lister explicitement les commandes CREATE et DROP dans le fichier @@ -3091,8 +3093,8 @@ </database-object> </hibernate-mapping>]]></programlisting> <para> - Le second mode est de fournir une classe particuli�re qui connait comment construire - les commandes CREATE et DROP. Cette classe particuli�re doit impl�menter l'interface + Le second mode est de fournir une classe particulière qui connait comment construire + les commandes CREATE et DROP. Cette classe particulière doit implémenter l'interface <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal>. </para> <programlisting><![CDATA[<hibernate-mapping> @@ -3102,7 +3104,7 @@ </database-object> </hibernate-mapping>]]></programlisting> <para> - Additionnellement, ces objets de base de donn�es peuvent �tre optionnellement trait�s + Additionnellement, ces objets de base de données peuvent être optionnellement traités selon l'utilisation de dialectes particuliers.. </para> <programlisting><![CDATA[<hibernate-mapping> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/batch.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/batch.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/batch.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,10 +1,12 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="batch"> <title>Traitement par paquet</title> <para> - Une approche na�ve pour ins�rer 100 000 lignes dans la base de donn�es en utilisant - Hibernate pourrait ressembler � �a : + Une approche naïve pour insérer 100 000 lignes dans la base de données en utilisant + Hibernate pourrait ressembler à ça : </para> <programlisting><![CDATA[Session session = sessionFactory.openSession(); @@ -17,14 +19,14 @@ session.close();]]></programlisting> <para> - Ceci devrait s'�crouler avec une <literal>OutOfMemoryException</literal> quelque - part aux alentours de la 50 000�me ligne. C'est parce qu'Hibernate cache toutes - les instances de <literal>Customer</literal> nouvellement ins�r�es dans le cache + Ceci devrait s'écrouler avec une <literal>OutOfMemoryException</literal> quelque + part aux alentours de la 50 000ème ligne. C'est parce qu'Hibernate cache toutes + les instances de <literal>Customer</literal> nouvellement insérées dans le cache de second niveau. </para> <para> - Dans ce chapitre nous montrerons comment �viter ce probl�me. D'abord, cependant, + Dans ce chapitre nous montrerons comment éviter ce problème. D'abord, cependant, si vous faites des traitements par batch, il est absolument critique que vous activiez l'utilisation ds paquet JDBC (NdT : JDBC batching), si vous avez l'intention d'obtenir des performances raisonnables. Configurez la taille du paquet JDBC avec un @@ -34,8 +36,8 @@ <programlisting><![CDATA[hibernate.jdbc.batch_size 20]]></programlisting> <para> - Vous pourriez aussi vouloir faire cette sorte de travail dans un traitement o� - l'interaction avec le cache de second niveau est compl�tement d�sactiv� : + Vous pourriez aussi vouloir faire cette sorte de travail dans un traitement où + l'interaction avec le cache de second niveau est complètement désactivé : </para> <programlisting><![CDATA[hibernate.cache.use_second_level_cache false]]></programlisting> @@ -44,9 +46,9 @@ <title>Insertions en paquet</title> <para> - Lorsque vous rendez des nouveaux objets persistants, vous devez r�guli�rement appeler + Lorsque vous rendez des nouveaux objets persistants, vous devez régulièrement appeler <literal>flush()</literal> et puis <literal>clear()</literal> sur la session, - pour contr�ler la taille du cache de premier niveau. + pour contrôler la taille du cache de premier niveau. </para> <programlisting><![CDATA[Session session = sessionFactory.openSession(); @@ -55,8 +57,8 @@ for ( int i=0; i<100000; i++ ) { Customer customer = new Customer(.....); session.save(customer); - if ( i % 20 == 0 ) { //20, m�me taille que la taille du paquet JDBC - //flush un paquet d'insertions et lib�re la m�moire : + if ( i % 20 == 0 ) { //20, même taille que la taille du paquet JDBC + //flush un paquet d'insertions et libère la mémoire : session.flush(); session.clear(); } @@ -68,12 +70,12 @@ </sect1> <sect1 id="batch-update" > - <title>Paquet de mises � jour</title> + <title>Paquet de mises à jour</title> <para> - Pour r�cup�rer et mettre � jour des donn�es les m�mes id�es s'appliquent. En plus, + Pour récupérer et mettre à jour des données les mêmes idées s'appliquent. En plus, vous avez besoin d'utiliser <literal>scroll()</literal> pour tirer partie des - curseurs c�t� serveur pour les requ�tes qui retournent beaucoup de lignes de donn�es. + curseurs côté serveur pour les requêtes qui retournent beaucoup de lignes de données. </para> <programlisting><![CDATA[Session session = sessionFactory.openSession(); @@ -87,7 +89,7 @@ Customer customer = (Customer) customers.get(0); customer.updateStuff(...); if ( ++count % 20 == 0 ) { - //flush un paquet de mises � jour et lib�re la m�moire : + //flush un paquet de mises à jour et libère la mémoire : session.flush(); session.clear(); } @@ -101,20 +103,20 @@ <sect1 id="batch-statelesssession"> <title>L'interface StatelessSession</title> <para> - Alternativement, Hibernate fournit une API orient�e commande qui peut �tre - utilis�e avec des flux de donn�es pour et en provenance de la base de donn�es - sous la forme d'objets d�tach�s. Une <literal>StatelessSession</literal> n'a pas - de contexte de persistance associ� et ne fournit pas beaucoup de s�mantique de - dur�e de vie de haut niveau. En particulier, une session sans �tat n'impl�mente + Alternativement, Hibernate fournit une API orientée commande qui peut être + utilisée avec des flux de données pour et en provenance de la base de données + sous la forme d'objets détachés. Une <literal>StatelessSession</literal> n'a pas + de contexte de persistance associé et ne fournit pas beaucoup de sémantique de + durée de vie de haut niveau. En particulier, une session sans état n'implémente pas de cache de premier niveau et n'interagit pas non plus avec un cache de - seconde niveau ou un cache de requ�tes. Elle n'impl�mente pas les transactions - ou la v�rification sale automatique (NdT : automatic dirty checking). Les - op�rations r�alis�es avec une session sans �tat ne sont jamais r�percut�es - en cascade sur les instances associ�es. Les collections sont ignor�es par une - session sans �tat. Les op�rations ex�cut�es via une session sans �tat outrepasse - le mod�le d'�v�nements d'Hibernate et les intercepteurs. Les sessions sans �tat sont - vuln�rables aux effets de modification des donn�es, ceci est d� au manque de cache - de premier niveau. Une session sans �tat est une abstraction bas niveau, plus + seconde niveau ou un cache de requêtes. Elle n'implémente pas les transactions + ou la vérification sale automatique (NdT : automatic dirty checking). Les + opérations réalisées avec une session sans état ne sont jamais répercutées + en cascade sur les instances associées. Les collections sont ignorées par une + session sans état. Les opérations exécutées via une session sans état outrepasse + le modèle d'événements d'Hibernate et les intercepteurs. Les sessions sans état sont + vulnérables aux effets de modification des données, ceci est dû au manque de cache + de premier niveau. Une session sans état est une abstraction bas niveau, plus proche de la couche JDBC sous-jacente. </para> @@ -134,39 +136,39 @@ <para> Notez que dans le code de l'exemple, les intances de <literal>Customer</literal> - retourn�es par la requ�te sont imm�diatement d�tach�es. Elles ne sont jamais - associ�es � un contexte de persistance. + retournées par la requête sont immédiatement détachées. Elles ne sont jamais + associées à un contexte de persistance. </para> <para> - Les op�rations <literal>insert()</literal>, <literal>update()</literal> et - <literal>delete()</literal> d�finies par l'interface <literal>StatelessSession</literal> - sont consid�r�es comme des op�rations d'acc�s direct aux lignes de la base de donn�es, - ce qui r�sulte en une ex�cution imm�diate du SQL <literal>INSERT</literal>, <literal>UPDATE</literal> - ou <literal>DELETE</literal> respectif. De l�, elles ont des s�mantiques tres diff�rentes des - op�rations <literal>save()</literal>, <literal>saveOrUpdate()</literal> - et <literal>delete()</literal> d�finies par l'interface <literal>Session</literal>. + Les opérations <literal>insert()</literal>, <literal>update()</literal> et + <literal>delete()</literal> définies par l'interface <literal>StatelessSession</literal> + sont considérées comme des opérations d'accès direct aux lignes de la base de données, + ce qui résulte en une exécution immédiate du SQL <literal>INSERT</literal>, <literal>UPDATE</literal> + ou <literal>DELETE</literal> respectif. De là, elles ont des sémantiques tres différentes des + opérations <literal>save()</literal>, <literal>saveOrUpdate()</literal> + et <literal>delete()</literal> définies par l'interface <literal>Session</literal>. </para> </sect1> <sect1 id="batch-direct" revision="2"> - <title>Op�rations de style DML</title> + <title>Opérations de style DML</title> <para> - Comme d�j� discut� avant, le mapping objet/relationnel automatique et transparent - est int�ress� par la gestion de l'�tat de l'objet. Ceci implique que l'�tat de l'objet - est disponible en m�moire, d'o� manipuler (en utilisant des expressions du langage de - manipulation de donn�es - <literal>Data Manipulation Language</literal> (DML) - SQL) - les donn�es directement dans la base n'affectera pas l'�tat en m�moire. Pourtant, Hibernate - fournit des m�thodes pour l'ex�cution d'expression DML de style SQL lesquelles sont - r�alis�es � travers le langage de requ�te d'Hibernate (<xref linkend="queryhql">HQL</xref>). + Comme déjà discuté avant, le mapping objet/relationnel automatique et transparent + est intéressé par la gestion de l'état de l'objet. Ceci implique que l'état de l'objet + est disponible en mémoire, d'où manipuler (en utilisant des expressions du langage de + manipulation de données - <literal>Data Manipulation Language</literal> (DML) - SQL) + les données directement dans la base n'affectera pas l'état en mémoire. Pourtant, Hibernate + fournit des méthodes pour l'exécution d'expression DML de style SQL lesquelles sont + réalisées à travers le langage de requête d'Hibernate (<xref linkend="queryhql">HQL</xref>). </para> <para> La pseudo-syntaxe pour les expressions <literal>UPDATE</literal> et <literal>DELETE</literal> est : <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?</literal>. - Certains points sont � noter : + Certains points sont à noter : </para> <itemizedlist spacing="compact"> @@ -177,18 +179,18 @@ </listitem> <listitem> <para> - Il ne peut y avoir qu'une seule entit� nomm�e dans la clause from ; elle peut - optionnellement avoir un alias. Si le nom de l'entit� a un alias, alors - n'importe quelle r�f�rence de propri�t� doit �tre qualifi�e en ayant un alias ; - si le nom de l'entit� n'a pas d'alias, alors il est ill�gal pour n'importe quelle - r�f�rence de propri�t� d'�tre qualifi�e. + Il ne peut y avoir qu'une seule entité nommée dans la clause from ; elle peut + optionnellement avoir un alias. Si le nom de l'entité a un alias, alors + n'importe quelle référence de propriété doit être qualifiée en ayant un alias ; + si le nom de l'entité n'a pas d'alias, alors il est illégal pour n'importe quelle + référence de propriété d'être qualifiée. </para> </listitem> <listitem> <para> - Aucune jointure (implicite ou explicite) ne peut �tre sp�cifi�e dans une requ�te HQL. - Les sous-requ�tes peuvent �tre utilis�es dans la clause where ; les sous-requ�tes, - elles-m�mes, peuvent contenir des jointures. + Aucune jointure (implicite ou explicite) ne peut être spécifiée dans une requête HQL. + Les sous-requêtes peuvent être utilisées dans la clause where ; les sous-requêtes, + elles-mêmes, peuvent contenir des jointures. </para> </listitem> <listitem> @@ -199,8 +201,8 @@ </itemizedlist> <para> - Par exemple, pour ex�cuter un <literal>UPDATE</literal> HQL, utilisez la m�thode - <literal>Query.executeUpdate()</literal> (la m�thode est donn�es pour ceux + Par exemple, pour exécuter un <literal>UPDATE</literal> HQL, utilisez la méthode + <literal>Query.executeUpdate()</literal> (la méthode est données pour ceux qui sont familiers avec <literal>PreparedStatement.executeUpdate()</literal> de JDBC) : </para> @@ -218,7 +220,7 @@ session.close();]]></programlisting> <para> - Pour ex�cuter un <literal>DELETE</literal> HQL, utilisez la m�me m�thode + Pour exécuter un <literal>DELETE</literal> HQL, utilisez la même méthode <literal>Query.executeUpdate()</literal> : </para> @@ -234,85 +236,85 @@ session.close();]]></programlisting> <para> - La valeur du <literal>int</literal> retourn� par la m�thode <literal>Query.executeUpdate()</literal> - indique le nombre d'entit�s affect�es par l'op�ration. Consid�rez que cela peut ou pas - corr�ler le nombre de lignes affect�s dans la base de donn�es. Une op�ration HQL - pourrait entra�ner l'ex�cution de multiples expressions SQL r�elles, pour des classes - filles mapp�es par jointure (NdT: join-subclass), par exemple. Le nombre retourn� - indique le nombre d'entit�s r�elles affect�es par l'expression. Retour � l'exemple de la - classe fille mapp�e par jointure, un effacement d'une des classes filles peut r�ellement - entra�ner des suppressions pas seulement dans la table qui mappe la classe fille, mais + La valeur du <literal>int</literal> retourné par la méthode <literal>Query.executeUpdate()</literal> + indique le nombre d'entités affectées par l'opération. Considérez que cela peut ou pas + corréler le nombre de lignes affectés dans la base de données. Une opération HQL + pourrait entraîner l'exécution de multiples expressions SQL réelles, pour des classes + filles mappées par jointure (NdT: join-subclass), par exemple. Le nombre retourné + indique le nombre d'entités réelles affectées par l'expression. Retour à l'exemple de la + classe fille mappée par jointure, un effacement d'une des classes filles peut réellement + entraîner des suppressions pas seulement dans la table qui mappe la classe fille, mais aussi dans la table "racine" et potentillement dans les tables des classes filles plus bas - dans la hi�rarchie d'h�ritage. + dans la hiérarchie d'héritage. </para> <para> La pseudo-syntaxe pour l'expression <literal>INSERT</literal> est : <literal>INSERT INTO EntityName properties_list select_statement</literal>. Quelques - points sont � noter : + points sont à noter : </para> <itemizedlist spacing="compact"> <listitem> <para> - Seule la forme INSERT INTO ... SELECT ... est support�e ; pas la forme INSERT INTO ... VALUES ... . + Seule la forme INSERT INTO ... SELECT ... est supportée ; pas la forme INSERT INTO ... VALUES ... . </para> <para> - La properties_list est analogue � la <literal>sp�cification de la colonne</literal> + La properties_list est analogue à la <literal>spécification de la colonne</literal> The properties_list is analogous to the <literal>column speficiation</literal> dans - l'expression SQL <literal>INSERT</literal>. Pour les entit�s impliqu�es dans - un h�ritage mapp�, seules les propri�t�s directement d�finies � ce niveau de classe - donn� peuvent �tre utilis�es dans properties_list. Les propri�t�s de la classe m�re - ne sont pas permises ; et les propri�t�s des classes filles n'ont pas de sens. En + l'expression SQL <literal>INSERT</literal>. Pour les entités impliquées dans + un héritage mappé, seules les propriétés directement définies à ce niveau de classe + donné peuvent être utilisées dans properties_list. Les propriétés de la classe mère + ne sont pas permises ; et les propriétés des classes filles n'ont pas de sens. En d'autres mots, les expressions <literal>INSERT</literal> par nature non polymorphiques. </para> </listitem> <listitem> <para> - select_statement peut �tre n'importe quelle requ�te de s�lection HQl valide, avec + select_statement peut être n'importe quelle requête de sélection HQl valide, avec l'avertissement que les types de retour doivent correspondre aux types attendus par - l'insertion. Actuellement, c'est v�rifi� durant la compilation de la requ�te plut�t - que la v�rification soit rel�gu�e � la base de donn�es. Notez cependant que cela - pourrait poser des probl�mes entre les <literal>Type</literal>s d'Hibernate qui - sont <emphasis>�quivalents</emphasis> oppos� � <emphasis>�gaux</emphasis>. Cela - pourrait poser des probl�mes avec des disparit�s entre une propri�t� d�finie - comme un <literal>org.hibernate.type.DateType</literal> et une propri�t� d�finie - comme un <literal>org.hibernate.type.TimestampType</literal>, m�me si la base de donn�es - ne ferait pas de distinction ou ne serait pas capable de g�rer la conversion. + l'insertion. Actuellement, c'est vérifié durant la compilation de la requête plutôt + que la vérification soit reléguée à la base de données. Notez cependant que cela + pourrait poser des problèmes entre les <literal>Type</literal>s d'Hibernate qui + sont <emphasis>équivalents</emphasis> opposé à <emphasis>égaux</emphasis>. Cela + pourrait poser des problèmes avec des disparités entre une propriété définie + comme un <literal>org.hibernate.type.DateType</literal> et une propriété définie + comme un <literal>org.hibernate.type.TimestampType</literal>, même si la base de données + ne ferait pas de distinction ou ne serait pas capable de gérer la conversion. </para> </listitem> <listitem> <para> - Pour la propri�te id, l'expression d'insertion vous donne deux options. Vous - pouvez soit sp�cifier explicitement la propri�t� id dans properties_list - (auquel cas sa valeur est extraite de l'expression de s�lection correspondante), - soit l'omettre de properties_list (auquel cas une valeur g�n�r�e est utilis�e). - Cette derni�re option est seulement disponible en utilisant le g�n�rateur d'identifiant - qui op�re dans la base de donn�es ; tenter d'utiliser cette option avec n'importe quel - type de g�n�rateur "en m�moire" causera une exception durant l'analyse. Notez - que pour les buts de cette discussion, les g�n�rateurs "en base" sont consid�r�s - �tre <literal>org.hibernate.id.SequenceGenerator</literal> (et ses classes filles) - et n'importe quelles impl�mentations de + Pour la propriéte id, l'expression d'insertion vous donne deux options. Vous + pouvez soit spécifier explicitement la propriété id dans properties_list + (auquel cas sa valeur est extraite de l'expression de sélection correspondante), + soit l'omettre de properties_list (auquel cas une valeur générée est utilisée). + Cette dernière option est seulement disponible en utilisant le générateur d'identifiant + qui opère dans la base de données ; tenter d'utiliser cette option avec n'importe quel + type de générateur "en mémoire" causera une exception durant l'analyse. Notez + que pour les buts de cette discussion, les générateurs "en base" sont considérés + être <literal>org.hibernate.id.SequenceGenerator</literal> (et ses classes filles) + et n'importe quelles implémentations de <literal>org.hibernate.id.PostInsertIdentifierGenerator</literal>. L'exception la plus notable ici est <literal>org.hibernate.id.TableHiLoGenerator</literal>, - qu ne peut pas �tre utilis�e parce qu'il ne propose pas un moyen de d'exposer ses valeurs + qu ne peut pas être utilisée parce qu'il ne propose pas un moyen de d'exposer ses valeurs par un select. </para> </listitem> <listitem> <para> - Pour des propri�t�s mapp�es comme <literal>version</literal> ou <literal>timestamp</literal>, - l'expression d'insertion vous donne deux options. Vous pouvez soit sp�cifier la propri�t� dans + Pour des propriétés mappées comme <literal>version</literal> ou <literal>timestamp</literal>, + l'expression d'insertion vous donne deux options. Vous pouvez soit spécifier la propriété dans properties_list (auquel cas sa valeur est extraite des expressions select correspondantes), soit l'omettre de properties_list (auquel cas la <literal>valeur de graine</literal> - (NdT : seed value) d�finie par le <literal>org.hibernate.type.VersionType</literal> est utilis�e). + (NdT : seed value) définie par le <literal>org.hibernate.type.VersionType</literal> est utilisée). </para> </listitem> </itemizedlist> <para> - Un exemple d'ex�cution d'une expression <literal>INSERT</literal> HQL : + Un exemple d'exécution d'une expression <literal>INSERT</literal> HQL : </para> <programlisting><![CDATA[Session session = sessionFactory.openSession(); Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/best_practices.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/best_practices.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/best_practices.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,25 +1,27 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="best-practices" revision="3"> <title>Meilleures pratiques</title> <variablelist spacing="compact"> <varlistentry> - <term>D�coupez finement vos classes et mappez les en utilisant <literal>&lt;component&gt;</literal>.</term> + <term>Découpez finement vos classes et mappez les en utilisant <literal>&lt;component&gt;</literal>.</term> <listitem> <para> Utilisez une classe <literal>Adresse</literal> pour encapsuler <literal>Rue</literal>, <literal>Region</literal>, <literal>CodePostal</literal>. - Ceci permet la r�utilisation du code et simplifie la maintenance. + Ceci permet la réutilisation du code et simplifie la maintenance. </para> </listitem> </varlistentry> <varlistentry> - <term>D�clarez des propri�t�s d'identifiants dans les classes persistantes.</term> + <term>Déclarez des propriétés d'identifiants dans les classes persistantes.</term> <listitem> <para> - Hibernate rend les propri�t�s d'identifiants optionnelles. Il existe beaucoup de raisons + Hibernate rend les propriétés d'identifiants optionnelles. Il existe beaucoup de raisons pour lesquelles vous devriez les utiliser. Nous recommandons que vous utilisiez des identifiants - techniques (g�n�r�s, et sans connotation m�tier). + techniques (générés, et sans connotation métier). </para> </listitem> </varlistentry> @@ -27,9 +29,9 @@ <term>Identifiez les clefs naturelles.</term> <listitem> <para> - Identifiez les clefs naturelles pour toutes les entit�s, et mappez les avec - <literal>&lt;natural-id&gt;</literal>. Impl�mentez <literal>equals()</literal> et - <literal>hashCode()</literal> pour comparer les propri�t�s qui composent la clef naturelle. + Identifiez les clefs naturelles pour toutes les entités, et mappez les avec + <literal>&lt;natural-id&gt;</literal>. Implémentez <literal>equals()</literal> et + <literal>hashCode()</literal> pour comparer les propriétés qui composent la clef naturelle. </para> </listitem> </varlistentry> @@ -39,7 +41,7 @@ <para> N'utilisez pas un unique document de mapping. Mappez <literal>com.eg.Foo</literal> dans le fichier <literal>com/eg/Foo.hbm.xml</literal>. Cela prend tout son sens lors - d'un travail en �quipe. + d'un travail en équipe. </para> </listitem> </varlistentry> @@ -47,63 +49,63 @@ <term>Chargez les mappings comme des ressources.</term> <listitem> <para> - D�ployez les mappings en m�me temps que les classes qu'ils mappent. + Déployez les mappings en même temps que les classes qu'ils mappent. </para> </listitem> </varlistentry> <varlistentry> - <term>Pensez � externaliser les cha�nes de caract�res.</term> + <term>Pensez à externaliser les chaînes de caractères.</term> <listitem> <para> - Ceci est une bonne habitude si vos requ�tes appellent des fonctions SQL qui ne sont + Ceci est une bonne habitude si vos requêtes appellent des fonctions SQL qui ne sont pas au standard ANSI. Cette externalisation dans les fichiers de mapping rendra votre application plus portable. </para> </listitem> </varlistentry> <varlistentry> - <term>Utilisez les variables "bind�es".</term> + <term>Utilisez les variables "bindées".</term> <listitem> <para> Comme en JDBC, remplacez toujours les valeurs non constantes par "?". N'utilisez jamais - la manipulation des cha�nes de caract�res pour remplacer des valeurs non constantes dans - une requ�te ! Encore mieux, utilisez les param�tres nomm�s dans les requ�tes. + la manipulation des chaînes de caractères pour remplacer des valeurs non constantes dans + une requête ! Encore mieux, utilisez les paramètres nommés dans les requêtes. </para> </listitem> </varlistentry> <varlistentry> - <term>Ne g�rez pas vous m�me les connexions JDBC.</term> + <term>Ne gérez pas vous même les connexions JDBC.</term> <listitem> <para> - Hibernate laisse l'application g�rer les connexions JDBC. Vous ne devriez g�rer vos connexions - qu'en dernier recours. Si vous ne pouvez pas utiliser les syst�mes de connexions livr�s, - r�fl�chissez � l'id�e de fournir votre propre impl�mentation de <literal>org.hibernate.connection.ConnectionProvider</literal>. + Hibernate laisse l'application gérer les connexions JDBC. Vous ne devriez gérer vos connexions + qu'en dernier recours. Si vous ne pouvez pas utiliser les systèmes de connexions livrés, + réfléchissez à l'idée de fournir votre propre implémentation de <literal>org.hibernate.connection.ConnectionProvider</literal>. </para> </listitem> </varlistentry> <varlistentry> - <term>Pensez � utiliser les types utilisateurs.</term> + <term>Pensez à utiliser les types utilisateurs.</term> <listitem> <para> - Supposez que vous ayez une type Java, de telle biblioth�que, qui a besoin d'�tre persist� mais - qui ne fournit pas les accesseurs n�cessaires pour le mapper comme composant. Vous devriez - impl�menter - <literal>org.hibernate.UserType</literal>.Cette approche lib�re le code de l'application - de l'impl�mentation des transformations vers / depuis les types Hibernate. + Supposez que vous ayez une type Java, de telle bibliothèque, qui a besoin d'être persisté mais + qui ne fournit pas les accesseurs nécessaires pour le mapper comme composant. Vous devriez + implémenter + <literal>org.hibernate.UserType</literal>.Cette approche libère le code de l'application + de l'implémentation des transformations vers / depuis les types Hibernate. </para> </listitem> </varlistentry> <varlistentry> - <term>Utilisez du JDBC pur dans les goulets d'�tranglement.</term> + <term>Utilisez du JDBC pur dans les goulets d'étranglement.</term> <listitem> <para> - Dans certaines parties critiques de votre syst�me d'un point de vue performance, quelques op�rations + Dans certaines parties critiques de votre système d'un point de vue performance, quelques opérations peuvent tirer partie d'un appel JDBC natif. Mais attendez de <emphasis>savoir</emphasis> - que c'est un goulet d'�tranglement. Ne supposez jamais qu'un appel JDBC sera forc�ment plus + que c'est un goulet d'étranglement. Ne supposez jamais qu'un appel JDBC sera forcément plus rapide. Si vous avez besoin d'utiliser JDBC directement, ouvrez une <literal>Session</literal> - Hibernate et utilisez la connexion SQL sous-jacente. Ainsi vous pourrez utiliser la m�me strat�gie - de transation et la m�me gestion des connexions. + Hibernate et utilisez la connexion SQL sous-jacente. Ainsi vous pourrez utiliser la même stratégie + de transation et la même gestion des connexions. </para> </listitem> </varlistentry> @@ -111,101 +113,101 @@ <term>Comprendre le flush de <literal>Session</literal>.</term> <listitem> <para> - De temps en temps la Session synchronise ses �tats persistants avec la base de donn�es. - Les performances seront affect�es si ce processus arrive trop souvent. Vous pouvez parfois - minimiser les flush non n�cessaires en d�sactivant le flush automatique ou m�me en changeant - l'ordre des op�rations men�es dans une transaction particuli�re. + De temps en temps la Session synchronise ses états persistants avec la base de données. + Les performances seront affectées si ce processus arrive trop souvent. Vous pouvez parfois + minimiser les flush non nécessaires en désactivant le flush automatique ou même en changeant + l'ordre des opérations menées dans une transaction particulière. </para> </listitem> </varlistentry> <varlistentry> - <term>Dans une architecture � trois couches, pensez � utiliser <literal>saveOrUpdate()</literal>.</term> + <term>Dans une architecture à trois couches, pensez à utiliser <literal>saveOrUpdate()</literal>.</term> <listitem> <para> - Quand vous utilisez une architecture � base de servlet / session bean, vous pourriez passer - des objets charg�s dans le bean session vers et depuis la couche servlet / JSP. Utilisez - une nouvelle session pour traiter chaque requ�te. + Quand vous utilisez une architecture à base de servlet / session bean, vous pourriez passer + des objets chargés dans le bean session vers et depuis la couche servlet / JSP. Utilisez + une nouvelle session pour traiter chaque requête. Utilisez <literal>Session.merge()</literal> ou <literal>Session.saveOrUpdate()</literal> pour - synchroniser les objets avec la base de donn�es. + synchroniser les objets avec la base de données. </para> </listitem> </varlistentry> <varlistentry> - <term>Dans une architecture � deux couches, pensez � utiliser la d�connexion de session.</term> + <term>Dans une architecture à deux couches, pensez à utiliser la déconnexion de session.</term> <listitem> <para> - Les transactions de bases de donn�es doivent �tre aussi courtes que possible - pour une meilleure mont�e en charge.Cependant, il est souvent n�cessaire d'impl�menter - de longues <emphasis>transactions applicatives</emphasis>, une simple unit� de travail du point de vue de + Les transactions de bases de données doivent être aussi courtes que possible + pour une meilleure montée en charge.Cependant, il est souvent nécessaire d'implémenter + de longues <emphasis>transactions applicatives</emphasis>, une simple unité de travail du point de vue de l'utilisateur. Une transaction applicative - peut s'�taler sur plusieurs cycles de requ�tes/r�ponses du client. - Il est commun d'utiliser des objets d�tach�s pour impl�menter des transactions applicatives. - Une alternative, extr�mement appropri�e dans une architecture � 2 couches, est de - maintenir un seul contact de persistance ouvert (session) pour toute la dur�e de vie - de la transaction applicative et simplement se d�connecter de la connexion JDBC � la fin de chaque requ�te, - et se reconnecter au d�but de la requ�te suivante. Ne partagez jamais une seule + peut s'étaler sur plusieurs cycles de requêtes/réponses du client. + Il est commun d'utiliser des objets détachés pour implémenter des transactions applicatives. + Une alternative, extrêmement appropriée dans une architecture à 2 couches, est de + maintenir un seul contact de persistance ouvert (session) pour toute la durée de vie + de la transaction applicative et simplement se déconnecter de la connexion JDBC à la fin de chaque requête, + et se reconnecter au début de la requête suivante. Ne partagez jamais une seule session avec plus d'une transaction applicative, ou vous travaillerez avec des - donn�es p�rim�es. + données périmées. </para> </listitem> </varlistentry> <varlistentry> - <term>Consid�rez que les exceptions ne sont pas rattrapables.</term> + <term>Considérez que les exceptions ne sont pas rattrapables.</term> <listitem> <para> Il s'agit plus d'une pratique obligatoire que d'une "meilleure pratique". Quand une exception intervient, il faut faire un rollback de la <literal>Transaction</literal> et fermer la <literal>Session</literal>. - Sinon, Hibernate ne peut garantir l'int�grit� des �tats persistants en m�moire. En particulier, - n'utilisez pas <literal>Session.load()</literal> pour d�terminer si une instance avec un identifiant - donn� existe en base de donn�es, utilisez <literal>Session.get()</literal> ou un requ�te. + Sinon, Hibernate ne peut garantir l'intégrité des états persistants en mémoire. En particulier, + n'utilisez pas <literal>Session.load()</literal> pour déterminer si une instance avec un identifiant + donné existe en base de données, utilisez <literal>Session.get()</literal> ou un requête. </para> </listitem> </varlistentry> <varlistentry> - <term>Pr�f�rez le chargement tardif des associations.</term> + <term>Préférez le chargement tardif des associations.</term> <listitem> <para> - Utilisez le chargement complet avec mod�ration. - Utilisez les proxies et les collections charg�es tardivement + Utilisez le chargement complet avec modération. + Utilisez les proxies et les collections chargées tardivement pour la plupart des associations vers des classes qui ne sont pas susceptibles - d'�tre compl�tement retenues dans le cache de second niveau. - Pour les assocations de classes en cache, o� il y a une extr�mement - forte probabilit� que l'�l�ment soit en cache, d�sactivez explicitement le chargement + d'être complètement retenues dans le cache de second niveau. + Pour les assocations de classes en cache, où il y a une extrêmement + forte probabilité que l'élément soit en cache, désactivez explicitement le chargement par jointures ouvertes en utilisant <literal>outer-join="false"</literal>. - Lorsqu'un chargement par jointure ouverte est appropri� pour un cas d'utilisation - particulier, utilisez une requ�te avec un <literal>left join fetch</literal>. + Lorsqu'un chargement par jointure ouverte est approprié pour un cas d'utilisation + particulier, utilisez une requête avec un <literal>left join fetch</literal>. </para> </listitem> </varlistentry> <varlistentry> <term> Utilisez le pattern <emphasis>d'une ouverture de session dans une vue</emphasis>, - ou une <emphasis>phase d'assemblage</emphasis> disciplin�e pour �viter des probl�mes - avec des donn�es non rapatri�es. + ou une <emphasis>phase d'assemblage</emphasis> disciplinée pour éviter des problèmes + avec des données non rapatriées. </term> <listitem> <para> - Hibernate lib�re les d�veloppeurs de l'�criture fastidieuse des <emphasis>objets de transfert - de donn�es (NdT : Data Transfer Objects)</emphasis> (DTO). Dans une architecture EJB traditionnelle, - les DTOs ont deux buts : premi�rement, ils contournent le probl�me des "entity bean" qui ne sont pas - s�rialisables ; deuxi�mement, ils d�finissent implicitement une phase d'assemblage o� toutes les - donn�es utilis�es par la vue sont rapatri�es et organis�es dans les DTOs avant de retourner sous le - contr�le de la couche de pr�sentation. Hibernate �limine le premier but. Pourtant, vous aurez encore - besoin d'une phase d'assemblage (pensez vos m�thodes m�tier comme ayant un contrat strict avec la - couche de pr�sentation � propos de quelles donn�es sont disponibles dans les objets d�tach�s) - � moins que vous soyez pr�par�s � garder le contexte de - persistance (la session) ouvert � travers tout le processus de rendu de la vue. + Hibernate libère les développeurs de l'écriture fastidieuse des <emphasis>objets de transfert + de données (NdT : Data Transfer Objects)</emphasis> (DTO). Dans une architecture EJB traditionnelle, + les DTOs ont deux buts : premièrement, ils contournent le problème des "entity bean" qui ne sont pas + sérialisables ; deuxièmement, ils définissent implicitement une phase d'assemblage où toutes les + données utilisées par la vue sont rapatriées et organisées dans les DTOs avant de retourner sous le + contrôle de la couche de présentation. Hibernate élimine le premier but. Pourtant, vous aurez encore + besoin d'une phase d'assemblage (pensez vos méthodes métier comme ayant un contrat strict avec la + couche de présentation à propos de quelles données sont disponibles dans les objets détachés) + à moins que vous soyez préparés à garder le contexte de + persistance (la session) ouvert à travers tout le processus de rendu de la vue. </para> </listitem> </varlistentry> <varlistentry> - <term>Pensez � abstraite votre logique m�tier d'Hibernate.</term> + <term>Pensez à abstraite votre logique métier d'Hibernate.</term> <listitem> <para> - Cachez le m�canisme d'acc�s aux donn�es (Hibernate) derri�re une interface. Combinez les patterns - <emphasis>DAO</emphasis> et <emphasis>Thread Local Session</emphasis>. Vous pouvez m�me avoir quelques - classes persist�es par du JDBC pur, associ�es � Hibernate via un <literal>UserType</literal> (ce conseil est + Cachez le mécanisme d'accès aux données (Hibernate) derrière une interface. Combinez les patterns + <emphasis>DAO</emphasis> et <emphasis>Thread Local Session</emphasis>. Vous pouvez même avoir quelques + classes persistées par du JDBC pur, associées à Hibernate via un <literal>UserType</literal> (ce conseil est valable pour des applications de taille respectables ; il n'est pas valable pour une application avec cinq tables). </para> @@ -217,20 +219,20 @@ <para> De bons cas d'utilisation pour de vraies associations plusieurs-vers-plusieurs sont rares. La plupart du temps vous avez besoin d'informations additionnelles - stock�es dans la table d'association. - Dans ce cas, il est pr�f�rable d'utiliser deux associations un-vers-plusieurs vers une classe - de liaisons interm�diaire. En fait, nous pensons que la plupart des associations sont - de type un-vers-plusieurs ou plusieurs-vers-un, vous devez �tre tr�s attentifs lorsque - vous utilisez autre chose et vous demander si c'est vraiment n�cessaire. + stockées dans la table d'association. + Dans ce cas, il est préférable d'utiliser deux associations un-vers-plusieurs vers une classe + de liaisons intermédiaire. En fait, nous pensons que la plupart des associations sont + de type un-vers-plusieurs ou plusieurs-vers-un, vous devez être très attentifs lorsque + vous utilisez autre chose et vous demander si c'est vraiment nécessaire. </para> </listitem> </varlistentry> <varlistentry> - <term>Pr�f�rez les associations bidirectionnelles.</term> + <term>Préférez les associations bidirectionnelles.</term> <listitem> <para> - Les associations unidirectionnelles sont plus difficiles � questionner. - Dans une grande application, la plupart des associations devraient �tre navigables dans les deux directions dans les requ�tes. + Les associations unidirectionnelles sont plus difficiles à questionner. + Dans une grande application, la plupart des associations devraient être navigables dans les deux directions dans les requêtes. </para> </listitem> </varlistentry> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/collection_mapping.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/collection_mapping.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/collection_mapping.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,4 +1,6 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="collections"> <title>Mapping des collections</title> @@ -6,7 +8,7 @@ <title>Collections persistantes</title> <para> - Hibernate requiert que les champs contenant des collections persistantes soient d�clar�s + Hibernate requiert que les champs contenant des collections persistantes soient déclarés comme des types d'interface, par exemple : </para> @@ -21,21 +23,21 @@ }]]></programlisting> <para> - L'interface r�elle devrait �tre <literal>java.util.Set</literal>, + L'interface réelle devrait être <literal>java.util.Set</literal>, <literal>java.util.Collection</literal>, <literal>java.util.List</literal>, <literal>java.util.Map</literal>, <literal>java.util.SortedSet</literal>, - <literal>java.util.SortedMap</literal> ou ... n'importe quoi d'autre ! (O� - "n'importe quoi d'autre" signifie que vous devrez �crire une impl�mentation de + <literal>java.util.SortedMap</literal> ou ... n'importe quoi d'autre ! (Où + "n'importe quoi d'autre" signifie que vous devrez écrire une implémentation de <literal>org.hibernate.usertype.UserCollectionType</literal>.) </para> <para> - Notez comment nous avons initialis� les variables d'instance avec une instance de + Notez comment nous avons initialisé les variables d'instance avec une instance de <literal>HashSet</literal>. C'est le meilleur moyen pour initialiser les - collections d'instances nouvellement cr��es (non persistantes). Quand + collections d'instances nouvellement créées (non persistantes). Quand nous fabriquons l'instance persistante - en appelant <literal>persist()</literal>, - par exemple - Hibernate remplacera r�ellement le <literal>HashSet</literal> - avec une instance d'une impl�mentation propre � Hibernate de <literal>Set</literal>. + par exemple - Hibernate remplacera réellement le <literal>HashSet</literal> + avec une instance d'une implémentation propre à Hibernate de <literal>Set</literal>. Prenez garde aux erreurs : </para> @@ -50,7 +52,7 @@ (HashSet) cat.getKittens(); // Erreur !]]></programlisting> <para> - Les collections persistantes inject�es par Hibernate se comportent de la m�me mani�re que + Les collections persistantes injectées par Hibernate se comportent de la même manière que <literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</literal>, <literal>TreeSet</literal> ou <literal>ArrayList</literal>, selon le type de l'interface. @@ -58,19 +60,19 @@ <para> Les instances des collections ont le comportement habituel des types des valeurs. - Elles sont automatiquement persist�es quand elles sont r�f�renc�es par un objet persistant et - automatiquement effac�es quand elles sont d�r�f�renc�es. Si une collection est pass�e - d'un objet persistant � un autre, ses �l�ments pourraient �tre d�plac�s d'une table - � une autre. Deux entit�s ne peuvent pas partager une r�f�rence vers une m�me instance - d'une collection. D� au mod�le relationnel sous-jacent, les propri�t�s contenant des - collections ne supportent pas la s�mantique de la valeur null ; Hibernate ne distingue pas - une r�f�rence vers une collection nulle d'une collection vide. + Elles sont automatiquement persistées quand elles sont référencées par un objet persistant et + automatiquement effacées quand elles sont déréférencées. Si une collection est passée + d'un objet persistant à un autre, ses éléments pourraient être déplacés d'une table + à une autre. Deux entités ne peuvent pas partager une référence vers une même instance + d'une collection. Dû au modèle relationnel sous-jacent, les propriétés contenant des + collections ne supportent pas la sémantique de la valeur null ; Hibernate ne distingue pas + une référence vers une collection nulle d'une collection vide. </para> <para> - Vous ne devriez pas vous pr�occuper trop de �a. Utilisez les collections persistantes de - la m�me mani�re que vous utilisez des collections Java ordinaires. Assurez-vous - de comprendre la s�mantique des associations bidirectionnelles (trait�e plus loin). + Vous ne devriez pas vous préoccuper trop de ça. Utilisez les collections persistantes de + la même manière que vous utilisez des collections Java ordinaires. Assurez-vous + de comprendre la sémantique des associations bidirectionnelles (traitée plus loin). </para> </sect1> @@ -79,9 +81,9 @@ <title>Mapper une collection</title> <para> - L'�l�ment de mapping d'Hibernate utilis� pour mapper une collection d�pend du type de - l'interface. Par exemple, un �l�ment <literal>&lt;set&gt;</literal> est utilis� - pour mapper des propri�t�s de type <literal>Set</literal>. + L'élément de mapping d'Hibernate utilisé pour mapper une collection dépend du type de + l'interface. Par exemple, un élément <literal>&lt;set&gt;</literal> est utilisé + pour mapper des propriétés de type <literal>Set</literal>. </para> <programlisting><![CDATA[<class name="Product"> @@ -93,11 +95,11 @@ </class>]]></programlisting> <para> - � part <literal>&lt;set&gt;</literal>, il y aussi les �l�ments de mapping + À part <literal>&lt;set&gt;</literal>, il y aussi les éléments de mapping <literal>&lt;list&gt;</literal>, <literal>&lt;map&gt;</literal>, <literal>&lt;bag&gt;</literal>, <literal>&lt;array&gt;</literal> et <literal>&lt;primitive-array&gt;</literal>. - L'�l�ment <literal>&lt;map&gt;</literal> est repr�sentatif : + L'élément <literal>&lt;map&gt;</literal> est représentatif : </para> <programlistingco> @@ -143,97 +145,97 @@ <calloutlist> <callout arearefs="mappingcollection1"> <para> - <literal>name</literal> : le nom de la propri�t� contenant la collection + <literal>name</literal> : le nom de la propriété contenant la collection </para> </callout> <callout arearefs="mappingcollection2"> <para> - <literal>table</literal> (optionnel - par d�faut = nom de la propri�t�) : le - nom de la table de la collection (non utilis� pour les associations one-to-many) + <literal>table</literal> (optionnel - par défaut = nom de la propriété) : le + nom de la table de la collection (non utilisé pour les associations one-to-many) </para> </callout> <callout arearefs="mappingcollection3"> <para> - <literal>schema</literal> (optionnel) : le nom du sch�ma pour surcharger le - sch�ma d�clar� dans l'�l�ment racine + <literal>schema</literal> (optionnel) : le nom du schéma pour surcharger le + schéma déclaré dans l'élément racine </para> </callout> <callout arearefs="mappingcollection4"> <para> - <literal>lazy</literal> (optionnel - par d�faut = <literal>true</literal>) : - peut �tre utilis� pour d�sactiver l'initialisation tardive et sp�cifier - que l'association est toujours rapport�e, ou pour activer la - r�cup�ration extra-paresseuse (NdT : extra-lazy) o� la plupart des - op�rations n'initialisent pas la collection (appropri� pour de tr�s + <literal>lazy</literal> (optionnel - par défaut = <literal>true</literal>) : + peut être utilisé pour désactiver l'initialisation tardive et spécifier + que l'association est toujours rapportée, ou pour activer la + récupération extra-paresseuse (NdT : extra-lazy) où la plupart des + opérations n'initialisent pas la collection (approprié pour de très grosses collections) </para> </callout> <callout arearefs="mappingcollection5"> <para> - <literal>inverse</literal> (optionnel - par d�faut = <literal>false</literal>) : - d�finit cette collection comme l'extr�mit� "inverse" de l'association + <literal>inverse</literal> (optionnel - par défaut = <literal>false</literal>) : + définit cette collection comme l'extrêmité "inverse" de l'association bidirectionnelle </para> </callout> <callout arearefs="mappingcollection6"> <para> - <literal>cascade</literal> (optionnel - par d�faut = <literal>none</literal>) : - active les op�rations de cascade vers les entit�s filles + <literal>cascade</literal> (optionnel - par défaut = <literal>none</literal>) : + active les opérations de cascade vers les entités filles </para> </callout> <callout arearefs="mappingcollection7"> <para> - <literal>sort</literal> (optionnel) : sp�cifie une collection tri�e via un ordre - de tri <literal>naturel</literal>, ou via une classe comparateur donn�e (impl�mentant Comparator) + <literal>sort</literal> (optionnel) : spécifie une collection triée via un ordre + de tri <literal>naturel</literal>, ou via une classe comparateur donnée (implémentant Comparator) </para> </callout> <callout arearefs="mappingcollection8"> <para> - <literal>order-by</literal> (optionnel, seulement � partir du JDK1.4) : - sp�cifie une colonne de table - (ou des colonnes) qui d�finit l'ordre d'it�ration de <literal>Map</literal>, <literal>Set</literal> + <literal>order-by</literal> (optionnel, seulement à partir du JDK1.4) : + spécifie une colonne de table + (ou des colonnes) qui définit l'ordre d'itération de <literal>Map</literal>, <literal>Set</literal> ou Bag, avec en option <literal>asc</literal> ou <literal>desc</literal> </para> </callout> <callout arearefs="mappingcollection9"> <para> - <literal>where</literal> (optionnel) : sp�cifie une condition SQL arbitraire <literal>WHERE</literal> - � utiliser au chargement ou � la suppression d'une collection (utile si la collection - ne doit contenir qu'un sous ensemble des donn�es disponibles) + <literal>where</literal> (optionnel) : spécifie une condition SQL arbitraire <literal>WHERE</literal> + à utiliser au chargement ou à la suppression d'une collection (utile si la collection + ne doit contenir qu'un sous ensemble des données disponibles) </para> </callout> <callout arearefs="mappingcollection10"> <para> - <literal>fetch</literal> (optionnel, par d�faut = <literal>select</literal>) : - � choisir entre r�cup�ration par jointures externes, r�cup�ration par - selects s�quentiels, et r�cup�ration par sous-selects s�quentiels + <literal>fetch</literal> (optionnel, par défaut = <literal>select</literal>) : + à choisir entre récupération par jointures externes, récupération par + selects séquentiels, et récupération par sous-selects séquentiels </para> </callout> <callout arearefs="mappingcollection11"> <para> - <literal>batch-size</literal> (optionnel, par d�faut = <literal>1</literal>) : une taille - de batch (batch size) utilis�e pour charger plusieurs instances de cette collection en + <literal>batch-size</literal> (optionnel, par défaut = <literal>1</literal>) : une taille + de batch (batch size) utilisée pour charger plusieurs instances de cette collection en initialisation tardive </para> </callout> <callout arearefs="mappingcollection12"> <para> - <literal>access</literal> (optionnel - par d�faut = <literal>property</literal>) : La - strat�gie qu'Hibernate doit utiliser pour acc�der � la valeur de la propri�t� + <literal>access</literal> (optionnel - par défaut = <literal>property</literal>) : La + stratégie qu'Hibernate doit utiliser pour accéder à la valeur de la propriété </para> </callout> <callout arearefs="mappingcollection13"> <para> - <literal>optimistic-lock</literal> (optionnel - par d�faut = <literal>true</literal>) : - sp�cifie que changer l'�tat de la collection entra�ne l'incr�mentation - de la version appartenant � l'entit� (Pour une association un vers plusieurs, - il est souvent raisonnable de d�sactiver ce param�tre) + <literal>optimistic-lock</literal> (optionnel - par défaut = <literal>true</literal>) : + spécifie que changer l'état de la collection entraîne l'incrémentation + de la version appartenant à l'entité (Pour une association un vers plusieurs, + il est souvent raisonnable de désactiver ce paramètre) </para> </callout> <callout arearefs="mappingcollection14"> <para> - <literal>mutable</literal> (optionnel - par d�faut = <literal>true</literal>) : - une valeur � <literal>false</literal> sp�cifie que les �l�ments de la + <literal>mutable</literal> (optionnel - par défaut = <literal>true</literal>) : + une valeur à <literal>false</literal> spécifie que les éléments de la collection ne changent jamais (une optimisation mineure dans certains cas) </para> </callout> @@ -241,74 +243,74 @@ </programlistingco> <sect2 id="collections-foreignkeys" > - <title>Les clefs �trang�res d'une collection</title> + <title>Les clefs étrangères d'une collection</title> <para> - Les instances d'une collection sont distingu�es dans la base par la clef �trang�re - de l'entit� qui poss�de la collection. Cette clef �trang�re est r�f�renc�e comme la(es) + Les instances d'une collection sont distinguées dans la base par la clef étrangère + de l'entité qui possède la collection. Cette clef étrangère est référencée comme la(es) <emphasis>colonne(s) de la clef de la collection</emphasis> de la table de la collection. - La colonne de la clef de la collection est mapp�e par l'�l�ment <literal>&lt;key&gt;</literal>. + La colonne de la clef de la collection est mappée par l'élément <literal>&lt;key&gt;</literal>. </para> <para> - Il peut y avoir une contrainte de nullit� sur la colonne de la clef �trang�re. Pour les - associations unidirectionnelles un vers plusieurs, la colonne de la clef �trang�re - peut �tre nulle par d�faut, donc vous pourriez avoir besoin de sp�cifier + Il peut y avoir une contrainte de nullité sur la colonne de la clef étrangère. Pour les + associations unidirectionnelles un vers plusieurs, la colonne de la clef étrangère + peut être nulle par défaut, donc vous pourriez avoir besoin de spécifier <literal>not-null="true"</literal>. </para> <programlisting><![CDATA[<key column="productSerialNumber" not-null="true"/>]]></programlisting> <para> - La contraite de la clef �trang�re peut utiliser <literal>ON DELETE CASCADE</literal>. + La contraite de la clef étrangère peut utiliser <literal>ON DELETE CASCADE</literal>. </para> <programlisting><![CDATA[<key column="productSerialNumber" on-delete="cascade"/>]]></programlisting> <para> - Voir le chapitre pr�c�dent pour une d�finition compl�te de l'�l�ment <literal>&lt;key&gt;</literal>. + Voir le chapitre précédent pour une définition complète de l'élément <literal>&lt;key&gt;</literal>. </para> </sect2> <sect2 id="collections-elements" > - <title>Les �l�ments d'une collection</title> + <title>Les éléments d'une collection</title> <para> Les collections peuvent contenir la plupart des autres types Hibernate, dont tous les types - basiques, les types utilisateur, les composants, et bien s�r, les r�f�rences vers - d'autres entit�s. C'est une distinction importante : un objet dans une collection - pourrait �tre g�r� avec une s�mantique de "valeur" (sa dur�e de vie d�pend compl�tement - du propri�taire de la collection) ou il pourrait avoir une r�f�rence vers une autre - entit�, avec sa propre dur�e de vie. Dans le dernier cas, seul le "lien" entre les 2 objets - est consid�r� �tre l'�tat retenu par la collection. + basiques, les types utilisateur, les composants, et bien sûr, les références vers + d'autres entités. C'est une distinction importante : un objet dans une collection + pourrait être géré avec une sémantique de "valeur" (sa durée de vie dépend complètement + du propriétaire de la collection) ou il pourrait avoir une référence vers une autre + entité, avec sa propre durée de vie. Dans le dernier cas, seul le "lien" entre les 2 objets + est considéré être l'état retenu par la collection. </para> <para> - Le type contenu est r�f�renc� comme le <emphasis>type de l'�l�ment de la collection</emphasis>. - Les �l�ments de la collections sont mapp�s par <literal>&lt;element&gt;</literal> ou - <literal>&lt;composite-element&gt;</literal>, ou dans le cas des r�f�rences d'entit�, avec + Le type contenu est référencé comme le <emphasis>type de l'élément de la collection</emphasis>. + Les éléments de la collections sont mappés par <literal>&lt;element&gt;</literal> ou + <literal>&lt;composite-element&gt;</literal>, ou dans le cas des références d'entité, avec <literal>&lt;one-to-many&gt;</literal> ou <literal>&lt;many-to-many&gt;</literal>. - Les deux premiers mappent des �l�ments avec un s�mantique de valeur, les deux suivants sont - utilis�s pour mapper des associations d'entit�. + Les deux premiers mappent des éléments avec un sémantique de valeur, les deux suivants sont + utilisés pour mapper des associations d'entité. </para> </sect2> <sect2 id="collections-indexed"> - <title>Collections index�es</title> + <title>Collections indexées</title> <para> - Tous les mappings de collection, except�s ceux avec les s�mantiques d'ensemble (NdT : set) et + Tous les mappings de collection, exceptés ceux avec les sémantiques d'ensemble (NdT : set) et de sac (NdT : bag), ont besoin d'une <emphasis>colonne d'index</emphasis> dans la table de la collection - une colonne qui mappe un index de tableau, ou un index de <literal>List</literal>, ou une clef de <literal>Map</literal>. L'index d'une - <literal>Map</literal> peut �tre n'importe quel type basique, mapp� avec - <literal>&lt;map-key&gt;</literal>, �a peut �tre une r�f�rence d'entit� mapp�e avec - <literal>&lt;map-key-many-to-many&gt;</literal>, ou �a peut �tre un type compos�, mapp� avec + <literal>Map</literal> peut être n'importe quel type basique, mappé avec + <literal>&lt;map-key&gt;</literal>, ça peut être une référence d'entité mappée avec + <literal>&lt;map-key-many-to-many&gt;</literal>, ou ça peut être un type composé, mappé avec <literal>&lt;composite-map-key&gt;</literal>. L'index d'un tableau ou d'une liste est toujours - de type <literal>integer</literal> et est mapp� en utilisant l'�l�ment <literal>&lt;list-index&gt;</literal>. - Les colonnes mapp�es contiennent des entiers s�quentiels (num�rot�s � partir de z�ro par d�faut). + de type <literal>integer</literal> et est mappé en utilisant l'élément <literal>&lt;list-index&gt;</literal>. + Les colonnes mappées contiennent des entiers séquentiels (numérotés à partir de zéro par défaut). </para> <programlistingco> @@ -327,8 +329,8 @@ </callout> <callout arearefs="index1"> <para> - <literal>base</literal> (optionnel, par d�faut = <literal>0</literal>) : la valeur - de la colonne de l'index qui correspond au premier �l�ment de la liste ou du tableau + <literal>base</literal> (optionnel, par défaut = <literal>0</literal>) : la valeur + de la colonne de l'index qui correspond au premier élément de la liste ou du tableau </para> </callout> </calloutlist> @@ -356,7 +358,7 @@ <callout arearefs="mapkey2"> <para> <literal>formula</literal> (optionnel) : - une formule SQL utilis�e pour �valuer la clef de la map + une formule SQL utilisée pour évaluer la clef de la map </para> </callout> <callout arearefs="mapkey3"> @@ -382,35 +384,35 @@ <callout arearefs="indexmanytomany1"> <para> <literal>column</literal> (optionnel) : - le nom de la colonne de la clef �trang�re pour les valeurs de l'index de la collection + le nom de la colonne de la clef étrangère pour les valeurs de l'index de la collection </para> </callout> <callout arearefs="indexmanytomany2"> <para> <literal>formula</literal> (optionnel) : - une formulre SQL utilis�e pour �valuer la clef �trang�re de la clef de la map + une formulre SQL utilisée pour évaluer la clef étrangère de la clef de la map </para> </callout> <callout arearefs="indexmanytomany3"> <para> - <literal>class</literal> (requis): la classe de l'entit� utilis�e comme clef de la map + <literal>class</literal> (requis): la classe de l'entité utilisée comme clef de la map </para> </callout> </calloutlist> </programlistingco> <para> - Si votre table n'a pas de colonne d'index, et que vous souhaitez tout de m�me utiliser - <literal>List</literal> comme type de propri�t�, vous devriez mapper la propri�t� comme un + Si votre table n'a pas de colonne d'index, et que vous souhaitez tout de même utiliser + <literal>List</literal> comme type de propriété, vous devriez mapper la propriété comme un <emphasis>&lt;bag&gt;</emphasis> Hibernate. Un sac (NdT : bag) ne garde pas son ordre quand - il est r�cup�r� de la base de donn�es, mais il peut �tre optionnellement tri� ou ordonn�. + il est récupéré de la base de données, mais il peut être optionnellement trié ou ordonné. </para> </sect2> <para> - Il y a pas mal de vari�t�s de mappings qui peuvent �tre g�n�r�s pour les collections, - couvrant beaucoup des mod�les relationnels communs. Nous vous sugg�rons d'exp�rimenter avec l'outil de - g�n�ration de sch�ma pour avoir une id�e de comment traduire les diff�rentes d�clarations de mapping vers des table de la base de donn�es. + Il y a pas mal de variétés de mappings qui peuvent être générés pour les collections, + couvrant beaucoup des modèles relationnels communs. Nous vous suggérons d'expérimenter avec l'outil de + génération de schéma pour avoir une idée de comment traduire les différentes déclarations de mapping vers des table de la base de données. </para> <sect2 id="collections-ofvalues" revision="2"> @@ -418,8 +420,8 @@ <para> N'importe quelle collection de valeurs ou association plusieurs-vers-plusieurs requiert une - <emphasis>table de collection</emphasis> avec une(des) colonne(s) de clef �trang�re, une(des) - <emphasis>colonne(s) d'�l�ment de la collection</emphasis> ou des colonnes et possiblement + <emphasis>table de collection</emphasis> avec une(des) colonne(s) de clef étrangère, une(des) + <emphasis>colonne(s) d'élément de la collection</emphasis> ou des colonnes et possiblement une(des) colonne(s) d'index. </para> @@ -447,25 +449,25 @@ <calloutlist> <callout arearefs="element1b"> <para> - <literal>column</literal> (optionnel) : le nom de la colonne contenant les valeurs de l'�l�ment de la collection + <literal>column</literal> (optionnel) : le nom de la colonne contenant les valeurs de l'élément de la collection </para> </callout> <callout arearefs="element2b"> <para> - <literal>formula</literal> (optionnel) : une formule SQL utilis�e pour �valuer l'�l�ment + <literal>formula</literal> (optionnel) : une formule SQL utilisée pour évaluer l'élément </para> </callout> <callout arearefs="element3b"> <para> - <literal>type</literal> (requis) : le type de l'�l�ment de la collection + <literal>type</literal> (requis) : le type de l'élément de la collection </para> </callout> </calloutlist> </programlistingco> <para> - Une <emphasis>association plusieurs-vers-plusieurs</emphasis> est sp�cifi�e en - utilisant l'�l�ment <literal>&lt;many-to-many&gt;</literal>. + Une <emphasis>association plusieurs-vers-plusieurs</emphasis> est spécifiée en + utilisant l'élément <literal>&lt;many-to-many&gt;</literal>. </para> <programlistingco> @@ -494,63 +496,63 @@ <calloutlist> <callout arearefs="manytomany1"> <para> - <literal>column</literal> (optionnel) : le nom de la colonne de la clef �trang�re de l'�l�ment + <literal>column</literal> (optionnel) : le nom de la colonne de la clef étrangère de l'élément </para> </callout> <callout arearefs="manytomany2"> <para> <literal>formula</literal> (optionnel) : - une formule SQL utilis�e pour �valuer la valeur de la clef �trang�re de l'�l�ment + une formule SQL utilisée pour évaluer la valeur de la clef étrangère de l'élément </para> </callout> <callout arearefs="manytomany3"> <para> - <literal>class</literal> (requis) : le nom de la classe associ�e + <literal>class</literal> (requis) : le nom de la classe associée </para> </callout> <callout arearefs="manytomany4"> <para> - <literal>fetch</literal> (optionnel - par d�faut <literal>join</literal>) : - active les r�cup�rations par jointures externes ou par selects s�quentiels pour cette association. - C'est un cas sp�cial ; pour une r�cup�ration compl�te sans attente (dans un seul <literal>SELECT</literal>) d'une - entit� et de ses relations plusieurs-vers-plusieurs vers d'autres entit�s, - vous devriez activer la r�cup�ration <literal>join</literal> non seulement sur - la collection elle-m�me, mais aussi avec cet attribut sur l'�l�ment imbriqu� + <literal>fetch</literal> (optionnel - par défaut <literal>join</literal>) : + active les récupérations par jointures externes ou par selects séquentiels pour cette association. + C'est un cas spécial ; pour une récupération complète sans attente (dans un seul <literal>SELECT</literal>) d'une + entité et de ses relations plusieurs-vers-plusieurs vers d'autres entités, + vous devriez activer la récupération <literal>join</literal> non seulement sur + la collection elle-même, mais aussi avec cet attribut sur l'élément imbriqué <literal>&lt;many-to-many&gt;</literal>. </para> </callout> <callout arearefs="manytomany5"> <para> - <literal>unique</literal> (optionnel) : activer la g�n�ration DDL d'une - contrainte d'unicit� pour la colonne de la clef �trang�re. �a rend la pluralit� + <literal>unique</literal> (optionnel) : activer la génération DDL d'une + contrainte d'unicité pour la colonne de la clef étrangère. Ça rend la pluralité de l'association effectivement un-vers-plusieurs. </para> </callout> <callout arearefs="manytomany6"> <para> - <literal>not-found</literal> (optionnel - par d�faut <literal>exception</literal>) : - sp�cifie comment les clefs �trang�res qui r�f�rencent la lignes - manquantes seront g�r�es : <literal>ignore</literal> traitera + <literal>not-found</literal> (optionnel - par défaut <literal>exception</literal>) : + spécifie comment les clefs étrangères qui référencent la lignes + manquantes seront gérées : <literal>ignore</literal> traitera une ligne manquante comme une association nulle. </para> </callout> <callout arearefs="manytomany7"> <para> - <literal>entity-name</literal> (optionnel) : le nom de l'entit� de la classe associ�e, comme une alternative � <literal>class</literal> + <literal>entity-name</literal> (optionnel) : le nom de l'entité de la classe associée, comme une alternative à <literal>class</literal> </para> </callout> <callout arearefs="manytomany8"> <para> - <literal>property-ref</literal> (optionnel) : le nom d'une propri�t� de - la classe associ�e qui est jointe � cette clef �trang�re. Si non sp�cifi�e, - la clef primaire de la classe associ�e est utilis�e. + <literal>property-ref</literal> (optionnel) : le nom d'une propriété de + la classe associée qui est jointe à cette clef étrangère. Si non spécifiée, + la clef primaire de la classe associée est utilisée. </para> </callout> </calloutlist> </programlistingco> <para> - Quelques exemples, d'abord, un ensemble de cha�nes de caract�res : + Quelques exemples, d'abord, un ensemble de chaînes de caractères : </para> <programlisting><![CDATA[<set name="names" table="person_names"> @@ -559,7 +561,7 @@ </set>]]></programlisting> <para> - Un bag contenant des entiers (avec un ordre d'it�ration d�termin� par l'attribut <literal>order-by</literal>) : + Un bag contenant des entiers (avec un ordre d'itération déterminé par l'attribut <literal>order-by</literal>) : </para> <programlisting><![CDATA[<bag name="sizes" @@ -570,7 +572,7 @@ </bag>]]></programlisting> <para> - Un tableau d'entit�s - dans ce cas, une association plusieurs-vers-plusieurs : + Un tableau d'entités - dans ce cas, une association plusieurs-vers-plusieurs : </para> <programlisting><![CDATA[<array name="addresses" @@ -582,7 +584,7 @@ </array>]]></programlisting> <para> - Une map de cha�nes de caract�res vers des dates : + Une map de chaînes de caractères vers des dates : </para> <programlisting><![CDATA[<map name="holidays" @@ -616,26 +618,26 @@ <para> Une <emphasis>association un vers plusieurs</emphasis> lie les tables de deux classes - par une clef �trang�re, sans l'intervention d'une table de collection. Ce mapping perd certaines s�mantiques des collections Java normales : + par une clef étrangère, sans l'intervention d'une table de collection. Ce mapping perd certaines sémantiques des collections Java normales : </para> <itemizedlist spacing="compact"> <listitem> <para> - Une instance de la classe de l'entit� contenue ne peut pas appartenir � plus d'une + Une instance de la classe de l'entité contenue ne peut pas appartenir à plus d'une instance de la collection </para> </listitem> <listitem> <para> - Une instance de la classe de l'entit� contenue ne peut pas appara�tre plus plus d'une valeur d'index de la collection + Une instance de la classe de l'entité contenue ne peut pas apparaître plus plus d'une valeur d'index de la collection </para> </listitem> </itemizedlist> <para> Une association de <literal>Product</literal> vers <literal>Part</literal> requiert l'existence d'une - clef �trang�re et possiblement une colonne d'index pour la table <literal>Part</literal>. Une balise + clef étrangère et possiblement une colonne d'index pour la table <literal>Part</literal>. Une balise <literal>&lt;one-to-many&gt;</literal> indique que c'est une association un vers plusieurs. </para> @@ -655,41 +657,41 @@ <calloutlist> <callout arearefs="onetomany1"> <para> - <literal>class</literal> (requis) : le nom de la classe associ�e + <literal>class</literal> (requis) : le nom de la classe associée </para> </callout> <callout arearefs="onetomany2"> <para> - <literal>not-found</literal> (optionnel - par d�faut <literal>exception</literal>) : - sp�cifie comment les identifiants cach�s qui r�f�rencent des lignes manquantes seront g�r�s : + <literal>not-found</literal> (optionnel - par défaut <literal>exception</literal>) : + spécifie comment les identifiants cachés qui référencent des lignes manquantes seront gérés : <literal>ignore</literal> traitera une ligne manquante comme une association nulle </para> </callout> <callout arearefs="onetomany3"> <para> - <literal>entity-name</literal> (optionnel) : le nom de l'entit� de la - classe associ�e, comme une alternative � <literal>class</literal>. + <literal>entity-name</literal> (optionnel) : le nom de l'entité de la + classe associée, comme une alternative à <literal>class</literal>. </para> </callout> </calloutlist> </programlistingco> <para> - Notez que l'�l�ment <literal>&lt;one-to-many&gt;</literal> n'a pas besoin de d�clarer de colonnes. Il n'est pas non plus n�cessaire de sp�cifier le nom de la table nulle part. + Notez que l'élément <literal>&lt;one-to-many&gt;</literal> n'a pas besoin de déclarer de colonnes. Il n'est pas non plus nécessaire de spécifier le nom de la table nulle part. </para> <para> - <emphasis>Note tr�s importante :</emphasis> si la colonne de la clef d'une association - <literal>&lt;one-to-many&gt;</literal> est d�clar�e <literal>NOT NULL</literal>, vous devez d�clarer le + <emphasis>Note très importante :</emphasis> si la colonne de la clef d'une association + <literal>&lt;one-to-many&gt;</literal> est déclarée <literal>NOT NULL</literal>, vous devez déclarer le mapping de <literal>&lt;key&gt;</literal> avec <literal>not-null="true"</literal> ou <emphasis>utiliser une association bidirectionnelle</emphasis> avec le mapping de la - collection marqu� <literal>inverse="true"</literal>. Voir la discussion sur les associations bidirectionnelles plus tard dans ce chapitre. + collection marqué <literal>inverse="true"</literal>. Voir la discussion sur les associations bidirectionnelles plus tard dans ce chapitre. </para> <para> - Cet exemple montre une map d'entit�s <literal>Part</literal> par nom (o� - <literal>partName</literal> est une propri�t� persistante de <literal>Part</literal>). - Notez l'utilisation d'un index bas� sur une formule. + Cet exemple montre une map d'entités <literal>Part</literal> par nom (où + <literal>partName</literal> est une propriété persistante de <literal>Part</literal>). + Notez l'utilisation d'un index basé sur une formule. </para> <programlisting><![CDATA[<map name="parts" @@ -703,14 +705,14 @@ </sect1> <sect1 id="collections-advancedmappings"> - <title>Mappings de collection avanc�s</title> + <title>Mappings de collection avancés</title> <sect2 id="collections-sorted" revision="2"> - <title>Collections tri�es</title> + <title>Collections triées</title> <para> - Hibernate supporte des collections impl�mentant <literal>java.util.SortedMap</literal> et - <literal>java.util.SortedSet</literal>. Vous devez sp�cifier un comparateur dans le fichier de mapping : + Hibernate supporte des collections implémentant <literal>java.util.SortedMap</literal> et + <literal>java.util.SortedSet</literal>. Vous devez spécifier un comparateur dans le fichier de mapping : </para> <programlisting><![CDATA[<set name="aliases" @@ -728,21 +730,21 @@ <para> Les valeurs permises pour l'attribut <literal>sort</literal> sont <literal>unsorted</literal>, - <literal>natural</literal> et le nom d'une classe impl�mentant + <literal>natural</literal> et le nom d'une classe implémentant <literal>java.util.Comparator</literal>. </para> <para> - Les collections tri�es se comportent r�ellement comme <literal>java.util.TreeSet</literal> ou + Les collections triées se comportent réellement comme <literal>java.util.TreeSet</literal> ou <literal>java.util.TreeMap</literal>. </para> <para> - Si vous voulez que la base de donn�es elle-m�me ordonne les �l�ments de la collection, utilisez l'attribut + Si vous voulez que la base de données elle-même ordonne les éléments de la collection, utilisez l'attribut <literal>order-by</literal> des mappings <literal>set</literal>, <literal>bag</literal> - ou <literal>map</literal>. Cette solution est seulement disponible � partir du JDK 1.4 (c'est - impl�ment� en utilisant <literal>LinkedHashSet</literal> ou - <literal>LinkedHashMap</literal>). Ceci ex�cute le tri dans la requ�te SQL, pas en m�moire. + ou <literal>map</literal>. Cette solution est seulement disponible à partir du JDK 1.4 (c'est + implémenté en utilisant <literal>LinkedHashSet</literal> ou + <literal>LinkedHashMap</literal>). Ceci exécute le tri dans la requête SQL, pas en mémoire. </para> <programlisting><![CDATA[<set name="aliases" table="person_aliases" order-by="lower(name) asc"> @@ -761,7 +763,7 @@ </para> <para> - Les associations peuvent m�me �tre tri�es sur des crit�res arbitraires � l'ex�cution en utilisant un <literal>filter()</literal> de collection. + Les associations peuvent même être triées sur des critères arbitraires à l'exécution en utilisant un <literal>filter()</literal> de collection. </para> <programlisting><![CDATA[sortedUsers = s.createFilter( group.getUsers(), "order by this.name" ).list();]]></programlisting> @@ -772,14 +774,14 @@ <title>Associations bidirectionnelles</title> <para> - Une <emphasis>association bidirectionnelle</emphasis> permet une navigation � - partir de la "fin" de l'association. Deux sortes d'associations bidirectionnelles sont support�es : + Une <emphasis>association bidirectionnelle</emphasis> permet une navigation à + partir de la "fin" de l'association. Deux sortes d'associations bidirectionnelles sont supportées : <variablelist> <varlistentry> <term>un-vers-plusieurs (NdT : one-to-many)</term> <listitem> <para> - ensemble ou sac � une extr�mit�, une seule valeur � l'autre + ensemble ou sac à une extrémité, une seule valeur à l'autre </para> </listitem> </varlistentry> @@ -787,7 +789,7 @@ <term>plusieurs-vers-plusieurs (NdT : many-to-many)</term> <listitem> <para> - ensemble ou sac aux deux extr�mit�s + ensemble ou sac aux deux extrémités </para> </listitem> </varlistentry> @@ -795,13 +797,13 @@ </para> <para> - Vous pouvez sp�cifier une association plusieurs-vers-plusieurs bidirectionnelle simplement - en mappant deux associations plusieurs-vers-plusieurs vers la m�me table de base de donn�es et en d�clarant une extr�mit� comme <emphasis>inverse</emphasis> (celle de votre choix, mais �a ne peut pas �tre une collection index�e). + Vous pouvez spécifier une association plusieurs-vers-plusieurs bidirectionnelle simplement + en mappant deux associations plusieurs-vers-plusieurs vers la même table de base de données et en déclarant une extrémité comme <emphasis>inverse</emphasis> (celle de votre choix, mais ça ne peut pas être une collection indexée). </para> <para> - Voici un exemple d'association bidirectionnelle plusieurs-vers-plusieurs ; chaque cat�gorie peut - avoir plusieurs objets et chaque objet peut �tre dans plusieurs cat�gories : + Voici un exemple d'association bidirectionnelle plusieurs-vers-plusieurs ; chaque catégorie peut + avoir plusieurs objets et chaque objet peut être dans plusieurs catégories : </para> <programlisting><![CDATA[<class name="Category"> @@ -825,28 +827,28 @@ </class>]]></programlisting> <para> - Les changements faits uniquement sur l'extr�mint� inverse de l'association <emphasis>ne sont pas</emphasis> - persist�s. Ceci signifie qu'Hibernate a deux repr�sentations en m�moire pour chaque + Les changements faits uniquement sur l'extréminté inverse de l'association <emphasis>ne sont pas</emphasis> + persistés. Ceci signifie qu'Hibernate a deux représentations en mémoire pour chaque association bidirectionnelles, un lien de A vers B et un autre de B vers A. C'est - plus facile � comprendre si vous pensez au mod�le objet de Java et comment nous - cr�ons une relation plusieurs-vers-plusieurs en Java : + plus facile à comprendre si vous pensez au modèle objet de Java et comment nous + créons une relation plusieurs-vers-plusieurs en Java : </para> <programlisting><![CDATA[ -category.getItems().add(item); // La cat�gorie est maintenant "au courant" de la relation +category.getItems().add(item); // La catégorie est maintenant "au courant" de la relation item.getCategories().add(category); // L'objet est maintenant "au courant" de la relation -session.persist(item); // La relation ne sera pas sauvegard�e ! -session.persist(category); // La relation sera sauvegard�e]]></programlisting> +session.persist(item); // La relation ne sera pas sauvegardée ! +session.persist(category); // La relation sera sauvegardée]]></programlisting> <para> - La partie non-inverse est utilis�e pour sauvegarder la repr�sentation en m�moire dans la base de donn�es. + La partie non-inverse est utilisée pour sauvegarder la représentation en mémoire dans la base de données. </para> <para> - Vous pouvez d�finir une association un-vers-plusieurs bidirectionnelle en mappant une - association un-vers-plusieurs vers la(es) m�me(s) colonne(s) de table qu'une association - plusieurs-vers-un et en d�clarant l'extr�mit� pluri-valu�e <literal>inverse="true"</literal>. + Vous pouvez définir une association un-vers-plusieurs bidirectionnelle en mappant une + association un-vers-plusieurs vers la(es) même(s) colonne(s) de table qu'une association + plusieurs-vers-un et en déclarant l'extrémité pluri-valuée <literal>inverse="true"</literal>. </para> <programlisting><![CDATA[<class name="Parent"> @@ -868,19 +870,19 @@ </class>]]></programlisting> <para> - Mapper une extr�mit� d'une association avec <literal>inverse="true"</literal> n'affecte - pas l'op�ration de cascades, ce sont des concepts orthogonaux ! + Mapper une extrémité d'une association avec <literal>inverse="true"</literal> n'affecte + pas l'opération de cascades, ce sont des concepts orthogonaux ! </para> </sect2> <sect2 id="collections-indexedbidirectional"> - <title>Associations bidirectionnelles avec des collections index�es</title> + <title>Associations bidirectionnelles avec des collections indexées</title> <para> - Une association bidirectionnelle o� une extr�mit� est repr�sent�e comme une <literal>&lt;list&gt;</literal> - ou une <literal>&lt;map&gt;</literal> requiert une consid�ration sp�ciale. Si il y a une - propri�t� de la classe enfant qui mappe la colonne de l'index, pas de probl�me, nous pouvons - continuer � utiliser <literal>inverse="true"</literal> sur le mapping de la collection : + Une association bidirectionnelle où une extrémité est représentée comme une <literal>&lt;list&gt;</literal> + ou une <literal>&lt;map&gt;</literal> requiert une considération spéciale. Si il y a une + propriété de la classe enfant qui mappe la colonne de l'index, pas de problème, nous pouvons + continuer à utiliser <literal>inverse="true"</literal> sur le mapping de la collection : </para> <programlisting><![CDATA[<class name="Parent"> @@ -906,10 +908,10 @@ </class>]]></programlisting> <para> - Mais, si il n'y a pas de telle prorpri�t� sur la classe enfant, nous ne pouvons pas penser - � l'association comme vraiment bidirectionnelle (il y a des informations disponibles � une - extr�mit� de l'association qui ne sont pas disponibles � l'autre extr�mit�). Dans ce cas, - nous ne pouvons pas mapper la collection <literal>inverse="true"</literal>. � la place, nous + Mais, si il n'y a pas de telle prorpriété sur la classe enfant, nous ne pouvons pas penser + à l'association comme vraiment bidirectionnelle (il y a des informations disponibles à une + extrémité de l'association qui ne sont pas disponibles à l'autre extrémité). Dans ce cas, + nous ne pouvons pas mapper la collection <literal>inverse="true"</literal>. À la place, nous pourrions utiliser le mapping suivant : </para> @@ -937,8 +939,8 @@ </class>]]></programlisting> <para> - Notez que dans ce mapping, l'extr�mit� de l'association contenant la collection est responsable - des mises � jour de la clef �trang�re. � faire : cela entra�ne-t-il r�ellement des expressions + Notez que dans ce mapping, l'extrémité de l'association contenant la collection est responsable + des mises à jour de la clef étrangère. À faire : cela entraîne-t-il réellement des expressions updates inutiles ? </para> @@ -965,12 +967,12 @@ </map>]]></programlisting> <para> - Une seconde approche est simplement de remodeler l'association comme une classe d'entit�. C'est + Une seconde approche est simplement de remodeler l'association comme une classe d'entité. C'est l'approche la plus commune. </para> <para> - Une alternative finale est d'utiliser des �l�ments composites, dont nous discuterons plus tard. + Une alternative finale est d'utiliser des éléments composites, dont nous discuterons plus tard. </para> </sect2> @@ -979,21 +981,21 @@ <title>Utiliser un <literal>&lt;idbag&gt;</literal></title> <para> - Si vous embrassez pleinement notre vue que les clefs compos�es sont une mauvaise - chose et que des entit�s devraient avoir des identifiants artificiels (des clefs - subrog�es), alors vous pourriez trouver un peu curieux que les associations - plusieurs-vers-plusieurs et les collections de valeurs que nous avons montr� jusqu'ici - mappent toutes des tables avec des clefs compos�es ! Maintenant, ce point est assez - discutable ; une table d'association pure ne semble pas beaucoup b�n�ficier d'une clef - subrog�e (bien qu'une collection de valeur compos�es le <emphasis>pourrait</emphasis>). - N�anmoins, Hibernate fournit une foncionnalit� qui vous permet de mapper + Si vous embrassez pleinement notre vue que les clefs composées sont une mauvaise + chose et que des entités devraient avoir des identifiants artificiels (des clefs + subrogées), alors vous pourriez trouver un peu curieux que les associations + plusieurs-vers-plusieurs et les collections de valeurs que nous avons montré jusqu'ici + mappent toutes des tables avec des clefs composées ! Maintenant, ce point est assez + discutable ; une table d'association pure ne semble pas beaucoup bénéficier d'une clef + subrogée (bien qu'une collection de valeur composées le <emphasis>pourrait</emphasis>). + Néanmoins, Hibernate fournit une foncionnalité qui vous permet de mapper des associations plusieurs-vers-plusieurs et des collections de valeurs vers une - table avec une clef subrog�e. + table avec une clef subrogée. </para> <para> - L'�l�ment <literal>&lt;idbag&gt;</literal> vous laisse mapper une <literal>List</literal> - (ou une <literal>Collection</literal>) avec une s�mantique de sac. + L'élément <literal>&lt;idbag&gt;</literal> vous laisse mapper une <literal>List</literal> + (ou une <literal>Collection</literal>) avec une sémantique de sac. </para> <programlisting><![CDATA[<idbag name="lovers" table="LOVERS"> @@ -1005,22 +1007,22 @@ </idbag>]]></programlisting> <para> - Comme vous pouvez voir, un <literal>&lt;idbag&gt;</literal> a un g�n�r�teur d'id - artificiel, comme une classe d'entit� ! Une clef subrog�e diff�rente est assign�e - � chaque ligne de la collection. Cependant, Hibernate ne fournit pas de m�canisme pour - d�couvrir la valeur d'une clef subrog�e d'une ligne particuli�re. + Comme vous pouvez voir, un <literal>&lt;idbag&gt;</literal> a un généréteur d'id + artificiel, comme une classe d'entité ! Une clef subrogée différente est assignée + à chaque ligne de la collection. Cependant, Hibernate ne fournit pas de mécanisme pour + découvrir la valeur d'une clef subrogée d'une ligne particulière. </para> <para> - Notez que les performances de la mise � jour d'un <literal>&lt;idbag&gt;</literal> + Notez que les performances de la mise à jour d'un <literal>&lt;idbag&gt;</literal> sont <emphasis>bien</emphasis> meilleures qu'un <literal>&lt;bag&gt;</literal> ordinaire ! - Hibernate peut localiser des lignes individuelles efficacement et les mettre � jour ou + Hibernate peut localiser des lignes individuelles efficacement et les mettre à jour ou les effacer individuellement, comme une liste, une map ou un ensemble. </para> <para> - Dans l'impl�mentation actuelle, la strat�gie de la g�n�ration de l'identifiant <literal>native</literal> - n'est pas support�e pour les identifiants de collection <literal>&lt;idbag&gt;</literal>. + Dans l'implémentation actuelle, la stratégie de la génération de l'identifiant <literal>native</literal> + n'est pas supportée pour les identifiants de collection <literal>&lt;idbag&gt;</literal>. </para> </sect2> @@ -1045,7 +1047,7 @@ <title>Exemples de collections</title> <para> - Les sections pr�c�dentes sont assez confuses. Donc prenons un exemple. Cette classe : + Les sections précédentes sont assez confuses. Donc prenons un exemple. Cette classe : </para> <programlisting><![CDATA[package eg; @@ -1093,7 +1095,7 @@ </hibernate-mapping>]]></programlisting> <para> - Ceci mappe les d�finitions de tables suivantes : + Ceci mappe les définitions de tables suivantes : </para> <programlisting><![CDATA[create table parent ( id bigint not null primary key ) @@ -1139,7 +1141,7 @@ <para> Alternativement, si vous insistez absolument pour que cette association soit unidirectionnelle, - vous pouvez d�clarer la contrainte <literal>NOT NULL</literal> sur le mapping <literal>&lt;key&gt;</literal> : + vous pouvez déclarer la contrainte <literal>NOT NULL</literal> sur le mapping <literal>&lt;key&gt;</literal> : </para> <programlisting><![CDATA[<hibernate-mapping> @@ -1164,8 +1166,8 @@ </hibernate-mapping>]]></programlisting> <para> - D'un autre c�t�, si un enfant pouvait avoir plusieurs parent, une association - plusieurs-vers-plusieurs est plus appropri�e : + D'un autre côté, si un enfant pouvait avoir plusieurs parent, une association + plusieurs-vers-plusieurs est plus appropriée : </para> <programlisting><![CDATA[<hibernate-mapping> @@ -1190,7 +1192,7 @@ </hibernate-mapping>]]></programlisting> <para> - D�finitions des tables : + Définitions des tables : </para> <programlisting><![CDATA[create table parent ( id bigint not null primary key ) @@ -1202,12 +1204,12 @@ alter table childset add constraint childsetfk1 (child_id) references child]]></programlisting> <para> - Pour plus d'exemples et une revue compl�te du mapping de la relation parent/enfant, voir + Pour plus d'exemples et une revue complète du mapping de la relation parent/enfant, voir see <xref linkend="example-parentchild"/>. </para> <para> - Des mappings d'association plus exotiques sont possibles, nous cataloguerons toutes les possibilit�s + Des mappings d'association plus exotiques sont possibles, nous cataloguerons toutes les possibilités dans le prochain chapitre. </para> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/component_mapping.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/component_mapping.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/component_mapping.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,21 +1,23 @@ -<?xml version='1.0' encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="components"> <title>Mapping de composants</title> <para> - La notion de <emphasis>composants</emphasis> est r�utilis� dans diff�rents contextes, - avec diff�rents objectifs, � travers Hibernate. + La notion de <emphasis>composants</emphasis> est réutilisé dans différents contextes, + avec différents objectifs, à travers Hibernate. </para> <sect1 id="components-dependentobjects" revision="2" > - <title>Objects d�pendants</title> + <title>Objects dépendants</title> <para> - Le composant est un objet inclu dans un autre qui est sauvegard� comme une valeur, et - non pas comme une entit�. - Le composant fait r�f�rence � la notion (au sens objet) de composition + Le composant est un objet inclu dans un autre qui est sauvegardé comme une valeur, et + non pas comme une entité. + Le composant fait référence à la notion (au sens objet) de composition (et non pas de composant au sens d'architecture de composants). - Par exemple on pourrait mod�lis� l'objet personne de cette fa�on: + Par exemple on pourrait modélisé l'objet personne de cette façon: </para> <programlisting><![CDATA[public class Person { @@ -69,14 +71,14 @@ }]]></programlisting> <para> - Maintenant <literal>Name</literal> peut-�tre sauvegard� comme un composant de - <literal>Person</literal>. Remarquer que <literal>Name</literal> d�finit des methodes - d'acc�s et de modification pour ses propri�t�s persistantes, mais il n'a pas besoin - des interfaces ou des propri�t�s d'identification ( par exemple getId() ) qui sont propres aux entit�s. + Maintenant <literal>Name</literal> peut-être sauvegardé comme un composant de + <literal>Person</literal>. Remarquer que <literal>Name</literal> définit des methodes + d'accès et de modification pour ses propriétés persistantes, mais il n'a pas besoin + des interfaces ou des propriétés d'identification ( par exemple getId() ) qui sont propres aux entités. </para> <para> - Nous serions alors amen� � mapper ce composant de cette fa�on: + Nous serions alors amené à mapper ce composant de cette façon: </para> <programlisting><![CDATA[<class name="eg.Person" table="person"> @@ -100,24 +102,24 @@ </para> <para> - Comme tous les types valeurs, les composants ne supportent pas les r�f�rences partag�s. - En d'autres mots, deux instances de person peuvent avoir un m�me nom, mais ces noms sont - ind�pendants, ils peuvent �tre identiques si on les compare par valeur mais ils repr�sentent - deux objets distincts en m�moire. La notion de nullit� pour un composant est + Comme tous les types valeurs, les composants ne supportent pas les références partagés. + En d'autres mots, deux instances de person peuvent avoir un même nom, mais ces noms sont + indépendants, ils peuvent être identiques si on les compare par valeur mais ils représentent + deux objets distincts en mémoire. La notion de nullité pour un composant est <emphasis>ad hoc</emphasis>. Quand il recharge l'objet qui contient le composant, Hibernate - supposera que si tous les champs du composants sont nuls alors le composant sera positionn� - � la valeur null. Ce choix programmatif devrait �tre satisfaisant dans la plupart des cas. + supposera que si tous les champs du composants sont nuls alors le composant sera positionné + à la valeur null. Ce choix programmatif devrait être satisfaisant dans la plupart des cas. </para> <para> - Les propri�t�s d'un composant peuvent �tre de tous les types qu'Hibernate supporte habituellement + Les propriétés d'un composant peuvent être de tous les types qu'Hibernate supporte habituellement (collections, many-to-one associations, autres composants, etc). Les composants inclus ne doivent <emphasis>pas</emphasis> - �tre vus comme quelque chose d'exotique. Hibernate a �t� con�u pour supporter un mod�le objet tr�s granulaire. + être vus comme quelque chose d'exotique. Hibernate a été conçu pour supporter un modèle objet très granulaire. </para> <para> - Le <literal>&lt;component&gt;</literal> peut inclure dans la liste de ses propri�t�s - une r�f�rence au <literal>&lt;parent&gt;</literal> conteneur. + Le <literal>&lt;component&gt;</literal> peut inclure dans la liste de ses propriétés + une référence au <literal>&lt;parent&gt;</literal> conteneur. </para> <programlisting><![CDATA[<class name="eg.Person" table="person"> @@ -126,7 +128,7 @@ </id> <property name="birthday" type="date"/> <component name="Name" class="eg.Name" unique="true"> - <parent name="namedPerson"/> <!-- r�f�rence arri�re � Person --> + <parent name="namedPerson"/> <!-- référence arrière à Person --> <property name="initial"/> <property name="first"/> <property name="last"/> @@ -136,11 +138,11 @@ </sect1> <sect1 id="components-incollections" revision="1"> - <title>Collection d'objets d�pendants</title> + <title>Collection d'objets dépendants</title> <para> - Les collections d'objets d�pendants sont support�s (exemple: un tableau de type - <literal>Name</literal>). D�clarer la collection de composants en rempla�ant le tag <literal>&lt;element&gt;</literal> + Les collections d'objets dépendants sont supportés (exemple: un tableau de type + <literal>Name</literal>). Déclarer la collection de composants en remplaçant le tag <literal>&lt;element&gt;</literal> par le tag <literal>&lt;composite-element&gt;</literal>. </para> @@ -154,39 +156,39 @@ </set>]]></programlisting> <para> - Remarque: Si vous d�finissez un <literal>Set</literal> d'�l�ment composite, - il est tr�s important d'impl�menter la m�thode <literal>equals()</literal> et + Remarque: Si vous définissez un <literal>Set</literal> d'élément composite, + il est très important d'implémenter la méthode <literal>equals()</literal> et <literal>hashCode()</literal> correctement. </para> <para> - Les �lements composite peuvent aussi contenir des composants mais pas des collections. - Si votre �l�ment composite contient aussi des composants, utilisez l'�l�ment <literal>&lt;nested-composite-element&gt;</literal> - . Une collections de composants qui ccontiennent eux-m�mes des composants est un cas tr�s exotique. - A ce stade demandez-vous si une association un-�-plusieurs ne serait pas plus appropri�. - Essayez de re remodeler votre �l�ment composite comme une entit� ( Dans ce cas m�me si le mod�le - Java est le m�me la logique de persitence et de relation sont tout de m�me diff�rentes) + Les élements composite peuvent aussi contenir des composants mais pas des collections. + Si votre élément composite contient aussi des composants, utilisez l'élément <literal>&lt;nested-composite-element&gt;</literal> + . Une collections de composants qui ccontiennent eux-mêmes des composants est un cas très exotique. + A ce stade demandez-vous si une association un-à-plusieurs ne serait pas plus approprié. + Essayez de re remodeler votre élément composite comme une entité ( Dans ce cas même si le modèle + Java est le même la logique de persitence et de relation sont tout de même différentes) </para> <para> - Remarque, le mapping d'�l�ments composites ne supporte pas la nullit� des - propri�t�s lorsqu'on utilise un <literal>&lt;set&gt;</literal>. Hibernate + Remarque, le mapping d'éléments composites ne supporte pas la nullité des + propriétés lorsqu'on utilise un <literal>&lt;set&gt;</literal>. Hibernate lorsqu'il supprime un objet utilise chaque colonne pour identifier un objet - (on ne peut pas utiliser des cl�s primaires distinctes dans une table d'�l�ments composites), - ce qui n'est pas possible avec des valeurs nulles. Vous devez donc choisir d'interdire la nullit� - des propri�t�s d'un �l�ment composite ou choisir un autre type de collection comme : + (on ne peut pas utiliser des clés primaires distinctes dans une table d'éléments composites), + ce qui n'est pas possible avec des valeurs nulles. Vous devez donc choisir d'interdire la nullité + des propriétés d'un élément composite ou choisir un autre type de collection comme : <literal>&lt;list&gt;</literal>, <literal>&lt;map&gt;</literal>, <literal>&lt;bag&gt;</literal> ou <literal>&lt;idbag&gt;</literal>. </para> <para> - Un cas particulier d'�l�ment composite est un �l�ment composite qui inclut un �l�ment + Un cas particulier d'élément composite est un élément composite qui inclut un élément <literal>&lt;many-to-one&gt;</literal>. Un mapping comme celui-ci - vous permet d'associer les colonnes d'une table d'association plusieurs � plusieurs (many-to-many) - � la classse de l'�l�ment composite. L'exemple suivant est une association plusieurs � plusieurs - de <literal>Order</literal> � <literal>Item</literal> � + vous permet d'associer les colonnes d'une table d'association plusieurs à plusieurs (many-to-many) + à la classse de l'élément composite. L'exemple suivant est une association plusieurs à plusieurs + de <literal>Order</literal> à <literal>Item</literal> à <literal>purchaseDate</literal>, <literal>price</literal> et - <literal>quantity</literal> sont des propri�t�s de l'association. + <literal>quantity</literal> sont des propriétés de l'association. </para> <programlisting><![CDATA[<class name="eg.Order" .... > @@ -203,12 +205,12 @@ </class>]]></programlisting> <para> - Bien s�r, il ne peut pas y avoir de r�f�rence � l'achat (purchase) depuis l'article (item), pour - pouvoir naviguer de fa�on bidirectionnelle dans l'association. N'oubliez pas que les composants - sont de type valeurs et n'autorise pas les r�f�rences partag�es. + Bien sûr, il ne peut pas y avoir de référence à l'achat (purchase) depuis l'article (item), pour + pouvoir naviguer de façon bidirectionnelle dans l'association. N'oubliez pas que les composants + sont de type valeurs et n'autorise pas les références partagées. </para> - <para>M�me les associations ternaires ou quaternaires sont possibles:</para> + <para>Même les associations ternaires ou quaternaires sont possibles:</para> <programlisting><![CDATA[<class name="eg.Order" .... > .... @@ -222,8 +224,8 @@ </class>]]></programlisting> <para> - Les �l�ments composites peuvent appara�tre dans les requ�tes en utilisant - la m�me syntaxe que associations + Les éléments composites peuvent apparaître dans les requêtes en utilisant + la même syntaxe que associations </para> </sect1> @@ -232,9 +234,9 @@ <title>Utiliser les composants comme index de map</title> <para> - l'�l�ment <literal>&lt;composite-map-key&gt;</literal> + l'élément <literal>&lt;composite-map-key&gt;</literal> vous permet d'utiliser une classe de composant comme indice de - <literal>Map</literal>. Assurez-vous d'avoir surd�fini + <literal>Map</literal>. Assurez-vous d'avoir surdéfini <literal>hashCode()</literal> et <literal>equals()</literal> dans la classe du composant. </para> @@ -244,42 +246,42 @@ <title>Utiliser un composant comme identifiant</title> <para> - Vous pouvez utiliser un composant comme identifiant d'une entit�. - Mais pour cela la classe du composant doit respecter certaines r�gles. + Vous pouvez utiliser un composant comme identifiant d'une entité. + Mais pour cela la classe du composant doit respecter certaines règles. </para> <itemizedlist spacing="compact"> <listitem> <para> - Elle doit impl�menter <literal>java.io.Serializable</literal>. + Elle doit implémenter <literal>java.io.Serializable</literal>. </para> </listitem> <listitem> <para> - Elle doit red�finir <literal>equals()</literal> et - <literal>hashCode()</literal>, de fa�on coh�rente avec le - fait qu'elle d�finit une cl� composite dans la base de - donn�es. + Elle doit redéfinir <literal>equals()</literal> et + <literal>hashCode()</literal>, de façon cohérente avec le + fait qu'elle définit une clé composite dans la base de + données. </para> </listitem> </itemizedlist> <para> <emphasis> - Remarque: avec hibernate3, la seconde r�gle n'est plus absolument - necessaire mais fa�tes le quand m�me.</emphasis> + Remarque: avec hibernate3, la seconde règle n'est plus absolument + necessaire mais faîtes le quand même.</emphasis> </para> <para> - Vous ne pouvez pas utiliser de <literal>IdentifierGenerator</literal> pour g�n�rer - une cl� composite, l'application devra d�finir elle m�me ses propres identifiants. + Vous ne pouvez pas utiliser de <literal>IdentifierGenerator</literal> pour générer + une clé composite, l'application devra définir elle même ses propres identifiants. </para> <para> - Utiliser l'�l�ment <literal>&lt;composite-id&gt;</literal> (en incluant l'�l�ment - <literal>&lt;key-property&gt;</literal>) � la place de l'habituel d�claration + Utiliser l'élément <literal>&lt;composite-id&gt;</literal> (en incluant l'élément + <literal>&lt;key-property&gt;</literal>) à la place de l'habituel déclaration <literal>&lt;id&gt;</literal>. Par exemple la classe - <literal>OrderLine</literal> qui d�pend de la cl� primaire + <literal>OrderLine</literal> qui dépend de la clé primaire (composite) de <literal>Order</literal>. </para> @@ -303,9 +305,9 @@ </class>]]></programlisting> <para> - Maintenant toutes cl�s �trang�res r�f�ren�ant la table <literal>OrderLine</literal> - devra aussi �tre composite. Vous devez en tenir compte lorsque vous �crivez vos mapping d'association pour les autres classes. - Une association � <literal>OrderLine</literal> devrait �tre mapp� de la fa�on suivante : + Maintenant toutes clés étrangères référençant la table <literal>OrderLine</literal> + devra aussi être composite. Vous devez en tenir compte lorsque vous écrivez vos mapping d'association pour les autres classes. + Une association à <literal>OrderLine</literal> devrait être mappé de la façon suivante : </para> <programlisting><![CDATA[<many-to-one name="orderLine" class="OrderLine"> @@ -316,13 +318,13 @@ </many-to-one>]]></programlisting> <para> - (Remarque: l'�l�ment <literal>&lt;column&gt;</literal> est une alternative � l'attribut + (Remarque: l'élément <literal>&lt;column&gt;</literal> est une alternative à l'attribut <literal>column</literal> que l'on utilise partout.) </para> <para> - Une association <literal>plusieurs-�-plusieurs</literal> (many-to-many) � <literal>OrderLine</literal> - utilisera aussi une cl� �trang�re composite: + Une association <literal>plusieurs-à-plusieurs</literal> (many-to-many) à <literal>OrderLine</literal> + utilisera aussi une clé étrangère composite: </para> <programlisting><![CDATA[<set name="undeliveredOrderLines"> @@ -348,12 +350,12 @@ </set>]]></programlisting> <para> - (L'�l�ment <literal>&lt;one-to-many&gt;</literal>, comme d'habitude, ne d�clare pas de colonne.) + (L'élément <literal>&lt;one-to-many&gt;</literal>, comme d'habitude, ne déclare pas de colonne.) </para> <para> - Si <literal>OrderLine</literal> lui-m�me poss�de une collection, celle-ci aura aussi - une cl� composite �trang�re. + Si <literal>OrderLine</literal> lui-même possède une collection, celle-ci aura aussi + une clé composite étrangère. </para> <programlisting><![CDATA[<class name="OrderLine"> @@ -378,7 +380,7 @@ <title>Composant Dynamique</title> <para> - Vous pouvez m�me mapper une propri�t� de type <literal>Map</literal>: + Vous pouvez même mapper une propriété de type <literal>Map</literal>: </para> <programlisting><![CDATA[<dynamic-component name="userAttributes"> @@ -388,12 +390,12 @@ </dynamic-component>]]></programlisting> <para> - La s�mantique de l'association � un <literal>&lt;dynamic-component&gt;</literal> - est identique � celle que l'on utilise pour les composants. - L'avantage de ce type de mapping est qu'il pemet de d�terminer les v�ritables propri�t�s - du bean au moment su d�ploiement en �ditant simplement le document de mapping. + La sémantique de l'association à un <literal>&lt;dynamic-component&gt;</literal> + est identique à celle que l'on utilise pour les composants. + L'avantage de ce type de mapping est qu'il pemet de déterminer les véritables propriétés + du bean au moment su déploiement en éditant simplement le document de mapping. La manipulation du document de mapping pendant l'execution de l'application est aussi - possible en utilisant un parser DOM. Il ya m�me mieux, vous pouvez acc�der (et changer) + possible en utilisant un parser DOM. Il ya même mieux, vous pouvez accéder (et changer) le metamodel de configuration d'hibernate en utilisant l'objet <literal>Configuration</literal> </para> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/configuration.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/configuration.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/configuration.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,15 +1,17 @@ -<?xml version='1.0' encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="session-configuration" revision="1"> <title>Configuration</title> <para> - Parce qu'Hibernate est con�u pour fonctionner dans diff�rents environnements, - il existe beaucoup de param�tres de configuration. Heureusement, la plupart - ont des valeurs par d�faut appropri�es et la distribution d'Hibernate contient - un exemple de fichier <literal>hibernate.properties</literal> dans le r�pertoire - <literal>etc/</literal> qui montre les diff�rentes options. Vous n'avez qu'� - placer ce fichier dans votre classpath et � l'adapter. + Parce qu'Hibernate est conçu pour fonctionner dans différents environnements, + il existe beaucoup de paramètres de configuration. Heureusement, la plupart + ont des valeurs par défaut appropriées et la distribution d'Hibernate contient + un exemple de fichier <literal>hibernate.properties</literal> dans le répertoire + <literal>etc/</literal> qui montre les différentes options. Vous n'avez qu'à + placer ce fichier dans votre classpath et à l'adapter. </para> <sect1 id="configuration-programmatic" revision="1"> @@ -17,17 +19,17 @@ <para> Une instance de <literal>org.hibernate.cfg.Configuration</literal> - repr�sente un ensemble de mappings des classes Java d'une application vers - la base de donn�es SQL. La <literal>Configuration</literal> est utilis�e + représente un ensemble de mappings des classes Java d'une application vers + la base de données SQL. La <literal>Configuration</literal> est utilisée pour construire un objet (immuable) <literal>SessionFactory</literal>. - Les mappings sont constitu�s d'un ensemble de fichiers de mapping XML. + Les mappings sont constitués d'un ensemble de fichiers de mapping XML. </para> <para> Vous pouvez obtenir une instance de <literal>Configuration</literal> - en l'instanciant directement et en sp�cifiant la liste des documents + en l'instanciant directement et en spécifiant la liste des documents XML de mapping. Si les fichiers de mapping sont dans le classpath, vous - pouvez le faire � l'aide de la m�thode <literal>addResource()</literal> : + pouvez le faire à l'aide de la méthode <literal>addResource()</literal> : </para> <programlisting><![CDATA[Configuration cfg = new Configuration() @@ -35,7 +37,7 @@ .addResource("Bid.hbm.xml");]]></programlisting> <para> - Une alternative (parfois meilleure) est de sp�cifier les classes mapp�es + Une alternative (parfois meilleure) est de spécifier les classes mappées et de laisser Hibernate trouver les documents de mapping pour vous : </para> @@ -47,12 +49,12 @@ Hibernate va rechercher les fichiers de mappings <literal>/org/hibernate/auction/Item.hbm.xml</literal> et <literal>/org/hibernate/auction/Bid.hbm.xml</literal> dans le classpath. - Cette approche �limine les noms de fichiers en dur. + Cette approche élimine les noms de fichiers en dur. </para> <para> - Une <literal>Configuration</literal> vous permet �galement de pr�ciser des - propri�t�s de configuration : + Une <literal>Configuration</literal> vous permet également de préciser des + propriétés de configuration : </para> <programlisting><![CDATA[Configuration cfg = new Configuration() @@ -63,32 +65,32 @@ .setProperty("hibernate.order_updates", "true");]]></programlisting> <para> - Ce n'est pas le seul moyen de passer des propri�t�s de configuration � Hibernate. - Les diff�rentes options sont : + Ce n'est pas le seul moyen de passer des propriétés de configuration à Hibernate. + Les différentes options sont : </para> <orderedlist spacing="compact"> <listitem> <para> Passer une instance de <literal>java.util.Properties</literal> - � <literal>Configuration.setProperties()</literal>. + à <literal>Configuration.setProperties()</literal>. </para> </listitem> <listitem> <para> - Placer <literal>hibernate.properties</literal> dans un r�pertoire racine + Placer <literal>hibernate.properties</literal> dans un répertoire racine du classpath </para> </listitem> <listitem> <para> - Positionner les propri�t�s <literal>System</literal> en utilisant + Positionner les propriétés <literal>System</literal> en utilisant <literal>java -Dproperty=value</literal>. </para> </listitem> <listitem> <para> - Inclure des �l�ments <literal>&lt;property&gt;</literal> dans le + Inclure des éléments <literal>&lt;property&gt;</literal> dans le fichier <literal>hibernate.cfg.xml</literal> (voir plus loin). </para> </listitem> @@ -96,11 +98,11 @@ <para> L'utilisation d'<literal>hibernate.properties</literal> est l'approche la plus - simple si vous voulez d�marrer rapidement + simple si vous voulez démarrer rapidement </para> <para> - La <literal>Configuration</literal> est un objet de d�marrage qui sera supprim� - une fois qu'une <literal>SessionFactory</literal> aura �t� cr��e. + La <literal>Configuration</literal> est un objet de démarrage qui sera supprimé + une fois qu'une <literal>SessionFactory</literal> aura été créée. </para> </sect1> @@ -109,16 +111,16 @@ <title>Obtenir une SessionFactory</title> <para> - Une fois que tous les mappings ont �t� pars�s par la <literal>Configuration</literal>, + Une fois que tous les mappings ont été parsés par la <literal>Configuration</literal>, l'application doit obtenir une fabrique d'instances de <literal>Session</literal>. - Cette fabrique sera partag�e entre tous les threads de l'application : + Cette fabrique sera partagée entre tous les threads de l'application : </para> <programlisting><![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]></programlisting> <para> - Hibernate permet � votre application d'instancier plus d'une <literal>SessionFactory</literal>. - Cela est pratique lorsque vous utilisez plus d'une base de donn�es. + Hibernate permet à votre application d'instancier plus d'une <literal>SessionFactory</literal>. + Cela est pratique lorsque vous utilisez plus d'une base de données. </para> </sect1> @@ -127,7 +129,7 @@ <title>Connexions JDBC</title> <para> - Habituellement, vous voulez que la <literal>SessionFactory</literal> cr�e les connexions JDBC et + Habituellement, vous voulez que la <literal>SessionFactory</literal> crée les connexions JDBC et les mette dans un pool pour vous. Si vous suivez cette approche, ouvrir une <literal>Session</literal> est aussi simple que : </para> @@ -135,31 +137,31 @@ <programlisting><![CDATA[Session session = sessions.openSession(); // open a new Session]]></programlisting> <para> - D�s que vous ferez quelquechose qui requiert un acc�s � la base de donn�es, une connexion - JDBC sera r�cup�r�e dans le pool. + Dès que vous ferez quelquechose qui requiert un accès à la base de données, une connexion + JDBC sera récupérée dans le pool. </para> <para> - Pour faire cela, il faut passer les propri�t�s de la connexion JDBC � Hibernate. - Tous les noms des propri�t�s Hibernate et leur signification sont d�finies dans + Pour faire cela, il faut passer les propriétés de la connexion JDBC à Hibernate. + Tous les noms des propriétés Hibernate et leur signification sont définies dans la classe <literal>org.hibernate.cfg.Environment</literal>. Nous allons maintenant - d�crire les param�tres de configuration des connexions JDBC les plus importants. + décrire les paramètres de configuration des connexions JDBC les plus importants. </para> <para> Hibernate obtiendra des connexions (et les mettra dans un pool) en utilisant - <literal>java.sql.DriverManager</literal> si vous positionnez les param�tres de la mani�re + <literal>java.sql.DriverManager</literal> si vous positionnez les paramètres de la manière suivante : </para> <table frame="topbot"> - <title>Propri�t�s JDBC d'Hibernate</title> + <title>Propriétés JDBC d'Hibernate</title> <tgroup cols="2"> <colspec colname="c1" colwidth="1*"/> <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Nom de la propri�t�</entry> + <entry>Nom de la propriété</entry> <entry>Fonction</entry> </row> </thead> @@ -185,7 +187,7 @@ <literal>hibernate.connection.username</literal> </entry> <entry> - <emphasis>utilisateur de la base de donn�es</emphasis> + <emphasis>utilisateur de la base de données</emphasis> </entry> </row> <row> @@ -193,7 +195,7 @@ <literal>hibernate.connection.password</literal> </entry> <entry> - <emphasis>mot de passe de la base de donn�es</emphasis> + <emphasis>mot de passe de la base de données</emphasis> </entry> </row> <row> @@ -209,19 +211,19 @@ </table> <para> - L'algorithme natif de pool de connexions d'Hibernate est plut�t rudimentaire. Il a �t� fait - dans le but de vous aider � d�marrer et <emphasis>n'est pas pr�vu pour un syst�me en production</emphasis> - ou m�me pour un test de peformance. Utilisez plut�t un pool tiers pour de meilleures performances et une - meilleure stabilit� : pour cela, remplacez la propri�t� <literal>hibernate.connection.pool_size</literal> avec les propri�t�s - sp�cifique au pool de connexions que vous avez choisi. Cela d�sactivera le pool de connexions interne + L'algorithme natif de pool de connexions d'Hibernate est plutôt rudimentaire. Il a été fait + dans le but de vous aider à démarrer et <emphasis>n'est pas prévu pour un système en production</emphasis> + ou même pour un test de peformance. Utilisez plutôt un pool tiers pour de meilleures performances et une + meilleure stabilité : pour cela, remplacez la propriété <literal>hibernate.connection.pool_size</literal> avec les propriétés + spécifique au pool de connexions que vous avez choisi. Cela désactivera le pool de connexions interne d'Hibernate. Vous pouvez par exemple utiliser C3P0. </para> <para> - C3P0 est un pool de connexions JDBC open source distribu� avec Hibernate dans le r�pertoire + C3P0 est un pool de connexions JDBC open source distribué avec Hibernate dans le répertoire <literal>lib</literal>. Hibernate utilisera son provider <literal>C3P0ConnectionProvider</literal> - pour le pool de connexions si vous positionnez les propri�t�s <literal>hibernate.c3p0.*</literal>. - Si vous voulez utiliser Proxool, r�f�rez vous au groupe de propri�t�s d'<literal>hibernate.properties</literal> + pour le pool de connexions si vous positionnez les propriétés <literal>hibernate.c3p0.*</literal>. + Si vous voulez utiliser Proxool, référez vous au groupe de propriétés d'<literal>hibernate.properties</literal> correspondant et regardez sur le site web d'Hibernate pour plus d'informations. </para> @@ -243,18 +245,18 @@ Dans le cadre de l'utilisation au sein d'un serveur d'applications, vous devriez quasiment toujours configurer Hibernate pour qu'il obtienne ses connexions de la <literal>DataSource</literal> du serveur d'application - enregistr�e dans le JNDI. Pour cela vous devrez d�finir au moins une des - propri�t�s suivantes : + enregistrée dans le JNDI. Pour cela vous devrez définir au moins une des + propriétés suivantes : </para> <table frame="topbot"> - <title>Propri�t� d'une Datasource Hibernate</title> + <title>Propriété d'une Datasource Hibernate</title> <tgroup cols="2"> <colspec colname="c1" colwidth="1*"/> <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Nom d'une propri�t�</entry> + <entry>Nom d'une propriété</entry> <entry>fonction</entry> </row> </thead> @@ -288,7 +290,7 @@ <literal>hibernate.connection.username</literal> </entry> <entry> - <emphasis>utilisateur de la base de donn�es</emphasis> (optionnelle) + <emphasis>utilisateur de la base de données</emphasis> (optionnelle) </entry> </row> <row> @@ -296,7 +298,7 @@ <literal>hibernate.connection.password</literal> </entry> <entry> - <emphasis>mot de passe de la base de donn�es</emphasis> (optionnelle) + <emphasis>mot de passe de la base de données</emphasis> (optionnelle) </entry> </row> </tbody> @@ -316,49 +318,49 @@ hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]></programlisting> <para> - Les connexions JDBC obtenues � partir d'une datasource JNDI participeront automatiquement - aux transactions g�r�es par le conteneur du serveur d'applications. + Les connexions JDBC obtenues à partir d'une datasource JNDI participeront automatiquement + aux transactions gérées par le conteneur du serveur d'applications. </para> <para> - Des propri�t�s suppl�mentaires de connexion peuvent �tre pass�es en pr�fixant - le nom de la propri�t� par "<literal>hibernate.connnection</literal>". Par exemple, - vous pouvez sp�cifier un jeu de caract�res en utilisant + Des propriétés supplémentaires de connexion peuvent être passées en préfixant + le nom de la propriété par "<literal>hibernate.connnection</literal>". Par exemple, + vous pouvez spécifier un jeu de caractères en utilisant <literal>hibernate.connection.charSet</literal>. </para> <para> - Vous pouvez fournir votre propre strat�gie d'obtention des connexions JDBC en impl�mentant l'interface - <literal>org.hibernate.connection.ConnectionProvider</literal>. Vous pouvez s�lectionner - une impl�mentation sp�cifique en positionnant <literal>hibernate.connection.provider_class</literal>. + Vous pouvez fournir votre propre stratégie d'obtention des connexions JDBC en implémentant l'interface + <literal>org.hibernate.connection.ConnectionProvider</literal>. Vous pouvez sélectionner + une implémentation spécifique en positionnant <literal>hibernate.connection.provider_class</literal>. </para> </sect1> <sect1 id="configuration-optional" revision="1"> - <title>Propri�t�s de configuration optionnelles</title> + <title>Propriétés de configuration optionnelles</title> <para> - Il y a un certain nombre d'autres propri�t�s qui contr�lent le fonctionnement - d'Hibernate � l'ex�cution. Toutes sont optionnelles et ont comme valeurs par d�faut + Il y a un certain nombre d'autres propriétés qui contrôlent le fonctionnement + d'Hibernate à l'exécution. Toutes sont optionnelles et ont comme valeurs par défaut des valeurs "raisonnables" pour un fonctionnement nominal. </para> <para> - <emphasis>Attention : Certaines de ces propri�t�s sont uniquement de niveau System.</emphasis> - Les propri�t�s de niveau System ne peuvent �tre positionn�es que via la ligne de commande - (<literal>java -Dproperty=value</literal>) ou �tre d�finies dans <literal>hibernate.properties</literal>. - Elle <emphasis>ne peuvent pas</emphasis> l'�tre via une des autres techniques d�crites ci-dessus. + <emphasis>Attention : Certaines de ces propriétés sont uniquement de niveau System.</emphasis> + Les propriétés de niveau System ne peuvent être positionnées que via la ligne de commande + (<literal>java -Dproperty=value</literal>) ou être définies dans <literal>hibernate.properties</literal>. + Elle <emphasis>ne peuvent pas</emphasis> l'être via une des autres techniques décrites ci-dessus. </para> <table frame="topbot" id="configuration-optional-properties" revision="8"> - <title>Propri�t�s de configuration d'Hibernate</title> + <title>Propriétés de configuration d'Hibernate</title> <tgroup cols="2"> <colspec colname="c1" colwidth="1*"/> <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Nom de la propri�t�</entry> + <entry>Nom de la propriété</entry> <entry>Fonction</entry> </row> </thead> @@ -369,8 +371,8 @@ </entry> <entry> Le nom de la classe du <literal>Dialect</literal> Hibernate. - qui permet � Hibernate de g�n�rer du SQL optimis� pour une - base de donn�es relationnelle particuli�re. + qui permet à Hibernate de générer du SQL optimisé pour une + base de données relationnelle particulière. <para> <emphasis role="strong">ex.</emphasis> <literal>nom.complet.de.ma.classe.de.Dialect</literal> @@ -382,8 +384,8 @@ <literal>hibernate.show_sql</literal> </entry> <entry> - Ecrit toutes les requ�tes SQL sur la console. Il s'agit d'une - alternative au positionnement de la cat�gorie de log + Ecrit toutes les requêtes SQL sur la console. Il s'agit d'une + alternative au positionnement de la catégorie de log <literal>org.hibernate.SQL</literal> au niveau <literal>debug</literal>. <para> <emphasis role="strong">ex.</emphasis> @@ -408,8 +410,8 @@ <literal>hibernate.default_schema</literal> </entry> <entry> - Positionne dans le SQL g�n�r� un sch�ma/tablespace par d�faut pour les noms de - table ne l'ayant pas surcharg�. + Positionne dans le SQL généré un schéma/tablespace par défaut pour les noms de + table ne l'ayant pas surchargé. <para> <emphasis role="strong">ex.</emphasis> <literal>MON_SCHEMA</literal> @@ -421,8 +423,8 @@ <literal>hibernate.default_catalog</literal> </entry> <entry> - Qualifie les noms de tables non qualifi�es avec ce catalogue - dans le SQL g�n�r�. + Qualifie les noms de tables non qualifiées avec ce catalogue + dans le SQL généré. <para> <emphasis role="strong">ex.</emphasis> <literal>CATALOG_NAME</literal> @@ -435,7 +437,7 @@ </entry> <entry> La <literal>SessionFactory</literal> sera automatiquement - li�e � ce nom dans le JNDI apr�s sa cr�ation. + liée à ce nom dans le JNDI après sa création. <para> <emphasis role="strong">ex.</emphasis> <literal>jndi/nom/hierarchique</literal> @@ -447,14 +449,14 @@ <literal>hibernate.max_fetch_depth</literal> </entry> <entry> - D�finit la profondeur maximale d'un arbre de chargement par - jointures ouvertes pour les associations � cardinalit� unitaire - (un-�-un, plusieurs-�-un). - Un <literal>0</literal> d�sactive le chargement par jointure + Définit la profondeur maximale d'un arbre de chargement par + jointures ouvertes pour les associations à cardinalité unitaire + (un-à-un, plusieurs-à-un). + Un <literal>0</literal> désactive le chargement par jointure ouverte. <para> <emphasis role="strong">ex.</emphasis> - valeurs recommand�es entre <literal>0</literal> et <literal>3</literal> + valeurs recommandées entre <literal>0</literal> et <literal>3</literal> </para> </entry> </row> @@ -463,10 +465,10 @@ <literal>hibernate.default_batch_fetch_size</literal> </entry> <entry> - D�finit une taille par d�faut pour le chargement par lot des associations + Définit une taille par défaut pour le chargement par lot des associations <para> <emphasis role="strong">ex.</emphasis> - Valeurs recommand�es : <literal>4</literal>, <literal>8</literal>, + Valeurs recommandées : <literal>4</literal>, <literal>8</literal>, <literal>16</literal> </para> </entry> @@ -476,7 +478,7 @@ <literal>hibernate.default_entity_mode</literal> </entry> <entry> - D�finit un mode de repr�sentation par d�faut des entit�s pour + Définit un mode de représentation par défaut des entités pour toutes les sessions ouvertes depuis cette <literal>SessionFactory</literal> <para> <literal>dynamic-map</literal>, <literal>dom4j</literal>, @@ -489,9 +491,9 @@ <literal>hibernate.order_updates</literal> </entry> <entry> - Force Hibernate � trier les updates SQL par la valeur de la cl� - primaire des �l�ments qui sont mis � jour. Cela permet de limiter - les deadlocks de transaction dans les syst�mes hautement concurents. + Force Hibernate à trier les updates SQL par la valeur de la clé + primaire des éléments qui sont mis à jour. Cela permet de limiter + les deadlocks de transaction dans les systèmes hautement concurents. <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -503,8 +505,8 @@ <literal>hibernate.generate_statistics</literal> </entry> <entry> - Si activ�, Hibernate va collecter des statistiques utiles - pour le r�glage des performances. + Si activé, Hibernate va collecter des statistiques utiles + pour le réglage des performances. <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -516,9 +518,9 @@ <literal>hibernate.use_identifer_rollback</literal> </entry> <entry> - Si activ�, les propri�t�s correspondant � l'identifiant - des objets vont �tre remises aux valeurs par d�faut lorsque - les objets seront supprim�s. + Si activé, les propriétés correspondant à l'identifiant + des objets vont être remises aux valeurs par défaut lorsque + les objets seront supprimés. <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -530,8 +532,8 @@ <literal>hibernate.use_sql_comments</literal> </entry> <entry> - Si activ�, Hibernate va g�n�rer des commentaires � l'int�rieur - des requ�tes SQL pour faciliter le debogage., par d�faut � <literal>false</literal>. + Si activé, Hibernate va générer des commentaires à l'intérieur + des requêtes SQL pour faciliter le debogage., par défaut à <literal>false</literal>. <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -543,13 +545,13 @@ </table> <table frame="topbot" id="configuration-jdbc-properties" revision="8"> - <title>Propri�t�s Hibernate li�es � JDBC et aux connexions</title> + <title>Propriétés Hibernate liées à JDBC et aux connexions</title> <tgroup cols="2"> <colspec colname="c1" colwidth="1*"/> <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Nom de la propri�t�</entry> + <entry>Nom de la propriété</entry> <entry>Fonction</entry> </row> </thead> @@ -559,7 +561,7 @@ <literal>hibernate.jdbc.fetch_size</literal> </entry> <entry> - Une valeur non nulle d�termine la taille de chargement + Une valeur non nulle détermine la taille de chargement des statements JDBC (appelle <literal>Statement.setFetchSize()</literal>). </entry> @@ -570,10 +572,10 @@ </entry> <entry> Une valeur non nulle active l'utilisation par Hibernate des mises - � jour par batch de JDBC2. + à jour par batch de JDBC2. <para> <emphasis role="strong">ex.</emphasis> - les valeurs recommand�es entre <literal>5</literal> et <literal>30</literal> + les valeurs recommandées entre <literal>5</literal> et <literal>30</literal> </para> </entry> </row> @@ -582,10 +584,10 @@ <literal>hibernate.jdbc.batch_versioned_data</literal> </entry> <entry> - Param�trez cette propri�t� � <literal>true</literal> si votre pilote JDBC + Paramétrez cette propriété à <literal>true</literal> si votre pilote JDBC retourne des row counts corrects depuis <literal>executeBatch()</literal> (il est - souvent appropri� d'activer cette option). Hibernate utilisera alors le "batched DML" pour - versionner automatiquement les donn�es. Par d�faut = <literal>false</literal>. + souvent approprié d'activer cette option). Hibernate utilisera alors le "batched DML" pour + versionner automatiquement les données. Par défaut = <literal>false</literal>. <para> <emphasis role="strong">eg.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -597,8 +599,8 @@ <literal>hibernate.jdbc.factory_class</literal> </entry> <entry> - S�lectionne un <literal>Batcher</literal> personnalis�. La - plupart des applications n'auront pas besoin de cette propri�t� + Sélectionne un <literal>Batcher</literal> personnalisé. La + plupart des applications n'auront pas besoin de cette propriété de configuration <para> <emphasis role="strong">ex.</emphasis> @@ -612,9 +614,9 @@ </entry> <entry> Active l'utilisation par Hibernate des resultsets scrollables - de JDBC2. Cette propri�t� est seulement n�cessaire lorsque l'on + de JDBC2. Cette propriété est seulement nécessaire lorsque l'on utilise une connexion JDBC fournie par l'utilisateur. Autrement, - Hibernate utilise les m�tadonn�es de la connexion. + Hibernate utilise les métadonnées de la connexion. <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -626,9 +628,9 @@ <literal>hibernate.jdbc.use_streams_for_binary</literal> </entry> <entry> - Utilise des flux lorsque l'on �crit/lit des types + Utilise des flux lorsque l'on écrit/lit des types <literal>binary</literal> ou <literal>serializable</literal> - vers et � partir de JDBC (propri�t� de niveau syst�me). + vers et à partir de JDBC (propriété de niveau système). <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -641,10 +643,10 @@ </entry> <entry> Active l'utilisation de <literal>PreparedStatement.getGeneratedKeys()</literal> de JDBC3 - pour r�cup�rer nativement les cl�s g�n�r�es apr�s insertion. N�cessite un pilote - JDBC3+, le mettre � false si votre pilote a des probl�mes avec les g�n�rateurs - d'identifiant Hibernate. Par d�faut, essaie de d�terminer les possibilit�s du - pilote en utilisant les meta donn�es de connexion. + pour récupérer nativement les clés générées après insertion. Nécessite un pilote + JDBC3+, le mettre à false si votre pilote a des problèmes avec les générateurs + d'identifiant Hibernate. Par défaut, essaie de déterminer les possibilités du + pilote en utilisant les meta données de connexion. <para> <emphasis role="strong">eg.</emphasis> <literal>true|false</literal> @@ -656,8 +658,8 @@ <literal>hibernate.connection.provider_class</literal> </entry> <entry> - Le nom de la classe d'un <literal>ConnectionProvider</literal> personnalis� - qui fournit des connexions JDBC � Hibernate + Le nom de la classe d'un <literal>ConnectionProvider</literal> personnalisé + qui fournit des connexions JDBC à Hibernate <para> <emphasis role="strong">ex.</emphasis> <literal>classname.of.ConnectionProvider</literal> @@ -669,10 +671,10 @@ <literal>hibernate.connection.isolation</literal> </entry> <entry> - D�finit le niveau d'isolation des transactions JDBC. Regardez - <literal>java.sql.Connection</literal> pour conna�tre le - sens des diff�rentes valeurs mais notez �galement que la plupart - des bases de donn�es ne supportent pas tous les niveaux d'isolation. + Définit le niveau d'isolation des transactions JDBC. Regardez + <literal>java.sql.Connection</literal> pour connaître le + sens des différentes valeurs mais notez également que la plupart + des bases de données ne supportent pas tous les niveaux d'isolation. <para> <emphasis role="strong">ex.</emphasis> <literal>1, 2, 4, 8</literal> @@ -685,7 +687,7 @@ </entry> <entry> Active le mode de commit automatique (autocommit) pour les connexions - JDBC du pool (non recommand�). + JDBC du pool (non recommandé). <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -697,13 +699,13 @@ <literal>hibernate.connection.release_mode</literal> </entry> <entry> - Sp�cifie � quel moment Hibernate doit relacher les connexion JDBC. - Par d�faut une connexion JDBC est conserv�e jusqu'� ce que la session - soit explicitement ferm�e ou d�connect�e. Pour une source de donn�es + Spécifie à quel moment Hibernate doit relacher les connexion JDBC. + Par défaut une connexion JDBC est conservée jusqu'à ce que la session + soit explicitement fermée ou déconnectée. Pour une source de données JTA d'un serveur d'application, vous devriez utiliser <literal>after_statement</literal> - pour lib�rer les connexions de mani�re plus agressive apr�s chaque appel - JDBC. Pour une connexion non JTA, il est souvent pr�f�rable de lib�rer - la connexion � la fin de chaque transaction en utilisant <literal>after_transaction</literal>. + pour libérer les connexions de manière plus agressive après chaque appel + JDBC. Pour une connexion non JTA, il est souvent préférable de libérer + la connexion à la fin de chaque transaction en utilisant <literal>after_transaction</literal>. <literal>auto</literal> choisira <literal>after_statement</literal> pour des transactions JTA et CMT et <literal>after_transaction</literal> pour des transactions JDBC. @@ -719,8 +721,8 @@ <literal>hibernate.connection.<emphasis>&lt;propertyName&gt;</emphasis></literal> </entry> <entry> - Passe la propri�t� JDBC<literal>propertyName</literal> - � <literal>DriverManager.getConnection()</literal>. + Passe la propriété JDBC<literal>propertyName</literal> + à <literal>DriverManager.getConnection()</literal>. </entry> </row> <row> @@ -728,7 +730,7 @@ <literal>hibernate.jndi.<emphasis>&lt;propertyName&gt;</emphasis></literal> </entry> <entry> - Passe la propri�t� <literal>propertyName</literal> � l'<literal>InitialContextFactory</literal> + Passe la propriété <literal>propertyName</literal> à l'<literal>InitialContextFactory</literal> de JNDI. </entry> </row> @@ -737,13 +739,13 @@ </table> <table frame="topbot" id="configuration-cache-properties" revision="7"> - <title>Propri�t�s du Cache d'Hibernate</title> + <title>Propriétés du Cache d'Hibernate</title> <tgroup cols="2"> <colspec colname="c1" colwidth="1*"/> <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Nom de la propri�t�</entry> + <entry>Nom de la propriété</entry> <entry>Fonction</entry> </row> </thead> @@ -754,7 +756,7 @@ </entry> <entry> Le nom de classe d'un <literal>CacheProvider</literal> - sp�cifique. + spécifique. <para> <emphasis role="strong">ex.</emphasis> <literal>nom.de.classe.du.CacheProvider</literal> @@ -766,10 +768,10 @@ <literal>hibernate.cache.use_minimal_puts</literal> </entry> <entry> - Optimise le cache de second niveau en minimisant les �critures, - au prix de plus de lectures. Ce param�tre est surtout utile pour - les caches en cluster et est activ� par d�faut dans hibernate3 - pour les impl�mentations de cache en cluster. + Optimise le cache de second niveau en minimisant les écritures, + au prix de plus de lectures. Ce paramètre est surtout utile pour + les caches en cluster et est activé par défaut dans hibernate3 + pour les implémentations de cache en cluster. <para> <emphasis role="strong">ex.</emphasis> <literal>true|false</literal> @@ -781,8 +783,8 @@ <literal>hibernate.cache.use_query_cache</literal> </entry> <entry> - Activer le cache de requ�te, les requ�tes individuelles doivent tout - de m�me �tre d�clar�es comme pouvant �tre mise en cache. + Activer le cache de requête, les requêtes individuelles doivent tout + de même être déclarées comme pouvant être mise en cache. <para> <emphasis role="strong">ex.</emphasis> <literal>true|false</literal> @@ -794,8 +796,8 @@ <literal>hibernate.cache.use_second_level_cache</literal> </entry> <entry> - Peut �tre utilis� pour d�sactiver compl�tement le cache de second niveau - qui est activ� par d�faut pour les classes qui sp�cifient un �l�ment + Peut être utilisé pour désactiver complètement le cache de second niveau + qui est activé par défaut pour les classes qui spécifient un élément <literal>&lt;cache&gt;</literal> dans leur mapping. <para> <emphasis role="strong">ex.</emphasis> @@ -809,7 +811,7 @@ </entry> <entry> Le nom de classe d'une interface <literal>QueryCacheFactory</literal> , - par d�faut = built-in <literal>StandardQueryCacheFactory</literal>. + par défaut = built-in <literal>StandardQueryCacheFactory</literal>. <para> <emphasis role="strong">ex.</emphasis> <literal>nom.de.la.classe.de.QueryCacheFactory</literal> @@ -822,7 +824,7 @@ <literal>hibernate.cache.region_prefix</literal> </entry> <entry> - Un pr�fixe � utiliser pour le nom des r�gions du + Un préfixe à utiliser pour le nom des régions du cache de second niveau. <para> <emphasis role="strong">ex.</emphasis> @@ -835,8 +837,8 @@ <literal>hibernate.cache.use_structured_entries</literal> </entry> <entry> - Force Hibernate � stocker les donn�es dans le cache de - second niveau dans un format plus adapt� � la visualisation + Force Hibernate à stocker les données dans le cache de + second niveau dans un format plus adapté à la visualisation par un humain. <para> <emphasis role="strong">ex.</emphasis> @@ -849,13 +851,13 @@ </table> <table frame="topbot" id="configuration-transaction-properties" revision="9"> - <title>Propri�t�s des transactions Hibernate</title> + <title>Propriétés des transactions Hibernate</title> <tgroup cols="2"> <colspec colname="c1" colwidth="1*"/> <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Nom de la propri�t�</entry> + <entry>Nom de la propriété</entry> <entry>Fonction</entry> </row> </thead> @@ -866,8 +868,8 @@ </entry> <entry> Le nom de classe d'une <literal>TransactionFactory</literal> - qui sera utilis�e par l'API <literal>Transaction</literal> - d'Hibernate (la valeur par d�faut est + qui sera utilisée par l'API <literal>Transaction</literal> + d'Hibernate (la valeur par défaut est <literal>JDBCTransactionFactory</literal>). <para> <emphasis role="strong">ex.</emphasis> @@ -880,7 +882,7 @@ <literal>jta.UserTransaction</literal> </entry> <entry> - Le nom JNDI utilis� par la <literal>JTATransactionFactory</literal> + Le nom JNDI utilisé par la <literal>JTATransactionFactory</literal> pour obtenir la <literal>UserTransaction</literal> JTA du serveur d'applications. <para> @@ -895,8 +897,8 @@ </entry> <entry> Le nom de la classe du <literal>TransactionManagerLookup</literal> - - requis lorsque le cache de niveau JVM est activ� ou lorsque l'on - utilise un g�n�rateur hilo dans un environnement JTA. + - requis lorsque le cache de niveau JVM est activé ou lorsque l'on + utilise un générateur hilo dans un environnement JTA. <para> <emphasis role="strong">ex.</emphasis> <literal>nom.de.classe.du.TransactionManagerLookup</literal> @@ -908,10 +910,10 @@ <literal>hibernate.transaction.flush_before_completion</literal> </entry> <entry> - Si activ�, la session sera automatiquement vid�e durant la phase - qui pr�c�de la fin de la transaction (before completion). + Si activé, la session sera automatiquement vidée durant la phase + qui précède la fin de la transaction (before completion). La gestion automatique de contexte fourni par Hibernate est - recommand�e, voir + recommandée, voir <xref linkend="architecture-current-session"/>. <para> <emphasis role="strong">ex.</emphasis> @@ -924,10 +926,10 @@ <literal>hibernate.transaction.auto_close_session</literal> </entry> <entry> - Si activ�, la session sera automatiquement ferm� pendant la phase + Si activé, la session sera automatiquement fermé pendant la phase qui suit la fin de la transaction (after completion). La gestion automatique de contexte fourni par Hibernate est - recommand�e, voir + recommandée, voir <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -939,13 +941,13 @@ </table> <table frame="topbot" id="configuration-misc-properties" revision="9"> - <title>Propri�t�s diverses</title> + <title>Propriétés diverses</title> <tgroup cols="2"> <colspec colname="c1" colwidth="1*"/> <colspec colname="c2" colwidth="1*"/> <thead> <row> - <entry>Nom de la propri�t�</entry> + <entry>Nom de la propriété</entry> <entry>Fonction</entry> </row> </thead> @@ -955,10 +957,10 @@ <literal>hibernate.current_session_context_class</literal> </entry> <entry> - Fournit une strat�gie particuli�re pour contextualiser + Fournit une stratégie particulière pour contextualiser la <literal>Session</literal> courante. Voir <xref linkend="architecture-current-session"/> pour plus - d'informations sur les strat�gies fournies. + d'informations sur les stratégies fournies. <para> <emphasis role="strong">eg.</emphasis> <literal>jta</literal> | <literal>thread</literal> | @@ -971,7 +973,7 @@ <literal>hibernate.query.factory_class</literal> </entry> <entry> - Choisi l'impl�mentation du parseur de requ�te + Choisi l'implémentation du parseur de requête <para> <emphasis role="strong">ex.</emphasis> <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> ou @@ -984,9 +986,9 @@ <literal>hibernate.query.substitutions</literal> </entry> <entry> - Lien entre les tokens de requ�tes Hibernate et les - tokens SQL (les tokens peuvent �tre des fonctions ou des - noms litt�raux par exemple). + Lien entre les tokens de requêtes Hibernate et les + tokens SQL (les tokens peuvent être des fonctions ou des + noms littéraux par exemple). <para> <emphasis role="strong">ex.</emphasis> <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal> @@ -998,11 +1000,11 @@ <literal>hibernate.hbm2ddl.auto</literal> </entry> <entry> - Valide ou exporte automatiquement le sch�ma DDL vers la base de donn�es - lorsque la <literal>SessionFactory</literal> est cr��e. + Valide ou exporte automatiquement le schéma DDL vers la base de données + lorsque la <literal>SessionFactory</literal> est créée. La valeur <literal>create-drop</literal> permet de supprimer - le sch�ma de base de donn�es lorsque la <literal>SessionFactory</literal> - est ferm�e explicitement. + le schéma de base de données lorsque la <literal>SessionFactory</literal> + est fermée explicitement. <para> <emphasis role="strong">ex.</emphasis> <literal>validate</literal> | <literal>update</literal> | @@ -1015,11 +1017,11 @@ <literal>hibernate.cglib.use_reflection_optimizer</literal> </entry> <entry> - Active l'utilisation de CGLIB � la place de la r�flexion � l'ex�cution - (Propri�t� de niveau syst�me). La r�flexion peut parfois �tre utile pour - r�soudre des probl�mes. Notez qu'Hibernate a tout de m�me toujours besoin - de CGLIB m�me si l'optimiseur est d�sactiv�. Cette optimisation ne peut �tre - d�finie que dans le fichier <literal>hibernate.cfg.xml</literal>. + Active l'utilisation de CGLIB à la place de la réflexion à l'exécution + (Propriété de niveau système). La réflexion peut parfois être utile pour + résoudre des problèmes. Notez qu'Hibernate a tout de même toujours besoin + de CGLIB même si l'optimiseur est désactivé. Cette optimisation ne peut être + définie que dans le fichier <literal>hibernate.cfg.xml</literal>. <para> <emphasis role="strong">ex.</emphasis> <literal>true</literal> | <literal>false</literal> @@ -1034,11 +1036,11 @@ <title>Dialectes SQL</title> <para> - Vous devriez toujours positionner la propri�t� <literal>hibernate.dialect</literal> � - la sous-classe de <literal>org.hibernate.dialect.Dialect</literal> appropri�e � - votre base de donn�es. Si vous sp�cifiez un dialecte, - Hibernate utilisera des valeurs adapt�es pour certaines autres - propri�t�s list�es ci-dessus, vous �vitant l'effort de le faire � la main. + Vous devriez toujours positionner la propriété <literal>hibernate.dialect</literal> à + la sous-classe de <literal>org.hibernate.dialect.Dialect</literal> appropriée à + votre base de données. Si vous spécifiez un dialecte, + Hibernate utilisera des valeurs adaptées pour certaines autres + propriétés listées ci-dessus, vous évitant l'effort de le faire à la main. </para> <table frame="topbot" id="sql-dialects" revision="2"> @@ -1129,24 +1131,24 @@ <title>Chargement par Jointure Ouverte</title> <para> - Si votre base de donn�es supporte les outer joins de type ANSI, Oracle ou Sybase, - <emphasis>le chargement par jointure ouverte</emphasis> devrait am�liorer les - performances en limitant le nombre d'aller-retour avec la base de donn�es (la - base de donn�es effectuant donc potentiellement plus de travail). Le chargement par - jointure ouverte permet � un graphe entier d'objets connect�s par une relation plusieurs-�-un, - un-�-plusieurs ou un-�-un d'�tre charg� en un seul <literal>SELECT</literal> SQL. + Si votre base de données supporte les outer joins de type ANSI, Oracle ou Sybase, + <emphasis>le chargement par jointure ouverte</emphasis> devrait améliorer les + performances en limitant le nombre d'aller-retour avec la base de données (la + base de données effectuant donc potentiellement plus de travail). Le chargement par + jointure ouverte permet à un graphe entier d'objets connectés par une relation plusieurs-à-un, + un-à-plusieurs ou un-à-un d'être chargé en un seul <literal>SELECT</literal> SQL. </para> <para> - Le chargement par jointure ouverte peut �tre d�sactiver <emphasis>globalement</emphasis> - en mettant la propri�t� <literal>hibernate.max_fetch_depth</literal> � <literal>0</literal>. + Le chargement par jointure ouverte peut être désactiver <emphasis>globalement</emphasis> + en mettant la propriété <literal>hibernate.max_fetch_depth</literal> à <literal>0</literal>. Une valeur de <literal>1</literal> ou plus active le chargement par jointure ouverte - pour les associatiosn un-�-un et plusieurs-�-un qui ont �t� mapp�e avec + pour les associatiosn un-à-un et plusieurs-à-un qui ont été mappée avec <literal>fetch="join"</literal>. </para> <para> - Reportez vous � <xref linkend="performance-fetching"/> pour plus d'information. + Reportez vous à <xref linkend="performance-fetching"/> pour plus d'information. </para> </sect2> @@ -1155,33 +1157,33 @@ <title>Flux binaires</title> <para> - Oracle limite la taille d'un tableau de <literal>byte</literal> qui peuvent �tre - pass�es � et vers son pilote JDBC. Si vous souhaitez utiliser des instances larges + Oracle limite la taille d'un tableau de <literal>byte</literal> qui peuvent être + passées à et vers son pilote JDBC. Si vous souhaitez utiliser des instances larges de type <literal>binary</literal> ou <literal>serializable</literal>, vous devez activer - la propri�t� <literal>hibernate.jdbc.use_streams_for_binary</literal>. <emphasis>C'est une - fonctionalit� de niveau syst�me uniquement.</emphasis> + la propriété <literal>hibernate.jdbc.use_streams_for_binary</literal>. <emphasis>C'est une + fonctionalité de niveau système uniquement.</emphasis> </para> </sect2> <sect2 id="configuration-optional-cacheprovider" revision="2"> - <title>Cache de second niveau et cache de requ�tes</title> + <title>Cache de second niveau et cache de requêtes</title> <para> - Les propri�t�s pr�fix�es par <literal>hibernate.cache</literal> - vous permettent d'utiliser un syst�me de cache de second niveau. Ce cache - peut avoir une port�e dans le processus ou m�me �tre utilisable dans un - syst�me distribu�. R�f�rez vous au chapitre <xref linkend="performance-cache"/> - pour plus de d�tails. + Les propriétés préfixées par <literal>hibernate.cache</literal> + vous permettent d'utiliser un système de cache de second niveau. Ce cache + peut avoir une portée dans le processus ou même être utilisable dans un + système distribué. Référez vous au chapitre <xref linkend="performance-cache"/> + pour plus de détails. </para> </sect2> <sect2 id="configuration-optional-querysubstitution"> - <title>Substitution dans le langage de requ�tage</title> + <title>Substitution dans le langage de requêtage</title> <para> - Vous pouvez d�finir de nouveaux tokens dans les requ�tes Hibernate en utilisant la propri�t� + Vous pouvez définir de nouveaux tokens dans les requêtes Hibernate en utilisant la propriété <literal>hibernate.query.substitutions</literal>. Par exemple : </para> @@ -1189,7 +1191,7 @@ <para> remplacerait les tokens <literal>vrai</literal> et <literal>faux</literal> par - des entiers dans le SQL g�n�r�. + des entiers dans le SQL généré. </para> <programlisting>hibernate.query.substitutions toLowercase=LOWER</programlisting> @@ -1205,9 +1207,9 @@ <para> Si vous activez <literal>hibernate.generate_statistics</literal>, Hibernate va - fournir un certains nombre de m�triques utiles pour r�gler les performances + fournir un certains nombre de métriques utiles pour régler les performances d'une application qui tourne via <literal>SessionFactory.getStatistics()</literal>. - Hibernate peut aussi �tre configur� pour exposer ces statistiques via JMX. + Hibernate peut aussi être configuré pour exposer ces statistiques via JMX. Lisez les Javadoc des interfaces dans le package <literal>org.hibernate.stats</literal> pour plus d'informations. </para> @@ -1219,65 +1221,65 @@ <title>Tracer</title> <para> - Hibernate trace divers �v�nements en utilisant Apache commons-logging. + Hibernate trace divers évènements en utilisant Apache commons-logging. </para> <para> - Le service commons-logging d�l�guera directement � Apache Log4j + Le service commons-logging délèguera directement à Apache Log4j (si vous incluez <literal>log4j.jar</literal> dans votre classpath) - ou le syst�me de trace du JDK 1.4 (si vous tournez sous le JDK 1.4 - et sup�rieur). Vous pouvez t�l�charger Log4j � partir de + ou le système de trace du JDK 1.4 (si vous tournez sous le JDK 1.4 + et supérieur). Vous pouvez télécharger Log4j à partir de <literal>http://jakarta.apache.org</literal>. Pour utiliser Log4j, vous devrez placer dans votre classpath un fichier - <literal>log4j.properties</literal>. Un exemple de fichier est distribu� - avec Hibernate dans le r�pertoire <literal>src/</literal>. + <literal>log4j.properties</literal>. Un exemple de fichier est distribué + avec Hibernate dans le répertoire <literal>src/</literal>. </para> <para> Nous vous recommandons fortement de vous familiariser avec les messages des traces - d'Hibernate. Beaucoup de soins a �t� apport� pour donner le plus de d�tails + d'Hibernate. Beaucoup de soins a été apporté pour donner le plus de détails possible sans les rendre illisibles. C'est un outil essentiel en cas de soucis. - Les cat�gories de trace les plus int�ressantes sont les suivantes : + Les catégories de trace les plus intéressantes sont les suivantes : </para> <table frame="topbot" id="log-categories" revision="2"> - <title>Cat�gories de trace d'Hibernate</title> + <title>Catégories de trace d'Hibernate</title> <tgroup cols="2"> <colspec colwidth="1*"/> <colspec colwidth="2.5*"/> <thead> <row> - <entry>Cat�gorie</entry> + <entry>Catégorie</entry> <entry>Fonction</entry> </row> </thead> <tbody> <row> <entry><literal>org.hibernate.SQL</literal></entry> - <entry>Trace toutes les requ�ts SQL de type DML (gestion des donn�es) qui sont ex�cut�es</entry> + <entry>Trace toutes les requêts SQL de type DML (gestion des données) qui sont exécutées</entry> </row> <row> <entry><literal>org.hibernate.type</literal></entry> - <entry>Trace tous les param�tres JDBC</entry> + <entry>Trace tous les paramètres JDBC</entry> </row> <row> <entry><literal>org.hibernate.tool.hbm2ddl</literal></entry> - <entry>Trace toutes les requ�ts SQL de type DDL (gestion de la structure de la base) qui sont ex�cut�es</entry> + <entry>Trace toutes les requêts SQL de type DDL (gestion de la structure de la base) qui sont exécutées</entry> </row> <row> <entry><literal>org.hibernate.pretty</literal></entry> <entry> - Trace l'�tat de toutes les entit�s (20 entit�s maximum) qui - sont associ�es avec la session hibernate au moment du flush + Trace l'état de toutes les entités (20 entités maximum) qui + sont associées avec la session hibernate au moment du flush </entry> </row> <row> <entry><literal>org.hibernate.cache</literal></entry> - <entry>Trace toute l'activit� du cache de second niveau</entry> + <entry>Trace toute l'activité du cache de second niveau</entry> </row> <row> <entry><literal>org.hibernate.transaction</literal></entry> - <entry>Trace toute l'activit� relative aux transactions</entry> + <entry>Trace toute l'activité relative aux transactions</entry> </row> <row> <entry><literal>org.hibernate.jdbc</literal></entry> @@ -1286,7 +1288,7 @@ <row> <entry><literal>org.hibernate.hql.ast.AST</literal></entry> <entry> - Trace l'arbre syntaxique des requ�tes HQL et SQL durant l'analyse syntaxique des requ�tes + Trace l'arbre syntaxique des requêtes HQL et SQL durant l'analyse syntaxique des requêtes </entry> </row> <row> @@ -1296,7 +1298,7 @@ <row> <entry><literal>org.hibernate</literal></entry> <entry> - Trace tout (beaucoupe d'informations, mais tr�s utile pour r�soudre les probl�mes). + Trace tout (beaucoupe d'informations, mais très utile pour résoudre les problèmes). </entry> </row> </tbody> @@ -1304,34 +1306,34 @@ </table> <para> - Lorsque vous d�veloppez des applications avec Hibernate, vous devriez quasiment toujours - travailler avec le niveau <literal>debug</literal> activ� pour la cat�gorie - <literal>org.hibernate.SQL</literal>, ou sinon avec la propri�t� - <literal>hibernate.show_sql</literal> activ�e. + Lorsque vous développez des applications avec Hibernate, vous devriez quasiment toujours + travailler avec le niveau <literal>debug</literal> activé pour la catégorie + <literal>org.hibernate.SQL</literal>, ou sinon avec la propriété + <literal>hibernate.show_sql</literal> activée. </para> </sect1> <sect1 id="configuration-namingstrategy"> - <title>Impl�menter une <literal>NamingStrategy</literal></title> + <title>Implémenter une <literal>NamingStrategy</literal></title> <para> L'interface <literal>org.hibernate.cfg.NamingStrategy</literal> vous permet de - sp�cifier une "strat�gie de nommage" des objets et �l�ments de la base de donn�es. + spécifier une "stratégie de nommage" des objets et éléments de la base de données. </para> <para> - Vous pouvez fournir des r�gles pour automatiquement g�n�rer les identifiants - de base de donn�es � partir des identifiants Java, ou transformer une colonne - ou table "logique" donn�e dans le fichier de mapping en une colonne ou table - "physique". Cette fonctionnalit� aide � r�duire la verbosit� de documents - de mapping, en �liminant le bruit r�p�titif (les pr�fixes <literal>TBL_</literal> - par exemple). La strat�gie par d�faut utilis�e par Hibernate est minimale. + Vous pouvez fournir des règles pour automatiquement générer les identifiants + de base de données à partir des identifiants Java, ou transformer une colonne + ou table "logique" donnée dans le fichier de mapping en une colonne ou table + "physique". Cette fonctionnalité aide à réduire la verbosité de documents + de mapping, en éliminant le bruit répétitif (les préfixes <literal>TBL_</literal> + par exemple). La stratégie par défaut utilisée par Hibernate est minimale. </para> <para> - Vous pouvez d�finir une strat�gie diff�rente en appelant + Vous pouvez définir une stratégie différente en appelant <literal>Configuration.setNamingStrategy()</literal> avant d'ajouter des mappings : </para> @@ -1344,7 +1346,7 @@ <para> <literal>net.sf.hibernate.cfg.ImprovedNamingStrategy</literal> est une - strat�gie fournie qui peut �tre utile comme point de d�part de quelques + stratégie fournie qui peut être utile comme point de départ de quelques applications. </para> @@ -1354,14 +1356,14 @@ <title>Fichier de configuration XML</title> <para> - Une approche alternative est de sp�cifier toute la configuration dans un - fichier nomm� <literal>hibernate.cfg.xml</literal>. Ce fichier peut �tre - utilis� � la place du fichier <literal>hibernate.properties</literal>, voire - m�me peut servir � surcharger les propri�t�s si les deux fichiers sont pr�sents. + Une approche alternative est de spécifier toute la configuration dans un + fichier nommé <literal>hibernate.cfg.xml</literal>. Ce fichier peut être + utilisé à la place du fichier <literal>hibernate.properties</literal>, voire + même peut servir à surcharger les propriétés si les deux fichiers sont présents. </para> <para> - Le fichier de configuration XML doit par d�faut se placer � la racine + Le fichier de configuration XML doit par défaut se placer à la racine du <literal>CLASSPATH</literal>. En voici un exemple : </para> @@ -1401,14 +1403,14 @@ <para> Commme vous pouvez le voir, l'avantage de cette approche est l'externalisation des noms des fichiers de mapping de la configuration. Le fichier <literal>hibernate.cfg.xml</literal> - est �galement plus pratique quand on commence � r�gler le cache d'Hibernate. Notez + est également plus pratique quand on commence à régler le cache d'Hibernate. Notez que vous pouvez choisir entre utiliser <literal>hibernate.properties</literal> ou - <literal>hibernate.cfg.xml</literal>, les deux sont �quivalents, sauf en ce qui - concerne les b�n�fices de l'utilisation de la syntaxe XML mentionn�s ci-dessus. + <literal>hibernate.cfg.xml</literal>, les deux sont équivalents, sauf en ce qui + concerne les bénéfices de l'utilisation de la syntaxe XML mentionnés ci-dessus. </para> <para> - Avec la configuration XML, d�marrer Hibernate devient donc aussi simple que ceci : + Avec la configuration XML, démarrer Hibernate devient donc aussi simple que ceci : </para> <programlisting><![CDATA[SessionFactory sf = new Configuration().configure().buildSessionFactory();]]></programlisting> @@ -1418,24 +1420,24 @@ </sect1> <sect1 id="configuration-j2ee" revision="1"> - <title>Int�gration � un serveur d'application J2EE</title> + <title>Intégration à un serveur d'application J2EE</title> <para> - Hibernate poss�de les points suivants d'int�gration � l'infrastructure J2EE : + Hibernate possède les points suivants d'intégration à l'infrastructure J2EE : </para> <itemizedlist> <listitem> <para> - <emphasis>Source de donn�es g�r�e par le conteneur</emphasis> : Hibernate peut - utiliser des connexions JDBC g�r�es par le conteneur et fournie par l'interm�diaire + <emphasis>Source de données gérée par le conteneur</emphasis> : Hibernate peut + utiliser des connexions JDBC gérées par le conteneur et fournie par l'intermédiaire de JNDI. Souvent, un <literal>TransactionManager</literal> compatible JTA et un <literal>ResourceManager</literal> s'occupent de la gestion des transactions (CMT). - Ils sont particuli�rement pr�vus pour pouvoir g�rer des transactions distribu�es - sur plusieurs sources de donn�es. Vous pouvez bien s�r �galement d�finir vos + Ils sont particulièrement prévus pour pouvoir gérer des transactions distribuées + sur plusieurs sources de données. Vous pouvez bien sûr également définir vos limites de transaction dans votre programme (BMT) ou vous pouvez sinon aussi utiliser l'API optionnelle <literal>Transaction</literal> d'Hibernate qui vous garantira - la portabilit� de votre code entre plusieurs serveurs d'application. + la portabilité de votre code entre plusieurs serveurs d'application. </para> </listitem> </itemizedlist> @@ -1444,7 +1446,7 @@ <listitem> <para> <emphasis>Association JNDI automatique</emphasis>: Hibernate peut associer sa - <literal>SessionFactory</literal> � JNDI apr�s le d�marrage. + <literal>SessionFactory</literal> à JNDI après le démarrage. </para> </listitem> </itemizedlist> @@ -1452,12 +1454,12 @@ <itemizedlist> <listitem> <para> - <emphasis>Association de la Session � JTA:</emphasis> La <literal>Session</literal> Hibernate - peut �tre associ�e automatiquement � une transaction JTA si vous utilisez les EJBs. - Vous avez juste � r�cup�rer la <literal>SessionFactory</literal> depuis JNDI et - � r�cup�rer la <literal>Session</literal> courante. Hibernate s'occupe de vider et + <emphasis>Association de la Session à JTA:</emphasis> La <literal>Session</literal> Hibernate + peut être associée automatiquement à une transaction JTA si vous utilisez les EJBs. + Vous avez juste à récupérer la <literal>SessionFactory</literal> depuis JNDI et + à récupérer la <literal>Session</literal> courante. Hibernate s'occupe de vider et fermer la <literal>Session</literal> lorsque le transaction JTA se termine. La - d�marcation des transactions se fait de mani�re d�clarative dans les descripteurs de d�ploiement. + démarcation des transactions se fait de manière déclarative dans les descripteurs de déploiement. </para> </listitem> </itemizedlist> @@ -1465,41 +1467,41 @@ <itemizedlist> <listitem> <para> - <emphasis>D�ploiement JMX :</emphasis>Si vous avez un serveur d'application compatible JMX - (JBoss AS par exemple), vous pouvez choisir de d�ployer Hibernate en temps que MBean g�r� par - le serveur. Cela vous �vite de coder la ligne de d�marrage qui permet de construire + <emphasis>Déploiement JMX :</emphasis>Si vous avez un serveur d'application compatible JMX + (JBoss AS par exemple), vous pouvez choisir de déployer Hibernate en temps que MBean géré par + le serveur. Cela vous évite de coder la ligne de démarrage qui permet de construire la <literal>SessionFactory</literal> depuis la <literal>Configuration</literal>. - Le conteneur va d�marrer votre <literal>HibernateService</literal>, et va id�alement - s'occuper des d�pendances entre les services (la source de donn�es doit �tre disponible - avant qu'Hibernate ne d�marre, etc). + Le conteneur va démarrer votre <literal>HibernateService</literal>, et va idéalement + s'occuper des dépendances entre les services (la source de données doit être disponible + avant qu'Hibernate ne démarre, etc). </para> </listitem> </itemizedlist> <para> - En fonction de votre environnement, vous devrez peut �tre mettre l'option de - configuration <literal>hibernate.connection.aggressive_release</literal> � vrai si + En fonction de votre environnement, vous devrez peut être mettre l'option de + configuration <literal>hibernate.connection.aggressive_release</literal> à vrai si le serveur d'application affiche des exceptions de type "connection containment". </para> <sect2 id="configuration-optional-transactionstrategy" revision="3"> - <title>Configuration de la strat�gie transactionnelle</title> + <title>Configuration de la stratégie transactionnelle</title> <para> - L'API de la <literal>Session</literal> Hibernate est ind�pendante de tout syst�me - de d�marcation des transactions qui peut �tre pr�sent dans votre architecture. Si + L'API de la <literal>Session</literal> Hibernate est indépendante de tout système + de démarcation des transactions qui peut être présent dans votre architecture. Si vous laissez Hibernate utiliser l'API JDBC directement via un pool de connexion, vous devrez commencer et terminer vos transactions en utilisant l'API JDBC. Si votre - application tourne � l'int�rieur d'un serveur d'application J2EE, vous voudrez peut �tre - utiliser les transactions g�r�es par les beans (BMT) et appeller l'API JTA et - <literal>UserTransaction</literal> lorsque cela est n�cessaire. + application tourne à l'intérieur d'un serveur d'application J2EE, vous voudrez peut être + utiliser les transactions gérées par les beans (BMT) et appeller l'API JTA et + <literal>UserTransaction</literal> lorsque cela est nécessaire. </para> <para> - Pour conserver votre code portable entre ces deux environnements (et d'autres �ventuels) + Pour conserver votre code portable entre ces deux environnements (et d'autres éventuels) nous vous recommandons d'utiliser l'API optionnelle <literal>Transaction</literal> d'Hibernate, - qui va encapsuler et masquer le syst�me de transaction sous-jacent. - Pour cela, vous devez pr�ciser une classe de fabrique d'instances de <literal>Transaction</literal> - en positionnant la propri�t� + qui va encapsuler et masquer le système de transaction sous-jacent. + Pour cela, vous devez préciser une classe de fabrique d'instances de <literal>Transaction</literal> + en positionnant la propriété <literal>hibernate.transaction.factory_class</literal>. </para> @@ -1511,38 +1513,38 @@ <varlistentry> <term><literal>net.sf.hibernate.transaction.JDBCTransactionFactory</literal></term> <listitem> - <para>d�l�gue aux transactions de la base de donn�es (JDBC). Valeur par d�faut.</para> + <para>délègue aux transactions de la base de données (JDBC). Valeur par défaut.</para> </listitem> </varlistentry> <varlistentry> <term><literal>org.hibernate.transaction.JTATransactionFactory</literal></term> <listitem> <para> - d�l�gue � CMT si une transaction existante est sous ce contexte (ex: m�thode - d'un EJB session), sinon une nouvelle transaction est entam�e et - une transaction g�r�e par le bean est utilis�e. + délègue à CMT si une transaction existante est sous ce contexte (ex: méthode + d'un EJB session), sinon une nouvelle transaction est entamée et + une transaction gérée par le bean est utilisée. </para> </listitem> </varlistentry> <varlistentry> <term><literal>org.hibernate.transaction.CMTTransactionFactory</literal></term> <listitem> - <para>d�l�gue � aux transactions JTA g�r�es par le conteneur</para> + <para>délègue à aux transactions JTA gérées par le conteneur</para> </listitem> </varlistentry> </variablelist> <para> - Vous pouvez �galement d�finir votre propre strat�gie transactionnelle + Vous pouvez également définir votre propre stratégie transactionnelle (pour un service de transaction CORBA par exemple). </para> <para> - Certaines fonctionnalit�s d'Hibernate (i.e. le cache de second niveau, l'association - automatique des Session � JTA, etc.) n�cessitent l'acc�s au <literal>TransactionManager</literal> - JTA dans un environnement "manag�". Dans un serveur d'application, vous devez indiquer - comment Hibernate peut obtenir une r�f�rence vers le <literal>TransactionManager</literal>, - car J2EE ne fournit pas un seul m�canisme standard. + Certaines fonctionnalités d'Hibernate (i.e. le cache de second niveau, l'association + automatique des Session à JTA, etc.) nécessitent l'accès au <literal>TransactionManager</literal> + JTA dans un environnement "managé". Dans un serveur d'application, vous devez indiquer + comment Hibernate peut obtenir une référence vers le <literal>TransactionManager</literal>, + car J2EE ne fournit pas un seul mécanisme standard. </para> <table frame="topbot" id="jtamanagerlookup" revision="1"> @@ -1604,37 +1606,37 @@ </sect2> <sect2 id="configuration-optional-jndi" revision="3"> - <title><literal>SessionFactory</literal> associ�e au JNDI</title> + <title><literal>SessionFactory</literal> associée au JNDI</title> <para> - Une <literal>SessionFactory</literal> Hibernate associ�e au JNDI peut - simplifier l'acc�s � la fabrique et donc la cr�ation de nouvelles - <literal>Session</literal>s. Notez que cela n'est pas li� avec les <literal>Datasource</literal> - associ�es au JNDI, elles utilisent juste le m�me registre. + Une <literal>SessionFactory</literal> Hibernate associée au JNDI peut + simplifier l'accès à la fabrique et donc la création de nouvelles + <literal>Session</literal>s. Notez que cela n'est pas lié avec les <literal>Datasource</literal> + associées au JNDI, elles utilisent juste le même registre. </para> <para> - Si vous d�sirez associer la <literal>SessionFactory</literal> � un nom JNDI, - sp�cifiez un nom (ex. <literal>java:hibernate/SessionFactory</literal>) en - utilisant la propri�t� <literal>hibernate.session_factory_name</literal>. - Si cette propri�t� est omise, la <literal>SessionFactory</literal> ne sera pas - associ�e au JNDI (c'est particuli�rement pratique dans les environnements ayant une - impl�mentation de JNDI en lecture seule, comme c'est le cas pour Tomcat). + Si vous désirez associer la <literal>SessionFactory</literal> à un nom JNDI, + spécifiez un nom (ex. <literal>java:hibernate/SessionFactory</literal>) en + utilisant la propriété <literal>hibernate.session_factory_name</literal>. + Si cette propriété est omise, la <literal>SessionFactory</literal> ne sera pas + associée au JNDI (c'est particulièrement pratique dans les environnements ayant une + implémentation de JNDI en lecture seule, comme c'est le cas pour Tomcat). </para> <para> Lorsqu'il associe la <literal>SessionFactory</literal> au JNDI, Hibernate utilisera les valeurs de <literal>hibernate.jndi.url</literal>, <literal>hibernate.jndi.class</literal> - pour instancier un contexte d'initialisation. S'ils ne sont pas sp�cifi�s, - l'<literal>InitialContext</literal> par d�faut sera utilis�. + pour instancier un contexte d'initialisation. S'ils ne sont pas spécifiés, + l'<literal>InitialContext</literal> par défaut sera utilisé. </para> <para> Hibernate va automatiquement placer la <literal>SessionFactory</literal> dans JNDI - apr�s avoir appel� <literal>cfg.buildSessionFactory()</literal>. Cela signifie que vous - devez avoir cet appel dans un code de d�marrage (ou dans une classe utilitaire) dans - votre application sauf si vous utilisez le d�ploiement JMX avec le service - <literal>HibernateService</literal> pr�sent� plus tard dans ce document. + après avoir appelé <literal>cfg.buildSessionFactory()</literal>. Cela signifie que vous + devez avoir cet appel dans un code de démarrage (ou dans une classe utilitaire) dans + votre application sauf si vous utilisez le déploiement JMX avec le service + <literal>HibernateService</literal> présenté plus tard dans ce document. </para> <para> Si vous utilisez <literal>SessionFactory</literal> JNDI, un EJB ou n'importe quelle autre classe @@ -1642,55 +1644,55 @@ </para> <para> - Nous recommandons que vous liiez la <literal>SessionFactory</literal> � JNDI dans les - environnements manag�s et que vous utilisiez un singleton <literal>static</literal> si ce n'est pas le cas. - Pour isoler votre application de ces d�tails, nous vous recommandons aussi de masquer + Nous recommandons que vous liiez la <literal>SessionFactory</literal> à JNDI dans les + environnements managés et que vous utilisiez un singleton <literal>static</literal> si ce n'est pas le cas. + Pour isoler votre application de ces détails, nous vous recommandons aussi de masquer le code de lookup actuel pour une <literal>SessionFactory</literal> dans une classe helper, comme <literal>HibernateUtil.getSessionFactory()</literal>. Notez qu'une telle classe - est aussi un moyen efficace de d�marrer Hibernate&mdash;voir chapitre 1. + est aussi un moyen efficace de démarrer Hibernate&mdash;voir chapitre 1. </para> </sect2> <sect2 id="configuration-j2ee-currentsession" revision="4"> - <title>Association automatique de la Session � JTA</title> + <title>Association automatique de la Session à JTA</title> <para> - Le moyen le plus simple de g�rer les <literal>Session</literal>s et transactions est + Le moyen le plus simple de gérer les <literal>Session</literal>s et transactions est la gestion automatique de session "courante" offerte par Hibernate. - Voir d�tail � <xref linkend="architecture-current-session">current sessions</xref>. + Voir détail à <xref linkend="architecture-current-session">current sessions</xref>. En utilisant le contexte de session <literal>"jta"</literal> session context, s'il n'y a pas - de <literal>Session</literal> associ�e � la transaction JTA courante, une session sera - d�marr�e et associ�e � la transaction JTA courante la premi�re fois que vous appelez + de <literal>Session</literal> associée à la transaction JTA courante, une session sera + démarrée et associée à la transaction JTA courante la première fois que vous appelez <literal>sessionFactory.getCurrentSession()</literal>. Les <literal>Session</literal>s obtenue via <literal>getCurrentSession()</literal> dans une contexte <literal>"jta"</literal> - seront automatiquement flush�es avant la validation de la transaction, ferm�es une fois - la transaction compl�t�e, et lib�reront les connexions JDBC de mani�re aggressive - apr�s chaque statement. Ceci permet aux <literal>Session</literal>s d'�tre - g�r�es par le cycle de vie de la transaction JTA � la quelle est sont associ�es, + seront automatiquement flushées avant la validation de la transaction, fermées une fois + la transaction complétée, et libéreront les connexions JDBC de manière aggressive + après chaque statement. Ceci permet aux <literal>Session</literal>s d'être + gérées par le cycle de vie de la transaction JTA à la quelle est sont associées, laissant le code de l'utilisateur propre de ce type de gestion. Votre code peut - soit utiliser JTA de mani�re programmatique via <literal>UserTransaction</literal>, ou (ce qui est recommand� - pour la portabilit� du code) utiliser l'API <literal>Transaction</literal> API pour marquer - les limites. Si vous ex�cutez sous un conteneur EJB, la d�marcation d�clarative des transactions - avec CMT est recommand�e. + soit utiliser JTA de manière programmatique via <literal>UserTransaction</literal>, ou (ce qui est recommandé + pour la portabilité du code) utiliser l'API <literal>Transaction</literal> API pour marquer + les limites. Si vous exécutez sous un conteneur EJB, la démarcation déclarative des transactions + avec CMT est recommandée. </para> </sect2> <sect2 id="configuration-j2ee-jmx" revision="1"> - <title>D�ploiement JMX</title> + <title>Déploiement JMX</title> <para> - La ligne <literal>cfg.buildSessionFactory()</literal> doit toujours �tre ex�cut�e + La ligne <literal>cfg.buildSessionFactory()</literal> doit toujours être exécutée quelque part pour avoir une <literal>SessionFactory</literal> dans JNDI. Vous pouvez faire cela dans un bloc d'initialisation <literal>static</literal> (comme celui qui se trouve dans la classe <literal>HibernateUtil</literal>) ou vous pouvez - d�ployer Hibernate en temps que <emphasis>service manag�</emphasis>. + déployer Hibernate en temps que <emphasis>service managé</emphasis>. </para> <para> - Hibernate est distribu� avec <literal>org.hibernate.jmx.HibernateService</literal> - pour le d�ploiement sur un serveur d'application avec le support de JMX comme JBoss AS. - Le d�ploiement et la configuration sont sp�cifiques � chaque vendeur. Voici un fichier + Hibernate est distribué avec <literal>org.hibernate.jmx.HibernateService</literal> + pour le déploiement sur un serveur d'application avec le support de JMX comme JBoss AS. + Le déploiement et la configuration sont spécifiques à chaque vendeur. Voici un fichier <literal>jboss-service.xml</literal> d'exemple pour JBoss 4.0.x: </para> @@ -1738,14 +1740,14 @@ </server>]]></programlisting> <para> - Ce fichier est d�ploy� dans un r�pertoire <literal>META-INF</literal> et est packag� + Ce fichier est déployé dans un répertoire <literal>META-INF</literal> et est packagé dans un fichier JAR avec l'extension <literal>.sar</literal> (service archive). - Vous devez �galement packager Hibernate, les librairies tierces requises, vos classes - persistantes compil�es et vos fichiers de mapping dans la m�me archive. Vos beans + Vous devez également packager Hibernate, les librairies tierces requises, vos classes + persistantes compilées et vos fichiers de mapping dans la même archive. Vos beans entreprise (souvent des EJBs session) peuvent rester dans leur propre fichier JAR mais - vous pouvez inclure ce fichier JAR dans le jar principal du service pour avoir une seule unit� - d�ployable � chaud. Vous pouvez consulter la documentation de JBoss AS pour plus d'information - sur les services JMX et le d�ploiement des EJBs. + vous pouvez inclure ce fichier JAR dans le jar principal du service pour avoir une seule unité + déployable à chaud. Vous pouvez consulter la documentation de JBoss AS pour plus d'information + sur les services JMX et le déploiement des EJBs. </para> </sect2> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/events.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/events.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/events.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,11 +1,13 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="events"> - <title>Les intercepteurs et les �v�nements</title> + <title>Les intercepteurs et les événements</title> <para> - Il est souvent utile pour l'application de r�agir � certains �v�nements - qui surviennent dans Hibernate. Cela autorise l'impl�mentation de certaines sortes de - fonctionnalit�s g�n�riques, et d'extensions de fonctionnalit�s d'Hibernate. + Il est souvent utile pour l'application de réagir à certains événements + qui surviennent dans Hibernate. Cela autorise l'implémentation de certaines sortes de + fonctionnalités génériques, et d'extensions de fonctionnalités d'Hibernate. </para> <sect1 id="objectstate-interceptors" revision="2"> @@ -13,18 +15,18 @@ <para> L'interface <literal>Interceptor</literal> fournit des "callbacks" de la session vers l'application - et permettent � l'application de consulter et/ou de manipuler des propri�t�s - d'un objet persistant avant qu'il soit sauvegard�, mis � jour, supprim� ou charg�. - Une utilisation possible de cette fonctionnalit� est de tracer l'acc�s � l'information. + et permettent à l'application de consulter et/ou de manipuler des propriétés + d'un objet persistant avant qu'il soit sauvegardé, mis à jour, supprimé ou chargé. + Une utilisation possible de cette fonctionnalité est de tracer l'accès à l'information. Par exemple, l'<literal>Interceptor</literal> suivant positionne - <literal>createTimestamp</literal> quand un <literal>Auditable</literal> est cr�� - et met � jour la propri�t� <literal>lastUpdateTimestamp</literal> quand un - <literal>Auditable</literal> est mis � jour. + <literal>createTimestamp</literal> quand un <literal>Auditable</literal> est créé + et met à jour la propriété <literal>lastUpdateTimestamp</literal> quand un + <literal>Auditable</literal> est mis à jour. </para> <para> - Vous pouvez soit impl�menter <literal>Interceptor</literal> directement ou (mieux) - �tendre <literal>EmptyInterceptor</literal>. + Vous pouvez soit implémenter <literal>Interceptor</literal> directement ou (mieux) + étendre <literal>EmptyInterceptor</literal>. </para> <programlisting><![CDATA[package org.hibernate.test; @@ -115,14 +117,14 @@ }]]></programlisting> <para> - L'intercepteur doit �tre sp�cifi� quand une session est cr��e. + L'intercepteur doit être spécifié quand une session est créée. </para> <programlisting><![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]></programlisting> <para> Vous pouvez aussi mettre un intercepteur au niveau global, en utilisant l'objet <literal>Configuration</literal>. - Dans ce cas, l'intercepteur doit �tre "threadsafe". + Dans ce cas, l'intercepteur doit être "threadsafe". </para> <programlisting><![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]></programlisting> @@ -130,49 +132,49 @@ </sect1> <sect1 id="objectstate-events" revision="3"> - <title>Syst�me d'�v�nements</title> + <title>Système d'événements</title> <para> - Si vous devez r�agir � des �v�nements particuliers dans votre couche de persistance, - vous pouvez aussi utiliser l'architecture d'<emphasis>�v�nements</emphasis> d'Hibernate3. - Le syst�me d'�v�nements peut �tre utilis� en suppl�ment ou en remplacement des interceptors. + Si vous devez réagir à des événements particuliers dans votre couche de persistance, + vous pouvez aussi utiliser l'architecture d'<emphasis>événements</emphasis> d'Hibernate3. + Le système d'événements peut être utilisé en supplément ou en remplacement des interceptors. </para> <para> - Essentiellement toutes les m�thodes de l'interface <literal>Session</literal> sont corr�l�es � - un �v�nement. Vous avez un <literal>LoadEvent</literal>, un <literal>FlushEvent</literal>, etc + Essentiellement toutes les méthodes de l'interface <literal>Session</literal> sont corrélées à + un événement. Vous avez un <literal>LoadEvent</literal>, un <literal>FlushEvent</literal>, etc (consultez la DTD du fichier de configuration XML ou le paquet <literal>org.hibernate.event</literal> - pour avoir la liste compl�te des types d'�v�nement d�finis). - Quand une requ�te est faite � partir d'une de ces m�thodes, la - <literal>Session</literal> Hibernate g�n�re un �v�nement appropri� et le passe - au listener configur� pour ce type. - Par d�faut, ces listeners impl�mentent le m�me traitement dans lequel ces m�thodes + pour avoir la liste complète des types d'événement définis). + Quand une requête est faite à partir d'une de ces méthodes, la + <literal>Session</literal> Hibernate génère un événement approprié et le passe + au listener configuré pour ce type. + Par défaut, ces listeners implémentent le même traitement dans lequel ces méthodes aboutissent toujours. - Cependant, vous �tes libre d'impl�menter une version personnalis�e d'une de ces - interfaces de listener (c'est-�-dire, le <literal>LoadEvent</literal> est trait� par - l'impl�mentation de l'interface <literal>LoadEventListener</literal> d�clar�e), dans - quel cas leur impl�mentation devrait �tre responsable du traitement des - requ�tes <literal>load()</literal> faites par la <literal>Session</literal>. + Cependant, vous êtes libre d'implémenter une version personnalisée d'une de ces + interfaces de listener (c'est-à-dire, le <literal>LoadEvent</literal> est traité par + l'implémentation de l'interface <literal>LoadEventListener</literal> déclarée), dans + quel cas leur implémentation devrait être responsable du traitement des + requêtes <literal>load()</literal> faites par la <literal>Session</literal>. </para> <para> - Les listeners devraient effectivement �tre consid�r�s comme des singletons ; dans le sens - o� ils sont partag�s entre des requ�tes, et donc ne devraient pas sauvegarder des �tats + Les listeners devraient effectivement être considérés comme des singletons ; dans le sens + où ils sont partagés entre des requêtes, et donc ne devraient pas sauvegarder des états de variables d'instance. </para> <para> - Un listener personnalis� devrait impl�menter l'interface appropri�e pour l'�v�nement - qu'il veut traiter et/ou �tendre une des classes de base (ou m�me l'�v�nement pr�t � - l'emploi utilis� par Hibernate comme ceux d�clar�s non-finaux � cette intention). Les - listeners personnalis�s peuvent �tre soit inscrits par programmation � travers l'objet - <literal>Configuration</literal>, ou sp�cifi�s la configuration XML d'Hibernate - (la configuration d�clarative � travers le fichier de propri�t�s n'est pas support�e). - Voici un exemple de listener personnalis� pour l'�v�nement de chargement : + Un listener personnalisé devrait implémenter l'interface appropriée pour l'événement + qu'il veut traiter et/ou étendre une des classes de base (ou même l'événement prêt à + l'emploi utilisé par Hibernate comme ceux déclarés non-finaux à cette intention). Les + listeners personnalisés peuvent être soit inscrits par programmation à travers l'objet + <literal>Configuration</literal>, ou spécifiés la configuration XML d'Hibernate + (la configuration déclarative à travers le fichier de propriétés n'est pas supportée). + Voici un exemple de listener personnalisé pour l'événement de chargement : </para> <programlisting><![CDATA[public class MyLoadListener implements LoadEventListener { - // C'est une simple m�thode d�finie par l'interface LoadEventListener + // C'est une simple méthode définie par l'interface LoadEventListener public void onLoad(LoadEvent event, LoadEventListener.LoadType loadType) throws HibernateException { if ( !MySecurity.isAuthorized( event.getEntityClassName(), event.getEntityId() ) ) { @@ -182,8 +184,8 @@ }]]></programlisting> <para> - Vous avez aussi besoin d'une entr�e de configuration disant � Hibernate d'utiliser - ce listener en plus du listener par d�faut : + Vous avez aussi besoin d'une entrée de configuration disant à Hibernate d'utiliser + ce listener en plus du listener par défaut : </para> <programlisting><![CDATA[<hibernate-configuration> @@ -205,33 +207,33 @@ cfg.EventListeners().setLoadEventListeners(stack);]]></programlisting> <para> - Les listeners inscrits d�clarativement ne peuvent pas partager d'instances. Si le m�me - nom de classe est utilis�e dans plusieurs �l�ments <literal>&lt;listener/&gt;</literal>, - chaque r�f�rence sera une instance distincte de cette classe. Si vous avez besoin de la - facult� de partager des instances de listener entre plusieurs types de listener, vous devez + Les listeners inscrits déclarativement ne peuvent pas partager d'instances. Si le même + nom de classe est utilisée dans plusieurs éléments <literal>&lt;listener/&gt;</literal>, + chaque référence sera une instance distincte de cette classe. Si vous avez besoin de la + faculté de partager des instances de listener entre plusieurs types de listener, vous devez utiliser l'approche d'inscription par programmation. </para> <para> - Pourquoi impl�menter une interface et d�finir le type sp�cifique durant la configuration ? - Une impl�mentation de listener pourrait impl�menter plusieurs interfaces de listener - d'�v�nements. Avoir en plus le type d�fini durant l'inscription rend plus facile - l'activation ou la d�sactivation pendant la configuration. + Pourquoi implémenter une interface et définir le type spécifique durant la configuration ? + Une implémentation de listener pourrait implémenter plusieurs interfaces de listener + d'événements. Avoir en plus le type défini durant l'inscription rend plus facile + l'activation ou la désactivation pendant la configuration. </para> </sect1> <sect1 id="objectstate-decl-security" revision="2"> - <title>S�curit� d�clarative d'Hibernate</title> + <title>Sécurité déclarative d'Hibernate</title> <para> - G�n�ralement, la s�curit� d�clarative dans les applications Hibernate est g�r�e dans la - couche de session. Maintenant, Hibernate3 permet � certaines actions d'�tre approuv�es - via JACC, et autoris�es via JAAS. Cette fonctionnalit� optionnelle est construite - au dessus de l'architecture d'�v�nements. + Généralement, la sécurité déclarative dans les applications Hibernate est gérée dans la + couche de session. Maintenant, Hibernate3 permet à certaines actions d'être approuvées + via JACC, et autorisées via JAAS. Cette fonctionnalité optionnelle est construite + au dessus de l'architecture d'événements. </para> <para> - D'abord, vous devez configurer les listeners d'�v�nements appropri�s pour permettre + D'abord, vous devez configurer les listeners d'événements appropriés pour permettre l'utilisation d'autorisations JAAS. </para> @@ -243,18 +245,18 @@ <para> Notez que <literal>&lt;listener type="..." class="..."/&gt;</literal> est juste un raccourci pour <literal>&lt;event type="..."&gt;&lt;listener class="..."/&gt;&lt;/event&gt;</literal> - quand il y a exactement un listener pour un type d'�v�nement particulier. + quand il y a exactement un listener pour un type d'événement particulier. </para> <para> - Ensuite, toujours dans <literal>hibernate.cfg.xml</literal>, lier les permissions aux r�les : + Ensuite, toujours dans <literal>hibernate.cfg.xml</literal>, lier les permissions aux rôles : </para> <programlisting><![CDATA[<grant role="admin" entity-name="User" actions="insert,update,read"/> <grant role="su" entity-name="User" actions="*"/>]]></programlisting> <para> - Les noms de r�le sont les r�les compris par votre fournisseur JAAC. + Les noms de rôle sont les rôles compris par votre fournisseur JAAC. </para> </sect1> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_mappings.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_mappings.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_mappings.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,19 +1,6 @@ -<?xml version="1.0" encoding="iso-8859-1"?> -<!-- - ~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved. - ~ - ~ This copyrighted material is made available to anyone wishing to use, modify, - ~ copy, or redistribute it subject to the terms and conditions of the GNU - ~ Lesser General Public License, v. 2.1. This program is distributed in the - ~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied - ~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - ~ Lesser General Public License for more details. You should have received a - ~ copy of the GNU Lesser General Public License, v.2.1 along with this - ~ distribution; if not, write to the Free Software Foundation, Inc., - ~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - ~ - ~ Red Hat Author(s): Steve Ebersole - --> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="example-mappings"> <title>Exemple : quelques mappings</title> @@ -22,14 +9,14 @@ </para> <sect1 id="example-mappings-emp"> - <title>Employeur/Employ� (Employer/Employee)</title> + <title>Employeur/Employé (Employer/Employee)</title> <para> - Le mod�le suivant de relation entre <literal>Employer</literal> et - <literal>Employee</literal> utilise une vraie classe entit� (<literal>Employment</literal>) - pour repr�senter l'association. On a fait cela parce qu'il peut y avoir plus d'une p�riode - d'emploi pour les deux m�mes parties. Des composants sont utilis�s pour mod�liser les - valeurs mon�taires et les noms des employ�s. + Le modèle suivant de relation entre <literal>Employer</literal> et + <literal>Employee</literal> utilise une vraie classe entité (<literal>Employment</literal>) + pour représenter l'association. On a fait cela parce qu'il peut y avoir plus d'une période + d'emploi pour les deux mêmes parties. Des composants sont utilisés pour modéliser les + valeurs monétaires et les noms des employés. </para> <mediaobject> @@ -95,7 +82,7 @@ </hibernate-mapping>]]></programlisting> <para> - Et voici le sch�ma des tables g�n�r�es par <literal>SchemaExport</literal>. + Et voici le schéma des tables générées par <literal>SchemaExport</literal>. </para> <programlisting><![CDATA[create table employers ( @@ -138,12 +125,12 @@ <title>Auteur/Travail (Author/Work)</title> <para> - Soit le mod�le de la relation entre <literal>Work</literal>, <literal>Author</literal> - et <literal>Person</literal>. Nous repr�sentons la relation entre <literal>Work</literal> + Soit le modèle de la relation entre <literal>Work</literal>, <literal>Author</literal> + et <literal>Person</literal>. Nous représentons la relation entre <literal>Work</literal> et <literal>Author</literal> comme une association plusieurs-vers-plusieurs. Nous avons choisi de - repr�senter la relation entre <literal>Author</literal> et <literal>Person</literal> - comme une association un-vers-un. Une autre possibilit� aurait �t� que - <literal>Author</literal> h�rite de <literal>Person</literal>. + représenter la relation entre <literal>Author</literal> et <literal>Person</literal> + comme une association un-vers-un. Une autre possibilité aurait été que + <literal>Author</literal> hérite de <literal>Person</literal>. </para> <mediaobject> @@ -156,7 +143,7 @@ </mediaobject> <para> - Le mapping suivant repr�sente exactement ces relations : + Le mapping suivant représente exactement ces relations : </para> <programlisting><![CDATA[<hibernate-mapping> @@ -214,9 +201,9 @@ <para> Il y a quatre tables dans ce mapping. <literal>works</literal>, <literal>authors</literal> et <literal>persons</literal> qui contiennent - respectivement les donn�es de work, author et person. + respectivement les données de work, author et person. <literal>author_work</literal> est une table d'association qui lie authors - � works. Voici le sch�ma de tables, g�n�r� par <literal>SchemaExport</literal>. + à works. Voici le schéma de tables, généré par <literal>SchemaExport</literal>. </para> <programlisting><![CDATA[create table works ( @@ -260,14 +247,14 @@ <title>Client/Commande/Produit (Customer/Order/Product)</title> <para> - Imaginons maintenant le mod�le de relation entre <literal>Customer</literal>, + Imaginons maintenant le modèle de relation entre <literal>Customer</literal>, <literal>Order</literal>, <literal>LineItem</literal> et <literal>Product</literal>. Il y a une association un-vers-plusieurs entre <literal>Customer</literal> et - <literal>Order</literal>, mais comment devrions nous repr�senter <literal>Order</literal> / + <literal>Order</literal>, mais comment devrions nous représenter <literal>Order</literal> / <literal>LineItem</literal> / <literal>Product</literal>? J'ai choisi de mapper - <literal>LineItem</literal> comme une classe d'association repr�sentant l'association + <literal>LineItem</literal> comme une classe d'association représentant l'association plusieurs-vers-plusieurs entre <literal>Order</literal> et <literal>Product</literal>. Dans - Hibernate, on appelle cela un �l�ment composite. + Hibernate, on appelle cela un élément composite. </para> <mediaobject> @@ -323,8 +310,8 @@ <para> <literal>customers</literal>, <literal>orders</literal>, <literal>line_items</literal> et - <literal>products</literal> contiennent les donn�es de customer, order, order line item et product. - <literal>line_items</literal> est aussi la table d'association liant orders � products. + <literal>products</literal> contiennent les données de customer, order, order line item et product. + <literal>line_items</literal> est aussi la table d'association liant orders à products. </para> <programlisting><![CDATA[create table customers ( @@ -404,7 +391,7 @@ </sect2> <sect2 id="example-mappings-composite-key"> - <title>Exemple de clef compos�e</title> + <title>Exemple de clef composée</title> <programlisting><![CDATA[<class name="Customer"> <id name="customerId" @@ -521,7 +508,7 @@ </sect2> <sect2 id="example-mappings-composite-key-manytomany"> - <title>Many-to-many avec une clef compos�e partag�e</title> + <title>Many-to-many avec une clef composée partagée</title> <programlisting><![CDATA[<class name="User" table="`User`"> <composite-id> <key-property name="name"/> @@ -560,7 +547,7 @@ </sect2> <sect2 id="example-mappings-content-discrimination"> - <title>Contenu bas� sur une discrimination</title> + <title>Contenu basé sur une discrimination</title> <programlisting><![CDATA[<class name="Person" discriminator-value="P"> @@ -614,7 +601,7 @@ </sect2> <sect2 id="example-mappings-association-alternatekeys" revision="2"> - <title>Associations sur des clefs altern�es</title> + <title>Associations sur des clefs alternées</title> <programlisting><![CDATA[<class name="Person"> <id name="id"> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_parentchild.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_parentchild.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_parentchild.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,61 +1,63 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="example-parentchild"> - <title>Exemple : P�re/Fils</title> + <title>Exemple : Père/Fils</title> <para> - L'une des premi�res choses que les nouveaux utilisateurs essaient de faire avec Hibernate est de mod�liser - une relation p�re/fils. Il y a deux approches diff�rentes pour cela. Pour un certain nombre de raisons, la m�thode la - plus courante, en particulier pour les nouveaux utilisateurs, est de mod�liser les deux relations <literal>P�re</literal> - et <literal>Fils</literal> comme des classes entit�s li�es par une association <literal>&lt;one-to-many&gt;</literal> du - <literal>P�re</literal> vers le <literal>Fils</literal> (l'autre approche est de d�clarer le <literal>Fils</literal> - comme un <literal>&lt;composite-element&gt;</literal>). Il est �vident que le sens de l'association un vers plusieurs - (dans Hibernate) est bien moins proche du sens habituel d'une relation p�re/fils que ne l'est celui d'un - �l�ment cmposite. Nous allons vous expliquer comment utiliser une association <emphasis>un vers plusieurs bidirectionnelle - avec cascade</emphasis> afin de mod�liser efficacement et �l�gamment une relation p�re/fils, ce n'est vraiment + L'une des premières choses que les nouveaux utilisateurs essaient de faire avec Hibernate est de modéliser + une relation père/fils. Il y a deux approches différentes pour cela. Pour un certain nombre de raisons, la méthode la + plus courante, en particulier pour les nouveaux utilisateurs, est de modéliser les deux relations <literal>Père</literal> + et <literal>Fils</literal> comme des classes entités liées par une association <literal>&lt;one-to-many&gt;</literal> du + <literal>Père</literal> vers le <literal>Fils</literal> (l'autre approche est de déclarer le <literal>Fils</literal> + comme un <literal>&lt;composite-element&gt;</literal>). Il est évident que le sens de l'association un vers plusieurs + (dans Hibernate) est bien moins proche du sens habituel d'une relation père/fils que ne l'est celui d'un + élément cmposite. Nous allons vous expliquer comment utiliser une association <emphasis>un vers plusieurs bidirectionnelle + avec cascade</emphasis> afin de modéliser efficacement et élégamment une relation père/fils, ce n'est vraiment pas difficile ! </para> <sect1 id="example-parentchild-collections"> - <title>Une note � propos des collections</title> + <title>Une note à propos des collections</title> <para> - Les collections Hibernate sont consid�r�es comme �tant une partie logique - de l'entit� dans laquelle elles sont contenues ; jamais des entit�s qu'elle - contient. C'est une distinction crutiale ! Les cons�quences sont les suivantes : + Les collections Hibernate sont considérées comme étant une partie logique + de l'entité dans laquelle elles sont contenues ; jamais des entités qu'elle + contient. C'est une distinction crutiale ! Les conséquences sont les suivantes : </para> <itemizedlist> <listitem> <para> - Quand nous ajoutons / retirons un objet d'une collection, le num�ro de version du - propri�taire de la collection est incr�ment�. + Quand nous ajoutons / retirons un objet d'une collection, le numéro de version du + propriétaire de la collection est incrémenté. </para> </listitem> <listitem> <para> - Si un objet qui a �t� enlev� d'une collection est une instance de type valeur (ex : - �l�ment composite), cet objet cessera d'�tre persistant et son �tat sera compl�tement effac� - de la base de donn�es. Par ailleurs, ajouter une instance de type valeur dans une collection - aura pour cons�quence que son �tat sera imm�diatement persistant. + Si un objet qui a été enlevé d'une collection est une instance de type valeur (ex : + élément composite), cet objet cessera d'être persistant et son état sera complètement effacé + de la base de données. Par ailleurs, ajouter une instance de type valeur dans une collection + aura pour conséquence que son état sera immédiatement persistant. </para> </listitem> <listitem> <para> - Si une entit� est enlev�e d'une collection (association un-vers-plusieurs - ou plusieurs-vers-plusieurs), par d�faut, elle ne sera pas effac�e. Ce comportement - est compl�tement logique - une modification de l'un des �tats internes d'une entit� - ne doit pas causer la disparition de l'entit� associ�e ! - De m�me, l'ajout d'une entit� dans une collection n'engendre pas, - par d�faut, la persistance de cette entit�. + Si une entité est enlevée d'une collection (association un-vers-plusieurs + ou plusieurs-vers-plusieurs), par défaut, elle ne sera pas effacée. Ce comportement + est complètement logique - une modification de l'un des états internes d'une entité + ne doit pas causer la disparition de l'entité associée ! + De même, l'ajout d'une entité dans une collection n'engendre pas, + par défaut, la persistance de cette entité. </para> </listitem> </itemizedlist> <para> - Le comportement par d�faut est donc que l'ajout d'une entit� dans une collection cr�� - simplement le lien entre les deux entit�s, et qu'effacer une entit� supprime ce lien. - C'est le comportement le plus appropri� dans la plupart des cas. Ce comportement n'est - cependant pas appropri� lorsque la vie du fils est li�e au cycle de vie du p�re. + Le comportement par défaut est donc que l'ajout d'une entité dans une collection créé + simplement le lien entre les deux entités, et qu'effacer une entité supprime ce lien. + C'est le comportement le plus approprié dans la plupart des cas. Ce comportement n'est + cependant pas approprié lorsque la vie du fils est liée au cycle de vie du père. </para> </sect1> @@ -84,16 +86,16 @@ session.flush();]]></programlisting> <para> - Hibernate ex�cuterait deux ordres SQL: + Hibernate exécuterait deux ordres SQL: </para> <itemizedlist> <listitem> - <para>un <literal>INSERT</literal> pour cr�er l'enregistrement pour <literal>c</literal></para> + <para>un <literal>INSERT</literal> pour créer l'enregistrement pour <literal>c</literal></para> </listitem> <listitem> <para> - un <literal>UPDATE</literal> pour cr�er le lien de <literal>p</literal> vers + un <literal>UPDATE</literal> pour créer le lien de <literal>p</literal> vers <literal>c</literal> </para> </listitem> @@ -101,8 +103,8 @@ <para> Ceci est non seuleument inefficace, mais viole aussi toute contrainte <literal>NOT NULL</literal> sur - la colonne <literal>parent_id</literal>. Nous pouvons r�parer la contrainte de nullit� - en sp�cifiant <literal>not-null="true"</literal> dans le mapping de la collection : + la colonne <literal>parent_id</literal>. Nous pouvons réparer la contrainte de nullité + en spécifiant <literal>not-null="true"</literal> dans le mapping de la collection : </para> <programlisting><![CDATA[<set name="children"> @@ -111,25 +113,25 @@ </set>]]></programlisting> <para> - Cependant ce n'est pas la solution recommand�e. + Cependant ce n'est pas la solution recommandée. </para> <para> - La cause sous jacente � ce comportement est que le lien (la cl� �trang�re <literal>parent_id</literal>) de - <literal>p</literal> vers <literal>c</literal> n'est pas consid�r�e comme faisant partie de l'�tat - de l'objet <literal>Child</literal> et n'est donc pas cr�� par l'<literal>INSERT</literal>. + La cause sous jacente à ce comportement est que le lien (la clé étrangère <literal>parent_id</literal>) de + <literal>p</literal> vers <literal>c</literal> n'est pas considérée comme faisant partie de l'état + de l'objet <literal>Child</literal> et n'est donc pas créé par l'<literal>INSERT</literal>. La solution est donc que ce lien fasse partie du mapping de <literal>Child</literal>. </para> <programlisting><![CDATA[<many-to-one name="parent" column="parent_id" not-null="true"/>]]></programlisting> <para> - (Nous avons aussi besoin d'ajouter la propri�t� <literal>parent</literal> dans la classe <literal>Child</literal>). + (Nous avons aussi besoin d'ajouter la propriété <literal>parent</literal> dans la classe <literal>Child</literal>). </para> <para> - Maintenant que l'�tat du lien est g�r� par l'entit� <literal>Child</literal>, nous sp�cifions � la - collection de ne pas mettre � jour le lien. Nous utilisons l'attribut <literal>inverse</literal>. + Maintenant que l'état du lien est géré par l'entité <literal>Child</literal>, nous spécifions à la + collection de ne pas mettre à jour le lien. Nous utilisons l'attribut <literal>inverse</literal>. </para> <programlisting><![CDATA[<set name="children" inverse="true"> @@ -138,7 +140,7 @@ </set>]]></programlisting> <para> - Le code suivant serait utilis� pour ajouter un nouveau <literal>Child</literal> + Le code suivant serait utilisé pour ajouter un nouveau <literal>Child</literal> </para> <programlisting><![CDATA[Parent p = (Parent) session.load(Parent.class, pid); @@ -149,11 +151,11 @@ session.flush();]]></programlisting> <para> - Maintenant, seul un <literal>INSERT</literal> SQL est n�cessaire ! + Maintenant, seul un <literal>INSERT</literal> SQL est nécessaire ! </para> <para> - Pour all�ger encore un peu les choses, nous devrions cr�er une m�thode <literal>addChild()</literal> + Pour alléger encore un peu les choses, nous devrions créer une méthode <literal>addChild()</literal> dans <literal>Parent</literal>. </para> @@ -188,7 +190,7 @@ </set>]]></programlisting> <para> - Simplifie le code pr�c�dent en + Simplifie le code précédent en </para> <programlisting><![CDATA[Parent p = (Parent) session.load(Parent.class, pid); @@ -197,9 +199,9 @@ session.flush();]]></programlisting> <para> - De la m�me mani�re, nous n'avons pas � it�rer sur les fils lorsque nous sauvons + De la même manière, nous n'avons pas à itérer sur les fils lorsque nous sauvons ou effacons un <literal>Parent</literal>. Le code suivant efface <literal>p</literal> - et tous ses fils de la base de donn�es. + et tous ses fils de la base de données. </para> <programlisting><![CDATA[Parent p = (Parent) session.load(Parent.class, pid); @@ -217,7 +219,7 @@ session.flush();]]></programlisting> <para> - n'effacera pas <literal>c</literal> de la base de donn�es, il enl�vera seulement + n'effacera pas <literal>c</literal> de la base de données, il enlèvera seulement le lien vers <literal>p</literal> (et causera une violation de contrainte <literal>NOT NULL</literal>, dans ce cas). Vous devez explicitement utiliser <literal>delete()</literal> sur <literal>Child</literal>. @@ -230,8 +232,8 @@ session.flush();]]></programlisting> <para> - Dans notre cas, un <literal>Child</literal> ne peut pas vraiment exister sans son p�re. Si nous - effacons un <literal>Child</literal> de la collection, nous voulons vraiment qu'il soit effac�. + Dans notre cas, un <literal>Child</literal> ne peut pas vraiment exister sans son père. Si nous + effacons un <literal>Child</literal> de la collection, nous voulons vraiment qu'il soit effacé. Pour cela, nous devons utiliser <literal>cascade="all-delete-orphan"</literal>. </para> @@ -241,9 +243,9 @@ </set>]]></programlisting> <para> - A noter : m�me si le mapping de la collection sp�cifie <literal>inverse="true"</literal>, les cascades - sont toujours assur�es par l'it�ration sur les �l�ments de la collection. Donc, si vous avez besoin - qu'un objet soit enregistr�, effac� ou mis � jour par cascade, vous devez l'ajouter dans la colleciton. + A noter : même si le mapping de la collection spécifie <literal>inverse="true"</literal>, les cascades + sont toujours assurées par l'itération sur les éléments de la collection. Donc, si vous avez besoin + qu'un objet soit enregistré, effacé ou mis à jour par cascade, vous devez l'ajouter dans la colleciton. Il ne suffit pas d'appeler explicitement <literal>setParent()</literal>. </para> @@ -253,26 +255,26 @@ <title>Cascades et <literal>unsaved-value</literal></title> <para> - Supposons que nous ayons charg� un <literal>Parent</literal> dans une <literal>Session</literal>, - que nous l'ayons ensuite modifi� et que voulions persiter ces modifications dans une nouvelle session + Supposons que nous ayons chargé un <literal>Parent</literal> dans une <literal>Session</literal>, + que nous l'ayons ensuite modifié et que voulions persiter ces modifications dans une nouvelle session en appelant <literal>update()</literal>. - Le <literal>Parent</literal> contiendra une collection de fils et, puisque la cascade est activ�e, - Hibernate a besoin de savoir quels fils viennent d'�tre instanci�s et quels fils proviennent de la base - de donn�es. Supposons aussi que <literal>Parent</literal> et <literal>Child</literal> ont tous deux + Le <literal>Parent</literal> contiendra une collection de fils et, puisque la cascade est activée, + Hibernate a besoin de savoir quels fils viennent d'être instanciés et quels fils proviennent de la base + de données. Supposons aussi que <literal>Parent</literal> et <literal>Child</literal> ont tous deux des identifiants du type <literal>Long</literal>. - Hibernate utilisera la propri�t� de l'identifiant et la propri�t� de la version/horodatage pour d�terminer quels fils sont nouveaux - (vous pouvez aussi utiliser la propri�t� version ou timestamp, voir + Hibernate utilisera la propriété de l'identifiant et la propriété de la version/horodatage pour déterminer quels fils sont nouveaux + (vous pouvez aussi utiliser la propriété version ou timestamp, voir <xref linkend="manipulatingdata-updating-detached"/>). - <emphasis>Dans Hibernate3, il n'est plus n�cessaire de sp�cifier + <emphasis>Dans Hibernate3, il n'est plus nécessaire de spécifier une <literal>unsaved-value</literal> explicitement.</emphasis> </para> <para> - Le code suivant mettra � jour <literal>parent</literal> et <literal>child</literal> - et ins�rera <literal>newChild</literal>. + Le code suivant mettra à jour <literal>parent</literal> et <literal>child</literal> + et insérera <literal>newChild</literal>. </para> - <programlisting><![CDATA[//parent et child ont �t� charg�s dans une session pr�c�dente + <programlisting><![CDATA[//parent et child ont été chargés dans une session précédente parent.addChild(child); Child newChild = new Child(); parent.addChild(newChild); @@ -280,12 +282,12 @@ session.flush();]]></programlisting> <para> - Ceci est tr�s bien pour des identifiants g�n�r�s, mais qu'en est-il des identifiants assign�s et des - identifiants compos�s ? C'est plus difficile, - puisqu'Hibernate ne peut pas utiliser la propri�t� de l'identifiant pour distinguer un objet - nouvellement instanci� (avec un identifiant assign� par l'utilisateur) d'un objet charg� dans une session pr�c�dente. - Dans ce cas, Hibernate utilisera soit la propri�t� de version ou d'horodatage, soit effectuera vraiment une requ�te au cache - de second niveau, soit, dans le pire des cas, � la base de donn�es, pour voir si la ligne existe. + Ceci est très bien pour des identifiants générés, mais qu'en est-il des identifiants assignés et des + identifiants composés ? C'est plus difficile, + puisqu'Hibernate ne peut pas utiliser la propriété de l'identifiant pour distinguer un objet + nouvellement instancié (avec un identifiant assigné par l'utilisateur) d'un objet chargé dans une session précédente. + Dans ce cas, Hibernate utilisera soit la propriété de version ou d'horodatage, soit effectuera vraiment une requête au cache + de second niveau, soit, dans le pire des cas, à la base de données, pour voir si la ligne existe. </para> <!-- undocumenting @@ -354,19 +356,19 @@ <title>Conclusion</title> <para> - Il y a quelques principes � ma�triser dans ce chapitre et tout cela peut para�tre d�routant la premi�re fois. + Il y a quelques principes à maîtriser dans ce chapitre et tout cela peut paraître déroutant la première fois. Cependant, dans la pratique, tout fonctionne parfaitement. La plupart des applications Hibernate utilisent - le pattern p�re / fils. + le pattern père / fils. </para> <para> - Nous avons �voqu� une alternative dans le premier paragraphe. Aucun des points trait�s pr�c�demment n'existe - dans le cas d'un mapping <literal>&lt;composite-element&gt;</literal> qui poss�de exactement la s�mantique - d'une relation p�re / fils. Malheureusement, il y a deux grandes limitations pour les classes �l�ments - composites : les �l�ments composites ne peuvent contenir de collections, et ils ne peuvent �tre les fils - d'entit�s autres que l'unique parent. + Nous avons évoqué une alternative dans le premier paragraphe. Aucun des points traités précédemment n'existe + dans le cas d'un mapping <literal>&lt;composite-element&gt;</literal> qui possède exactement la sémantique + d'une relation père / fils. Malheureusement, il y a deux grandes limitations pour les classes éléments + composites : les éléments composites ne peuvent contenir de collections, et ils ne peuvent être les fils + d'entités autres que l'unique parent. </para> </sect1> -</chapter> \ No newline at end of file +</chapter> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_weblog.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_weblog.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/example_weblog.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,4 +1,6 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="example-weblog"> <title>Exemple : application Weblog</title> @@ -6,9 +8,9 @@ <title>Classes persistantes</title> <para> - Les classes persistantes representent un weblog, et un article post� - dans un weblog. Il seront mod�lis�s comme une relation p�re/fils - standard, mais nous allons utiliser un "bag" tri� au lieu d'un set. + Les classes persistantes representent un weblog, et un article posté + dans un weblog. Il seront modélisés comme une relation père/fils + standard, mais nous allons utiliser un "bag" trié au lieu d'un set. </para> @@ -91,7 +93,7 @@ <title>Mappings Hibernate</title> <para> - Le mapping XML doit maintenant �tre relativement simple � vos yeux. + Le mapping XML doit maintenant être relativement simple à vos yeux. </para> <programlisting><![CDATA[<?xml version="1.0"?> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/filters.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/filters.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/filters.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,32 +1,34 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="filters"> - <title>Filtrer les donn�es</title> + <title>Filtrer les données</title> <para> - Hibernate3 fournit une nouvelle approche innovatrice pour g�rer des donn�es - avec des r�gles de "visibilit�". Un <emphasis>filtre Hibernate</emphasis> est un filtre - global, nomm�, param�tr� qui peut �tre activ� ou d�sactiv� pour une session Hibernate - particuli�re. + Hibernate3 fournit une nouvelle approche innovatrice pour gérer des données + avec des règles de "visibilité". Un <emphasis>filtre Hibernate</emphasis> est un filtre + global, nommé, paramétré qui peut être activé ou désactivé pour une session Hibernate + particulière. </para> <sect1 id="objectstate-filters"> <title>Filtres Hibernate</title> <para> - Hibernate3 ajoute la capacit� de pr�d�finir des crit�res de filtre et d'attacher ces - filtres � une classe ou � une collection. Un crit�re de filtre est la facult� de d�finir - une clause de restriction tr�s similaire � l'attribut "where" existant disponible sur - une classe et divers �l�ments d'une collection. Mis � part que ces conditions de filtre - peuvent �tre param�tr�es. L'application peut alors prendre la d�cision � l'ex�cution - si des filtres donn�s devraient �tre activ�s et quels devraient �tre leurs param�tres. - Des filtres peuvent �tre utilis�s comme des vues de base de donn�es, mais param�tr�es + Hibernate3 ajoute la capacité de prédéfinir des critères de filtre et d'attacher ces + filtres à une classe ou à une collection. Un critère de filtre est la faculté de définir + une clause de restriction très similaire à l'attribut "where" existant disponible sur + une classe et divers éléments d'une collection. Mis à part que ces conditions de filtre + peuvent être paramétrées. L'application peut alors prendre la décision à l'exécution + si des filtres donnés devraient être activés et quels devraient être leurs paramètres. + Des filtres peuvent être utilisés comme des vues de base de données, mais paramétrées dans l'application. </para> <para> - Afin d'utiliser des filtres, ils doivent d'abord �tre d�finis, puis attach�s aux �l�ments - de mapping appropri�s. Pour d�finir un filtre, utilisez l'�l�ment <literal>&lt;filter-def/&gt;</literal> - dans un �l�ment <literal>&lt;hibernate-mapping/&gt;</literal> : + Afin d'utiliser des filtres, ils doivent d'abord être définis, puis attachés aux éléments + de mapping appropriés. Pour définir un filtre, utilisez l'élément <literal>&lt;filter-def/&gt;</literal> + dans un élément <literal>&lt;hibernate-mapping/&gt;</literal> : </para> <programlisting><![CDATA[<filter-def name="myFilter"> @@ -34,7 +36,7 @@ </filter-def>]]></programlisting> <para> - Puis, ce filtre peut �tre attach� � une classe : + Puis, ce filtre peut être attaché à une classe : </para> <programlisting><![CDATA[<class name="myClass" ...> @@ -43,7 +45,7 @@ </class>]]></programlisting> <para> - ou � une collection : + ou à une collection : </para> <programlisting><![CDATA[<set ...> @@ -51,27 +53,27 @@ </set>]]></programlisting> <para> - ou m�me aux deux (ou � plusieurs de chaque) en m�me temps. + ou même aux deux (ou à plusieurs de chaque) en même temps. </para> <para> - Les m�thodes sur <literal>Session</literal> sont : <literal>enableFilter(String filterName)</literal>, + Les méthodes sur <literal>Session</literal> sont : <literal>enableFilter(String filterName)</literal>, <literal>getEnabledFilter(String filterName)</literal>, et <literal>disableFilter(String filterName)</literal>. - Par d�faut, les filtres <emphasis>ne sont pas</emphasis> activ�s pour une session donn�e ; - ils doivent �tre explicitement activ�s en appelant la m�thode + Par défaut, les filtres <emphasis>ne sont pas</emphasis> activés pour une session donnée ; + ils doivent être explicitement activés en appelant la méthode <literal>Session.enabledFilter()</literal>, laquelle retourne une instance de l'interface - <literal>Filter</literal>. Utiliser le simple filtre d�fini au-dessus ressemblerait � : + <literal>Filter</literal>. Utiliser le simple filtre défini au-dessus ressemblerait à : </para> <programlisting><![CDATA[session.enableFilter("myFilter").setParameter("myFilterParam", "some-value");]]></programlisting> <para> - Notez que des m�thodes sur l'interface org.hibernate.Filter autorisent le cha�nage de beaucoup - de m�thodes communes d'Hibernate. + Notez que des méthodes sur l'interface org.hibernate.Filter autorisent le chaînage de beaucoup + de méthodes communes d'Hibernate. </para> <para> - Un exemple complet, utilisant des donn�es temporelles avec une structure de date + Un exemple complet, utilisant des données temporelles avec une structure de date d'enregistrement effectif : </para> @@ -104,9 +106,9 @@ </class>]]></programlisting> <para> - Puis, afin de s'assurer que vous pouvez toujours r�cup�rer les enregistrements actuellement - effectifs, activez simplement le filtre sur la session avant de r�cup�rer des donn�es des - employ�s : + Puis, afin de s'assurer que vous pouvez toujours récupérer les enregistrements actuellement + effectifs, activez simplement le filtre sur la session avant de récupérer des données des + employés : </para> <programlisting><![CDATA[Session session = ...; @@ -117,16 +119,16 @@ ]]></programlisting> <para> - Dans le HQL ci-dessus, bien que nous ayons seulement mentionn� une contrainte de - salaire sur les resultats, � cause du filtre activ�, la requ�te retournera seulement - les employ�s actuellement actifs qui ont un salaire sup�rieur � un million de dollars. + Dans le HQL ci-dessus, bien que nous ayons seulement mentionné une contrainte de + salaire sur les resultats, à cause du filtre activé, la requête retournera seulement + les employés actuellement actifs qui ont un salaire supérieur à un million de dollars. </para> <para> - A noter : si vous pr�voyez d'utiliser des filtres avec des jointures externes (soit - � travers HQL, soit par le chargement) faites attention � la direction de l'expression - de condition. Il est plus s�r de la positionner pour les jointures externes � gauche ; - en g�n�ral, placez le param�tre d'abord, suivi du(des) nom(s) de colonne apr�s l'op�rateur. + A noter : si vous prévoyez d'utiliser des filtres avec des jointures externes (soit + à travers HQL, soit par le chargement) faites attention à la direction de l'expression + de condition. Il est plus sûr de la positionner pour les jointures externes à gauche ; + en général, placez le paramètre d'abord, suivi du(des) nom(s) de colonne après l'opérateur. </para> </sect1> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/inheritance_mapping.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/inheritance_mapping.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/inheritance_mapping.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,18 +1,20 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="inheritance"> - <title>Mapping d'h�ritage de classe</title> + <title>Mapping d'héritage de classe</title> <sect1 id="inheritance-strategies" revision="3"> - <title>Les trois strat�gies</title> + <title>Les trois stratégies</title> <para> - Hibernate supporte les trois strat�gies d'h�ritage de base : + Hibernate supporte les trois stratégies d'héritage de base : </para> <itemizedlist> <listitem> <para> - une table par hi�rarchie de classe (table per class hierarchy) + une table par hiérarchie de classe (table per class hierarchy) </para> </listitem> <listitem> @@ -22,13 +24,13 @@ </listitem> <listitem> <para> - une table par classe concr�te (table per concrete class) + une table par classe concrète (table per concrete class) </para> </listitem> </itemizedlist> <para> - Hibernate supporte en plus une quatri�mestrat�gie, l�g�rement diff�rente, qui supporte le polymorphisme : + Hibernate supporte en plus une quatrièmestratégie, légèrement différente, qui supporte le polymorphisme : </para> <itemizedlist> @@ -40,26 +42,26 @@ </itemizedlist> <para> - Il est possible d'utiliser diff�rentes strat�gies de mapping pour diff�rentes branches d'une m�me - hi�rarchie d'h�ritage, et alors d'employer le polymorphisme implicite pour r�aliser le - polymorphisme � travers toute la hi�rarchie. Pourtant, Hibernate ne supporte pas de m�langer + Il est possible d'utiliser différentes stratégies de mapping pour différentes branches d'une même + hiérarchie d'héritage, et alors d'employer le polymorphisme implicite pour réaliser le + polymorphisme à travers toute la hiérarchie. Pourtant, Hibernate ne supporte pas de mélanger des mappings <literal>&lt;subclass&gt;</literal> et <literal>&lt;joined-subclass&gt;</literal> et <literal>&lt;union-subclass&gt;</literal> - pour le m�me �l�ment <literal>&lt;class&gt;</literal> racine. - Il est possible de m�langer ensemble les strat�gies d'une table par hi�rarchie et d'une - table par sous-classe, pour le m�me �l�ment <literal>&lt;class&gt;</literal>, en combinant - les �l�ments <literal>&lt;subclass&gt;</literal> et <literal>&lt;join&gt;</literal> (voir dessous). + pour le même élément <literal>&lt;class&gt;</literal> racine. + Il est possible de mélanger ensemble les stratégies d'une table par hiérarchie et d'une + table par sous-classe, pour le même élément <literal>&lt;class&gt;</literal>, en combinant + les éléments <literal>&lt;subclass&gt;</literal> et <literal>&lt;join&gt;</literal> (voir dessous). </para> <para> - Il est possible de d�finir des mappings de <literal>subclass</literal>, <literal>union-subclass</literal>, - et <literal>joined-subclass</literal> dans des documents de mapping s�par�s, directement sous - <literal>hibernate-mapping</literal>. Ceci vous permet d'�tendre une hi�rarchie de classe juste en - ajoutant un nouveau fichier de mapping. Vous devez sp�cifier un attribut <literal>extends</literal> - dans le mapping de la sous-classe, en nommant une super-classe pr�c�demment mapp�e. Note : - pr�c�demment cette foncionnalit� rendait l'ordre des documents de mapping important. Depuis + Il est possible de définir des mappings de <literal>subclass</literal>, <literal>union-subclass</literal>, + et <literal>joined-subclass</literal> dans des documents de mapping séparés, directement sous + <literal>hibernate-mapping</literal>. Ceci vous permet d'étendre une hiérarchie de classe juste en + ajoutant un nouveau fichier de mapping. Vous devez spécifier un attribut <literal>extends</literal> + dans le mapping de la sous-classe, en nommant une super-classe précédemment mappée. Note : + précédemment cette foncionnalité rendait l'ordre des documents de mapping important. Depuis Hibernate3, l'ordre des fichier de mapping n'importe plus lors de l'utilisation du mot-clef "extends". - L'ordre � l'int�rieur d'un simple fichier de mapping impose encore de d�finir les classes m�res + L'ordre à l'intérieur d'un simple fichier de mapping impose encore de définir les classes mères avant les classes filles. </para> @@ -72,12 +74,12 @@ <sect2 id="inheritance-tableperclass" > - <title>Une table par hi�rarchie de classe</title> + <title>Une table par hiérarchie de classe</title> <para> - Supposons que nous ayons une interface <literal>Payment</literal>, impl�ment�e + Supposons que nous ayons une interface <literal>Payment</literal>, implémentée par <literal>CreditCardPayment</literal>, <literal>CashPayment</literal>, - <literal>ChequePayment</literal>. La strat�gie une table par hi�rarchie serait : + <literal>ChequePayment</literal>. La stratégie une table par hiérarchie serait : </para> <programlisting><![CDATA[<class name="Payment" table="PAYMENT"> @@ -101,7 +103,7 @@ <para> Une seule table est requise. Une grande limitation de cette - strat�gie est que les colonnes d�clar�es par les classes filles, telles que <literal>CCTYPE</literal>, + stratégie est que les colonnes déclarées par les classes filles, telles que <literal>CCTYPE</literal>, ne peuvent avoir de contrainte <literal>NOT NULL</literal>. </para> @@ -111,7 +113,7 @@ <title>Une table par classe fille</title> <para> - La strat�gie une table par classe fille serait : + La stratégie une table par classe fille serait : </para> <programlisting><![CDATA[<class name="Payment" table="PAYMENT"> @@ -137,7 +139,7 @@ <para> Quatre tables sont requises. Les trois tables des classes filles ont - une cl� primaire associ�e � la table classe m�re (le mod�le relationnel + une clé primaire associée à la table classe mère (le modèle relationnel est une association un-vers-un). </para> @@ -147,14 +149,14 @@ <title>Une table par classe fille, en utilisant un discriminant</title> <para> - Notez que l'impl�mentation Hibernate de la strat�gie un table par - classe fille ne n�cessite pas de colonne discriminante dans la table - classe m�re. D'autres impl�mentations de mappers Objet/Relationnel utilisent - une autre impl�mentation de la strat�gie une table par classe fille qui n�cessite - une colonne de type discriminant dans la table de la classe m�re. L'approche - prise par Hibernate est plus difficile � impl�menter mais plus correcte + Notez que l'implémentation Hibernate de la stratégie un table par + classe fille ne nécessite pas de colonne discriminante dans la table + classe mère. D'autres implémentations de mappers Objet/Relationnel utilisent + une autre implémentation de la stratégie une table par classe fille qui nécessite + une colonne de type discriminant dans la table de la classe mère. L'approche + prise par Hibernate est plus difficile à implémenter mais plus correcte d'une point de vue relationnel. Si vous aimeriez utiliser - une colonne discriminante avec la strat�gie d'une table par classe fille, vous pourriez combiner + une colonne discriminante avec la stratégie d'une table par classe fille, vous pourriez combiner l'utilisation de <literal>&lt;subclass&gt;</literal> et <literal>&lt;join&gt;</literal>, comme suit : </para> @@ -188,17 +190,17 @@ </class>]]></programlisting> <para> - La d�claration optionnelle <literal>fetch="select"</literal> indique � Hibernate - de ne pas r�cup�rer les donn�es de la classe fille <literal>ChequePayment</literal> par une jointure externe lors des requ�tes sur la classe m�re. + La déclaration optionnelle <literal>fetch="select"</literal> indique à Hibernate + de ne pas récupérer les données de la classe fille <literal>ChequePayment</literal> par une jointure externe lors des requêtes sur la classe mère. </para> </sect2> <sect2 id="inheritance-mixing-tableperclass-tablepersubclass"> - <title>M�lange d'une table par hi�rarchie de classe avec une table par classe fille</title> + <title>Mélange d'une table par hiérarchie de classe avec une table par classe fille</title> <para> - Vous pouvez m�me m�langer les strat�gies d'une table par hi�rarchie de classe et d'une table par classe fille en utilisant cette approche : + Vous pouvez même mélanger les stratégies d'une table par hiérarchie de classe et d'une table par classe fille en utilisant cette approche : </para> <programlisting><![CDATA[<class name="Payment" table="PAYMENT"> @@ -223,8 +225,8 @@ </class>]]></programlisting> <para> - Pour importe laquelle de ces strat�gies, une association polymorphique vers la classe racine - <literal>Payment</literal> est mapp�e en utilisant <literal>&lt;many-to-one&gt;</literal>. + Pour importe laquelle de ces stratégies, une association polymorphique vers la classe racine + <literal>Payment</literal> est mappée en utilisant <literal>&lt;many-to-one&gt;</literal>. </para> <programlisting><![CDATA[<many-to-one name="payment" column="PAYMENT_ID" class="Payment"/>]]></programlisting> @@ -232,10 +234,10 @@ </sect2> <sect2 id="inheritance-tableperconcrete" revision="2"> - <title>Une table par classe concr�te</title> + <title>Une table par classe concrète</title> <para> - Il y a deux mani�res d'utiliser la strat�gie d'une table par classe concr�te. La premi�re + Il y a deux manières d'utiliser la stratégie d'une table par classe concrète. La première est d'employer <literal>&lt;union-subclass&gt;</literal>. </para> @@ -258,30 +260,30 @@ </class>]]></programlisting> <para> - Trois tables sont n�cessaires pour les classes filles. Chaque table d�finit des colonnes - pour toutes les propri�t�s de la classe, incluant les propri�t�s h�rit��s. + Trois tables sont nécessaires pour les classes filles. Chaque table définit des colonnes + pour toutes les propriétés de la classe, incluant les propriétés héritéés. </para> <para> - La limitation de cette approche est que si une propri�t� est mapp�e sur la classe m�re, le nom - de la colonne doit �tre le m�me pour toutes les classes filles. (Nous pourrions �tre plus souple + La limitation de cette approche est que si une propriété est mappée sur la classe mère, le nom + de la colonne doit être le même pour toutes les classes filles. (Nous pourrions être plus souple dans une future version d'Hibernate). - La strat�gie du g�n�rateur d'identifiant n'est pas permise dans l'h�ritage de classes filles par + La stratégie du générateur d'identifiant n'est pas permise dans l'héritage de classes filles par union, en effet la valeur (NdT : seed) de la clef primaire - doit �tre partag�e par toutes les classes filles "union" d'une hi�rarchie. + doit être partagée par toutes les classes filles "union" d'une hiérarchie. </para> <para> - Si votre classe m�re est abstraite, mappez la avec <literal>abstract="true"</literal>. - Bien s�r, si elle n'est pas abstraite, une table suppl�mentaire (par d�faut, + Si votre classe mère est abstraite, mappez la avec <literal>abstract="true"</literal>. + Bien sûr, si elle n'est pas abstraite, une table supplémentaire (par défaut, <literal>PAYMENT</literal> dans l'exemple ci-dessus) est requise pour contenir des instances - de la classe m�re. + de la classe mère. </para> </sect2> <sect2 id="inheritance-tableperconcreate-polymorphism"> - <title>Une table par classe concr�te, en utilisant le polymorphisme implicite</title> + <title>Une table par classe concrète, en utilisant le polymorphisme implicite</title> <para> Une approche alternative est l'emploi du polymorphisme implicite : @@ -313,20 +315,20 @@ <para> Notez que nulle part nous ne mentionnons l'interface <literal>Payment</literal> explicitement. - Notez aussi que des propri�t�s de <literal>Payment</literal> sont mapp�es dans - chaque classe fille. Si vous voulez �viter des duplications, consid�rez l'utilisation des - entit�s XML (cf. <literal>[ &lt;!ENTITY allproperties SYSTEM "allproperties.xml"&gt; ]</literal> - dans la d�claration du <literal>DOCTYPE</literal> et <literal>&amp;allproperties;</literal> dans le mapping). + Notez aussi que des propriétés de <literal>Payment</literal> sont mappées dans + chaque classe fille. Si vous voulez éviter des duplications, considérez l'utilisation des + entités XML (cf. <literal>[ &lt;!ENTITY allproperties SYSTEM "allproperties.xml"&gt; ]</literal> + dans la déclaration du <literal>DOCTYPE</literal> et <literal>&amp;allproperties;</literal> dans le mapping). </para> <para> - L'inconv�nient de cette approche est qu'Hibernate ne g�n�re pas d'<literal>UNION</literal>s SQL - lors de l'ex�cution des requ�tes polymorphiques. + L'inconvénient de cette approche est qu'Hibernate ne génère pas d'<literal>UNION</literal>s SQL + lors de l'exécution des requêtes polymorphiques. </para> <para> - Pour cette strat�gie de mapping, une association polymorphique pour <literal>Payment</literal> - est habituellement mapp�e en utilisant <literal>&lt;any&gt;</literal>. + Pour cette stratégie de mapping, une association polymorphique pour <literal>Payment</literal> + est habituellement mappée en utilisant <literal>&lt;any&gt;</literal>. </para> <programlisting><![CDATA[<any name="payment" meta-type="string" id-type="long"> @@ -340,14 +342,14 @@ </sect2> <sect2 id="inheritace-mixingpolymorphism"> - <title>M�lange du polymorphisme implicite avec d'autres mappings d'h�ritage</title> + <title>Mélange du polymorphisme implicite avec d'autres mappings d'héritage</title> <para> - Il y a une chose suppl�mentaire � noter � propos de ce mapping. Puisque les classes filles sont - chacune mapp�es avec leur propre �l�ment <literal>&lt;class&gt;</literal> (et puisque + Il y a une chose supplémentaire à noter à propos de ce mapping. Puisque les classes filles sont + chacune mappées avec leur propre élément <literal>&lt;class&gt;</literal> (et puisque <literal>Payment</literal> est juste une interface), chaque classe fille pourrait - facilement faire partie d'une autre hi�rarchie - d'h�ritage ! (Et vous pouvez encore faire des requ�tes polymorphiques pour l'interface <literal>Payment</literal>). + facilement faire partie d'une autre hiérarchie + d'héritage ! (Et vous pouvez encore faire des requêtes polymorphiques pour l'interface <literal>Payment</literal>). </para> <programlisting><![CDATA[<class name="CreditCardPayment" table="CREDIT_PAYMENT"> @@ -380,10 +382,10 @@ <para> Encore une fois, nous ne mentionnons pas explicitement <literal>Payment</literal>. - Si nous ex�cutons une requ�te sur l'interface <literal>Payment</literal> - par + Si nous exécutons une requête sur l'interface <literal>Payment</literal> - par exemple, <literal>from Payment</literal> - Hibernate retournera automatiquement les instances de <literal>CreditCardPayment</literal> - (et ses classes filles puisqu'elles impl�mentent aussi <literal>Payment</literal>), + (et ses classes filles puisqu'elles implémentent aussi <literal>Payment</literal>), <literal>CashPayment</literal> et <literal>ChequePayment</literal> mais pas les instances de <literal>NonelectronicTransaction</literal>. </para> @@ -396,17 +398,17 @@ <title>Limitations</title> <para> - Il y a certaines limitations � l'approche du "polymorphisme implicite" - pour la strat�gie de mapping d'une table par classe concr�te. - Il y a plut�t moins de limitations restrictives aux mappings <literal>&lt;union-subclass&gt;</literal>. + Il y a certaines limitations à l'approche du "polymorphisme implicite" + pour la stratégie de mapping d'une table par classe concrète. + Il y a plutôt moins de limitations restrictives aux mappings <literal>&lt;union-subclass&gt;</literal>. </para> <para> - La table suivante montre les limitations des mappings d'une table par classe concr�te, et du polymorphisme implicite, dans Hibernate. + La table suivante montre les limitations des mappings d'une table par classe concrète, et du polymorphisme implicite, dans Hibernate. </para> <table frame="topbot"> - <title>Caract�ristiques du mapping d'h�ritage</title> + <title>Caractéristiques du mapping d'héritage</title> <tgroup cols='8' align='left' colsep='1' rowsep='1'> <colspec colname='c1' colwidth="1*"/> <colspec colname='c2' colwidth="1*"/> @@ -418,20 +420,20 @@ <colspec colname='c8' colwidth="1*"/> <thead> <row> - <entry>Strat�gie d'h�ritage</entry> + <entry>Stratégie d'héritage</entry> <entry>many-to-one polymorphique</entry> <entry>one-to-one polymorphique</entry> <entry>one-to-many polymorphique</entry> <entry>many-to-many polymorphique</entry> <entry><literal>load()/get()</literal> polymorphique</entry> - <entry>Requ�tes polymorphiques</entry> + <entry>Requêtes polymorphiques</entry> <entry>Jointures polymorphiques</entry> - <entry>R�cup�ration par jointure externe</entry> + <entry>Récupération par jointure externe</entry> </row> </thead> <tbody> <row> - <entry>une table par hi�rarchie de classe</entry> + <entry>une table par hiérarchie de classe</entry> <entry><literal>&lt;many-to-one&gt;</literal></entry> <entry><literal>&lt;one-to-one&gt;</literal></entry> <entry><literal>&lt;one-to-many&gt;</literal></entry> @@ -439,7 +441,7 @@ <entry><literal>s.get(Payment.class, id)</literal></entry> <entry><literal>from Payment p</literal></entry> <entry><literal>from Order o join o.payment p</literal></entry> - <entry><emphasis>support�e</emphasis></entry> + <entry><emphasis>supportée</emphasis></entry> </row> <row> <entry>une table par classe fille</entry> @@ -450,10 +452,10 @@ <entry><literal>s.get(Payment.class, id)</literal></entry> <entry><literal>from Payment p</literal></entry> <entry><literal>from Order o join o.payment p</literal></entry> - <entry><emphasis>support�e</emphasis></entry> + <entry><emphasis>supportée</emphasis></entry> </row> <row> - <entry>une table par classe concr�te (union-subclass)</entry> + <entry>une table par classe concrète (union-subclass)</entry> <entry><literal>&lt;many-to-one&gt;</literal></entry> <entry><literal>&lt;one-to-one&gt;</literal></entry> <entry><literal>&lt;one-to-many&gt;</literal> (pour <literal>inverse="true"</literal> seulement)</entry> @@ -461,18 +463,18 @@ <entry><literal>s.get(Payment.class, id)</literal></entry> <entry><literal>from Payment p</literal></entry> <entry><literal>from Order o join o.payment p</literal></entry> - <entry><emphasis>support�e</emphasis></entry> + <entry><emphasis>supportée</emphasis></entry> </row> <row> - <entry>une table par classe concr�te (polymorphisme implicite)</entry> + <entry>une table par classe concrète (polymorphisme implicite)</entry> <entry><literal>&lt;any&gt;</literal></entry> - <entry><emphasis>non support�</emphasis></entry> - <entry><emphasis>non support�</emphasis></entry> + <entry><emphasis>non supporté</emphasis></entry> + <entry><emphasis>non supporté</emphasis></entry> <entry><literal>&lt;many-to-any&gt;</literal></entry> <entry><literal>s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()</literal></entry> <entry><literal>from Payment p</literal></entry> - <entry><emphasis>non support�es</emphasis></entry> - <entry><emphasis>non support�e</emphasis></entry> + <entry><emphasis>non supportées</emphasis></entry> + <entry><emphasis>non supportée</emphasis></entry> </row> </tbody> </tgroup> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/performance.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/performance.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/performance.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,143 +1,145 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="performance"> - <title>Am�liorer les performances</title> + <title>Améliorer les performances</title> <sect1 id="performance-fetching" revision="2"> - <title>Strat�gies de chargement</title> + <title>Stratégies de chargement</title> <para> - Une <emphasis>strat�gie de chargement</emphasis> est une strat�gie qu'Hibernate va - utiliser pour r�cup�rer des objets associ�s si l'application � besoin de naviguer � + Une <emphasis>stratégie de chargement</emphasis> est une stratégie qu'Hibernate va + utiliser pour récupérer des objets associés si l'application à besoin de naviguer à travers une association. - Les strat�gies de chargement peuvent �tre d�clar�es dans les m�ta-donn�es de l'outil - de mapping objet relationnel ou surcharg�es par une requ�te de type HQL ou <literal>Criteria</literal> - particuli�re. + Les stratégies de chargement peuvent être déclarées dans les méta-données de l'outil + de mapping objet relationnel ou surchargées par une requête de type HQL ou <literal>Criteria</literal> + particulière. </para> <para> - Hibernate3 d�finit les strat�gies de chargement suivantes : + Hibernate3 définit les stratégies de chargement suivantes : </para> <itemizedlist> <listitem> <para> - <emphasis>Chargement par jointure</emphasis> - Hibernate r�cup�re - l'instance associ�e ou la collection dans un m�me <literal>SELECT</literal>, + <emphasis>Chargement par jointure</emphasis> - Hibernate récupère + l'instance associée ou la collection dans un même <literal>SELECT</literal>, en utilisant un <literal>OUTER JOIN</literal>. </para> </listitem> <listitem> <para> <emphasis>Chargement par select</emphasis> - Un second <literal>SELECT</literal> - est utilis� pour r�cup�rer l'instance associ�e ou la collection. A moins - que vous ne d�sactiviez explicitement le chargement tardif en sp�cifiant - <literal>lazy="false"</literal>, ce second select ne sera ex�cut� que lorsque - vous acc�derez r�ellement � l'association. + est utilisé pour récupérer l'instance associée ou la collection. A moins + que vous ne désactiviez explicitement le chargement tardif en spécifiant + <literal>lazy="false"</literal>, ce second select ne sera exécuté que lorsque + vous accéderez réellement à l'association. </para> </listitem> <listitem> <para> <emphasis>Chargement par sous-select</emphasis> - Un second <literal>SELECT</literal> - est utilis� pour r�cup�rer les associations pour toutes les entit�s r�cup�r�es dans - une requ�te ou un chargement pr�alable. A moins - que vous ne d�sactiviez explicitement le chargement tardif en sp�cifiant - <literal>lazy="false"</literal>, ce second select ne sera ex�cut� que lorsque - vous acc�derez r�ellement � l'association. + est utilisé pour récupérer les associations pour toutes les entités récupérées dans + une requête ou un chargement préalable. A moins + que vous ne désactiviez explicitement le chargement tardif en spécifiant + <literal>lazy="false"</literal>, ce second select ne sera exécuté que lorsque + vous accéderez réellement à l'association. </para> </listitem> <listitem> <para> - <emphasis>Chargement par lot</emphasis> - Il s'agit d'une strat�gie d'optimisation - pour le chargement par select - Hibernate r�cup�re un lot - d'instances ou de collections en un seul <literal>SELECT</literal> en sp�cifiant - une liste de cl� primaire ou de cl� �trang�re. + <emphasis>Chargement par lot</emphasis> - Il s'agit d'une stratégie d'optimisation + pour le chargement par select - Hibernate récupère un lot + d'instances ou de collections en un seul <literal>SELECT</literal> en spécifiant + une liste de clé primaire ou de clé étrangère. </para> </listitem> </itemizedlist> <para> - Hibernate fait �galement la distinction entre : + Hibernate fait également la distinction entre : </para> <itemizedlist> <listitem> <para> - <emphasis>Chargement imm�diat</emphasis> - Une association, une collection ou - un attribut est charg� imm�diatement lorsque l'objet auquel appartient cet - �l�ment est charg�. + <emphasis>Chargement immédiat</emphasis> - Une association, une collection ou + un attribut est chargé immédiatement lorsque l'objet auquel appartient cet + élément est chargé. </para> </listitem> <listitem> <para> <emphasis>Chargement tardif d'une collection</emphasis> - Une collection est - charg�e lorque l'application invoque une m�thode sur cette collection (il s'agit - du mode de chargement par d�faut pour les collections). + chargée lorque l'application invoque une méthode sur cette collection (il s'agit + du mode de chargement par défaut pour les collections). </para> </listitem> <listitem> <para> <emphasis>Chargement "super tardif" d'une collection</emphasis> - les - �l�ments de la collection sont r�cup�r�s individuellement depuis la base de donn�es - lorsque n�cessaire. - Hibernate essaie de ne pas charger toute la collection en m�moire sauf si cela est - absolument n�cessaire (bien adapt� aux tr�s grandes collections). + éléments de la collection sont récupérés individuellement depuis la base de données + lorsque nécessaire. + Hibernate essaie de ne pas charger toute la collection en mémoire sauf si cela est + absolument nécessaire (bien adapté aux très grandes collections). </para> </listitem> <listitem> <para> <emphasis>Chargement par proxy</emphasis> - une association vers un seul - objet est charg�e lorsqu'une m�thode autre que le getter sur l'identifiant est - appel�e sur l'objet associ�. + objet est chargée lorsqu'une méthode autre que le getter sur l'identifiant est + appelée sur l'objet associé. </para> </listitem> <listitem> <para> <emphasis>Chargement "sans proxy"</emphasis> - une association vers un seul objet - est charg�e lorsque l'on acc�de � cet objet. Par rapport au chargement par proxy, - cette approche est moins tardif (l'association est quand m�me charg�e m�me - si on n'acc�de qu'� l'identifiant) mais plus transparente car il n'y a pas de proxy + est chargée lorsque l'on accède à cet objet. Par rapport au chargement par proxy, + cette approche est moins tardif (l'association est quand même chargée même + si on n'accède qu'à l'identifiant) mais plus transparente car il n'y a pas de proxy visible dans l'application. Cette approche requiert une instrumentation du bytecode - � la compilation et est rarement n�cessaire. + à la compilation et est rarement nécessaire. </para> </listitem> <listitem> <para> <emphasis>Chargement tardif des attributs</emphasis> - Un attribut ou un - objet associ� seul est charg� lorsque l'on y acc�de. Cette approche requiert - une instrumentation du bytecode � la compilation et est rarement n�cessaire. + objet associé seul est chargé lorsque l'on y accède. Cette approche requiert + une instrumentation du bytecode à la compilation et est rarement nécessaire. </para> </listitem> </itemizedlist> <para> Nous avons ici deux notions orthogonales : <emphasis>quand</emphasis> l'association est - charg�e et <emphasis>comment</emphasis> (quelle requ�te SQL est utilis�e). Il ne faut - pas confondre les deux. Le mode de chargement est utilis� pour am�liorer les performances. - On peut utiliser le mode tardif pour d�finir un contrat sur quelles donn�es sont toujours - accessibles sur une instance d�tach�e d'une classe particuli�re. + chargée et <emphasis>comment</emphasis> (quelle requête SQL est utilisée). Il ne faut + pas confondre les deux. Le mode de chargement est utilisé pour améliorer les performances. + On peut utiliser le mode tardif pour définir un contrat sur quelles données sont toujours + accessibles sur une instance détachée d'une classe particulière. </para> <sect2 id="performance-fetching-lazy"> - <title>Travailler avec des associations charg�es tardivement</title> + <title>Travailler avec des associations chargées tardivement</title> <para> - Par d�faut, Hibernate3 utilise le chargement tardif par select pour les collections + Par défaut, Hibernate3 utilise le chargement tardif par select pour les collections et le chargement tardif par proxy pour les associations vers un seul objet. - Ces valeurs par d�faut sont valables pour la plupart des associations dans la + Ces valeurs par défaut sont valables pour la plupart des associations dans la plupart des applications. </para> <para> - <emphasis>Note :</emphasis> si vous d�finissez + <emphasis>Note :</emphasis> si vous définissez <literal>hibernate.default_batch_fetch_size</literal>, Hibernate va utiliser l'optimisation du chargement par lot pour le chargement tardif (cette optimisation peut aussi - �tre activ�e � un niveau de granularit� plus fin). + être activée à un niveau de granularité plus fin). </para> <para> - Cependant, le chargement tardif pose un probl�me qu'il faut connaitre. L'acc�s � - une association d�finie comme "tardive", hors du contexte d'une session hibernate - ouverte, va conduire � une exception. Par exemple : + Cependant, le chargement tardif pose un problème qu'il faut connaitre. L'accès à + une association définie comme "tardive", hors du contexte d'une session hibernate + ouverte, va conduire à une exception. Par exemple : </para> <programlisting><![CDATA[s = sessions.openSession(); @@ -153,38 +155,38 @@ Integer accessLevel = (Integer) permissions.get("accounts"); // Error!]]></programlisting> <para> - Etant donn� que la collection des permissions n'a pas �t� initialis�e - avant que la <literal>Session</literal> soit ferm�e, la collection n'est + Etant donné que la collection des permissions n'a pas été initialisée + avant que la <literal>Session</literal> soit fermée, la collection n'est pas capable de se charger. <emphasis>Hibernate ne supporte pas le chargement - tardif pour des objets d�tach�s</emphasis>. La solution � ce probl�me est de - d�placer le code qui lit la collection avant le "commit" de la transaction. + tardif pour des objets détachés</emphasis>. La solution à ce problème est de + déplacer le code qui lit la collection avant le "commit" de la transaction. </para> <para> Une autre alternative est d'utiliser une collection ou une association non - "tardive" en sp�cifiant <literal>lazy="false"</literal> dans le mapping de + "tardive" en spécifiant <literal>lazy="false"</literal> dans le mapping de l'association. - Cependant il est pr�vu que le chargement tardif soit utilis� pour quasiment - toutes les collections ou associations. Si vous d�finissez trop d'associtions - non "tardives" dans votre mod�le objet, Hibernate va finir par devoir charger - toute la base de donn�es en m�moire � chaque transaction ! + Cependant il est prévu que le chargement tardif soit utilisé pour quasiment + toutes les collections ou associations. Si vous définissez trop d'associtions + non "tardives" dans votre modèle objet, Hibernate va finir par devoir charger + toute la base de données en mémoire à chaque transaction ! </para> <para> - D'un autre c�t�, on veut souvent choisir un chargement par jointure (qui est par - d�faut non tardif) � la place du chargement par select dans une transaction particuli�re. - Nous allons maintenant voir comment adapter les strat�gies de chargement. Dans Hibernate3 - les m�canismes pour choisir une strat�gie de chargement sont identiques que + D'un autre côté, on veut souvent choisir un chargement par jointure (qui est par + défaut non tardif) à la place du chargement par select dans une transaction particulière. + Nous allons maintenant voir comment adapter les stratégies de chargement. Dans Hibernate3 + les mécanismes pour choisir une stratégie de chargement sont identiques que l'on ait une association vers un objet simple ou vers une collection. </para> </sect2> <sect2 id="performance-fetching-custom" revision="4"> - <title>Personnalisation des strat�gies de chargement</title> + <title>Personnalisation des stratégies de chargement</title> <para> - Le chargement par select (mode par d�faut) est tr�s vuln�rable au probl�me du + Le chargement par select (mode par défaut) est très vulnérable au problème du N+1 selects, du coup vous pouvez avoir envie d'activer le chargement par jointure dans les fichiers de mapping : </para> @@ -198,53 +200,53 @@ <programlisting><![CDATA[<many-to-one name="mother" class="Cat" fetch="join"/>]]></programlisting> <para> - La strat�gie de chargement d�finie � l'aide du mot <literal>fetch</literal> dans les fichiers + La stratégie de chargement définie à l'aide du mot <literal>fetch</literal> dans les fichiers de mapping affecte : </para> <itemizedlist> <listitem> <para> - La r�cup�ration via <literal>get()</literal> ou <literal>load()</literal> + La récupération via <literal>get()</literal> ou <literal>load()</literal> </para> </listitem> <listitem> <para> - La r�cup�ration implicite lorsque l'on navigue � travers une association + La récupération implicite lorsque l'on navigue à travers une association </para> </listitem> <listitem> <para> - Les requ�tes de type <literal>Criteria</literal> + Les requêtes de type <literal>Criteria</literal> </para> </listitem> <listitem> <para> - Les requ�tes HQL si l'on utilise le chargement par <literal>subselect</literal> + Les requêtes HQL si l'on utilise le chargement par <literal>subselect</literal> </para> </listitem> </itemizedlist> <para> - Quelle que soit la strat�gie de chargement que vous utilisez, la partie du graphe - d'objets qui est d�finie comme non "tardive" sera charg�e en m�moire. Cela peut - mener � l'ex�cution de plusieurs selects successifs pour une seule requ�te HQL. + Quelle que soit la stratégie de chargement que vous utilisez, la partie du graphe + d'objets qui est définie comme non "tardive" sera chargée en mémoire. Cela peut + mener à l'exécution de plusieurs selects successifs pour une seule requête HQL. </para> <para> On n'utilise pas souvent les documents de mapping pour adapter le chargement. - Au lieu de cela, on conserve le comportement par d�faut et on le surcharge pour - une transaction particuli�re en utilisant <literal>left join fetch</literal> - dans les requ�tes HQL. Cela indique � hibernate � Hibernate de charger l'association - de mani�re agressive lors du premier select en utilisant une jointure externe. - Dans l'API Criteria vous pouvez utiliser la m�thode + Au lieu de cela, on conserve le comportement par défaut et on le surcharge pour + une transaction particulière en utilisant <literal>left join fetch</literal> + dans les requêtes HQL. Cela indique à hibernate à Hibernate de charger l'association + de manière agressive lors du premier select en utilisant une jointure externe. + Dans l'API Criteria vous pouvez utiliser la méthode <literal>setFetchMode(FetchMode.JOIN)</literal> </para> <para> - Si vous ne vous sentez pas pr�t � modifier la strat�gie de chargement utilis� + Si vous ne vous sentez pas prêt à modifier la stratégie de chargement utilisé par <literal>get()</literal> ou <literal>load()</literal>, vous pouvez juste - utiliser une requ�te de type <literal>Criteria</literal> comme par exemple : + utiliser une requête de type <literal>Criteria</literal> comme par exemple : </para> <programlisting><![CDATA[User user = (User) session.createCriteria(User.class) @@ -253,12 +255,12 @@ .uniqueResult();]]></programlisting> <para> - (Il s'agit de l'�quivalent pour Hibernate de ce que d'autres outils de mapping + (Il s'agit de l'équivalent pour Hibernate de ce que d'autres outils de mapping appellent un "fetch plan" ou "plan de chargement") </para> <para> - Une autre mani�re compl�tement diff�rente d'�viter le probl�me des N+1 selects + Une autre manière complètement différente d'éviter le problème des N+1 selects est d'utiliser le cache de second niveau. </para> @@ -268,34 +270,34 @@ <title>Proxys pour des associations vers un seul objet</title> <para> - Le chargement tardif des collections est impl�ment� par Hibernate en utilisant - ses propres impl�mentations pour des collections persistantes. Si l'on veut un - chargement tardif pour des associations vers un seul objet m�tier il faut utiliser - un autre m�canisme. L'entit� qui est point�e par l'association doit �tre masqu�e - derri�re un proxy. Hibernate impl�mente l'initialisation tardive des proxys sur des - objets persistents via une mise � jour � chaud du bytecode (� l'aide de l'excellente + Le chargement tardif des collections est implémenté par Hibernate en utilisant + ses propres implémentations pour des collections persistantes. Si l'on veut un + chargement tardif pour des associations vers un seul objet métier il faut utiliser + un autre mécanisme. L'entité qui est pointée par l'association doit être masquée + derrière un proxy. Hibernate implémente l'initialisation tardive des proxys sur des + objets persistents via une mise à jour à chaud du bytecode (à l'aide de l'excellente librairie CGLIB). </para> <para> - Par d�faut, Hibernate g�n�re des proxys (au d�marrage) pour toutes les classes + Par défaut, Hibernate génère des proxys (au démarrage) pour toutes les classes persistantes et les utilise pour activer le chargement tardif des associations <literal>many-to-one</literal> et <literal>one-to-one</literal>. </para> <para> - Le fichier de mapping peut d�clarer une interface qui sera utilis�e par le proxy - d'interfa�age pour cette classe � l'aide de l'attribut <literal>proxy</literal>. - Par d�faut Hibernate utilises une sous classe de la classe persistante. - <emphasis>Il faut que les classes pour lesquelles on ajoute un proxy impl�mentent - un constructeur par d�faut de visibilit� au moins package. Ce constructeur est - recommand� pour toutes les classes persistantes !</emphasis> + Le fichier de mapping peut déclarer une interface qui sera utilisée par le proxy + d'interfaçage pour cette classe à l'aide de l'attribut <literal>proxy</literal>. + Par défaut Hibernate utilises une sous classe de la classe persistante. + <emphasis>Il faut que les classes pour lesquelles on ajoute un proxy implémentent + un constructeur par défaut de visibilité au moins package. Ce constructeur est + recommandé pour toutes les classes persistantes !</emphasis> </para> <para> - Il y a quelques pr�cautions � prendre lorsque l'on �tend cette approche � des classes + Il y a quelques précautions à prendre lorsque l'on étend cette approche à des classes polymorphiques, exemple : </para> @@ -307,19 +309,19 @@ </class>]]></programlisting> <para> - Tout d'abord, les instances de <literal>Cat</literal> ne pourront jamais �tre "cast�es" - en <literal>DomesticCat</literal>, m�me si l'instance sous jacente est une instance + Tout d'abord, les instances de <literal>Cat</literal> ne pourront jamais être "castées" + en <literal>DomesticCat</literal>, même si l'instance sous jacente est une instance de <literal>DomesticCat</literal> : </para> - <programlisting><![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instancie un proxy (n'interroge pas la base de donn�es) -if ( cat.isDomesticCat() ) { // interroge la base de donn�es pour initialiser le proxy + <programlisting><![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instancie un proxy (n'interroge pas la base de données) +if ( cat.isDomesticCat() ) { // interroge la base de données pour initialiser le proxy DomesticCat dc = (DomesticCat) cat; // Erreur ! .... }]]></programlisting> <para> - Deuxi�mement, il est possible de casser la notion d'<literal>==</literal> des proxy. + Deuxièmement, il est possible de casser la notion d'<literal>==</literal> des proxy. </para> <programlisting><![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instancie un proxy Cat @@ -328,29 +330,29 @@ System.out.println(cat==dc); // faux]]></programlisting> <para> - Cette situation n'est pas si mauvaise qu'il n'y parait. M�me si nous avons deux - r�f�rences � deux objets proxys diff�rents, l'instance de base sera quand m�me le m�me objet : + Cette situation n'est pas si mauvaise qu'il n'y parait. Même si nous avons deux + références à deux objets proxys différents, l'instance de base sera quand même le même objet : </para> - <programlisting><![CDATA[cat.setWeight(11.0); // interroge la base de donn�es pour initialiser le proxy + <programlisting><![CDATA[cat.setWeight(11.0); // interroge la base de données pour initialiser le proxy System.out.println( dc.getWeight() ); // 11.0]]></programlisting> <para> - Troisi�mement, vous ne pourrez pas utiliser un proxy CGLIB pour une classe <literal>final</literal> - ou pour une classe contenant la moindre m�thode <literal>final</literal>. + Troisièmement, vous ne pourrez pas utiliser un proxy CGLIB pour une classe <literal>final</literal> + ou pour une classe contenant la moindre méthode <literal>final</literal>. </para> <para> - Enfin, si votre objet persistant obtient une ressource � l'instanciation (par - example dans les initialiseurs ou dans le contructeur par d�faut), alors ces ressources + Enfin, si votre objet persistant obtient une ressource à l'instanciation (par + example dans les initialiseurs ou dans le contructeur par défaut), alors ces ressources seront aussi obtenues par le proxy. La classe proxy est vraiment une sous classe de la classe persistante. </para> <para> - Ces probl�mes sont tous dus aux limitations fondamentales du mod�le d'h�ritage unique de Java. - Si vous souhaitez �viter ces probl�mes, vos classes persistantes doivent chacune impl�menter - une interface qui d�clare ses m�thodes m�tier. Vous devriez alors sp�cifier ces interfaces + Ces problèmes sont tous dus aux limitations fondamentales du modèle d'héritage unique de Java. + Si vous souhaitez éviter ces problèmes, vos classes persistantes doivent chacune implémenter + une interface qui déclare ses méthodes métier. Vous devriez alors spécifier ces interfaces dans le fichier de mapping : </para> @@ -362,10 +364,10 @@ </class>]]></programlisting> <para> - o� <literal>CatImpl</literal> impl�mente l'interface <literal>Cat</literal> et <literal>DomesticCatImpl</literal> - impl�mente l'interface <literal>DomesticCat</literal>. Ainsi, des proxys pour les instances de - <literal>Cat</literal> et <literal>DomesticCat</literal> pourraient �tre retourn�es par <literal>load()</literal> - ou <literal>iterate()</literal> (Notez que <literal>list()</literal> ne retourne g�n�ralement pas de proxy). + où <literal>CatImpl</literal> implémente l'interface <literal>Cat</literal> et <literal>DomesticCatImpl</literal> + implémente l'interface <literal>DomesticCat</literal>. Ainsi, des proxys pour les instances de + <literal>Cat</literal> et <literal>DomesticCat</literal> pourraient être retournées par <literal>load()</literal> + ou <literal>iterate()</literal> (Notez que <literal>list()</literal> ne retourne généralement pas de proxy). </para> <programlisting><![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid); @@ -373,13 +375,13 @@ Cat fritz = (Cat) iter.next();]]></programlisting> <para> - Les relations sont aussi initialis�es tardivement. Ceci signifie que vous - devez d�clarer chaque propri�t� comme �tant de type <literal>Cat</literal>, + Les relations sont aussi initialisées tardivement. Ceci signifie que vous + devez déclarer chaque propriété comme étant de type <literal>Cat</literal>, et non <literal>CatImpl</literal>. </para> <para> - Certaines op�rations ne n�cessitent pas l'initialisation du proxy + Certaines opérations ne nécessitent pas l'initialisation du proxy </para> <itemizedlist spacing="compact"> @@ -403,15 +405,15 @@ </itemizedlist> <para> - Hibernate d�tectera les classes qui surchargent <literal>equals()</literal> ou + Hibernate détectera les classes qui surchargent <literal>equals()</literal> ou <literal>hashCode()</literal>. </para> <para> Eh choisissant <literal>lazy="no-proxy"</literal> au lieu de <literal>lazy="proxy"</literal> - qui est la valeur par d�faut, il est possible d'�viter les probl�mes li�s au transtypage. - Il faudra alors une instrumentation du bytecode � la compilation et toutes les op�rations - r�sulterons imm�diatement en une initialisation du proxy. + qui est la valeur par défaut, il est possible d'éviter les problèmes liés au transtypage. + Il faudra alors une instrumentation du bytecode à la compilation et toutes les opérations + résulterons immédiatement en une initialisation du proxy. </para> </sect2> @@ -420,94 +422,94 @@ <title>Initialisation des collections et des proxys</title> <para> - Une exception de type <literal>LazyInitializationException</literal> sera renvoy�e par hibernate - si une collection ou un proxy non initialis� est acc�d� en dehors de la port�e de la <literal>Session</literal>, - e.g. lorsque l'entit� � laquelle appartient la collection ou qui a une r�f�rence vers le proxy est - dans l'�tat "d�tach�e". + Une exception de type <literal>LazyInitializationException</literal> sera renvoyée par hibernate + si une collection ou un proxy non initialisé est accédé en dehors de la portée de la <literal>Session</literal>, + e.g. lorsque l'entité à laquelle appartient la collection ou qui a une référence vers le proxy est + dans l'état "détachée". </para> <para> - Parfois, nous devons nous assurer qu'un proxy ou une collection est initialis�e avant de - fermer la <literal>Session</literal>. Bien s�r, nous pouvons toujours forcer l'initialisation + Parfois, nous devons nous assurer qu'un proxy ou une collection est initialisée avant de + fermer la <literal>Session</literal>. Bien sûr, nous pouvons toujours forcer l'initialisation en appelant par exemple <literal>cat.getSex()</literal> ou <literal>cat.getKittens().size()</literal>. - Mais ceci n'est pas tr�s lisible pour les personnes parcourant le code et n'est pas tr�s g�n�rique. + Mais ceci n'est pas très lisible pour les personnes parcourant le code et n'est pas très générique. </para> <para> - Les m�thodes statiques <literal>Hibernate.initialize()</literal> et <literal>Hibernate.isInitialized()</literal> - fournissent � l'application un moyen de travailler avec des proxys ou des collections initialis�s. + Les méthodes statiques <literal>Hibernate.initialize()</literal> et <literal>Hibernate.isInitialized()</literal> + fournissent à l'application un moyen de travailler avec des proxys ou des collections initialisés. <literal>Hibernate.initialize(cat)</literal> forcera l'initialisation d'un proxy de <literal>cat</literal>, si tant est que sa <literal>Session</literal> est ouverte. <literal>Hibernate.initialize( cat.getKittens() )</literal> - a le m�me effet sur la collection kittens. + a le même effet sur la collection kittens. </para> <para> - Une autre option est de conserver la <literal>Session</literal> ouverte jusqu'� - ce que toutes les collections et tous les proxys aient �t� charg�s. Dans certaines - architectures applicatives, particuli�rement celles ou le code d'acc�s aux donn�es - via hiberante et le code qui utilise ces donn�es sont dans des couches applicatives - diff�rentes ou des processus physiques diff�rents, il peut devenir probl�matique + Une autre option est de conserver la <literal>Session</literal> ouverte jusqu'à + ce que toutes les collections et tous les proxys aient été chargés. Dans certaines + architectures applicatives, particulièrement celles ou le code d'accès aux données + via hiberante et le code qui utilise ces données sont dans des couches applicatives + différentes ou des processus physiques différents, il peut devenir problématique de garantir que la <literal>Session</literal> est ouverte lorsqu'une collection - est initialis�e. Il y a deux moyens de traiter ce probl�me : + est initialisée. Il y a deux moyens de traiter ce problème : </para> <itemizedlist> <listitem> <para> - Dans une application web, un filtre de servlet peut �tre utilis� pour - fermer la <literal>Session</literal> uniquement lorsque la requ�te - a �t� enti�rement trait�e, lorsque le rendu de la vue est fini + Dans une application web, un filtre de servlet peut être utilisé pour + fermer la <literal>Session</literal> uniquement lorsque la requête + a été entièrement traitée, lorsque le rendu de la vue est fini (il s'agit du pattern <emphasis>Open Session in View</emphasis>). - Bien s�r, cela demande plus d'attention � la bonne gestion des exceptions + Bien sûr, cela demande plus d'attention à la bonne gestion des exceptions de l'application. Il est d'une importance vitale que la <literal>Session</literal> - soit ferm�e et la transaction termin�e avant que l'on rende la main � l'utilisateur - m�me si une exception survient durant le traitement de la vue. + soit fermée et la transaction terminée avant que l'on rende la main à l'utilisateur + même si une exception survient durant le traitement de la vue. Voir le wiki Hibernate pour des exemples sur le pattern "Open Session in View". </para> </listitem> <listitem> <para> - Dans une application avec une couche m�tier s�par�e, la couche contenant - la logique m�tier doit "pr�parer" toutes les collections qui seront - n�cessaires � la couche web avant de retourner les donn�es. Cela signifie - que la couche m�tier doit charger toutes les donn�es et retourner toutes - les donn�es d�j� initialis�es � la couche de pr�sentation/web pour un - cas d'utilisation donn�. En g�n�ral l'application appelle la m�thode - <literal>Hibernate.initialize()</literal> pour chaque collection n�cessaire - dans la couche web (cet appel doit �tre fait avant la fermeture de la session) - ou bien r�cup�re les collections de mani�re agressive � l'aide d'une requ�te - HQL avec une clause <literal>FETCH</literal> ou � l'aide du mode - <literal>FetchMode.JOIN</literal> pour une requ�te de type <literal>Criteria</literal>. - Cela est en g�n�ral plus facile si vous utilisez le pattern <emphasis>Command</emphasis> - plut�t que <emphasis>Session Facade</emphasis>. + Dans une application avec une couche métier séparée, la couche contenant + la logique métier doit "préparer" toutes les collections qui seront + nécessaires à la couche web avant de retourner les données. Cela signifie + que la couche métier doit charger toutes les données et retourner toutes + les données déjà initialisées à la couche de présentation/web pour un + cas d'utilisation donné. En général l'application appelle la méthode + <literal>Hibernate.initialize()</literal> pour chaque collection nécessaire + dans la couche web (cet appel doit être fait avant la fermeture de la session) + ou bien récupère les collections de manière agressive à l'aide d'une requête + HQL avec une clause <literal>FETCH</literal> ou à l'aide du mode + <literal>FetchMode.JOIN</literal> pour une requête de type <literal>Criteria</literal>. + Cela est en général plus facile si vous utilisez le pattern <emphasis>Command</emphasis> + plutôt que <emphasis>Session Facade</emphasis>. </para> </listitem> <listitem> <para> - Vous pouvez �galement attacher � une <literal>Session</literal> un objet charg� - au pr�alable � l'aide des m�thodes <literal>merge()</literal> ou <literal>lock()</literal> - avant d'acc�der aux collections (ou aux proxys) non initialis�s. Non, Hibernate ne + Vous pouvez également attacher à une <literal>Session</literal> un objet chargé + au préalable à l'aide des méthodes <literal>merge()</literal> ou <literal>lock()</literal> + avant d'accéder aux collections (ou aux proxys) non initialisés. Non, Hibernate ne fait pas, et ne doit pas faire, cela automatiquement car cela pourrait introduire - une s�mantique transactionnelle ad hoc. + une sémantique transactionnelle ad hoc. </para> </listitem> </itemizedlist> <para> - Parfois, vous ne voulez pas initialiser une grande collection mais vous avez quand m�me - besoin d'informations sur elle (comme sa taille) ou un sous ensemble de ses donn�es + Parfois, vous ne voulez pas initialiser une grande collection mais vous avez quand même + besoin d'informations sur elle (comme sa taille) ou un sous ensemble de ses données </para> <para> - Vous pouvez utiliser un filtre de collection pour r�cup�rer sa taille sans l'initialiser : + Vous pouvez utiliser un filtre de collection pour récupérer sa taille sans l'initialiser : </para> <programlisting><![CDATA[( (Integer) s.createFilter( collection, "select count(*)" ).list().get(0) ).intValue()]]></programlisting> <para> - La m�thode <literal>createFilter()</literal> est �galement utilis�e pour r�cup�rer - de mani�re efficace des sous ensembles d'une collection sans avoir besoin de l'initialiser + La méthode <literal>createFilter()</literal> est également utilisée pour récupérer + de manière efficace des sous ensembles d'une collection sans avoir besoin de l'initialiser dans son ensemble. </para> @@ -520,40 +522,40 @@ <title>Utiliser le chargement par lot</title> <para> - Pour am�liorer les performances, Hibernate peut utiliser le chargement par lot - ce qui veut dire qu'Hibernate peut charger plusieurs proxys (ou collections) non initialis�s en une seule - requ�te lorsque l'on acc�de � l'un de ces proxys. Le chargement par lot est une optimisation - intimement li�e � la strat�gie de chargement tardif par select. Il y a deux moyens d'activer le + Pour améliorer les performances, Hibernate peut utiliser le chargement par lot + ce qui veut dire qu'Hibernate peut charger plusieurs proxys (ou collections) non initialisés en une seule + requête lorsque l'on accède à l'un de ces proxys. Le chargement par lot est une optimisation + intimement liée à la stratégie de chargement tardif par select. Il y a deux moyens d'activer le chargement par lot : au niveau de la classe et au niveau de la collection. </para> <para> - Le chargement par lot pour les classes/entit�s est plus simple � comprendre. Imaginez que vous ayez la - situation suivante � l'ex�cution : vous avez 25 instances de <literal>Cat</literal> - charg�es dans une <literal>Session</literal>, chaque <literal>Cat</literal> a une r�f�rence - � son <literal>owner</literal>, une <literal>Person</literal>. - La classe <literal>Person</literal> est mapp�e avec un proxy, <literal>lazy="true"</literal>. - Si vous it�rez sur tous les cats et appelez <literal>getOwner()</literal> sur chacun d'eux, - Hibernate ex�cutera par d�faut 25 <literal>SELECT</literal>, pour charger les owners - (initialiser le proxy). Vous pouvez param�trer ce comportement en sp�cifiant une + Le chargement par lot pour les classes/entités est plus simple à comprendre. Imaginez que vous ayez la + situation suivante à l'exécution : vous avez 25 instances de <literal>Cat</literal> + chargées dans une <literal>Session</literal>, chaque <literal>Cat</literal> a une référence + à son <literal>owner</literal>, une <literal>Person</literal>. + La classe <literal>Person</literal> est mappée avec un proxy, <literal>lazy="true"</literal>. + Si vous itérez sur tous les cats et appelez <literal>getOwner()</literal> sur chacun d'eux, + Hibernate exécutera par défaut 25 <literal>SELECT</literal>, pour charger les owners + (initialiser le proxy). Vous pouvez paramétrer ce comportement en spécifiant une <literal>batch-size</literal> (taille du lot) dans le mapping de <literal>Person</literal> : </para> <programlisting><![CDATA[<class name="Person" batch-size="10">...</class>]]></programlisting> <para> - Hibernate ex�cutera d�sormais trois requ�tes, en chargeant respectivement 10, - 10, et 5 entit�s. + Hibernate exécutera désormais trois requêtes, en chargeant respectivement 10, + 10, et 5 entités. </para> <para> Vous pouvez aussi activer le chargement par lot pour les collections. Par exemple, - si chaque <literal>Person</literal> a une collection charg�e tardivement de - <literal>Cat</literal>s, et que 10 personnes sont actuellement charg�es dans la - <literal>Session</literal>, it�rer sur toutes les persons g�n�rera 10 <literal>SELECT</literal>s, + si chaque <literal>Person</literal> a une collection chargée tardivement de + <literal>Cat</literal>s, et que 10 personnes sont actuellement chargées dans la + <literal>Session</literal>, itérer sur toutes les persons générera 10 <literal>SELECT</literal>s, un pour chaque appel de <literal>getCats()</literal>. Si vous activez le chargement par lot pour la collection <literal>cats</literal> dans le mapping de <literal>Person</literal>, Hibernate pourra - pr�charger les collections : + précharger les collections : </para> <programlisting><![CDATA[<class name="Person"> @@ -565,15 +567,15 @@ <para> Avec une taille de lot (<literal>batch-size</literal>) de 3, Hibernate chargera respectivement 3, 3, 3, et 1 collections en quatre <literal>SELECT</literal>s. - Encore une fois, la valeur de l'attribut d�pend du nombre de collections - non initialis�es dans une <literal>Session</literal> particuli�re. + Encore une fois, la valeur de l'attribut dépend du nombre de collections + non initialisées dans une <literal>Session</literal> particulière. </para> <para> - Le chargement par lot de collections est particuli�rement utile si vous avez des - arborescenses r�cursives d'�l�ments (typiquement, le sch�ma facture de - mat�riels). (Bien qu'un <emphasis>sous ensemble</emphasis> ou un - <emphasis>chemin mat�rialis�</emphasis> est sans doute une meilleure option pour + Le chargement par lot de collections est particulièrement utile si vous avez des + arborescenses récursives d'éléments (typiquement, le schéma facture de + matériels). (Bien qu'un <emphasis>sous ensemble</emphasis> ou un + <emphasis>chemin matérialisé</emphasis> est sans doute une meilleure option pour des arbres principalement en lecture.) </para> @@ -583,9 +585,9 @@ <title>Utilisation du chargement par sous select</title> <para> - Si une collection ou un proxy vers un objet doit �tre charg�, Hibernate va tous les - charger en r�-ex�cutant la requ�te orignial dans un sous select. Cela fonctionne de la - m�me mani�re que le chargement par lot sans la possibilit� de fragmenter le chargement. + Si une collection ou un proxy vers un objet doit être chargé, Hibernate va tous les + charger en ré-exécutant la requête orignial dans un sous select. Cela fonctionne de la + même manière que le chargement par lot sans la possibilité de fragmenter le chargement. </para> <!-- TODO: Write more about this --> @@ -593,21 +595,21 @@ </sect2> <sect2 id="performance-fetching-lazyproperties"> - <title>Utiliser le chargement tardif des propri�t�s</title> + <title>Utiliser le chargement tardif des propriétés</title> <para> - Hibernate3 supporte le chargement tardif de propri�t�s individuelles. La technique - d'optimisation est �galement connue sous le nom de <emphasis>fetch groups</emphasis> (groupes - de chargement). Il faut noter qu'il s'agit principalement d'une fonctionnalit� marketing + Hibernate3 supporte le chargement tardif de propriétés individuelles. La technique + d'optimisation est également connue sous le nom de <emphasis>fetch groups</emphasis> (groupes + de chargement). Il faut noter qu'il s'agit principalement d'une fonctionnalité marketing car en pratique l'optimisation de la lecture d'un enregistrement est beaucoup plus importante - que l'optimisation de la lecture d'une colonne. Cependant, la restriction du chargement � - certaines colonnes peut �tre pratique dans des cas extr�mes, lorsque des tables "legacy" - poss�dent des centaines de colonnes et que le mod�le de donn�es ne peut pas �tre am�lior�. + que l'optimisation de la lecture d'une colonne. Cependant, la restriction du chargement à + certaines colonnes peut être pratique dans des cas extrèmes, lorsque des tables "legacy" + possèdent des centaines de colonnes et que le modèle de données ne peut pas être amélioré. </para> <para> - Pour activer le chargement tardif d'une propri�t�, il faut mettre l'attribut <literal>lazy</literal> - sur une propri�t� particuli�re du mapping : + Pour activer le chargement tardif d'une propriété, il faut mettre l'attribut <literal>lazy</literal> + sur une propriété particulière du mapping : </para> <programlisting><![CDATA[<class name="Document"> @@ -620,13 +622,13 @@ </class>]]></programlisting> <para> - Le chargement tardif des propri�t�s requiert une instrumentation du bytecode lors de la - compilation ! Si les classes persistantes ne sont pas instrument�es, Hibernate ignorera de - mani�re silencieuse le mode tardif et retombera dans le mode de chargement imm�diat. + Le chargement tardif des propriétés requiert une instrumentation du bytecode lors de la + compilation ! Si les classes persistantes ne sont pas instrumentées, Hibernate ignorera de + manière silencieuse le mode tardif et retombera dans le mode de chargement immédiat. </para> <para> - Pour l'instrumentation du bytecode vous pouvez utiliser la t�che Ant suivante : + Pour l'instrumentation du bytecode vous pouvez utiliser la tâche Ant suivante : </para> <programlisting><![CDATA[<target name="instrument" depends="compile"> @@ -644,16 +646,16 @@ </target>]]></programlisting> <para> - Une autre fa�on (meilleure ?) pour �viter de lire plus de colonnes que - n�cessaire au moins pour des transactions en lecture seule est d'utiliser - les fonctionnalit�s de projection des requ�tes HQL ou Criteria. Cela �vite - de devoir instrumenter le bytecode � la compilation et est certainement une - solution pr�f�rable. + Une autre façon (meilleure ?) pour éviter de lire plus de colonnes que + nécessaire au moins pour des transactions en lecture seule est d'utiliser + les fonctionnalités de projection des requêtes HQL ou Criteria. Cela évite + de devoir instrumenter le bytecode à la compilation et est certainement une + solution préférable. </para> <para> - Vous pouvez forcer le mode de chargement agressif des propri�t�s en utilisant - <literal>fetch all properties</literal> dans les requ�ts HQL. + Vous pouvez forcer le mode de chargement agressif des propriétés en utilisant + <literal>fetch all properties</literal> dans les requêts HQL. </para> </sect2> @@ -664,21 +666,21 @@ <para> Une <literal>Session</literal> Hibernate est un cache de niveau transactionnel - des donn�es persistantes. Il est possible de configurer un cache de cluster ou de JVM - (de niveau <literal>SessionFactory</literal> pour �tre exact) d�fini classe par classe - et collection par collection. Vous pouvez m�me utiliser votr choix de cache - en impl�mentant le pourvoyeur (provider) associ�. + des données persistantes. Il est possible de configurer un cache de cluster ou de JVM + (de niveau <literal>SessionFactory</literal> pour être exact) défini classe par classe + et collection par collection. Vous pouvez même utiliser votr choix de cache + en implémentant le pourvoyeur (provider) associé. Faites attention, les caches ne sont jamais avertis des modifications faites - dans la base de donn�es par d'autres applications (ils peuvent cependant �tre - configur�s pour r�guli�rement expirer les donn�es en cache). + dans la base de données par d'autres applications (ils peuvent cependant être + configurés pour régulièrement expirer les données en cache). </para> <para> - Par d�faut, Hibernate utilise EHCache comme cache de niveau JVM (le support - de JCS est d�sormais d�pr�ci� et sera enlev� des futures versions d'Hibernate). - Vous pouvez choisir une autre impl�mentation en sp�cifiant le nom de la classe qui - impl�mente <literal>org.hibernate.cache.CacheProvider</literal> en utilisant - la propri�t� <literal>hibernate.cache.provider_class</literal>. + Par défaut, Hibernate utilise EHCache comme cache de niveau JVM (le support + de JCS est désormais déprécié et sera enlevé des futures versions d'Hibernate). + Vous pouvez choisir une autre implémentation en spécifiant le nom de la classe qui + implémente <literal>org.hibernate.cache.CacheProvider</literal> en utilisant + la propriété <literal>hibernate.cache.provider_class</literal>. </para> <table frame="topbot" id="cacheproviders" revision="1"> @@ -695,28 +697,28 @@ <entry>Classe pourvoyeuse</entry> <entry>Type</entry> <entry>Support en Cluster</entry> - <entry>Cache de requ�tes support�</entry> + <entry>Cache de requêtes supporté</entry> </row> </thead> <tbody> <row> <entry>Hashtable (ne pas utiliser en production)</entry> <entry><literal>org.hibernate.cache.HashtableCacheProvider</literal></entry> - <entry>m�moire</entry> + <entry>mémoire</entry> <entry></entry> <entry>oui</entry> </row> <row> <entry>EHCache</entry> <entry><literal>org.hibernate.cache.EhCacheProvider</literal></entry> - <entry>m�moire, disque</entry> + <entry>mémoire, disque</entry> <entry></entry> <entry>oui</entry> </row> <row> <entry>OSCache</entry> <entry><literal>org.hibernate.cache.OSCacheProvider</literal></entry> - <entry>m�moire, disque</entry> + <entry>mémoire, disque</entry> <entry>oui (invalidation de cluster)</entry> <entry>oui</entry> </row> @@ -732,7 +734,7 @@ <entry><literal>org.hibernate.cache.TreeCacheProvider</literal></entry> <entry>en cluster (multicast ip), transactionnel</entry> <entry>oui (replication)</entry> - <entry>oui (horloge sync. n�cessaire)</entry> + <entry>oui (horloge sync. nécessaire)</entry> </row> </tbody> </tgroup> @@ -742,7 +744,7 @@ <title>Mapping de Cache</title> <para> - L'�l�ment <literal>&lt;cache&gt;</literal> d'une classe ou d'une collection � + L'élément <literal>&lt;cache&gt;</literal> d'une classe ou d'une collection à la forme suivante : </para> @@ -760,39 +762,39 @@ <calloutlist> <callout arearefs="cache1"> <para> - <literal>usage</literal> (requis) sp�cifie la strat�gie de cache : + <literal>usage</literal> (requis) spécifie la stratégie de cache : <literal>transactionel</literal>, - <literal>lecture-�criture</literal>, - <literal>lecture-�criture non stricte</literal> ou + <literal>lecture-écriture</literal>, + <literal>lecture-écriture non stricte</literal> ou <literal>lecture seule</literal> </para> </callout> <callout arearefs="cache2"> <para> - <literal>region</literal> (optionnel, par d�faut il s'agit du nom - de la classe ou du nom de role de la collection) sp�cifie le nom de la - r�gion du cache de second niveau + <literal>region</literal> (optionnel, par défaut il s'agit du nom + de la classe ou du nom de role de la collection) spécifie le nom de la + région du cache de second niveau </para> </callout> <callout arearefs="cache3"> <para> - <literal>include</literal> (optionnel, par d�faut <literal>all</literal>) - <literal>non-lazy</literal> sp�cifie que les propri�t�s des entit�s mapp�es avec - <literal>lazy="true"</literal> ne doivent pas �tre mises en cache lorsque - le chargement tardif des attributs est activ�. + <literal>include</literal> (optionnel, par défaut <literal>all</literal>) + <literal>non-lazy</literal> spécifie que les propriétés des entités mappées avec + <literal>lazy="true"</literal> ne doivent pas être mises en cache lorsque + le chargement tardif des attributs est activé. </para> </callout> </calloutlist> </programlistingco> <para> - Alternativement (voir pr�f�rentiellement), vous pouvez sp�cifier les �l�ments + Alternativement (voir préférentiellement), vous pouvez spécifier les éléments <literal>&lt;class-cache&gt;</literal> et <literal>&lt;collection-cache&gt;</literal> dans <literal>hibernate.cfg.xml</literal>. </para> <para> - L'attribut <literal>usage</literal> sp�cifie une <emphasis>strat�gie de concurrence d'acc�s au cache</emphasis>. + L'attribut <literal>usage</literal> spécifie une <emphasis>stratégie de concurrence d'accès au cache</emphasis>. </para> </sect2> @@ -802,8 +804,8 @@ <para> Si votre application a besoin de lire mais ne modifie jamais les instances d'une classe, - un cache <literal>read-only</literal> peut �tre utilis�. C'est la strat�gie la plus simple - et la plus performante. Elle est m�me parfaitement s�re dans un cluster. + un cache <literal>read-only</literal> peut être utilisé. C'est la stratégie la plus simple + et la plus performante. Elle est même parfaitement sûre dans un cluster. </para> <programlisting><![CDATA[<class name="eg.Immutable" mutable="false"> @@ -815,19 +817,19 @@ <sect2 id="performance-cache-readwrite"> - <title>Strat�gie : lecture/�criture</title> + <title>Stratégie : lecture/écriture</title> <para> - Si l'application a besoin de mettre � jour des donn�es, un cache <literal>read-write</literal> peut - �tre appropri�. Cette strat�gie ne devrait jamais �tre utilis�e si votre application - n�cessite un niveau d'isolation transactionnelle s�rialisable. Si le cache est utilis� - dans un environnement JTA, vous devez sp�cifier - <literal>hibernate.transaction.manager_lookup_class</literal>, fournissant une strat�gie pour obtenir + Si l'application a besoin de mettre à jour des données, un cache <literal>read-write</literal> peut + être approprié. Cette stratégie ne devrait jamais être utilisée si votre application + nécessite un niveau d'isolation transactionnelle sérialisable. Si le cache est utilisé + dans un environnement JTA, vous devez spécifier + <literal>hibernate.transaction.manager_lookup_class</literal>, fournissant une stratégie pour obtenir le <literal>TransactionManager</literal> JTA. Dans d'autres environnements, vous devriez vous assurer - que la transation est termin�e � l'appel de <literal>Session.close()</literal> - ou <literal>Session.disconnect()</literal>. Si vous souhaitez utiliser cette strat�gie - dans un cluster, vous devriez vous assurer que l'impl�mentation de cache utilis�e supporte - le v�rrouillage. Ce que ne font <emphasis>pas</emphasis> les pourvoyeurs caches fournis. + que la transation est terminée à l'appel de <literal>Session.close()</literal> + ou <literal>Session.disconnect()</literal>. Si vous souhaitez utiliser cette stratégie + dans un cluster, vous devriez vous assurer que l'implémentation de cache utilisée supporte + le vérrouillage. Ce que ne font <emphasis>pas</emphasis> les pourvoyeurs caches fournis. </para> <programlisting><![CDATA[<class name="eg.Cat" .... > @@ -842,40 +844,40 @@ </sect2> <sect2 id="performance-cache-nonstrict"> - <title>Strat�gie : lecture/�criture non stricte</title> + <title>Stratégie : lecture/écriture non stricte</title> <para> - Si l'application besoin de mettre � jour les donn�es de mani�re occasionnelle - (qu'il est tr�s peu probable que deux transactions essaient de mettre � jour le m�me - �l�ment simultan�ment) et qu'une isolation transactionnelle stricte n'est pas n�cessaire, - un cache <literal>nonstrict-read-write</literal> peut �tre appropri�. Si le cache est - utilis� dans un environnement JTA, vous devez sp�cifier + Si l'application besoin de mettre à jour les données de manière occasionnelle + (qu'il est très peu probable que deux transactions essaient de mettre à jour le même + élément simultanément) et qu'une isolation transactionnelle stricte n'est pas nécessaire, + un cache <literal>nonstrict-read-write</literal> peut être approprié. Si le cache est + utilisé dans un environnement JTA, vous devez spécifier <literal>hibernate.transaction.manager_lookup_class</literal>. Dans d'autres - environnements, vous devriez vous assurer que la transation est termin�e � l'appel + environnements, vous devriez vous assurer que la transation est terminée à l'appel de <literal>Session.close()</literal> ou <literal>Session.disconnect()</literal> </para> </sect2> <sect2 id="performance-cache-transactional"> - <title>Strat�gie : transactionelle</title> + <title>Stratégie : transactionelle</title> <para> - La strat�gie de cache <literal>transactional</literal> supporte un cache - compl�tement transactionnel comme, par exemple, JBoss TreeCache. Un tel cache ne - peut �tre utilis� que dans un environnement JTA et vous devez sp�cifier + La stratégie de cache <literal>transactional</literal> supporte un cache + complètement transactionnel comme, par exemple, JBoss TreeCache. Un tel cache ne + peut être utilisé que dans un environnement JTA et vous devez spécifier <literal>hibernate.transaction.manager_lookup_class</literal>. </para> </sect2> <para> - Aucun des caches livr�s ne supporte toutes les strat�gies de concurrence. Le tableau suivant montre - quels caches sont compatibles avec quelles strat�gies de concurrence. + Aucun des caches livrés ne supporte toutes les stratégies de concurrence. Le tableau suivant montre + quels caches sont compatibles avec quelles stratégies de concurrence. </para> <table frame="topbot"> - <title>Strat�gie de concurrence du cache</title> + <title>Stratégie de concurrence du cache</title> <tgroup cols='5' align='left' colsep='1' rowsep='1'> <colspec colname='c1' colwidth="1*"/> <colspec colname='c2' colwidth="1*"/> @@ -886,8 +888,8 @@ <row> <entry>Cache</entry> <entry>read-only (lecture seule)</entry> - <entry>nonstrict-read-write (lecture-�criture non stricte)</entry> - <entry>read-write (lecture-�riture)</entry> + <entry>nonstrict-read-write (lecture-écriture non stricte)</entry> + <entry>read-write (lecture-ériture)</entry> <entry>transactional (transactionnel)</entry> </row> </thead> @@ -934,21 +936,21 @@ </sect1> <sect1 id="performance-sessioncache" revision="2"> - <title>G�rer les caches</title> + <title>Gérer les caches</title> <para> - A chaque fois que vous passez un objet � la m�thode <literal>save()</literal>, - <literal>update()</literal> ou <literal>saveOrUpdate()</literal> et � chaque fois - que vous r�cup�rez un objet avec <literal>load()</literal>, <literal>get()</literal>, + A chaque fois que vous passez un objet à la méthode <literal>save()</literal>, + <literal>update()</literal> ou <literal>saveOrUpdate()</literal> et à chaque fois + que vous récupérez un objet avec <literal>load()</literal>, <literal>get()</literal>, <literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()</literal>, - cet objet est ajout� au cache interne de la <literal>Session</literal>. + cet objet est ajouté au cache interne de la <literal>Session</literal>. </para> <para> - Lorsqu'il y a un appel � la m�thode <literal>flush()</literal>, l'�tat de cet objet - va �tre synchronis� avec la base de donn�es. Si vous ne voulez pas que cette synchronisation - ait lieu ou si vous traitez un grand nombre d'objets et que vous avez besoin de g�rer - la m�moire de mani�re efficace, vous pouvez utiliser la m�thode <literal>evict()</literal> - pour supprimer l'objet et ses collections d�pendantes du cache de la session + Lorsqu'il y a un appel à la méthode <literal>flush()</literal>, l'état de cet objet + va être synchronisé avec la base de données. Si vous ne voulez pas que cette synchronisation + ait lieu ou si vous traitez un grand nombre d'objets et que vous avez besoin de gérer + la mémoire de manière efficace, vous pouvez utiliser la méthode <literal>evict()</literal> + pour supprimer l'objet et ses collections dépendantes du cache de la session </para> <programlisting><![CDATA[ScrollableResult cats = sess.createQuery("from Cat as cat").scroll(); //a huge result set @@ -959,7 +961,7 @@ }]]></programlisting> <para> - La <literal>Session</literal> dispose aussi de la m�thode <literal>contains()</literal> pour d�terminer + La <literal>Session</literal> dispose aussi de la méthode <literal>contains()</literal> pour déterminer si une instance appartient au cache de la session. </para> @@ -968,10 +970,10 @@ </para> <para> - Pour le cache de second niveau, il existe des m�thodes d�finies dans + Pour le cache de second niveau, il existe des méthodes définies dans <literal>SessionFactory</literal> pour retirer des instances du cache, - la classe enti�re, une instance de collection ou - le r�le entier d'une collection. + la classe entière, une instance de collection ou + le rôle entier d'une collection. </para> <programlisting><![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular Cat @@ -980,39 +982,39 @@ sessionFactory.evictCollection("Cat.kittens"); //evict all kitten collections]]></programlisting> <para> - Le <literal>CacheMode</literal> contr�le comme une session particuli�re interragit avec le + Le <literal>CacheMode</literal> contrôle comme une session particulière interragit avec le cache de second niveau </para> <itemizedlist> <listitem> <para> - <literal>CacheMode.NORMAL</literal> - lit et �crit les items dans le cache de second niveau + <literal>CacheMode.NORMAL</literal> - lit et écrit les items dans le cache de second niveau </para> </listitem> <listitem> <para> <literal>CacheMode.GET</literal> - lit les items dans le cache de second niveau mais ne - les �crit pas sauf dans le cache d'une mise � jour d'une donn�e + les écrit pas sauf dans le cache d'une mise à jour d'une donnée </para> </listitem> <listitem> <para> - <literal>CacheMode.PUT</literal> - �crit les items dans le cache de second niveau mais ne les + <literal>CacheMode.PUT</literal> - écrit les items dans le cache de second niveau mais ne les lit pas dans le cache de second niveau </para> </listitem> <listitem> <para> - <literal>CacheMode.REFRESH</literal> - �crit les items dans le cache de second niveau mais ne les + <literal>CacheMode.REFRESH</literal> - écrit les items dans le cache de second niveau mais ne les lit pas dans le cache de second niveau, outrepasse l'effet de<literal>hibernate.cache.use_minimal_puts</literal>, - en for�ant un rafra�chissement du cache de second niveau pour chaque item lu dans la base + en forçant un rafraîchissement du cache de second niveau pour chaque item lu dans la base </para> </listitem> </itemizedlist> <para> - Pour parcourir le contenu du cache de second niveau ou la r�gion du cache d�di�e au requ�tes, vous + Pour parcourir le contenu du cache de second niveau ou la région du cache dédiée au requêtes, vous pouvez utiliser l'API <literal>Statistics</literal> API: </para> @@ -1022,8 +1024,8 @@ .getEntries();]]></programlisting> <para> - Vous devez pour cela activer les statistiques et optionnellement forcer Hibernate � conserver les entr�es dans le - cache sous un format plus compr�hensible pour l'utilisateur : + Vous devez pour cela activer les statistiques et optionnellement forcer Hibernate à conserver les entrées dans le + cache sous un format plus compréhensible pour l'utilisateur : </para> <programlisting><![CDATA[hibernate.generate_statistics true @@ -1032,37 +1034,37 @@ </sect1> <sect1 id="performance-querycache" revision="1"> - <title>Le cache de requ�tes</title> + <title>Le cache de requêtes</title> <para> - Les r�sultats d'une requ�te peuvent aussi �tre plac�s en cache. Ceci n'est utile - que pour les requ�tes qui sont ex�cut�es avec les m�mes param�tres. Pour utiliser - le cache de requ�tes, vous devez d'abord l'activer : + Les résultats d'une requête peuvent aussi être placés en cache. Ceci n'est utile + que pour les requêtes qui sont exécutées avec les mêmes paramètres. Pour utiliser + le cache de requêtes, vous devez d'abord l'activer : </para> <programlisting><![CDATA[hibernate.cache.use_query_cache true]]></programlisting> <para> - Ce param�tre am�ne la cr�ation de deux nouvelles r�gions dans le cache, une qui va conserver - le r�sultat des requ�tes mises en cache (<literal>org.hibernate.cache.StandardQueryCache</literal>) - et l'autre qui va conserver l'horodatage des mises � jour les plus r�centes effectu�es sur les - tables requ�tables (<literal>org.hibernate.cache.UpdateTimestampsCache</literal>). - Il faut noter que le cache de requ�te ne conserve pas l'�tat des entit�s, il met en cache + Ce paramètre amène la création de deux nouvelles régions dans le cache, une qui va conserver + le résultat des requêtes mises en cache (<literal>org.hibernate.cache.StandardQueryCache</literal>) + et l'autre qui va conserver l'horodatage des mises à jour les plus récentes effectuées sur les + tables requêtables (<literal>org.hibernate.cache.UpdateTimestampsCache</literal>). + Il faut noter que le cache de requête ne conserve pas l'état des entités, il met en cache uniquement les valeurs de l'identifiant et les valeurs de types de base (?). Le cache - de requ�te doit toujours �tre utilis� avec le cache de second niveau pour �tre efficace. + de requête doit toujours être utilisé avec le cache de second niveau pour être efficace. </para> <para> - La plupart des requ�tes ne retirent pas de b�n�fice pas du cache, - donc par d�faut les requ�tes ne sont pas mises en cache. Pour activer le cache, + La plupart des requêtes ne retirent pas de bénéfice pas du cache, + donc par défaut les requêtes ne sont pas mises en cache. Pour activer le cache, appelez <literal>Query.setCacheable(true)</literal>. - Cet appel permet de v�rifier si les r�sultats sont en cache ou non, voire - d'ajouter ces r�sultats si la requ�te est ex�cut�e. + Cet appel permet de vérifier si les résultats sont en cache ou non, voire + d'ajouter ces résultats si la requête est exécutée. </para> <para> - Si vous avez besoin de contr�ler finement les d�lais d'expiration du cache, vous - pouvez sp�cifier une r�gion de cache nomm�e pour une requ�te particuli�re en + Si vous avez besoin de contrôler finement les délais d'expiration du cache, vous + pouvez spécifier une région de cache nommée pour une requête particulière en appelant <literal>Query.setCacheRegion()</literal>. </para> @@ -1074,12 +1076,12 @@ .list();]]></programlisting> <para> - Si une requ�te doit forcer le rafra�chissement de sa r�gion de cache, vous devez - appeler <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. C'est particuli�rement - utile lorsque les donn�es peuvent avoir �t� mises � jour par un processus s�par� (e.g. elles - n'ont pas �t� modifi�es par Hibernate). Cela permet � l'application de rafra�chir de - mani�re s�lective les r�sultats d'une requ�te particuli�re. Il s'agit d'une alternative plus - efficace � l'�viction d'une r�gion du cache � l'aide de la m�thode + Si une requête doit forcer le rafraîchissement de sa région de cache, vous devez + appeler <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. C'est particulièrement + utile lorsque les données peuvent avoir été mises à jour par un processus séparé (e.g. elles + n'ont pas été modifiées par Hibernate). Cela permet à l'application de rafraîchir de + manière sélective les résultats d'une requête particulière. Il s'agit d'une alternative plus + efficace à l'éviction d'une région du cache à l'aide de la méthode <literal>SessionFactory.evictQueries()</literal>. </para> @@ -1088,15 +1090,15 @@ <title>Comprendre les performances des Collections</title> <para> - Nous avons d�j� pass� du temps � discuter des collections. + Nous avons déjà passé du temps à discuter des collections. Dans cette section, nous allons traiter du comportement des - collections � l'ex�cution. + collections à l'exécution. </para> <sect2 id="performance-collections-taxonomy"> <title>Classification</title> - <para>Hibernate d�finit trois types de collections :</para> + <para>Hibernate définit trois types de collections :</para> <itemizedlist> <listitem> @@ -1111,17 +1113,17 @@ </itemizedlist> <para> - Cette classification distingue les diff�rentes relations entre les tables - et les cl�s �trang�res mais ne nous apprend rien de ce que nous devons savoir - sur le mod�le relationnel. Pour comprendre parfaitement la structure relationnelle - et les caract�ristiques des performances, nous devons consid�rer la structure - de la cl� primaire qui est utilis�e par Hibernate pour mettre � jour ou supprimer - les �l�ments des collections. Cel� nous am�ne aux classifications suivantes : + Cette classification distingue les différentes relations entre les tables + et les clés étrangères mais ne nous apprend rien de ce que nous devons savoir + sur le modèle relationnel. Pour comprendre parfaitement la structure relationnelle + et les caractéristiques des performances, nous devons considérer la structure + de la clé primaire qui est utilisée par Hibernate pour mettre à jour ou supprimer + les éléments des collections. Celà nous amène aux classifications suivantes : </para> <itemizedlist> <listitem> - <para>collections index�es</para> + <para>collections indexées</para> </listitem> <listitem> <para>sets</para> @@ -1132,46 +1134,46 @@ </itemizedlist> <para> - Toutes les collections index�es (maps, lists, arrays) ont une cl� primaire constitu�e - des colonnes cl� (<literal>&lt;key&gt;</literal>) et <literal>&lt;index&gt;</literal>. - Avec ce type de cl� primaire, la mise � jour de collection est en g�n�ral tr�s performante - la cl� - primaire peut �tre index�es efficacement et un �l�ment particulier peut �tre - localis� efficacement lorsqu'Hibernate essaie de le mettre � jour ou de le supprimer. + Toutes les collections indexées (maps, lists, arrays) ont une clé primaire constituée + des colonnes clé (<literal>&lt;key&gt;</literal>) et <literal>&lt;index&gt;</literal>. + Avec ce type de clé primaire, la mise à jour de collection est en général très performante - la clé + primaire peut être indexées efficacement et un élément particulier peut être + localisé efficacement lorsqu'Hibernate essaie de le mettre à jour ou de le supprimer. </para> <para> - Les Sets ont une cl� primaire compos�e de <literal>&lt;key&gt;</literal> et des - colonnes repr�sentant l'�l�ment. Elle est donc moins efficace pour certains - types de collections d'�l�ments, en particulier les �l�ments composites, - les textes volumineux ou les champs binaires ; la base de donn�es - peut ne pas �tre capable d'indexer aussi efficacement une cl� primaire + Les Sets ont une clé primaire composée de <literal>&lt;key&gt;</literal> et des + colonnes représentant l'élément. Elle est donc moins efficace pour certains + types de collections d'éléments, en particulier les éléments composites, + les textes volumineux ou les champs binaires ; la base de données + peut ne pas être capable d'indexer aussi efficacement une clé primaire aussi complexe. Cependant, pour les associations un-vers-plusieurs - ou plusieurs-vers-plusieurs, sp�cialement lorsque l'on utilise des entit�s + ou plusieurs-vers-plusieurs, spécialement lorsque l'on utilise des entités ayant des identifiants techniques, il est probable que cela soit aussi efficace - (note : si vous voulez que <literal>SchemaExport</literal> cr�� effectivement - la cl� primaire d'un <literal>&lt;set&gt;</literal> pour vous, vous devez - d�clarer toutes les colonnes avec <literal>not-null="true"</literal>). + (note : si vous voulez que <literal>SchemaExport</literal> créé effectivement + la clé primaire d'un <literal>&lt;set&gt;</literal> pour vous, vous devez + déclarer toutes les colonnes avec <literal>not-null="true"</literal>). </para> <para> - Le mapping � l'aide d'<literal>&lt;idbag&gt;</literal> d�finit une cl� - de substitution ce qui leur permet d'�tre tr�s efficaces lors de la - mise � jour. En fait il s'agit du meilleur cas de mise � jour d'une collection + Le mapping à l'aide d'<literal>&lt;idbag&gt;</literal> définit une clé + de substitution ce qui leur permet d'être très efficaces lors de la + mise à jour. En fait il s'agit du meilleur cas de mise à jour d'une collection </para> <para> - Le pire cas intervient pour les Bags. Dans la mesure o� un bag permet - la duplications des �l�ments et n'a pas de colonne d'index, aucune cl� primaire - ne peut �tre d�finie. Hibernate n'a aucun moyen de distinguer des enregistrements - dupliqu�s. Hibernate r�sout ce probl�me en supprimant compl�tement les - enregistrements (via un simple <literal>DELETE</literal>), puis en recr�ant - la collection chaque fois qu'elle change. Ce qui peut �tre tr�s inefficace. + Le pire cas intervient pour les Bags. Dans la mesure où un bag permet + la duplications des éléments et n'a pas de colonne d'index, aucune clé primaire + ne peut être définie. Hibernate n'a aucun moyen de distinguer des enregistrements + dupliqués. Hibernate résout ce problème en supprimant complètement les + enregistrements (via un simple <literal>DELETE</literal>), puis en recréant + la collection chaque fois qu'elle change. Ce qui peut être très inefficace. </para> <para> - Notez que pour une relation un-vers-plusieurs, la "cl� primaire" - peut ne pas �tre la cl� primaire de la table en base de donn�es - - mais m�me dans ce cas, la classification ci-dessus reste utile + Notez que pour une relation un-vers-plusieurs, la "clé primaire" + peut ne pas être la clé primaire de la table en base de données - + mais même dans ce cas, la classification ci-dessus reste utile (Elle explique comment Hibernate "localise" chaque enregistrement de la collection). </para> @@ -1179,39 +1181,39 @@ </sect2> <sect2 id="performance-collections-mostefficientupdate"> - <title>Les lists, les maps, les idbags et les sets sont les collections les plus efficaces pour la mise � jour</title> + <title>Les lists, les maps, les idbags et les sets sont les collections les plus efficaces pour la mise à jour</title> <para> - La discussion pr�c�dente montre clairement que les collections index�es - et (la plupart du temps) les sets, permettent de r�aliser le plus efficacement - les op�rations d'ajout, de suppression ou de modification d'�l�ments. + La discussion précédente montre clairement que les collections indexées + et (la plupart du temps) les sets, permettent de réaliser le plus efficacement + les opérations d'ajout, de suppression ou de modification d'éléments. </para> <para> - Il existe un autre avantage qu'ont les collections index�es sur les Sets + Il existe un autre avantage qu'ont les collections indexées sur les Sets dans le cadre d'une association plusieurs vers plusieurs ou d'une collection de valeurs. - A cause de la structure inh�rente d'un <literal>Set</literal>, Hibernate n'effectue jamais - d'<literal>UPDATE</literal> quand un enregistrement est modifi�. Les modifications - apport�es � un <literal>Set</literal> se font via un <literal>INSERT</literal> et <literal>DELETE</literal> + A cause de la structure inhérente d'un <literal>Set</literal>, Hibernate n'effectue jamais + d'<literal>UPDATE</literal> quand un enregistrement est modifié. Les modifications + apportées à un <literal>Set</literal> se font via un <literal>INSERT</literal> et <literal>DELETE</literal> (de chaque enregistrement). Une fois de plus, ce cas ne s'applique pas aux associations un vers plusieurs. </para> <para> - Apr�s s'�tre rappel� que les tableaux ne peuvent pas �tre charg�s tardivement, + Après s'être rappelé que les tableaux ne peuvent pas être chargés tardivement, nous pouvons conclure que les lists, les maps et les idbags sont les types de collections - (non invers�es) les plus performants, avec les sets pas loin derri�res. + (non inversées) les plus performants, avec les sets pas loin derrières. Les sets son le type de collection le plus courant dans les applications Hibernate. Cela - est du au fait que la s�mantique des "set" est la plus naturelle dans le mod�le + est du au fait que la sémantique des "set" est la plus naturelle dans le modèle relationnel. </para> <para> - Cependant, dans des mod�les objet bien con�us avec Hibernate, on voit souvent que + Cependant, dans des modèles objet bien conçus avec Hibernate, on voit souvent que la plupart des collections sont en fait des associations "un-vers-plusieurs" avec - <literal>inverse="true"</literal>. Pour ces associations, les mises � jour sont g�r�es - au niveau de l'association "plusieurs-vers-un" et les consid�rations de performance de - mise � jour des collections ne s'appliquent tout simplement pas dans ces cas l�. + <literal>inverse="true"</literal>. Pour ces associations, les mises à jour sont gérées + au niveau de l'association "plusieurs-vers-un" et les considérations de performance de + mise à jour des collections ne s'appliquent tout simplement pas dans ces cas là. </para> </sect2> @@ -1220,11 +1222,11 @@ <title>Les Bags et les lists sont les plus efficaces pour les collections inverse</title> <para> - Avant que vous n'oubliez les bags pour toujours, il y a un cas pr�cis o� les bags - (et les lists) sont bien plus performants que les sets. Pour une collection marqu�e + Avant que vous n'oubliez les bags pour toujours, il y a un cas précis où les bags + (et les lists) sont bien plus performants que les sets. Pour une collection marquée comme <literal>inverse="true"</literal> (le choix le plus courant pour un relation - un vers plusieurs bidirectionnelle), nous pouvons ajouter des �l�ments � un bag - ou une list sans avoir besoin de l'initialiser (fetch) les �l�ments du sac! + un vers plusieurs bidirectionnelle), nous pouvons ajouter des éléments à un bag + ou une list sans avoir besoin de l'initialiser (fetch) les éléments du sac! Ceci parce que <literal>Collection.add()</literal> ou <literal>Collection.addAll()</literal> doit toujours retourner vrai pour un bag ou une <literal>List</literal> (contrairement au <literal>Set</literal>). @@ -1243,49 +1245,49 @@ <title>Suppression en un coup</title> <para> - Parfois, effacer les �l�ments d'une collection un par un peut �tre extr�mement inefficace. + Parfois, effacer les éléments d'une collection un par un peut être extrêmement inefficace. Hibernate n'est pas totalement stupide, il sait qu'il ne faut pas le faire dans le cas d'une - collection compl�tement vid�e (lorsque vous appellez <literal>list.clear()</literal>, par exemple). + collection complètement vidée (lorsque vous appellez <literal>list.clear()</literal>, par exemple). Dans ce cas, Hibernate fera un simple <literal>DELETE</literal> et le travail est fait ! </para> <para> - Supposons que nous ajoutions un �l�ment dans une collection de taille vingt et que nous - enlevions ensuite deux �l�ments. Hibernate effectuera un <literal>INSERT</literal> puis - deux <literal>DELETE</literal> (� moins que la collection ne soit un bag). Ce qui est + Supposons que nous ajoutions un élément dans une collection de taille vingt et que nous + enlevions ensuite deux éléments. Hibernate effectuera un <literal>INSERT</literal> puis + deux <literal>DELETE</literal> (à moins que la collection ne soit un bag). Ce qui est souhaitable. </para> <para> - Cependant, supposons que nous enlevions dix huit �l�ments, laissant ainsi deux �l�ments, puis - que nous ajoutions trois nouveaux �l�ments. Il y a deux moyens de proc�der. + Cependant, supposons que nous enlevions dix huit éléments, laissant ainsi deux éléments, puis + que nous ajoutions trois nouveaux éléments. Il y a deux moyens de procéder. </para> <itemizedlist> <listitem> - <para>effacer dix huit enregistrements un � un puis en ins�rer trois</para> + <para>effacer dix huit enregistrements un à un puis en insérer trois</para> </listitem> <listitem> - <para>effacer la totalit� de la collection (en un <literal>DELETE</literal> SQL) puis ins�rer - les cinq �l�ments restant un � un</para> + <para>effacer la totalité de la collection (en un <literal>DELETE</literal> SQL) puis insérer + les cinq éléments restant un à un</para> </listitem> </itemizedlist> <para> - Hibernate n'est pas assez intelligent pour savoir que, dans ce cas, la seconde m�thode est plus - rapide (Il plut�t heureux qu'Hibernate ne soit pas trop intelligent ; un tel comportement - pourrait rendre l'utilisation de triggers de bases de donn�es plut�t al�atoire, etc...). + Hibernate n'est pas assez intelligent pour savoir que, dans ce cas, la seconde méthode est plus + rapide (Il plutôt heureux qu'Hibernate ne soit pas trop intelligent ; un tel comportement + pourrait rendre l'utilisation de triggers de bases de données plutôt aléatoire, etc...). </para> <para> Heureusement, vous pouvez forcer ce comportement lorsque vous le souhaitez, en liberant - (c'est-�-dire en d�r�f�ren�ant) la collection initiale et en retournant une collection - nouvellement instanci�e avec les �l�ments restants. Ceci peut �tre tr�s pratique et - tr�s puissant de temps en temps. + (c'est-à-dire en déréférençant) la collection initiale et en retournant une collection + nouvellement instanciée avec les éléments restants. Ceci peut être très pratique et + très puissant de temps en temps. </para> <para> - Bien s�r, la suppression en un coup ne s'applique pas pour les collections qui sont mapp�es + Bien sûr, la suppression en un coup ne s'applique pas pour les collections qui sont mappées avec <literal>inverse="true"</literal>. </para> </sect2> @@ -1296,8 +1298,8 @@ <title>Moniteur de performance</title> <para> - L'optimisation n'est pas d'un grand int�r�t sans le suivi et l'acc�s aux donn�es de - performance. Hibernate fournit toute une panoplie de rapport sur ses op�rations internes. + L'optimisation n'est pas d'un grand intérêt sans le suivi et l'accès aux données de + performance. Hibernate fournit toute une panoplie de rapport sur ses opérations internes. Les statistiques dans Hibernate sont fournies par <literal>SessionFactory</literal>. </para> @@ -1305,13 +1307,13 @@ <title>Suivi d'une SessionFactory</title> <para> - Vous pouvez acc�der au m�triques d'une <literal>SessionFactory</literal> de deux - mani�res. La premi�re option est d'appeler <literal>sessionFactory.getStatistics()</literal> - et de lire ou d'afficher les <literal>Statistics</literal> vous m�me. + Vous pouvez accéder au métriques d'une <literal>SessionFactory</literal> de deux + manières. La première option est d'appeler <literal>sessionFactory.getStatistics()</literal> + et de lire ou d'afficher les <literal>Statistics</literal> vous même. </para> <para> - Hibernate peut �galement utiliser JMX pour publier les m�triques si vous activez + Hibernate peut également utiliser JMX pour publier les métriques si vous activez le MBean <literal>StatisticsService</literal>. Vous pouvez activer un seul MBean pour toutes vos <literal>SessionFactory</literal> ou un par factory. Voici un code qui montre un exemple de configuration minimaliste : @@ -1338,81 +1340,81 @@ server.registerMBean(stats, on); // Register the MBean on the server]]></programlisting> <para> - TODO: Cela n'a pas de sens : dans le premier cs on r�cup�re et on utilise le MBean directement. + TODO: Cela n'a pas de sens : dans le premier cs on récupère et on utilise le MBean directement. Dans le second, on doit fournir le nom JNDI sous lequel est retenu la fabrique de session avant de l'utiliser. Pour cela il faut utiliser <literal>hibernateStatsBean.setSessionFactoryJNDIName("my/JNDI/Name")</literal> </para> <para> - Vous pouvez (d�s)activer le suivi pour une <literal>SessionFactory</literal> + Vous pouvez (dés)activer le suivi pour une <literal>SessionFactory</literal> </para> <itemizedlist> <listitem> <para> - au moment de la configuration en mettant <literal>hibernate.generate_statistics</literal> � <literal>false</literal> + au moment de la configuration en mettant <literal>hibernate.generate_statistics</literal> à <literal>false</literal> </para> </listitem> </itemizedlist> <itemizedlist> <listitem> <para> - � chaud avec <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> + à chaud avec <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> ou <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal> </para> </listitem> </itemizedlist> <para> - Les statistiques peuvent �tre remises � z�ro de mani�re programmatique � l'aide de la m�thode + Les statistiques peuvent être remises à zéro de manière programmatique à l'aide de la méthode <literal>clear()</literal> - Un r�sum� peut �tre envoy� � un logger (niveau info) � l'aide de la m�thode <literal>logSummary()</literal> + Un résumé peut être envoyé à un logger (niveau info) à l'aide de la méthode <literal>logSummary()</literal> </para> </sect2> <sect2 id="performance-monitoring-metrics" revision="1"> - <title>M�triques</title> + <title>Métriques</title> <para> - Hibernate fournit un certain nombre de m�triques, qui vont des informations tr�s basiques - aux informations tr�s sp�cialis�es qui ne sont appropri�es que dans certains scenarii. - Tous les compteurs accessibles sont d�crits dans l'API de l'interface - <literal>Statistics</literal> dans trois cat�gories : + Hibernate fournit un certain nombre de métriques, qui vont des informations très basiques + aux informations très spécialisées qui ne sont appropriées que dans certains scenarii. + Tous les compteurs accessibles sont décrits dans l'API de l'interface + <literal>Statistics</literal> dans trois catégories : </para> <itemizedlist> <listitem> <para> - Les m�triques relatives � l'usage g�n�ral de la <literal>Session</literal> - comme le nombre de sessions ouvertes, le nombre de connexions JDBC r�cup�r�es, etc... + Les métriques relatives à l'usage général de la <literal>Session</literal> + comme le nombre de sessions ouvertes, le nombre de connexions JDBC récupérées, etc... </para> </listitem> <listitem> <para> - Les m�triques relatives aux entit�s, collections, requ�tes et caches dans - leur ensemble (m�triques globales), + Les métriques relatives aux entités, collections, requêtes et caches dans + leur ensemble (métriques globales), </para> </listitem> <listitem> <para> - Les m�triques d�taill�es relatives � une entit�, une collection, une requ�te - ou une r�gion de cache particuli�re. + Les métriques détaillées relatives à une entité, une collection, une requête + ou une région de cache particulière. </para> </listitem> </itemizedlist> <para> - Par exemple, vous pouvez v�rifier l'acc�s au cache ainsi que le taux d'�l�ments manquants et - de mise � jour des entit�s, collections et requ�tes et le temps moyen que met une requ�te. - Il faut faire attention au fait que le nombre de millisecondes est sujet � approximation en - Java. Hibernate est li� � la pr�cision de la machine virtuelle, sur certaines plateformes, - cela n'offre qu'une pr�cision de l'ordre de 10 secondes. + Par exemple, vous pouvez vérifier l'accès au cache ainsi que le taux d'éléments manquants et + de mise à jour des entités, collections et requêtes et le temps moyen que met une requête. + Il faut faire attention au fait que le nombre de millisecondes est sujet à approximation en + Java. Hibernate est lié à la précision de la machine virtuelle, sur certaines plateformes, + cela n'offre qu'une précision de l'ordre de 10 secondes. </para> <para> - Des accesseurs simples sont utilis�s pour acc�der aux m�triques globales (e.g. celles qui ne - sont pas li�es � une entit�, collection ou r�gion de cache particuli�re). Vous pouvez acc�der - aux m�triques d'une entit�, collection, r�gion de cache particuli�re � l'aide de son nom et � l'aide - de sa repr�sentation HQL ou SQL pour une requ�te. R�f�rez vous � la javadoc des APIS + Des accesseurs simples sont utilisés pour accéder aux métriques globales (e.g. celles qui ne + sont pas liées à une entité, collection ou région de cache particulière). Vous pouvez accéder + aux métriques d'une entité, collection, région de cache particulière à l'aide de son nom et à l'aide + de sa représentation HQL ou SQL pour une requête. Référez vous à la javadoc des APIS <literal>Statistics</literal>, <literal>EntityStatistics</literal>, <literal>CollectionStatistics</literal>, <literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</literal> pour plus d'informations. Le code ci-dessous montre @@ -1437,9 +1439,9 @@ log.info(Cat.class.getName() + " changed " + changes + "times" );]]></programlisting> <para> - Pour travailler sur toutes les entit�s, collections, requ�tes et r�gions de cache, vous pouvez - r�cup�rer la liste des noms des entit�s, collections, requ�tes et r�gions de cache avec les - m�thodes : <literal>getQueries()</literal>, <literal>getEntityNames()</literal>, + Pour travailler sur toutes les entités, collections, requêtes et régions de cache, vous pouvez + récupérer la liste des noms des entités, collections, requêtes et régions de cache avec les + méthodes : <literal>getQueries()</literal>, <literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</literal>, et <literal>getSecondLevelCacheRegionNames()</literal>. </para> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/persistent_classes.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/persistent_classes.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/persistent_classes.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,20 +1,22 @@ -<?xml version='1.0' encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="persistent-classes" revision="2"> <title>Classes persistantes</title> <para> - Les classes persistantes sont les classes d'une application qui impl�mentent - les entit�s d'un probl�me m�tier (ex. Client et Commande dans une application - de commerce �lectronique). - Toutes les instances d'une classe persistante ne sont pas forc�ment - dans l'�tat persistant - au lieu de cela, une instance peut �tre �ph�m�re (NdT : transient) ou d�tach�e. + Les classes persistantes sont les classes d'une application qui implémentent + les entités d'un problème métier (ex. Client et Commande dans une application + de commerce électronique). + Toutes les instances d'une classe persistante ne sont pas forcément + dans l'état persistant - au lieu de cela, une instance peut être éphémère (NdT : transient) ou détachée. </para> <para> - Hibernate fonctionne de mani�re optimale lorsque ces classes suivent quelques r�gles - simples, aussi connues comme le mod�le de programmation Plain Old Java Object - (POJO). Cependant, aucune de ces r�gles ne sont des besoins absolus. En effet, Hibernate3 suppose tr�s peu de choses � propos - de la nature de vos objets persistants. Vous pouvez exprimer un mod�le de domaine par d'autres moyens : utiliser des arbres + Hibernate fonctionne de manière optimale lorsque ces classes suivent quelques règles + simples, aussi connues comme le modèle de programmation Plain Old Java Object + (POJO). Cependant, aucune de ces règles ne sont des besoins absolus. En effet, Hibernate3 suppose très peu de choses à propos + de la nature de vos objets persistants. Vous pouvez exprimer un modèle de domaine par d'autres moyens : utiliser des arbres d'instances de <literal>Map</literal>, par exemple. </para> @@ -22,8 +24,8 @@ <title>Un exemple simple de POJO</title> <para> - Toute bonne application Java n�cessite une classe persistante - repr�sentant les f�lins. + Toute bonne application Java nécessite une classe persistante + représentant les félins. </para> <programlisting><![CDATA[package eg; @@ -106,49 +108,49 @@ }]]></programlisting> <para> - Il y a quatre r�gles � suivre ici : + Il y a quatre règles à suivre ici : </para> <sect2 id="persistent-classes-pojo-constructor" revision="1"> - <title>Impl�menter un constructeur sans argument</title> + <title>Implémenter un constructeur sans argument</title> <para> <literal>Cat</literal> a un constructeur sans argument. Toutes les classes persistantes doivent avoir un - constructeur par d�faut (lequel peut ne pas �tre public) pour qu'Hibernate puissent les instancier en utilisant - <literal>Constructor.newInstance()</literal>. Nous recommandons fortement d'avoir un constructeur par d�faut avec - au moins une visibilit� <emphasis>paquet</emphasis> pour la g�n�ration du proxy � l'ex�cution dans Hibernate. + constructeur par défaut (lequel peut ne pas être public) pour qu'Hibernate puissent les instancier en utilisant + <literal>Constructor.newInstance()</literal>. Nous recommandons fortement d'avoir un constructeur par défaut avec + au moins une visibilité <emphasis>paquet</emphasis> pour la génération du proxy à l'exécution dans Hibernate. </para> </sect2> <sect2 id="persistent-classes-pojo-identifier" revision="2"> - <title>Fournir une propri�t� d'indentifiant (optionnel)</title> + <title>Fournir une propriété d'indentifiant (optionnel)</title> <para> - <literal>Cat</literal> poss�de une propri�t� appel�e <literal>id</literal>. - Cette propri�t� mappe la valeur de la colonne de cl� primaire de la table - d'une base de donn�es.La propri�t� aurait pu s'appeler compl�tement autrement, - et son type aurait pu �tre n'importe quel type primitif, n'importe quel "encapsuleur" + <literal>Cat</literal> possède une propriété appelée <literal>id</literal>. + Cette propriété mappe la valeur de la colonne de clé primaire de la table + d'une base de données.La propriété aurait pu s'appeler complètement autrement, + et son type aurait pu être n'importe quel type primitif, n'importe quel "encapsuleur" de type primitif, <literal>java.lang.String</literal> ou <literal>java.util.Date</literal>. - (Si votre base de donn�es h�rit�e poss�de des cl�s composites, elles peuvent �tre mapp�es - en utilisant une classe d�finie par l'utilisateur et poss�dant les propri�t�s associ�es aux - types de la cl� composite - voir la section concernant les identifiants composites plus tard). + (Si votre base de données héritée possède des clés composites, elles peuvent être mappées + en utilisant une classe définie par l'utilisateur et possédant les propriétés associées aux + types de la clé composite - voir la section concernant les identifiants composites plus tard). </para> <para> - La propri�t� d'identifiant est strictement optionnelle. Vous pouver l'oublier et laisser Hibernate + La propriété d'identifiant est strictement optionnelle. Vous pouver l'oublier et laisser Hibernate s'occuper des identifiants de l'objet en interne. Toutefois, nous ne le recommandons pas. </para> <para> - En fait, quelques fonctionnalit�s ne sont disponibles que pour les classes - d�clarant un identifiant de propri�t� : + En fait, quelques fonctionnalités ne sont disponibles que pour les classes + déclarant un identifiant de propriété : </para> <itemizedlist spacing="compact"> <listitem> <para> - Les r�attachements transitifs pour les objets d�tach�s (mise � jour en cascade ou fusion en cascade) - + Les réattachements transitifs pour les objets détachés (mise à jour en cascade ou fusion en cascade) - voir <xref linkend="objectstate-transitive"/> </para> </listitem> @@ -165,8 +167,8 @@ </itemizedlist> <para> - Nous recommandons que vous d�clariez les propri�t�s d'identifiant de mani�re - uniforme. Nous recommandons �galement que vous utilisiez un type nullable + Nous recommandons que vous déclariez les propriétés d'identifiant de manière + uniforme. Nous recommandons également que vous utilisiez un type nullable (ie. non primitif). </para> </sect2> @@ -174,39 +176,39 @@ <sect2 id="persistent-classes-pojo-final"> <title>Favoriser les classes non finales (optionnel)</title> <para> - Une fonctionnalit� clef d'Hibernate, les <emphasis>proxies</emphasis>, n�cessitent - que la classe persistente soit non finale ou qu'elle soit l'impl�mentation d'une - interface qui d�clare toutes les m�thodes publiques. + Une fonctionnalité clef d'Hibernate, les <emphasis>proxies</emphasis>, nécessitent + que la classe persistente soit non finale ou qu'elle soit l'implémentation d'une + interface qui déclare toutes les méthodes publiques. </para> <para> - Vous pouvez persister, gr�ce � Hibernate, les classes <literal>final</literal> - qui n'impl�mentent pas d'interface, mais vous ne pourrez pas utiliser les proxies pour les chargements d'associations paresseuses - - ce qui limitera vos possibilit�s d'ajustement des performances. + Vous pouvez persister, grâce à Hibernate, les classes <literal>final</literal> + qui n'implémentent pas d'interface, mais vous ne pourrez pas utiliser les proxies pour les chargements d'associations paresseuses + - ce qui limitera vos possibilités d'ajustement des performances. </para> <para> - Vous devriez aussi �viter de d�clarer des m�thodes <literal>public final</literal> sur des classes - non-finales. Si vous voulez utiliser une classe avec une m�thode <literal>public final</literal>, vous devez - explicitement d�sactiver les proxies en param�trant + Vous devriez aussi éviter de déclarer des méthodes <literal>public final</literal> sur des classes + non-finales. Si vous voulez utiliser une classe avec une méthode <literal>public final</literal>, vous devez + explicitement désactiver les proxies en paramétrant <literal>lazy="false"</literal>. </para> </sect2> <sect2 id="persistent-classes-pojo-accessors" revision="2"> - <title>D�clarer les accesseurs et mutateurs des attributs persistants (optionnel)</title> + <title>Déclarer les accesseurs et mutateurs des attributs persistants (optionnel)</title> <para> - <literal>Cat</literal> d�clare des mutateurs pour toutes ses champs persistants. Beaucoup d'autres + <literal>Cat</literal> déclare des mutateurs pour toutes ses champs persistants. Beaucoup d'autres solutions de mapping Objet/relationnel persistent directement les variables d'instance. Nous pensons - qu'il est bien mieux de fournir une indirection entre le sch�ma relationnel et les structures de donn�es internes de la classe. - Par d�faut, Hibernate persiste les propri�t�s suivant le style JavaBean, et reconna�t les noms de m�thodes de la forme <literal> + qu'il est bien mieux de fournir une indirection entre le schéma relationnel et les structures de données internes de la classe. + Par défaut, Hibernate persiste les propriétés suivant le style JavaBean, et reconnaît les noms de méthodes de la forme <literal> getFoo</literal>, <literal>isFoo</literal> et - <literal>setFoo</literal>. Nous pouvons changer pour un acc�s direct aux champs pour des propri�t�s particuli�res, si besoin est. + <literal>setFoo</literal>. Nous pouvons changer pour un accès direct aux champs pour des propriétés particulières, si besoin est. </para> <para> - Les propri�t�s <emphasis>n'ont pas</emphasis> � �tre d�clar�es publiques - - Hibernate peut persister une propri�t� avec un paire de getter/setter de - visibilit� par d�fault, <literal>protected</literal> ou <literal> + Les propriétés <emphasis>n'ont pas</emphasis> à être déclarées publiques - + Hibernate peut persister une propriété avec un paire de getter/setter de + visibilité par défault, <literal>protected</literal> ou <literal> private</literal>. </para> @@ -215,11 +217,11 @@ </sect1> <sect1 id="persistent-classes-inheritance"> - <title>Impl�menter l'h�ritage</title> + <title>Implémenter l'héritage</title> <para> - Une sous-classe doit �galement suivre la premi�re et la seconde r�gle. - Elle h�rite sa propri�t� d'identifiant de <literal>Cat</literal>. + Une sous-classe doit également suivre la première et la seconde règle. + Elle hérite sa propriété d'identifiant de <literal>Cat</literal>. </para> <programlisting><![CDATA[package eg; @@ -237,55 +239,55 @@ </sect1> <sect1 id="persistent-classes-equalshashcode" revision="1"> - <title>Impl�menter <literal>equals()</literal> et <literal>hashCode()</literal></title> + <title>Implémenter <literal>equals()</literal> et <literal>hashCode()</literal></title> <para> - Vous devez surcharger les m�thodes <literal>equals()</literal> et + Vous devez surcharger les méthodes <literal>equals()</literal> et <literal>hashCode()</literal> si vous </para> <itemizedlist spacing="compact"> <listitem> <para> avez l'intention de mettre des instances de classes persistantes dans un <literal>Set</literal> - (la mani�re recommand�e pour repr�senter des associations pluri-valu�es) + (la manière recommandée pour représenter des associations pluri-valuées) <emphasis>et</emphasis> </para> </listitem> <listitem> <para> - avez l'intention d'utiliser le r�attachement d'instances d�tach�es + avez l'intention d'utiliser le réattachement d'instances détachées </para> </listitem> </itemizedlist> <para> - Hibernate garantit l'�quivalence de l'identit� persistante (ligne de base de donn�es) et l'identit� Java seulement - � l'int�rieur de la port�e d'une session particuli�re. Donc d�s que nous m�langeons des instances venant de diff�rentes - sessions, nous devons impl�menter <literal>equals()</literal> et - <literal>hashCode()</literal> si nous souhaitons avoir une s�mantique correcte pour les <literal>Set</literal>s. + Hibernate garantit l'équivalence de l'identité persistante (ligne de base de données) et l'identité Java seulement + à l'intérieur de la portée d'une session particulière. Donc dès que nous mélangeons des instances venant de différentes + sessions, nous devons implémenter <literal>equals()</literal> et + <literal>hashCode()</literal> si nous souhaitons avoir une sémantique correcte pour les <literal>Set</literal>s. </para> <para> - La mani�re la plus �vidente est d'impl�menter <literal>equals()</literal>/<literal>hashCode()</literal> + La manière la plus évidente est d'implémenter <literal>equals()</literal>/<literal>hashCode()</literal> en comparant la valeur de l'identifiant des deux objets. Si cette valeur est identique, les deux - doivent repr�senter la m�me ligne de base de donn�es, ils sont donc �gaux (si les deux sont - ajout�s � un <literal>Set</literal>, nous n'aurons qu'un seul �l�ment dans le + doivent représenter la même ligne de base de données, ils sont donc égaux (si les deux sont + ajoutés à un <literal>Set</literal>, nous n'aurons qu'un seul élément dans le <literal>Set</literal>). Malheureusement, nous ne pouvons pas utiliser cette approche avec - des identifiants g�n�r�s ! Hibernate n'assignera de - valeur d'identifiant qu'aux objets qui sont persistants, une instance nouvellement cr��e n'aura - donc pas de valeur d'identifiant ! De plus, si une instance est non sauvegard�e et actuellement dans un <literal>Set</literal>, - le sauvegarder assignera une valeur d'identifiant � l'objet. Si <literal>equals()</literal> et <literal>hashCode()</literal> - sont bas�es sur la valeur de l'identifiant, le code de hachage devrait changer, rompant le contrat du <literal>Set</literal>. - Regardez sur le site web d'Hibernate pour une discussion compl�te de ce probl�me. - Notez que ceci n'est pas un probl�me d'Hibernate, mais la s�mantique normale de Java pour l'identit� d'un objet et l'�galit�. + des identifiants générés ! Hibernate n'assignera de + valeur d'identifiant qu'aux objets qui sont persistants, une instance nouvellement créée n'aura + donc pas de valeur d'identifiant ! De plus, si une instance est non sauvegardée et actuellement dans un <literal>Set</literal>, + le sauvegarder assignera une valeur d'identifiant à l'objet. Si <literal>equals()</literal> et <literal>hashCode()</literal> + sont basées sur la valeur de l'identifiant, le code de hachage devrait changer, rompant le contrat du <literal>Set</literal>. + Regardez sur le site web d'Hibernate pour une discussion complète de ce problème. + Notez que ceci n'est pas un problème d'Hibernate, mais la sémantique normale de Java pour l'identité d'un objet et l'égalité. </para> <para> - Nous recommandons donc d'impl�menter + Nous recommandons donc d'implémenter <literal>equals()</literal> et <literal>hashCode()</literal> en utilisant <emphasis> - l'�galit� par cl� m�tier</emphasis>.L'�galit� par cl� m�tier signifie que la m�thode <literal>equals()</literal> - compare uniquement les propri�t�s qui forment une cl� m�tier, une cl� qui - identifierait notre instance dans le monde r�el (une cl� candidate + l'égalité par clé métier</emphasis>.L'égalité par clé métier signifie que la méthode <literal>equals()</literal> + compare uniquement les propriétés qui forment une clé métier, une clé qui + identifierait notre instance dans le monde réel (une clé candidate <emphasis>naturelle</emphasis>) : </para> @@ -314,39 +316,39 @@ }]]></programlisting> <para> - Notez qu'une clef m�tier ne doit pas �tre solide comme une clef primaire de base de donn�es - (voir <xref linkend="transactions-basics-identity"/>). Les propri�t�s - immuables ou uniques sont g�n�ralement de bonnes candidates pour une clef m�tier. + Notez qu'une clef métier ne doit pas être solide comme une clef primaire de base de données + (voir <xref linkend="transactions-basics-identity"/>). Les propriétés + immuables ou uniques sont généralement de bonnes candidates pour une clef métier. </para> </sect1> <sect1 id="persistent-classes-dynamicmodels"> - <title>Mod�les dynamiques</title> + <title>Modèles dynamiques</title> <para> - <emphasis>Notez que la fonctionnalit�s suivantes sont actuellement consid�r�es - comme exp�rimentales et peuvent changer dans un futur proche.</emphasis> + <emphasis>Notez que la fonctionnalités suivantes sont actuellement considérées + comme expérimentales et peuvent changer dans un futur proche.</emphasis> </para> <para> - Les entit�s persistantes ne doivent pas n�cessairement �tre repr�sent�es comme - des classes POJO ou des objets JavaBean � l'ex�cution. Hibernate supporte aussi les - mod�les dynamiques (en utilisant des <literal>Map</literal>s de <literal>Map</literal>s - � l'ex�cution) et la repr�sentation des entit�s comme des arbres DOM4J. Avec cette - approche, vous n'�crivez pas de classes persistantes, seulement des fichiers de mapping. + Les entités persistantes ne doivent pas nécessairement être représentées comme + des classes POJO ou des objets JavaBean à l'exécution. Hibernate supporte aussi les + modèles dynamiques (en utilisant des <literal>Map</literal>s de <literal>Map</literal>s + à l'exécution) et la représentation des entités comme des arbres DOM4J. Avec cette + approche, vous n'écrivez pas de classes persistantes, seulement des fichiers de mapping. </para> <para> - Par d�faut, Hibernate fonctionne en mode POJO normal. Vous pouvez param�trer - un mode de repr�sentation d'entit� par d�faut pour une <literal>SessionFactory</literal> - particuli�re en utilisant l'option de configuration <literal>default_entity_mode</literal> + Par défaut, Hibernate fonctionne en mode POJO normal. Vous pouvez paramétrer + un mode de représentation d'entité par défaut pour une <literal>SessionFactory</literal> + particulière en utilisant l'option de configuration <literal>default_entity_mode</literal> (voir <xref linkend="configuration-optional-properties"/>). </para> <para> - Les exemples suivants d�montrent la repr�sentation utilisant des <literal>Map</literal>s. - D'abord, dans le fichier de mapping, un <literal>entity-name</literal> doit �tre d�clar� + Les exemples suivants démontrent la représentation utilisant des <literal>Map</literal>s. + D'abord, dans le fichier de mapping, un <literal>entity-name</literal> doit être déclaré au lieu (ou en plus) d'un nom de classe : </para> @@ -385,13 +387,13 @@ </hibernate-mapping>]]></programlisting> <para> - Notez que m�me si des associations sont d�clar�es en utilisant des noms de classe cible, - le type de cible d'une association peut aussi �tre une entit� dynamique au lieu d'un POJO. + Notez que même si des associations sont déclarées en utilisant des noms de classe cible, + le type de cible d'une association peut aussi être une entité dynamique au lieu d'un POJO. </para> <para> - Apr�s avoir configur� le mode d'entit� par d�faut � <literal>dynamic-map</literal> - pour la <literal>SessionFactory</literal>, nous pouvons lors de l'ex�cution fonctionner + Après avoir configuré le mode d'entité par défaut à <literal>dynamic-map</literal> + pour la <literal>SessionFactory</literal>, nous pouvons lors de l'exécution fonctionner avec des <literal>Map</literal>s de <literal>Map</literal>s : </para> @@ -419,15 +421,15 @@ <para> Les avantages d'un mapping dynamique sont un gain de temps pour le prototypage - sans la n�cessit� d'impl�menter les classes d'entit�. Pourtant, vous perdez la - v�rification du typage au moment de la compilation et aurez plus d'exceptions � - g�rer lors de l'ex�cution. Gr�ce au mapping d'Hibernate, le sch�ma de la base de - donn�es peut facilement �tre normalis� et solidifi�, permettant de rajouter une - impl�mentation propre du mod�le de domaine plus tard. + sans la nécessité d'implémenter les classes d'entité. Pourtant, vous perdez la + vérification du typage au moment de la compilation et aurez plus d'exceptions à + gérer lors de l'exécution. Grâce au mapping d'Hibernate, le schéma de la base de + données peut facilement être normalisé et solidifié, permettant de rajouter une + implémentation propre du modèle de domaine plus tard. </para> <para> - Les modes de repr�sentation d'une entit� peut aussi �tre configur� par <literal>Session</literal> : + Les modes de représentation d'une entité peut aussi être configuré par <literal>Session</literal> : </para> <programlisting><![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode.MAP); @@ -445,17 +447,17 @@ <para> - Veuillez noter que l'appel � <literal>getSession()</literal> en utilisant un + Veuillez noter que l'appel à <literal>getSession()</literal> en utilisant un <literal>EntityMode</literal> se fait sur l'API <literal>Session</literal>, pas - <literal>SessionFactory</literal>. De cette mani�re, la nouvelle <literal>Session</literal> + <literal>SessionFactory</literal>. De cette manière, la nouvelle <literal>Session</literal> partage les connexions JDBC, transactions et autres informations de contexte sous-jacentes. - Cela signifie que vous n'avez pas � appeler <literal>flush()</literal> et <literal>close()</literal> + Cela signifie que vous n'avez pas à appeler <literal>flush()</literal> et <literal>close()</literal> sur la <literal>Session</literal> secondaire, et laissez aussi la gestion de la transaction - et de la connexion � l'unit� de travail primaire. + et de la connexion à l'unité de travail primaire. </para> <para> - Plus d'informations � propos de la repr�sentation XML peuvent �tre trouv�es dans + Plus d'informations à propos de la représentation XML peuvent être trouvées dans <xref linkend="xml"/>. </para> @@ -466,27 +468,27 @@ <para> <literal>org.hibernate.tuple.Tuplizer</literal>, et ses sous-interfaces, sont responsables - de la gestion d'une repr�sentation particuli�re d'un morceau de donn�es, en fonction du - <literal>org.hibernate.EntityMode</literal> de r�pr�sentation. Si un morceau donn� de donn�es - est pens� comme une structure de donn�es, alors un tuplizer est la chose qui sait comment - cr�er une telle structure de donn�es, comment extraire des valeurs et injecter des valeurs dans - une telle structure de donn�es. Par exemple, pour le mode d'entit� POJO, le tuplizer correspondant - sait comment cr�er le POJO � travers son constructeur et comment acc�der aux propri�t�s du POJO - utilisant les accesseurs de la propri�t� d�finie. Il y a deux types de Tuplizers haut niveau, - repr�sent� par les interfaces <literal>org.hibernate.tuple.EntityTuplizer</literal> et + de la gestion d'une représentation particulière d'un morceau de données, en fonction du + <literal>org.hibernate.EntityMode</literal> de réprésentation. Si un morceau donné de données + est pensé comme une structure de données, alors un tuplizer est la chose qui sait comment + créer une telle structure de données, comment extraire des valeurs et injecter des valeurs dans + une telle structure de données. Par exemple, pour le mode d'entité POJO, le tuplizer correspondant + sait comment créer le POJO à travers son constructeur et comment accéder aux propriétés du POJO + utilisant les accesseurs de la propriété définie. Il y a deux types de Tuplizers haut niveau, + représenté par les interfaces <literal>org.hibernate.tuple.EntityTuplizer</literal> et <literal>org.hibernate.tuple.ComponentTuplizer</literal>. Les <literal>EntityTuplizer</literal>s - sont responsables de la gestion des contrats mentionn�s ci-dessus pour les entit�s, alors que + sont responsables de la gestion des contrats mentionnés ci-dessus pour les entités, alors que les <literal>ComponentTuplizer</literal>s s'occupent des composants. </para> <para> - Les utilisateurs peuvent aussi brancher leurs propres tuplizers. Peut-�tre vous est-il n�cessaire qu'une - impl�mentation de <literal>java.util.Map</literal> autre que <literal>java.util.HashMap</literal> - soit utilis�e dans le mode d'entit� dynamic-map ; ou peut-�tre avez-vous besoin de d�finir une - stat�gie de g�n�ration de proxy diff�rente de celle utilis�e par d�faut. Les deux devraient �tre - effectu�es en d�finissant une impl�mentation de tuplizer utilisateur. Les d�finitions de tuplizers - sont attach�es au mapping de l'entit� ou du composant qu'ils sont cens�s g�rer. Retour � l'exemple de - notre entit� utilisateur : + Les utilisateurs peuvent aussi brancher leurs propres tuplizers. Peut-être vous est-il nécessaire qu'une + implémentation de <literal>java.util.Map</literal> autre que <literal>java.util.HashMap</literal> + soit utilisée dans le mode d'entité dynamic-map ; ou peut-être avez-vous besoin de définir une + statégie de génération de proxy différente de celle utilisée par défaut. Les deux devraient être + effectuées en définissant une implémentation de tuplizer utilisateur. Les définitions de tuplizers + sont attachées au mapping de l'entité ou du composant qu'ils sont censés gérer. Retour à l'exemple de + notre entité utilisateur : </para> <programlisting><![CDATA[<hibernate-mapping> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/preface.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/preface.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/preface.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,5 +1,4 @@ -<?xml version='1.0'?> - +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <preface id="preface"> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_criteria.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_criteria.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_criteria.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,17 +1,19 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="querycriteria"> - <title>Requ�tes par crit�res</title> + <title>Requêtes par critères</title> <para> - Hibernate offre une API d'interrogation par crit�res intuitive et extensible. + Hibernate offre une API d'interrogation par critères intuitive et extensible. </para> <sect1 id="querycriteria-creating"> - <title>Cr�er une instance de <literal>Criteria</literal></title> + <title>Créer une instance de <literal>Criteria</literal></title> <para> - L'interface <literal>net.sf.hibernate.Criteria</literal> repr�sente une requ�te sur une - classe persistente donn�e. La <literal>Session</literal> fournit les instances de + L'interface <literal>net.sf.hibernate.Criteria</literal> représente une requête sur une + classe persistente donnée. La <literal>Session</literal> fournit les instances de <literal>Criteria</literal>. </para> @@ -22,14 +24,14 @@ </sect1> <sect1 id="querycriteria-narrowing"> - <title>Restriction du r�sultat</title> + <title>Restriction du résultat</title> <para> - Un criterion (crit�re de recherche) est une instance de l'interface + Un criterion (critère de recherche) est une instance de l'interface <literal>org.hibernate.criterion.Criterion</literal>. La classe - <literal>org.hibernate.criterion.Restrictions</literal> d�finit - des m�thodes pour obtenir des types de <literal>Criterion</literal> - pr�-d�finis. + <literal>org.hibernate.criterion.Restrictions</literal> définit + des méthodes pour obtenir des types de <literal>Criterion</literal> + pré-définis. </para> <programlisting><![CDATA[List cats = sess.createCriteria(Cat.class) @@ -38,7 +40,7 @@ .list();]]></programlisting> <para> - Les restrictions peuvent �tre goup�es de mani�re logique. + Les restrictions peuvent être goupées de manière logique. </para> <programlisting><![CDATA[List cats = sess.createCriteria(Cat.class) @@ -60,8 +62,8 @@ .list();]]></programlisting> <para> - Il y a plusieurs types de criterion pr�-d�finis (sous classes de <literal>Restriction</literal>), - mais l'une d'entre elle particuli�rement utile vous permet de sp�cifier directement + Il y a plusieurs types de criterion pré-définis (sous classes de <literal>Restriction</literal>), + mais l'une d'entre elle particulièrement utile vous permet de spécifier directement du SQL. </para> @@ -70,13 +72,13 @@ .list();]]></programlisting> <para> - La zone <literal>{alias}</literal> sera remplac�e par l'alias de colonne de l'entit� - que l'on souhaite int�rroger. + La zone <literal>{alias}</literal> sera remplacée par l'alias de colonne de l'entité + que l'on souhaite intérroger. </para> <para> - Une autre approche pour obtenir un criterion est de le r�cup�rer d'une instance de <literal>Property</literal>. - Vous pouvez cr�er une <literal>Property</literal> en appelant <literal>Property.forName()</literal>. + Une autre approche pour obtenir un criterion est de le récupérer d'une instance de <literal>Property</literal>. + Vous pouvez créer une <literal>Property</literal> en appelant <literal>Property.forName()</literal>. </para> <programlisting><![CDATA[ @@ -94,10 +96,10 @@ </sect1> <sect1 id="querycriteria-ordering"> - <title>Trier les r�sultats</title> + <title>Trier les résultats</title> <para> - Vous pouvez trier les r�sultats en utilisant <literal>org.hibernate.criterion.Order</literal>. + Vous pouvez trier les résultats en utilisant <literal>org.hibernate.criterion.Order</literal>. </para> <programlisting><![CDATA[List cats = sess.createCriteria(Cat.class) @@ -120,7 +122,7 @@ <title>Associations</title> <para> - Vous pouvez facilement sp�cifier des contraintes sur des entit�s li�es, + Vous pouvez facilement spécifier des contraintes sur des entités liées, par des associations en utilisant <literal>createCriteria()</literal>. </para> @@ -132,7 +134,7 @@ <para> Notez que la seconde <literal>createCriteria()</literal> retourne une nouvelle - instance de <literal>Criteria</literal>, qui se rapporte aux �l�ments de la + instance de <literal>Criteria</literal>, qui se rapporte aux éléments de la collection <literal>kittens</literal>. </para> @@ -147,14 +149,14 @@ .list();]]></programlisting> <para> - (<literal>createAlias()</literal> ne cr�e pas de nouvelle instance de + (<literal>createAlias()</literal> ne crée pas de nouvelle instance de <literal>Criteria</literal>.) </para> <para> Notez que les collections kittens contenues dans les instances de <literal>Cat</literal> - retourn�es par les deux pr�c�dentes requ�tes ne sont <emphasis>pas</emphasis> pr�-filtr�es - par les crit�res ! Si vous souhaitez r�cup�rer uniquement les kittens qui correspondent � la + retournées par les deux précédentes requêtes ne sont <emphasis>pas</emphasis> pré-filtrées + par les critères ! Si vous souhaitez récupérer uniquement les kittens qui correspondent à la criteria, vous devez utiliser <literal>ResultTransformer</literal>. </para> @@ -173,11 +175,11 @@ </sect1> <sect1 id="querycriteria-dynamicfetching" revision="1"> - <title>Peuplement d'associations de mani�re dynamique</title> + <title>Peuplement d'associations de manière dynamique</title> <para> - Vous pouvez sp�ficier au moment de l'ex�cution le peuplement d'une association en utilisant - <literal>setFetchMode()</literal> (c'est-�-dire le chargement de celle-ci). + Vous pouvez spéficier au moment de l'exécution le peuplement d'une association en utilisant + <literal>setFetchMode()</literal> (c'est-à-dire le chargement de celle-ci). Cela permet de surcharger les valeurs "lazy" et "outer-join" du mapping. </para> @@ -189,18 +191,18 @@ .list();]]></programlisting> <para> - Cette requ�te recherchera <literal>mate</literal> et <literal>kittens</literal> + Cette requête recherchera <literal>mate</literal> et <literal>kittens</literal> via les jointures externes. Voir <xref linkend="performance-fetching"/> pour plus d'informations. </para> </sect1> <sect1 id="querycriteria-examples"> - <title>Requ�tes par l'exemple</title> + <title>Requêtes par l'exemple</title> <para> La classe <literal>org.hibernate.criterion.Example</literal> vous permet de - construire un crit�re suivant une instance d'objet donn�e. + construire un critère suivant une instance d'objet donnée. </para> <programlisting><![CDATA[Cat cat = new Cat(); @@ -211,12 +213,12 @@ .list();]]></programlisting> <para> - Les propri�t�s de type version, identifiant et association sont ignor�es. - Par d�faut, les valeurs null sont exclues. + Les propriétés de type version, identifiant et association sont ignorées. + Par défaut, les valeurs null sont exclues. </para> <para> - Vous pouvez ajuster la strat�gie d'utilisation de valeurs de + Vous pouvez ajuster la stratégie d'utilisation de valeurs de l'<literal>Exemple</literal>. </para> @@ -230,7 +232,7 @@ .list();]]></programlisting> <para> - Vous pouvez utiliser les "exemples" pour des crit�res sur les objets associ�s. + Vous pouvez utiliser les "exemples" pour des critères sur les objets associés. </para> <programlisting><![CDATA[List results = session.createCriteria(Cat.class) @@ -242,11 +244,11 @@ </sect1> <sect1 id="querycriteria-projection"> - <title>Projections, agr�gation et regroupement</title> + <title>Projections, agrégation et regroupement</title> <para> La classe <literal>org.hibernate.criterion.Projections</literal> est une fabrique d'instances de <literal>Projection</literal>. Nous appliquons une - projection sur une requ�te en appelant <literal>setProjection()</literal>. + projection sur une requête en appelant <literal>setProjection()</literal>. </para> <programlisting><![CDATA[List results = session.createCriteria(Cat.class) @@ -264,16 +266,16 @@ .list();]]></programlisting> <para> - Il n'y a pas besoin de "group by" explicite dans une requ�te par crit�re. - Certains types de projection sont d�finis pour �tre des <emphasis>projections + Il n'y a pas besoin de "group by" explicite dans une requête par critère. + Certains types de projection sont définis pour être des <emphasis>projections de regroupement</emphasis>, lesquels apparaissent aussi dans la clause <literal>group by</literal> SQL. </para> <para> - Un alias peut optionnellement �tre assign� � une projection, ainsi la valeur - projet�e peut �tre r�f�renc�e dans des restrictions ou des tris. Voici deux fa�ons - diff�rentes de faire �a : + Un alias peut optionnellement être assigné à une projection, ainsi la valeur + projetée peut être référencée dans des restrictions ou des tris. Voici deux façons + différentes de faire ça : </para> <programlisting><![CDATA[List results = session.createCriteria(Cat.class) @@ -287,9 +289,9 @@ .list();]]></programlisting> <para> - Les m�thodes <literal>alias()</literal> et <literal>as()</literal> enveloppe simplement - une instance de projection dans une autre instance (alias�e) de <literal>Projection</literal>. - Comme un raccourci, vous pouvez assignez un alias lorsque vous ajoutez la projection � la + Les méthodes <literal>alias()</literal> et <literal>as()</literal> enveloppe simplement + une instance de projection dans une autre instance (aliasée) de <literal>Projection</literal>. + Comme un raccourci, vous pouvez assignez un alias lorsque vous ajoutez la projection à la liste de projections : </para> @@ -337,10 +339,10 @@ </sect1> <sect1 id="querycriteria-detachedqueries"> - <title>Requ�tes et sous-requ�tes d�tach�es</title> + <title>Requêtes et sous-requêtes détachées</title> <para> - La classe <literal>DetachedCriteria</literal> vous laisse cr�er une requ�te en dehors de la - port�e de la session, et puis l'ex�cuter plus tard en utilisant n'importe quelle <literal>Session</literal> + La classe <literal>DetachedCriteria</literal> vous laisse créer une requête en dehors de la + portée de la session, et puis l'exécuter plus tard en utilisant n'importe quelle <literal>Session</literal> arbitraire. </para> @@ -354,8 +356,8 @@ session.close();]]></programlisting> <para> - Une <literal>DetachedCriteria</literal> peut aussi �tre utilis�e pour exprimer une - sous-requ�te. Des instances de criterion impliquant des sous-requ�tes peuvent �tre + Une <literal>DetachedCriteria</literal> peut aussi être utilisée pour exprimer une + sous-requête. Des instances de criterion impliquant des sous-requêtes peuvent être obtenues via <literal>Subqueries</literal> ou <literal>Property</literal>. </para> @@ -372,7 +374,7 @@ .list();]]></programlisting> <para> - M�me des requ�tes corr�l�es sont possibles : + Même des requêtes corrélées sont possibles : </para> <programlisting><![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat.class, "cat2") @@ -389,19 +391,19 @@ could also be explained. --> <sect1 id="query-criteria-naturalid"> - <title>Requ�tes par identifiant naturel</title> + <title>Requêtes par identifiant naturel</title> <para> - Pour la plupart des requ�tes, incluant les requ�tes par crit�re, le cache de requ�tes - n'est pas tr�s efficace, parce que l'invalidation du cache de requ�tes arrive trop - souvent. Cependant, il y a une sorte sp�ciale de requ�te o� nous pouvons optimiser + Pour la plupart des requêtes, incluant les requêtes par critère, le cache de requêtes + n'est pas très efficace, parce que l'invalidation du cache de requêtes arrive trop + souvent. Cependant, il y a une sorte spéciale de requête où nous pouvons optimiser l'algorithme d'invalidation du cache : les recherches sur une clef naturelle constante. - Dans certaines applications, cette sorte de requ�te se produit fr�quemment. L'API de - crit�re fournit une provision sp�ciale pour ce cas d'utilisation. + Dans certaines applications, cette sorte de requête se produit fréquemment. L'API de + critère fournit une provision spéciale pour ce cas d'utilisation. </para> <para> - D'abord vous devriez mapper la clef naturelle de votre entit� en utilisant + D'abord vous devriez mapper la clef naturelle de votre entité en utilisant <literal>&lt;natural-id&gt;</literal>, et activer l'utilisation du cache de second niveau. </para> @@ -418,12 +420,12 @@ </class>]]></programlisting> <para> - Notez que cette fonctionnalit� n'est pas pr�vue pour l'utilisation avec des - entit�s avec des clefs naturelles <emphasis>mutables</emphasis>. + Notez que cette fonctionnalité n'est pas prévue pour l'utilisation avec des + entités avec des clefs naturelles <emphasis>mutables</emphasis>. </para> <para> - Ensuite, activez le cache de requ�te d'Hibernate. + Ensuite, activez le cache de requête d'Hibernate. </para> <para> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_hql.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_hql.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_hql.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,33 +1,35 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="queryhql"> - <title>HQL: Langage de requ�tage d'Hibernate</title> + <title>HQL: Langage de requêtage d'Hibernate</title> <para> - Hibernate fourni un langage d'interrogation extr�mement puissant qui + Hibernate fourni un langage d'interrogation extrêmement puissant qui ressemble (et c'est voulu) au SQL. Mais ne soyez pas distraits par la syntaxe ; - HQL est totalement orient� objet, comprenant des notions d'h�ritage, de + HQL est totalement orienté objet, comprenant des notions d'héritage, de polymorphisme et d'association. </para> <sect1 id="queryhql-casesensitivity"> - <title>Sensibilit� � la casse</title> + <title>Sensibilité à la casse</title> <para> - Les requ�tes sont insensibles � la casse, � l'exception des noms des classes Java - et des propri�t�s. - Ainsi, <literal>SeLeCT</literal> est identique � - <literal>sELEct</literal> et � + Les requêtes sont insensibles à la casse, à l'exception des noms des classes Java + et des propriétés. + Ainsi, <literal>SeLeCT</literal> est identique à + <literal>sELEct</literal> et à <literal>SELECT</literal> mais <literal>net.sf.hibernate.eg.FOO</literal> n'est pas identique <literal>net.sf.hibernate.eg.Foo</literal> et - <literal>foo.barSet</literal> n'est pas identique � + <literal>foo.barSet</literal> n'est pas identique à <literal>foo.BARSET</literal>. </para> <para> - Ce guide utilise les mots cl�s HQL en minuscule. Certains utilisateurs trouvent les - requ�tes �crites avec les mots cl�s en majuscule plus lisibles, mais nous trouvons - cette convention p�nible lorsqu'elle est lue dans du code Java. + Ce guide utilise les mots clés HQL en minuscule. Certains utilisateurs trouvent les + requêtes écrites avec les mots clés en majuscule plus lisibles, mais nous trouvons + cette convention pénible lorsqu'elle est lue dans du code Java. </para> </sect1> @@ -36,7 +38,7 @@ <title>La clause from</title> <para> - La requ�te Hibernate la plus simple est de la forme : + La requête Hibernate la plus simple est de la forme : </para> <programlisting><![CDATA[from eg.Cat]]></programlisting> @@ -44,37 +46,37 @@ <para> qui retourne simplement toutes les instances de la classe <literal>eg.Cat</literal>. Nous n'avons pas besoin d'habitude de qualifier le nom de la classe, - puisque <literal>auto-import</literal> est la valeur par d�faut. Donc nous �crivons presque toujours : + puisque <literal>auto-import</literal> est la valeur par défaut. Donc nous écrivons presque toujours : </para> <programlisting><![CDATA[from Cat]]></programlisting> <para> La plupart du temps, vous devrez assigner un <emphasis>alias</emphasis> puisque vous - voudrez faire r�f�rence � <literal>Cat</literal> dans d'autres parties de la requ�te. + voudrez faire référence à <literal>Cat</literal> dans d'autres parties de la requête. </para> <programlisting><![CDATA[from Cat as cat]]></programlisting> <para> - Cette requ�te assigne l'alias <literal>cat</literal> � l'instance <literal>Cat</literal>, - nous pouvons donc utiliser cet alias ailleurs dans la requ�te. Le mot cl� <literal>as</literal> - est optionnel ; nous aurions pu �crire : + Cette requête assigne l'alias <literal>cat</literal> à l'instance <literal>Cat</literal>, + nous pouvons donc utiliser cet alias ailleurs dans la requête. Le mot clé <literal>as</literal> + est optionnel ; nous aurions pu écrire : </para> <programlisting><![CDATA[from Cat cat]]></programlisting> <para> - Plusieurs classes peuvent appara�tre, ce qui conduira � un produit - cart�sien (encore appel� jointures crois�es). + Plusieurs classes peuvent apparaître, ce qui conduira à un produit + cartésien (encore appelé jointures croisées). </para> <programlisting><![CDATA[from Formula, Parameter]]></programlisting> <programlisting><![CDATA[from Formula as form, Parameter as param]]></programlisting> <para> - C'est une bonne pratique que de nommer les alias dans les requ�tes en utilisant l'initiale - en miniscule, ce qui a le m�rite d'�tre en phase avec les standards de + C'est une bonne pratique que de nommer les alias dans les requêtes en utilisant l'initiale + en miniscule, ce qui a le mérite d'être en phase avec les standards de nommage Java pour les variables locales (<literal>domesticCat</literal>). </para> @@ -84,7 +86,7 @@ <title>Associations et jointures</title> <para> - On peut aussi assigner des alias � des entit�s associ�es, ou m�me aux �l�ments d'une collection + On peut aussi assigner des alias à des entités associées, ou même aux éléments d'une collection de valeurs, en utilisant un <literal>join</literal> (jointure). </para> @@ -97,13 +99,13 @@ <programlisting><![CDATA[from Formula form full join form.parameter param]]></programlisting> <para> - Les types de jointures support�es sont celles de ANSI SQL + Les types de jointures supportées sont celles de ANSI SQL </para> <itemizedlist spacing="compact"> <listitem> <para> - <literal>inner join</literal> (jointure ferm�e) + <literal>inner join</literal> (jointure fermée) </para> </listitem> <listitem> @@ -118,14 +120,14 @@ </listitem> <listitem> <para> - <literal>full join</literal> (jointure ouverte totalement - g�n�ralement inutile) + <literal>full join</literal> (jointure ouverte totalement - généralement inutile) </para> </listitem> </itemizedlist> <para> Les constructions des jointures <literal>inner join</literal>, <literal>left outer join</literal> - et <literal>right outer join</literal> peuvent �tre abbr�g�es. + et <literal>right outer join</literal> peuvent être abbrégées. </para> <programlisting><![CDATA[from Cat as cat @@ -133,7 +135,7 @@ left join cat.kittens as kitten]]></programlisting> <para> - Nous pouvons soumettre des conditions de jointure suppl�mentaires en utilisant le mot-clef HQL <literal>with</literal>. + Nous pouvons soumettre des conditions de jointure supplémentaires en utilisant le mot-clef HQL <literal>with</literal>. </para> <programlisting><![CDATA[from Cat as cat @@ -141,11 +143,11 @@ with kitten.bodyWeight > 10.0]]></programlisting> <para> - Par ailleurs, une jointure "fetch�e" (rapport�e) permet d'initialiser - les associations ou collections de valeurs en m�me temps que leur objet parent, + Par ailleurs, une jointure "fetchée" (rapportée) permet d'initialiser + les associations ou collections de valeurs en même temps que leur objet parent, le tout n'utilisant qu'un seul Select. - Ceci est particuli�rement utile dans le cas des collections. Ce syst�me permet de surcharger - les d�clarations "lazy" et "outer-join" des fichiers de mapping pour les associations et + Ceci est particulièrement utile dans le cas des collections. Ce système permet de surcharger + les déclarations "lazy" et "outer-join" des fichiers de mapping pour les associations et collections. Voir <xref linkend="performance-fetching"/> pour plus d'informations. </para> @@ -155,11 +157,11 @@ left join fetch cat.kittens]]></programlisting> <para> - Une jointure "fetch�e" (rapport�e) n'a g�n�ralement pas besoin de se voir assigner - un alias puisque les objets associ�s n'ont pas � �tre utilis�s dans les autres clauses. - Notez aussi que les objets associ�s ne sont pas retourn�s directement dans le r�sultat de - la requ�te mais l'on peut y acc�der via l'objet parent. La seule raison pour laquelle nous - pourrions avoir besoin d'un alias est si nous r�cup�rions r�cursivement une collection suppl�mentaire : + Une jointure "fetchée" (rapportée) n'a généralement pas besoin de se voir assigner + un alias puisque les objets associés n'ont pas à être utilisés dans les autres clauses. + Notez aussi que les objets associés ne sont pas retournés directement dans le résultat de + la requête mais l'on peut y accéder via l'objet parent. La seule raison pour laquelle nous + pourrions avoir besoin d'un alias est si nous récupérions récursivement une collection supplémentaire : </para> <programlisting><![CDATA[from Cat as cat @@ -168,20 +170,20 @@ left join fetch child.kittens]]></programlisting> <para> - Notez que la construction de <literal>fetch</literal> ne peut pas �tre utilis�e dans les requ�tes appel�es par + Notez que la construction de <literal>fetch</literal> ne peut pas être utilisée dans les requêtes appelées par <literal>scroll()</literal> ou <literal>iterate()</literal>. - <literal>fetch</literal> ne devrait pas non plus �tre utilis� avec <literal>setMaxResults()</literal> ou - <literal>setFirstResult()</literal>. <literal>fetch</literal> ne peut pas non plus �tre utilis� avec une + <literal>fetch</literal> ne devrait pas non plus être utilisé avec <literal>setMaxResults()</literal> ou + <literal>setFirstResult()</literal>. <literal>fetch</literal> ne peut pas non plus être utilisé avec une condition <literal>with</literal> ad hoc. Il est - possible de cr�er un produit cart�sien par jointure en r�cup�rant plus d'une collection dans une requ�te, - donc faites attention dans ce cas. R�cup�rer par jointure de multiples collections donne aussi parfois - des r�sultats inattendus pour des mappings de bag, donc soyez prudent lorsque vous formulez vos requ�tes dans de tels cas. - Finalement, notez que <literal>full join fetch</literal> et <literal>right join fetch</literal> ne sont pas utiles en g�n�ral. + possible de créer un produit cartésien par jointure en récupérant plus d'une collection dans une requête, + donc faites attention dans ce cas. Récupérer par jointure de multiples collections donne aussi parfois + des résultats inattendus pour des mappings de bag, donc soyez prudent lorsque vous formulez vos requêtes dans de tels cas. + Finalement, notez que <literal>full join fetch</literal> et <literal>right join fetch</literal> ne sont pas utiles en général. </para> <para> - Si vous utilisez un chargement retard� pour les propri�t�s (avec une instrumentation par bytecode), il est possible - de forcer Hibernate � r�cup�rer les propri�t�s non encore charg�es imm�diatement (dans la premi�re requ�te) + Si vous utilisez un chargement retardé pour les propriétés (avec une instrumentation par bytecode), il est possible + de forcer Hibernate à récupérer les propriétés non encore chargées immédiatement (dans la première requête) en utilisant <literal>fetch all properties</literal>. </para> @@ -198,15 +200,15 @@ </para> <para> - Les requ�tes pr�sentes dans la section pr�c�dente utilisent la forme <literal>explicite</literal> - o� le mode cl� join est explicitement utilis� dans la clause from. C'est la forme recommand�e. + Les requêtes présentes dans la section précédente utilisent la forme <literal>explicite</literal> + où le mode clé join est explicitement utilisé dans la clause from. C'est la forme recommandée. </para> <para> - La forme <literal>implicite</literal> n'utilise pas le mot cl� join. - A la place, les associations sont "d�r�f�renc�es" en utilisant le notation '.'. Ces + La forme <literal>implicite</literal> n'utilise pas le mot clé join. + A la place, les associations sont "déréférencées" en utilisant le notation '.'. Ces jointures peuvent apparaitre dans toutes les clauses. Les jointures <literal>implicites</literal> - r�sultent en des inner join dans le SQL g�n�r�. + résultent en des inner join dans le SQL généré. </para> <programlisting><![CDATA[from Cat as cat where cat.mate.name like '%s%']]></programlisting> @@ -216,8 +218,8 @@ <title>La clause select</title> <para> - La clause <literal>select</literal> s�lectionne les objets et propri�t�s - qui doivent �tre retourn�s dans le r�sultat de la requ�te. + La clause <literal>select</literal> sélectionne les objets et propriétés + qui doivent être retournés dans le résultat de la requête. Soit : </para> @@ -226,14 +228,14 @@ inner join cat.mate as mate]]></programlisting> <para> - La requ�te recherchera les <literal>mate</literal>s li�s aux <literal>Cat</literal>s. - Vous pouvez explimer la requ�te d'une mani�re plus compacte : + La requête recherchera les <literal>mate</literal>s liés aux <literal>Cat</literal>s. + Vous pouvez explimer la requête d'une manière plus compacte : </para> <programlisting><![CDATA[select cat.mate from Cat cat]]></programlisting> <para> - Les requ�tes peuvent retourner des propri�t�s de n'importe quel type, m�me celles de type + Les requêtes peuvent retourner des propriétés de n'importe quel type, même celles de type composant (component) : </para> @@ -243,7 +245,7 @@ <programlisting><![CDATA[select cust.name.firstName from Customer as cust]]></programlisting> <para> - Les requ�tes peuvent retourner plusieurs objets et/ou propri�t�s sous la forme + Les requêtes peuvent retourner plusieurs objets et/ou propriétés sous la forme d'un tableau du type <literal>Object[]</literal>, </para> @@ -262,7 +264,7 @@ left outer join mother.kittens as offspr]]></programlisting> <para> - ou sous la forme d'un objet Java typ�, + ou sous la forme d'un objet Java typé, </para> <programlisting><![CDATA[select new Family(mother, mate, offspr) @@ -271,18 +273,18 @@ left join mother.kittens as offspr]]></programlisting> <para> - � condition que la classe <literal>Family</literal> poss�de le constructeur appropri�. + à condition que la classe <literal>Family</literal> possède le constructeur approprié. </para> <para> - Vous pouvez assigner des alias aux expressions s�lectionn�es en utilisant <literal>as</literal> : + Vous pouvez assigner des alias aux expressions sélectionnées en utilisant <literal>as</literal> : </para> <programlisting><![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n from Cat cat]]></programlisting> <para> - C'est surtout utile lorsque c'est utilis� avec + C'est surtout utile lorsque c'est utilisé avec <literal>select new map</literal> : </para> @@ -290,17 +292,17 @@ from Cat cat]]></programlisting> <para> - Cette requ�te retourne une <literal>Map</literal> � partir des alias vers les valeurs s�lectionn�es. + Cette requête retourne une <literal>Map</literal> à partir des alias vers les valeurs sélectionnées. </para> </sect1> <sect1 id="queryhql-aggregation"> - <title>Fonctions d'aggr�gation</title> + <title>Fonctions d'aggrégation</title> <para> - Les requ�tes HQL peuvent aussi retourner le r�sultat de fonctions d'aggr�gation - sur les propri�t�s : + Les requêtes HQL peuvent aussi retourner le résultat de fonctions d'aggrégation + sur les propriétés : </para> <programlisting><![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat) @@ -317,7 +319,7 @@ --> <para> - Les fonctions support�es sont + Les fonctions supportées sont </para> <itemizedlist spacing="compact"> @@ -339,7 +341,7 @@ </itemizedlist> <para> - Vous pouvez utiliser des op�rateurs arithm�tiques, la concat�nation, et des fonctions SQL reconnues dans la clause select : + Vous pouvez utiliser des opérateurs arithmétiques, la concaténation, et des fonctions SQL reconnues dans la clause select : </para> <programlisting><![CDATA[select cat.weight + sum(kitten.weight) @@ -350,8 +352,8 @@ <programlisting><![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]></programlisting> <para> - Les mots cl� <literal>distinct</literal> et <literal>all</literal> peuvent �tre utilis�s et ont - la m�me signification qu'en SQL. + Les mots clé <literal>distinct</literal> et <literal>all</literal> peuvent être utilisés et ont + la même signification qu'en SQL. </para> <programlisting><![CDATA[select distinct cat.name from Cat cat @@ -361,34 +363,34 @@ </sect1> <sect1 id="queryhql-polymorphism"> - <title>Requ�tes polymorphiques</title> + <title>Requêtes polymorphiques</title> <para> - Une requ�te comme: + Une requête comme: </para> <programlisting><![CDATA[from Cat as cat]]></programlisting> <para> retourne non seuleument les instances de <literal>Cat</literal>, mais aussi celles des - sous classes comme <literal>DomesticCat</literal>. Les requ�tes Hibernate peuvent nommer n'importe - quelle classe ou interface Java dans la clause <literal>from</literal>. La requ�te retournera les - instances de toutes les classes persistantes qui �tendent cette classe ou impl�mente cette interface. - La requ�te suivante retournera tous les objets persistants : + sous classes comme <literal>DomesticCat</literal>. Les requêtes Hibernate peuvent nommer n'importe + quelle classe ou interface Java dans la clause <literal>from</literal>. La requête retournera les + instances de toutes les classes persistantes qui étendent cette classe ou implémente cette interface. + La requête suivante retournera tous les objets persistants : </para> <programlisting><![CDATA[from java.lang.Object o]]></programlisting> <para> - L'interface <literal>Named</literal> peut �tre impl�ment�e par plusieurs classes persistantes : + L'interface <literal>Named</literal> peut être implémentée par plusieurs classes persistantes : </para> <programlisting><![CDATA[from Named n, Named m where n.name = m.name]]></programlisting> <para> - Notez que ces deux derni�res requ�tes n�cessitent plus d'un <literal>SELECT</literal> SQL. - Ce qui signifie que la clause <literal>order by</literal> ne trie pas correctement la totalit� - des r�sultats (cela signifie aussi que vous ne pouvez ex�cuter ces requ�tes en appelant + Notez que ces deux dernières requêtes nécessitent plus d'un <literal>SELECT</literal> SQL. + Ce qui signifie que la clause <literal>order by</literal> ne trie pas correctement la totalité + des résultats (cela signifie aussi que vous ne pouvez exécuter ces requêtes en appelant <literal>Query.scroll()</literal>). </para> @@ -398,20 +400,20 @@ <title>La clause where</title> <para> - La clause <literal>where</literal> vous permet de r�duire la liste des instances retourn�es. - Si aucun alias n'existe, vous pouvez vous r�f�rer aux propri�t�s par leur nom : + La clause <literal>where</literal> vous permet de réduire la liste des instances retournées. + Si aucun alias n'existe, vous pouvez vous référer aux propriétés par leur nom : </para> <programlisting><![CDATA[from Cat where name='Fritz']]></programlisting> <para> - S'il y a un alias, utilisez un nom de propri�t� qualifi� : + S'il y a un alias, utilisez un nom de propriété qualifié : </para> <programlisting><![CDATA[from Cat as cat where cat.name='Fritz']]></programlisting> <para> - retourne les instances de <literal>Cat</literal> dont name est �gale � 'Fritz'. + retourne les instances de <literal>Cat</literal> dont name est égale à 'Fritz'. </para> <programlisting><![CDATA[select foo @@ -421,28 +423,28 @@ <para> retournera les instances de <literal>Foo</literal> pour lesquelles il existe une instance de <literal>bar</literal> avec la - propri�t� <literal>date</literal> est �gale � la - propri�t� <literal>startDate</literal> de <literal>Foo</literal>. + propriété <literal>date</literal> est égale à la + propriété <literal>startDate</literal> de <literal>Foo</literal>. Les expressions utilisant la navigation rendent la clause <literal>where</literal> - extr�mement puissante. Soit : + extrêmement puissante. Soit : </para> <programlisting><![CDATA[from Cat cat where cat.mate.name is not null]]></programlisting> <para> - Cette requ�te se traduit en SQL par une jointure interne � une table. - Si vous souhaitez �crire quelque chose comme : + Cette requête se traduit en SQL par une jointure interne à une table. + Si vous souhaitez écrire quelque chose comme : </para> <programlisting><![CDATA[from Foo foo where foo.bar.baz.customer.address.city is not null]]></programlisting> <para> - vous finiriez avec une requ�te qui n�cessiterait quatre jointures en SQL. + vous finiriez avec une requête qui nécessiterait quatre jointures en SQL. </para> <para> - L'op�rateur <literal>=</literal> peut �tre utilis� pour comparer aussi bien des propri�t�s que des instances : + L'opérateur <literal>=</literal> peut être utilisé pour comparer aussi bien des propriétés que des instances : </para> <programlisting><![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]></programlisting> @@ -452,9 +454,9 @@ where cat.mate = mate]]></programlisting> <para> - La propri�t� sp�ciale (en minuscule) <literal>id</literal> peut �tre utilis�e - pour faire r�f�rence � l'identifiant d'un objet (vous pouvez aussi utiliser - le nom de cette propri�t�). + La propriété spéciale (en minuscule) <literal>id</literal> peut être utilisée + pour faire référence à l'identifiant d'un objet (vous pouvez aussi utiliser + le nom de cette propriété). </para> <programlisting><![CDATA[from Cat as cat where cat.id = 123 @@ -462,12 +464,12 @@ from Cat as cat where cat.mate.id = 69]]></programlisting> <para> - La seconde requ�te est particuli�rement efficace. Aucune jointure n'est n�cessaire ! + La seconde requête est particulièrement efficace. Aucune jointure n'est nécessaire ! </para> <para> - Les propri�t�s d'un identifiant compos� peuvent aussi �tre utilis�es. Supposez que - <literal>Person</literal> ait un identifiant compos� de <literal>country</literal> et + Les propriétés d'un identifiant composé peuvent aussi être utilisées. Supposez que + <literal>Person</literal> ait un identifiant composé de <literal>country</literal> et <literal>medicareNumber</literal>. </para> @@ -480,22 +482,22 @@ and account.owner.id.medicareNumber = 123456]]></programlisting> <para> - Une fois de plus, la seconde requ�te ne n�cessite pas de jointure. + Une fois de plus, la seconde requête ne nécessite pas de jointure. </para> <para> - De m�me, la propri�t� sp�ciale <literal>class</literal> interroge la valeur discriminante - d'une instance dans le cas d'une persistance polymorphique. Le nom d'une classe Java incorpor�e + De même, la propriété spéciale <literal>class</literal> interroge la valeur discriminante + d'une instance dans le cas d'une persistance polymorphique. Le nom d'une classe Java incorporée dans la clause where sera traduite par sa valeur discriminante. </para> <programlisting><![CDATA[from Cat cat where cat.class = DomesticCat]]></programlisting> <para> - Vous pouvez aussi sp�cifier les propri�t�s des composants ou types utilisateurs compos�s + Vous pouvez aussi spécifier les propriétés des composants ou types utilisateurs composés (components, composite user types etc). N'essayez jamais d'utiliser un expression de navigation - qui se terminerait par une propri�t� de type composant (qui est diff�rent d'une propri�t� d'un - composant). Par exemple, si <literal>store.owner</literal> est une entit� avec un composant + qui se terminerait par une propriété de type composant (qui est différent d'une propriété d'un + composant). Par exemple, si <literal>store.owner</literal> est une entité avec un composant <literal>address</literal> </para> @@ -503,17 +505,17 @@ store.owner.address // error!]]></programlisting> <para> - Un type "any" poss�de les propri�t�s sp�ciales <literal>id</literal> et <literal>class</literal>, - qui nous permettent d'exprimer une jointure de la mani�re suivante (o� <literal>AuditLog.item</literal> - est une propri�t� mapp�e avec <literal>&lt;any&gt;</literal>). + Un type "any" possède les propriétés spéciales <literal>id</literal> et <literal>class</literal>, + qui nous permettent d'exprimer une jointure de la manière suivante (où <literal>AuditLog.item</literal> + est une propriété mappée avec <literal>&lt;any&gt;</literal>). </para> <programlisting><![CDATA[from AuditLog log, Payment payment where log.item.class = 'Payment' and log.item.id = payment.id]]></programlisting> <para> - Dans la requ�te pr�c�dente, notez que <literal>log.item.class</literal> et <literal>payment.class</literal> - feraient r�f�rence � des valeurs de colonnes de la base de donn�es compl�tement diff�rentes. + Dans la requête précédente, notez que <literal>log.item.class</literal> et <literal>payment.class</literal> + feraient référence à des valeurs de colonnes de la base de données complètement différentes. </para> </sect1> @@ -529,22 +531,22 @@ <itemizedlist spacing="compact"> <listitem> <para> - op�rateurs math�matiques <literal>+, -, *, /</literal> + opérateurs mathématiques <literal>+, -, *, /</literal> </para> </listitem> <listitem> <para> - op�rateur de comparaison binaire <literal>=, &gt;=, &lt;=, &lt;&gt;, !=, like</literal> + opérateur de comparaison binaire <literal>=, &gt;=, &lt;=, &lt;&gt;, !=, like</literal> </para> </listitem> <listitem> <para> - op�rateurs logiques <literal>and, or, not</literal> + opérateurs logiques <literal>and, or, not</literal> </para> </listitem> <listitem> <para> - Parenth�ses <literal>( )</literal>, indiquant un regroupement + Parenthèses <literal>( )</literal>, indiquant un regroupement </para> </listitem> <listitem> @@ -568,7 +570,7 @@ </listitem> <listitem> <para> - concatenation de cha�ne de caract�res <literal>...||...</literal> ou <literal>concat(...,...)</literal> + concatenation de chaîne de caractères <literal>...||...</literal> ou <literal>concat(...,...)</literal> </para> </listitem> <listitem> @@ -586,7 +588,7 @@ </listitem> <listitem> <para> - N'importe quel fonction ou op�rateur d�fini par EJB-QL 3.0 : <literal>substring(), trim(), + N'importe quel fonction ou opérateur défini par EJB-QL 3.0 : <literal>substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()</literal> </para> </listitem> @@ -597,48 +599,48 @@ </listitem> <listitem> <para> - <literal>str()</literal> pour convertir des valeurs num�riques ou temporelles vers une cha�ne de caract�res lisible + <literal>str()</literal> pour convertir des valeurs numériques ou temporelles vers une chaîne de caractères lisible </para> </listitem> <listitem> <para> - <literal>cast(... as ...)</literal>, o� le second argument est le nom d'un type Hibernate, et <literal>extract(... from ...)</literal> si le - <literal>cast()</literal> ANSI et <literal>extract()</literal> sont support�s par la base de donn�es sous-jacente + <literal>cast(... as ...)</literal>, où le second argument est le nom d'un type Hibernate, et <literal>extract(... from ...)</literal> si le + <literal>cast()</literal> ANSI et <literal>extract()</literal> sont supportés par la base de données sous-jacente </para> </listitem> <listitem> <para> - La fonction HQL <literal>index()</literal>, qui s'applique aux alias d'une collection index�e jointe + La fonction HQL <literal>index()</literal>, qui s'applique aux alias d'une collection indexée jointe </para> </listitem> <listitem> <para> - Les fonctions HQL qui s'appliquent expressions repr�sentant des collections : <literal>size(), - minelement(), maxelement(), minindex(), maxindex()</literal>, ainsi que les fonctions sp�ciales <literal>elements()</literal> - et <literal>indices</literal> qui peuvent �tre quantifi�es en utilisant <literal>some, all, exists, any, in</literal>. + Les fonctions HQL qui s'appliquent expressions représentant des collections : <literal>size(), + minelement(), maxelement(), minindex(), maxindex()</literal>, ainsi que les fonctions spéciales <literal>elements()</literal> + et <literal>indices</literal> qui peuvent être quantifiées en utilisant <literal>some, all, exists, any, in</literal>. </para> </listitem> <listitem> <para> - N'importe quelle fonction scalaire support�e par la base de donn�es comme + N'importe quelle fonction scalaire supportée par la base de données comme <literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</literal> </para> </listitem> <listitem> <para> - Les param�tres positionnels de JDBC + Les paramètres positionnels de JDBC <literal>?</literal> </para> </listitem> <listitem> <para> - param�tres nomm�s <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal> + paramètres nommés <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal> </para> </listitem> <listitem> <para> - litt�ral SQL <literal>'foo'</literal>, <literal>69</literal>, <literal>'1970-01-01 10:00:01.0'</literal> + littéral SQL <literal>'foo'</literal>, <literal>69</literal>, <literal>'1970-01-01 10:00:01.0'</literal> </para> </listitem> <listitem> @@ -649,7 +651,7 @@ </itemizedlist> <para> - <literal>in</literal> et <literal>between</literal> peuvent �tre utilis�s comme suit : + <literal>in</literal> et <literal>between</literal> peuvent être utilisés comme suit : </para> <programlisting><![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]></programlisting> @@ -657,7 +659,7 @@ <programlisting><![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]></programlisting> <para> - et la forme n�gative peut �tre �crite + et la forme négative peut être écrite </para> <programlisting><![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]></programlisting> @@ -665,27 +667,27 @@ <programlisting><![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]></programlisting> <para> - De m�me, <literal>is null</literal> et <literal>is not null</literal> peuvent �tre utilis�s pour tester + De même, <literal>is null</literal> et <literal>is not null</literal> peuvent être utilisés pour tester les valeurs nulle. </para> <para> - Les bool�ens peuvent �tre facilement utilis�s en d�clarant les substitutions de requ�tes dans la + Les booléens peuvent être facilement utilisés en déclarant les substitutions de requêtes dans la configuration Hibernate : </para> <programlisting><![CDATA[<property name="hibernate.query.substitutions">true 1, false 0</property>]]></programlisting> <para> - Ce qui remplacera les mots cl�s <literal>true</literal> et <literal>false</literal> par + Ce qui remplacera les mots clés <literal>true</literal> et <literal>false</literal> par <literal>1</literal> et <literal>0</literal> dans la traduction SQL du HQL suivant : </para> <programlisting><![CDATA[from Cat cat where cat.alive = true]]></programlisting> <para> - Vous pouvez tester la taille d'une collection par la propri�t� sp�ciale <literal>size</literal>, ou - la fonction sp�ciale <literal>size()</literal>. + Vous pouvez tester la taille d'une collection par la propriété spéciale <literal>size</literal>, ou + la fonction spéciale <literal>size()</literal>. </para> <programlisting><![CDATA[from Cat cat where cat.kittens.size > 0]]></programlisting> @@ -693,9 +695,9 @@ <programlisting><![CDATA[from Cat cat where size(cat.kittens) > 0]]></programlisting> <para> - Pour les collections index�es, vous pouvez faire r�f�rence aux indices minimum et maximum en - utilisant les fonctions <literal>minindex</literal> and <literal>maxindex</literal>. De mani�re similaire, - vous pouvez faire r�f�rence aux �l�ments minimum et maximum d'une collection de type basiques + Pour les collections indexées, vous pouvez faire référence aux indices minimum et maximum en + utilisant les fonctions <literal>minindex</literal> and <literal>maxindex</literal>. De manière similaire, + vous pouvez faire référence aux éléments minimum et maximum d'une collection de type basiques en utilisant les fonctions <literal>minelement</literal> et <literal>maxelement</literal>. </para> @@ -706,9 +708,9 @@ <programlisting><![CDATA[from Order order where minelement(order.items) > 10000]]></programlisting> <para> - Les fonctions SQL <literal>any, some, all, exists, in</literal> supportent que leur soient pass�es - l'�l�ment, l'index d'une collection (fonctions <literal>elements</literal> et <literal>indices</literal>) - ou le r�sultat d'une sous requ�te (voir ci dessous). + Les fonctions SQL <literal>any, some, all, exists, in</literal> supportent que leur soient passées + l'élément, l'index d'une collection (fonctions <literal>elements</literal> et <literal>indices</literal>) + ou le résultat d'une sous requête (voir ci dessous). </para> <programlisting><![CDATA[select mother from Cat as mother, Cat as kit @@ -724,13 +726,13 @@ <programlisting><![CDATA[from Show show where 'fizard' in indices(show.acts)]]></programlisting> <para> - Notez que l'�criture de - <literal>size</literal>, <literal>elements</literal>, + Notez que l'écriture de - <literal>size</literal>, <literal>elements</literal>, <literal>indices</literal>, <literal>minindex</literal>, <literal>maxindex</literal>, - <literal>minelement</literal>, <literal>maxelement</literal> - peuvent seulement �tre utilis�e dans la clause where dans Hibernate3. + <literal>minelement</literal>, <literal>maxelement</literal> - peuvent seulement être utilisée dans la clause where dans Hibernate3. </para> <para> - Les �l�ments de collections index�es (arrays, lists, maps) peuvent �tre r�f�renc�s via index + Les éléments de collections indexées (arrays, lists, maps) peuvent être référencés via index (dans une clause where seulement) : </para> @@ -747,14 +749,14 @@ where order.items[ maxindex(order.items) ] = item and order.id = 11]]></programlisting> <para> - L'expression entre <literal>[]</literal> peut m�me �tre une expression arithm�tique. + L'expression entre <literal>[]</literal> peut même être une expression arithmétique. </para> <programlisting><![CDATA[select item from Item item, Order order where order.items[ size(order.items) - 1 ] = item]]></programlisting> <para> - HQL propose aussi une fonction <literal>index()</literal> interne, pour les �l�ments + HQL propose aussi une fonction <literal>index()</literal> interne, pour les éléments d'une association one-to-many ou d'une collections de valeurs. </para> @@ -763,14 +765,14 @@ where index(item) < 5]]></programlisting> <para> - Les fonctions SQL scalaires support�es par la base de donn�es utilis�e peuvent �tre utilis�es + Les fonctions SQL scalaires supportées par la base de données utilisée peuvent être utilisées </para> <programlisting><![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]></programlisting> <para> - Si vous n'�tes pas encore convaincu par tout cela, imaginez la taille et l'illisibilit� qui caract�riseraient - la transformation SQL de la requ�te HQL suivante : + Si vous n'êtes pas encore convaincu par tout cela, imaginez la taille et l'illisibilité qui caractériseraient + la transformation SQL de la requête HQL suivante : </para> <programlisting><![CDATA[select cust @@ -809,8 +811,8 @@ <title>La clause order by</title> <para> - La liste retoun�e par la requ�te peut �tre tri�e par n'importe quelle propri�t� de la classe ou - du composant retourn� : + La liste retounée par la requête peut être triée par n'importe quelle propriété de la classe ou + du composant retourné : </para> <programlisting><![CDATA[from DomesticCat cat @@ -818,7 +820,7 @@ <para> Le mot optionnel <literal>asc</literal> ou <literal>desc</literal> indique respectivement si le tri - doit �tre croissant ou d�croissant. + doit être croissant ou décroissant. </para> </sect1> @@ -826,7 +828,7 @@ <title>La clause group by</title> <para> - Si la requ�te retourne des valeurs aggr�g�es, celles ci peuvent �tre group�es par propri�t� ou composant : + Si la requête retourne des valeurs aggrégées, celles ci peuvent être groupées par propriété ou composant : </para> <programlisting><![CDATA[select cat.color, sum(cat.weight), count(cat) @@ -847,8 +849,8 @@ having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]></programlisting> <para> - Les fonctions SQL et les fonctions d'aggr�gations sont permises dans les clauses <literal>having</literal> - et <literal>order by</literal>, si elles sont support�es par la base de donn�es (ce que ne fait pas MySQL par exemple). + Les fonctions SQL et les fonctions d'aggrégations sont permises dans les clauses <literal>having</literal> + et <literal>order by</literal>, si elles sont supportées par la base de données (ce que ne fait pas MySQL par exemple). </para> <programlisting><![CDATA[select cat @@ -860,19 +862,19 @@ <para> Notez que ni la clause <literal>group by</literal> ni la clause - <literal>order by</literal> ne peuvent contenir d'expressions arithm�tiques. + <literal>order by</literal> ne peuvent contenir d'expressions arithmétiques. </para> </sect1> <sect1 id="queryhql-subqueries" revision="2"> - <title>Sous-requ�tes</title> + <title>Sous-requêtes</title> <para> - Pour les bases de donn�es le supportant, Hibernate supporte les sous requ�tes dans les requ�tes. - Une sous requ�te doit �tre entre parenth�ses (souvent pour un appel � une fonction d'agr�gation SQL) - M�me les sous requ�tes corr�l�es (celles qui font r�f�rence � un alias de la requ�te principale) sont - support�es. + Pour les bases de données le supportant, Hibernate supporte les sous requêtes dans les requêtes. + Une sous requête doit être entre parenthèses (souvent pour un appel à une fonction d'agrégation SQL) + Même les sous requêtes corrélées (celles qui font référence à un alias de la requête principale) sont + supportées. </para> <programlisting><![CDATA[from Cat as fatcat @@ -899,11 +901,11 @@ from Cat as cat]]></programlisting> <para> - Notez que les sous-requ�tes HQL peuvent arriver seulememnt dans les clauses select ou where. + Notez que les sous-requêtes HQL peuvent arriver seulememnt dans les clauses select ou where. </para> <para> - Pour des sous-requ�tes avec plus d'une expression dans le select, vous pouvez utiliser un constructeur de tuples : + Pour des sous-requêtes avec plus d'une expression dans le select, vous pouvez utiliser un constructeur de tuples : </para> <programlisting><![CDATA[from Cat as cat @@ -912,22 +914,22 @@ )]]></programlisting> <para> - Notez que sur certaines bases de donn�es (mais par Oracle ou HSQL), vous pouvez utiliser des constructeurs de tuples - dans d'autres contextes, par exemple lors du requ�tage de composants ou de types utilisateur composites : + Notez que sur certaines bases de données (mais par Oracle ou HSQL), vous pouvez utiliser des constructeurs de tuples + dans d'autres contextes, par exemple lors du requêtage de composants ou de types utilisateur composites : </para> <programlisting><![CDATA[from Person where name = ('Gavin', 'A', 'King')]]></programlisting> <para> - Ce qui est �quivalent � la forme plus verbeuse suivante : + Ce qui est équivalent à la forme plus verbeuse suivante : </para> <programlisting><![CDATA[from Person where name.first = 'Gavin' and name.initial = 'A' and name.last = 'King')]]></programlisting> <para> Il y a deux bonnes raisons que vous ne puissiez ne pas vouloir faire cette sorte de choses : d'abord, ce n'est - pas compl�tement portable entre les plateformes de base de donn�es ; deuxi�mement, la requ�te est maintenant - d�pendante de l'ordre des propri�t�s dans le document de mapping. + pas complètement portable entre les plateformes de base de données ; deuxièmement, la requête est maintenant + dépendante de l'ordre des propriétés dans le document de mapping. </para> </sect1> @@ -936,19 +938,19 @@ <title>Exemples HQL</title> <para> - Les requ�tes Hibernate peuvent �tre relativement puissantes et complexes. En fait, la puissance - du langage de requ�tage est l'un des avantages principaux d'Hibernate. Voici quelques exemples - tr�s similaires aux requ�tes que nous avons utilis�es lors d'un r�cent projet. Notez que la plupart - des requ�tes que vous �crirez seront plus simples que les exemples suivantes ! + Les requêtes Hibernate peuvent être relativement puissantes et complexes. En fait, la puissance + du langage de requêtage est l'un des avantages principaux d'Hibernate. Voici quelques exemples + très similaires aux requêtes que nous avons utilisées lors d'un récent projet. Notez que la plupart + des requêtes que vous écrirez seront plus simples que les exemples suivantes ! </para> <para> - La requ�te suivante retourne l'id de commande (order), le nombre d'articles (items) et la valeur - totale de la commande (order) pour toutes les commandes non pay�es d'un client (customer) particulier - pour un total minimum donn�, le tout tri� par la valeur totale. La requ�te SQL g�n�r�e sur les tables + La requête suivante retourne l'id de commande (order), le nombre d'articles (items) et la valeur + totale de la commande (order) pour toutes les commandes non payées d'un client (customer) particulier + pour un total minimum donné, le tout trié par la valeur totale. La requête SQL générée sur les tables <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, - <literal>CATALOG</literal> et <literal>PRICE</literal> est compos�e de quatre jointures interne ainsi que - d'une sous-requ�te (non corr�l�e). + <literal>CATALOG</literal> et <literal>PRICE</literal> est composée de quatre jointures interne ainsi que + d'une sous-requête (non corrélée). </para> <programlisting><![CDATA[select order.id, sum(price.amount), count(item) @@ -972,8 +974,8 @@ <para> Quel monstre ! - En principe, nous ne sommes pas tr�s fan des sous-requ�tes, la requ�te ressemblait donc plut�t - � cela : + En principe, nous ne sommes pas très fan des sous-requêtes, la requête ressemblait donc plutôt + à cela : </para> <programlisting><![CDATA[select order.id, sum(price.amount), count(item) @@ -991,10 +993,10 @@ order by sum(price.amount) desc]]></programlisting> <para> - La requ�te suivante compte le nombre de paiements (payments) pour chaque status, en excluant - les paiements dans le status <literal>AWAITING_APPROVAL</literal> o� le changement de status - le plus r�cent � �t� fait par l'utilisateur courant. En SQL, cette requ�te effectue deux - jointures internes et des sous requ�tes corr�l�es sur les tables <literal>PAYMENT</literal>, + La requête suivante compte le nombre de paiements (payments) pour chaque status, en excluant + les paiements dans le status <literal>AWAITING_APPROVAL</literal> où le changement de status + le plus récent à été fait par l'utilisateur courant. En SQL, cette requête effectue deux + jointures internes et des sous requêtes corrélées sur les tables <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> et <literal>PAYMENT_STATUS_CHANGE</literal>. </para> @@ -1015,8 +1017,8 @@ order by status.sortOrder]]></programlisting> <para> - Si nous avions mapp� la collection <literal>statusChanges</literal> comme une liste, au lieu d'un ensemble, - la requ�te aurait �t� plus facile � �crire. + Si nous avions mappé la collection <literal>statusChanges</literal> comme une liste, au lieu d'un ensemble, + la requête aurait été plus facile à écrire. </para> <programlisting><![CDATA[select count(payment), status.name @@ -1028,10 +1030,10 @@ order by status.sortOrder]]></programlisting> <para> - La requ�te qui suit utilise la fonction de MS SQL <literal>isNull()</literal> pour retourner - tous les comptes (accounts) et paiements (payments) impay�s pour l'organisation � laquelle + La requête qui suit utilise la fonction de MS SQL <literal>isNull()</literal> pour retourner + tous les comptes (accounts) et paiements (payments) impayés pour l'organisation à laquelle l'uilisateur (user) courant appartient. Elle est traduite en SQL par trois jointures internes, - une jointure externe ainsi qu'une sous requ�te sur les tables <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, + une jointure externe ainsi qu'une sous requête sur les tables <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, <literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> et <literal>ORG_USER</literal>. </para> @@ -1044,7 +1046,7 @@ order by account.type.sortOrder, account.accountNumber, payment.dueDate]]></programlisting> <para> - Pour d'autres base de donn�es, nous aurions d� faire sans la sous-requ�te (corr�l�e). + Pour d'autres base de données, nous aurions dû faire sans la sous-requête (corrélée). </para> <programlisting><![CDATA[select account, payment @@ -1058,12 +1060,12 @@ </sect1> <sect1 id="queryhql-bulk" revision="2"> - <title>Mise � jour et suppression</title> + <title>Mise à jour et suppression</title> <para> HQL supporte maintenant les expressions <literal>update</literal>, <literal>delete</literal> et <literal>insert ... select ...</literal>. - Voir <xref linkend="batch-direct"/> pour les d�tails. + Voir <xref linkend="batch-direct"/> pour les détails. </para> </sect1> @@ -1071,13 +1073,13 @@ <title>Trucs &amp; Astuces</title> <para> - Vous pouvez compter le nombre de r�sultats d'une requ�te sans les retourner : + Vous pouvez compter le nombre de résultats d'une requête sans les retourner : </para> <programlisting><![CDATA[( (Integer) session.createQuery("select count(*) from ....").iterate().next() ).intValue()]]></programlisting> <para> - Pour trier les r�sultats par la taille d'une collection, utilisez la requ�te suivante : + Pour trier les résultats par la taille d'une collection, utilisez la requête suivante : </para> <programlisting><![CDATA[select usr.id, usr.name @@ -1087,14 +1089,14 @@ order by count(msg)]]></programlisting> <para> - Si votre base de donn�es supporte les sous-requ�tes, vous pouvez placer des - conditions sur la taille de la s�lection dans la clause where de votre requ�te: + Si votre base de données supporte les sous-requêtes, vous pouvez placer des + conditions sur la taille de la sélection dans la clause where de votre requête: </para> <programlisting><![CDATA[from User usr where size(usr.messages) >= 1]]></programlisting> <para> - Si votre base de donn�es ne supporte pas les sous-requ�tes, utilisez la requ�te suivante : + Si votre base de données ne supporte pas les sous-requêtes, utilisez la requête suivante : </para> <programlisting><![CDATA[select usr.id, usr.name @@ -1104,8 +1106,8 @@ having count(msg) >= 1]]></programlisting> <para> - Cette solution ne peut pas retourner un <literal>User</literal> avec z�ro message - � cause de la jointure interne, la forme suivante peut donc �tre utile : + Cette solution ne peut pas retourner un <literal>User</literal> avec zéro message + à cause de la jointure interne, la forme suivante peut donc être utile : </para> <programlisting><![CDATA[select usr.id, usr.name @@ -1115,7 +1117,7 @@ having count(msg) = 0]]></programlisting> <para> - Les propri�t�s d'un JavaBean peuvent �tre inject�es dans les param�tres nomm�s d'un requ�te : + Les propriétés d'un JavaBean peuvent être injectées dans les paramètres nommés d'un requête : </para> <programlisting><![CDATA[Query q = s.createQuery("from foo Foo as foo where foo.name=:name and foo.size=:size"); @@ -1132,14 +1134,14 @@ List page = q.list();]]></programlisting> <para> - Les �l�ments d'une collection peuvent �tre tri�s ou group�s en utilisant un filtre de requ�te : + Les éléments d'une collection peuvent être triés ou groupés en utilisant un filtre de requête : </para> <programlisting><![CDATA[Collection orderedCollection = s.filter( collection, "order by this.amount" ); Collection counts = s.filter( collection, "select this.type, count(this) group by this.type" );]]></programlisting> <para> - Vous pouvez r�cup�rer la taille d'une collection sans l'initialiser : + Vous pouvez récupérer la taille d'une collection sans l'initialiser : </para> <programlisting><![CDATA[( (Integer) session.createQuery("select count(*) from ....").iterate().next() ).intValue();]]></programlisting> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_sql.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_sql.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/query_sql.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,46 +1,48 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="querysql" revision="2"> <title>SQL natif</title> <para> - Vous pouvez aussi �crire vos requ�tes dans le dialecte SQL natif de votre base de donn�es. - Ceci est utile si vous souhaitez utiliser les fonctionnalit�s sp�cifiques de votre base de - donn�es comme le mot cl� <literal>CONNECT</literal> d'Oracle. Cette fonctionnalit� offre par ailleurs un moyen - de migration plus propre et doux d'une application bas�e sur SQL/JDBC vers + Vous pouvez aussi écrire vos requêtes dans le dialecte SQL natif de votre base de données. + Ceci est utile si vous souhaitez utiliser les fonctionnalités spécifiques de votre base de + données comme le mot clé <literal>CONNECT</literal> d'Oracle. Cette fonctionnalité offre par ailleurs un moyen + de migration plus propre et doux d'une application basée sur SQL/JDBC vers une application Hibernate. </para> - <para>Hibernate3 vous permet de sp�cifier du SQL �crit � la main (incluant les proc�dures stock�es) - pour toutes les op�rations de cr�ation, mise � jour, suppression et chargement.</para> + <para>Hibernate3 vous permet de spécifier du SQL écrit à la main (incluant les procédures stockées) + pour toutes les opérations de création, mise à jour, suppression et chargement.</para> <sect1 id="querysql-creating" revision="3"> <title>Utiliser une <literal>SQLQuery</literal></title> - <para>L'ex�cution des requ�tes en SQL natif est contr�l�e par l'interface <literal>SQLQuery</literal>, + <para>L'exécution des requêtes en SQL natif est contrôlée par l'interface <literal>SQLQuery</literal>, laquelle est obtenue en appelant <literal>Session.createSQLQuery()</literal>. - Dans des cas extr�mement simples, nous pouvons utiliser la forme suivante : + Dans des cas extrêmement simples, nous pouvons utiliser la forme suivante : </para> <programlisting>List cats = sess.createSQLQuery("select * from cats") .addEntity(Cat.class) .list();</programlisting> - <para>Cette requ�te a sp�cifi� :</para> + <para>Cette requête a spécifié :</para> <itemizedlist> <listitem> - <para>la requ�te SQL</para> + <para>la requête SQL</para> </listitem> <listitem> - <para>l'entit� retourn�e par la requ�te</para> + <para>l'entité retournée par la requête</para> </listitem> </itemizedlist> <para> - Ici, les noms de colonne des r�sultats sont suppos�s �tre les m�mes que les noms de colonne sp�cifi�s dans le - document de mapping. Cela peut �tre probl�matique pour des requ�tes SQL qui joignent de multiple tables, puisque - les m�mes noms de colonne peuvent appara�tre dans plus d'une table. La forme suivante n'est pas vuln�rable � la + Ici, les noms de colonne des résultats sont supposés être les mêmes que les noms de colonne spécifiés dans le + document de mapping. Cela peut être problématique pour des requêtes SQL qui joignent de multiple tables, puisque + les mêmes noms de colonne peuvent apparaître dans plus d'une table. La forme suivante n'est pas vulnérable à la duplication des noms de colonne : </para> @@ -48,26 +50,26 @@ .addEntity("cat", Cat.class) .list();</programlisting> - <para>Cette requ�te a sp�cifi� :</para> + <para>Cette requête a spécifié :</para> <itemizedlist> <listitem> - <para>la requ�te SQL, avec un param�tre fictif pour Hibernate pour injecter les alias de colonne</para> + <para>la requête SQL, avec un paramètre fictif pour Hibernate pour injecter les alias de colonne</para> </listitem> <listitem> - <para>l'entit� retourn�e par la requ�te, et son alias de table SQL</para> + <para>l'entité retournée par la requête, et son alias de table SQL</para> </listitem> </itemizedlist> <para> - La m�thode <literal>addEntity()</literal> associe l'alias de la table SQL - avec la classe de l'entit� retourn�e, et d�termine la forme de l'ensemble des r�sultats de la requ�te. + La méthode <literal>addEntity()</literal> associe l'alias de la table SQL + avec la classe de l'entité retournée, et détermine la forme de l'ensemble des résultats de la requête. </para> <para> - La m�thode <literal>addJoin()</literal> peut �tre utilis�e pour charger des associations vers d'autres - entit�s et collections. + La méthode <literal>addJoin()</literal> peut être utilisée pour charger des associations vers d'autres + entités et collections. </para> <programlisting>List cats = sess.createSQLQuery( @@ -78,15 +80,15 @@ .list();</programlisting> <para> - Une requ�te SQL native pourrait retourner une simple valeur scalaire ou une combinaison de scalaires et d'entit�s. + Une requête SQL native pourrait retourner une simple valeur scalaire ou une combinaison de scalaires et d'entités. </para> <programlisting>Double max = (Double) sess.createSQLQuery("select max(cat.weight) as maxWeight from cats cat") .addScalar("maxWeight", Hibernate.DOUBLE); .uniqueResult();</programlisting> - <para>Vous pouvez alternativement d�crire les informations de mapping des r�sultats dans vos fichiers hbm - et les utiliser pour vos requ�tes.</para> + <para>Vous pouvez alternativement décrire les informations de mapping des résultats dans vos fichiers hbm + et les utiliser pour vos requêtes.</para> <programlisting>List cats = sess.createSQLQuery( "select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id" @@ -96,20 +98,20 @@ </sect1> <sect1 id="querysql-aliasreferences"> - <title>Alias et r�f�rences de propri�t�</title> + <title>Alias et références de propriété</title> <para> - La notation <literal>{cat.*}</literal> utilis�e au-dessus est un raccourci pour "toutes les propri�t�s". - Alternativement, vous pouvez lister explicitement les colonnes, mais m�me ce cas que nous laissons � Hibernate - injecte des alias de colonne SQL pour chaque propri�t�. Le rempla�ant pour un alias de colonne - est juste le nom de la propri�t� qualifi� par l'alias de la table. - Dans l'exemple suivant, nous r�cup�rons des <literal>Cat</literal>s � partir d'une table diff�rente - (<literal>cat_log</literal>) de celle d�clar�e dans les m�ta-donn�es de mapping. - Notez que nous pouvons m�me utiliser les alias de propri�t� dans la clause "where" si nous le souhaitons. + La notation <literal>{cat.*}</literal> utilisée au-dessus est un raccourci pour "toutes les propriétés". + Alternativement, vous pouvez lister explicitement les colonnes, mais même ce cas que nous laissons à Hibernate + injecte des alias de colonne SQL pour chaque propriété. Le remplaçant pour un alias de colonne + est juste le nom de la propriété qualifié par l'alias de la table. + Dans l'exemple suivant, nous récupérons des <literal>Cat</literal>s à partir d'une table différente + (<literal>cat_log</literal>) de celle déclarée dans les méta-données de mapping. + Notez que nous pouvons même utiliser les alias de propriété dans la clause "where" si nous le souhaitons. </para> <para> - La syntaxe <literal>{}</literal> <emphasis>n'est pas</emphasis> requise pour le requ�tes nomm�es. Voir + La syntaxe <literal>{}</literal> <emphasis>n'est pas</emphasis> requise pour le requêtes nommées. Voir <xref linkend="querysql-namedqueries" />. </para> @@ -124,13 +126,13 @@ .list();</programlisting> <para> - <emphasis>� noter :</emphasis> si vous listez chaque propri�t� explicitement, vous devez inclure - toutes les propri�t�s de la classe <emphasis>et ses sous-classes</emphasis> ! + <emphasis>À noter :</emphasis> si vous listez chaque propriété explicitement, vous devez inclure + toutes les propriétés de la classe <emphasis>et ses sous-classes</emphasis> ! </para> <para> - La table suivante montre les diff�rentes possibilit�s d'utilisation de l'injection d'alias. � noter : les noms - des alias dans le r�sultat sont des exemples, chaque alias aura un nom unique et probablement diff�rent lors de l'utilisation. + La table suivante montre les différentes possibilités d'utilisation de l'injection d'alias. À noter : les noms + des alias dans le résultat sont des exemples, chaque alias aura un nom unique et probablement différent lors de l'utilisation. </para> <table frame="topbot" id="aliasinjection-summary"> @@ -155,7 +157,7 @@ <tbody> <row> - <entry>Une simple propri�t�</entry> + <entry>Une simple propriété</entry> <entry><literal>{[aliasname].[propertyname]}</literal></entry> @@ -163,7 +165,7 @@ </row> <row> - <entry>Une propri�t� compos�e</entry> + <entry>Une propriété composée</entry> <entry><literal>{[aliasname].[componentname].[propertyname]}</literal></entry> @@ -172,7 +174,7 @@ </row> <row> - <entry>Discriminant d'une entit�</entry> + <entry>Discriminant d'une entité</entry> <entry><literal>{[aliasname].class}</literal></entry> @@ -180,7 +182,7 @@ </row> <row> - <entry>Toutes les propri�t�s d'une entit�</entry> + <entry>Toutes les propriétés d'une entité</entry> <entry><literal>{[aliasname].*}</literal></entry> @@ -204,7 +206,7 @@ </row> <row> - <entry>L'�l�ment d'une collection</entry> + <entry>L'élément d'une collection</entry> <entry><literal>{[aliasname].element}</literal></entry> @@ -214,7 +216,7 @@ </row> <row> - <entry>Propri�t� de l'�l�ment dans la collection</entry> + <entry>Propriété de l'élément dans la collection</entry> <entry><literal>{[aliasname].element.[propertyname]}</literal></entry> @@ -222,7 +224,7 @@ </row> <row> - <entry>Toutes les propri�t�s de l'�l�ment dans la collection</entry> + <entry>Toutes les propriétés de l'élément dans la collection</entry> <entry><literal>{[aliasname].element.*}</literal></entry> @@ -230,7 +232,7 @@ </row> <row> - <entry>Toutes les propri�t�s de la collection</entry> + <entry>Toutes les propriétés de la collection</entry> <entry><literal>{[aliasname].*}</literal></entry> @@ -242,11 +244,11 @@ </sect1> <sect1 id="querysql-namedqueries" revision="3"> - <title>Requ�tes SQL nomm�es</title> + <title>Requêtes SQL nommées</title> <para> - Les requ�tes SQL nomm�es peuvent �tre d�finies dans le document de mapping - et appel�es exactement de la m�me mani�re qu'un requ�te HQL nomm�e. Dans ce + Les requêtes SQL nommées peuvent être définies dans le document de mapping + et appelées exactement de la même manière qu'un requête HQL nommée. Dans ce cas, nous <emphasis>n'avons pas besoin</emphasis> d'appeler <literal>addEntity()</literal>. </para> @@ -265,9 +267,9 @@ .list();</programlisting> <para> - Les �l�ments <literal>&lt;return-join&gt;</literal> et - <literal>&lt;load-collection&gt;</literal> sont respectivement utilis�s pour lier - des associations et d�finir des requ�tes qui initialisent des collections. + Les éléments <literal>&lt;return-join&gt;</literal> et + <literal>&lt;load-collection&gt;</literal> sont respectivement utilisés pour lier + des associations et définir des requêtes qui initialisent des collections. </para> <programlisting>&lt;sql-query name="personsWith"&gt; @@ -287,8 +289,8 @@ &lt;/sql-query&gt;</programlisting> <para> - Une requ�te SQL nomm�e peut retourner une valeur scalaire. Vous devez - sp�cifier l'alias de colonne et le type Hibernate utilisant l'�l�ment + Une requête SQL nommée peut retourner une valeur scalaire. Vous devez + spécifier l'alias de colonne et le type Hibernate utilisant l'élément <literal>&lt;return-scalar&gt;</literal> :</para> <programlisting>&lt;sql-query name="mySqlQuery"&gt; @@ -300,9 +302,9 @@ &lt;/sql-query&gt;</programlisting> <para> - Vous pouvez externaliser les informations de mapping des r�sultats dans un - �l�ment <literal>&lt;resultset&gt;</literal> pour soit les r�utiliser - dans diff�rentes requ�tes nomm�es, soit � travers l'API + Vous pouvez externaliser les informations de mapping des résultats dans un + élément <literal>&lt;resultset&gt;</literal> pour soit les réutiliser + dans différentes requêtes nommées, soit à travers l'API <literal>setResultSetMapping()</literal>. </para> @@ -326,11 +328,11 @@ &lt;/sql-query&gt;</programlisting> <sect2 id="propertyresults"> - <title>Utilisation de return-property pour sp�cifier explicitement les noms des colonnes/alias</title> + <title>Utilisation de return-property pour spécifier explicitement les noms des colonnes/alias</title> <para> Avec <literal>&lt;return-property&gt;</literal> vous pouvez explicitement dire - � Hibernate quels alias de colonne utiliser, plutot que d'employer la syntaxe + à Hibernate quels alias de colonne utiliser, plutot que d'employer la syntaxe <literal>{}</literal> pour laisser Hibernate injecter ses propres alias. </para> @@ -349,8 +351,8 @@ <para> <literal>&lt;return-property&gt;</literal> fonctionne aussi avec de - multiple colonnes. Cela r�sout une limitation de la syntaxe <literal>{}</literal> - qui ne peut pas permettre une bonne granularit� des propri�t�s multi-colonnes. + multiple colonnes. Cela résout une limitation de la syntaxe <literal>{}</literal> + qui ne peut pas permettre une bonne granularité des propriétés multi-colonnes. </para> <programlisting>&lt;sql-query name="organizationCurrentEmployments"&gt; @@ -370,28 +372,28 @@ &lt;/sql-query&gt;</programlisting> <para> - Notez que dans cet exemple nous avons utilis� <literal>&lt;return-property&gt;</literal> + Notez que dans cet exemple nous avons utilisé <literal>&lt;return-property&gt;</literal> en combinaison avec la syntaxe <literal>{}</literal> pour l'injection. Cela autorise les - utilisateurs � choisir comment ils veulent r�f�rencer les colonnes et les propri�t�s. + utilisateurs à choisir comment ils veulent référencer les colonnes et les propriétés. </para> <para> Si votre mapping a un discriminant vous devez utiliser - <literal>&lt;return-discriminator&gt;</literal> pour sp�cifier la colonne + <literal>&lt;return-discriminator&gt;</literal> pour spécifier la colonne discriminante. </para> </sect2> <sect2 id="sp_query" revision="1"> - <title>Utilisation de proc�dures stock�es pour les requ�tes</title> + <title>Utilisation de procédures stockées pour les requêtes</title> <para> - Hibernate 3 introduit le support des requ�tes via proc�dures stock�es et les fonctions. + Hibernate 3 introduit le support des requêtes via procédures stockées et les fonctions. La documentation suivante est valable pour les deux. - Les proc�dures stock�es/fonctions doivent retourner l'ensemble de r�sultats en tant que - premier param�tre sortant (NdT: "out-parameter") pour �tre capable de fonctionner - avec Hibernate. Un exemple d'une telle proc�dure stock�e en Oracle 9 et - version sup�rieure : + Les procédures stockées/fonctions doivent retourner l'ensemble de résultats en tant que + premier paramètre sortant (NdT: "out-parameter") pour être capable de fonctionner + avec Hibernate. Un exemple d'une telle procédure stockée en Oracle 9 et + version supérieure : </para> <programlisting>CREATE OR REPLACE FUNCTION selectAllEmployments @@ -407,7 +409,7 @@ RETURN st_cursor; END;</programlisting> - <para>Pour utiliser cette requ�te dans Hibernate vous avez besoin de la mapper via une requ�te nomm�e.</para> + <para>Pour utiliser cette requête dans Hibernate vous avez besoin de la mapper via une requête nommée.</para> <programlisting>&lt;sql-query name="selectAllEmployees_SP" callable="true"&gt; &lt;return alias="emp" class="Employment"&gt; @@ -426,52 +428,52 @@ &lt;/sql-query&gt;</programlisting> <para> - Notez que les proc�dures stock�es retournent, pour le moment, seulement des - scalaires et des entit�s. <literal>&lt;return-join&gt;</literal> et - <literal>&lt;load-collection&gt;</literal> ne sont pas support�s. + Notez que les procédures stockées retournent, pour le moment, seulement des + scalaires et des entités. <literal>&lt;return-join&gt;</literal> et + <literal>&lt;load-collection&gt;</literal> ne sont pas supportés. </para> <sect3 id="querysql-limits-storedprocedures" revision="1"> - <title>R�gles/limitations lors de l'utilisation des proc�dures stock�es</title> + <title>Règles/limitations lors de l'utilisation des procédures stockées</title> <para> - Pur utiliser des proc�dures stock�es avec Hibernate, les proc�dures doivent - suivre certaines r�gles. Si elles ne suivent pas ces r�gles, elles ne sont pas - utilisables avec Hibernate. Si vous voulez encore utiliser ces proc�dures vous - devez les ex�cuter via <literal>session.connection()</literal>. Les r�gles - sont diff�rentes pour chaque base de donn�es, puisque les vendeurs de base - de donn�es ont des s�mantiques/syntaxes diff�rentes pour les proc�dures stock�es. + Pur utiliser des procédures stockées avec Hibernate, les procédures doivent + suivre certaines règles. Si elles ne suivent pas ces règles, elles ne sont pas + utilisables avec Hibernate. Si vous voulez encore utiliser ces procédures vous + devez les exécuter via <literal>session.connection()</literal>. Les règles + sont différentes pour chaque base de données, puisque les vendeurs de base + de données ont des sémantiques/syntaxes différentes pour les procédures stockées. </para> - <para>Les requ�tes de proc�dures stock�es ne peuvent pas �tre pagin�es avec + <para>Les requêtes de procédures stockées ne peuvent pas être paginées avec <literal>setFirstResult()/setMaxResults()</literal>.</para> - <para>Pour Oracle les r�gles suivantes s'appliquent :</para> + <para>Pour Oracle les règles suivantes s'appliquent :</para> <itemizedlist spacing="compact"> <listitem> <para> - La proc�dure doit retourner un ensemble de r�sultats. Le - prmeier param�tre d'une proc�dure doit �tre un <literal>OUT</literal> - qui retourne un ensemble de r�sultats. Ceci est fait en + La procédure doit retourner un ensemble de résultats. Le + prmeier paramètre d'une procédure doit être un <literal>OUT</literal> + qui retourne un ensemble de résultats. Ceci est fait en retournant un <literal>SYS_REFCURSOR</literal> dans Oracle 9 ou 10. Dans - Oracle vous avez besoin de d�finir un type <literal>REF CURSOR</literal>.</para> + Oracle vous avez besoin de définir un type <literal>REF CURSOR</literal>.</para> </listitem> </itemizedlist> - <para>Pour Sybase ou MS SQL server les r�gles suivantes s'appliquent :</para> + <para>Pour Sybase ou MS SQL server les règles suivantes s'appliquent :</para> <itemizedlist spacing="compact"> <listitem> - <para>La proc�dure doit retourner un ensemble de r�sultats. Notez que comme - ces serveurs peuvent retourner de multiples ensembles de r�sultats et mettre � jour - des compteurs, Hibernate it�rera les r�sultats et prendra le premier r�sultat qui est - un ensemble de r�sultat comme valeur de retour. Tout le reste sera ignor�.</para> + <para>La procédure doit retourner un ensemble de résultats. Notez que comme + ces serveurs peuvent retourner de multiples ensembles de résultats et mettre à jour + des compteurs, Hibernate itérera les résultats et prendra le premier résultat qui est + un ensemble de résultat comme valeur de retour. Tout le reste sera ignoré.</para> </listitem> <listitem> - <para>Si vous pouvez activer <literal>SET NOCOUNT ON</literal> dans votre proc�dure, + <para>Si vous pouvez activer <literal>SET NOCOUNT ON</literal> dans votre procédure, elle sera probablement plus efficace, mais ce n'est pas une obligation.</para> </listitem> </itemizedlist> @@ -480,16 +482,16 @@ </sect1> <sect1 id="querysql-cud"> - <title>SQL personnalis� pour cr�er, mettre � jour et effacer</title> + <title>SQL personnalisé pour créer, mettre à jour et effacer</title> <para> - Hibernate3 peut utiliser des expression SQL personnalis�es pour des op�rations de cr�ation, - de mise � jour, et de suppression. Les objets persistants les classes et les collections - dans Hibernate contiennent d�j� un ensemble de cha�nes de caract�res g�n�r�es lors de la + Hibernate3 peut utiliser des expression SQL personnalisées pour des opérations de création, + de mise à jour, et de suppression. Les objets persistants les classes et les collections + dans Hibernate contiennent déjà un ensemble de chaînes de caractères générées lors de la configuration (insertsql, deletesql, updatesql, etc). Les tages de mapping <literal>&lt;sql-insert&gt;</literal>, <literal>&lt;sql-delete&gt;</literal>, et - <literal>&lt;sql-update&gt;</literal> surchargent ces cha�nes de caract�res :</para> + <literal>&lt;sql-update&gt;</literal> surchargent ces chaînes de caractères :</para> <programlisting>&lt;class name="Person"&gt; &lt;id name="id"&gt; @@ -501,11 +503,11 @@ &lt;sql-delete&gt;DELETE FROM PERSON WHERE ID=?&lt;/sql-delete&gt; &lt;/class&gt;</programlisting> - <para>Le SQL est directement ex�cut� dans votre base de donn�es, donc vous �tes libre d'utiliser - le dialecte que vous souhaitez. Cela r�duira bien s�r la portabilit� de votre mapping si vous - utilisez du SQL sp�cifique � votre base de donn�es.</para> + <para>Le SQL est directement exécuté dans votre base de données, donc vous êtes libre d'utiliser + le dialecte que vous souhaitez. Cela réduira bien sûr la portabilité de votre mapping si vous + utilisez du SQL spécifique à votre base de données.</para> - <para>Les proc�dures stock�es sont support�es si l'attribut <literal>callable</literal> est param�tr� :</para> + <para>Les procédures stockées sont supportées si l'attribut <literal>callable</literal> est paramétré :</para> <programlisting>&lt;class name="Person"&gt; &lt;id name="id"&gt; @@ -517,22 +519,22 @@ &lt;sql-update callable="true"&gt;{? = call updatePerson (?, ?)}&lt;/sql-update&gt; &lt;/class&gt;</programlisting> - <para>L'ordre des param�tres positionnels est actuellement vital, car ils doivent �tre dans la - m�me s�quence qu'Hibernate les attend.</para> + <para>L'ordre des paramètres positionnels est actuellement vital, car ils doivent être dans la + même séquence qu'Hibernate les attend.</para> <para> Vous pouvez voir l'ordre attendu en activant les journaux de debug pour le - niveau <literal>org.hibernate.persister.entity</literal> level. Avec ce niveau activ�, - Hibernate imprimera le SQL statique qui est utilis� pour cr�er, mettre � jour, - supprimer, etc. des entit�s. (Pour voir la s�quence attendue, rappelez-vous de ne pas - inclure votre SQL personnalis� dans les fichiers de mapping de mani�re � surcharger le - SQL statique g�n�r� par Hibernate.)</para> + niveau <literal>org.hibernate.persister.entity</literal> level. Avec ce niveau activé, + Hibernate imprimera le SQL statique qui est utilisé pour créer, mettre à jour, + supprimer, etc. des entités. (Pour voir la séquence attendue, rappelez-vous de ne pas + inclure votre SQL personnalisé dans les fichiers de mapping de manière à surcharger le + SQL statique généré par Hibernate.)</para> - <para>Les proc�dures stock�es sont dans la plupart des cas (lire : il vaut mieux le faire) - requises pour retourner le nombre de lignes ins�r�es/mises � jour/supprim�es, puisque - Hibernate fait quelques v�rifications de succ�s lors de l'ex�cution de l'expression. - Hibernate inscrit toujours la premi�re expression comme un param�tre de sortie num�rique pour les - op�rations CUD :</para> + <para>Les procédures stockées sont dans la plupart des cas (lire : il vaut mieux le faire) + requises pour retourner le nombre de lignes insérées/mises à jour/supprimées, puisque + Hibernate fait quelques vérifications de succès lors de l'exécution de l'expression. + Hibernate inscrit toujours la première expression comme un paramètre de sortie numérique pour les + opérations CUD :</para> <programlisting>CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2) RETURN NUMBER IS @@ -550,9 +552,9 @@ </sect1> <sect1 id="querysql-load"> - <title>SQL personnalis� pour le chargement</title> + <title>SQL personnalisé pour le chargement</title> - <para>Vous pouvez aussi d�clarer vos propres requ�tes SQL (ou HQL) pour le chargement d'entit� :</para> + <para>Vous pouvez aussi déclarer vos propres requêtes SQL (ou HQL) pour le chargement d'entité :</para> <programlisting>&lt;sql-query name="person"&gt; &lt;return alias="pers" class="Person" lock-mode="upgrade"/&gt; @@ -562,8 +564,8 @@ FOR UPDATE &lt;/sql-query&gt;</programlisting> - <para>Ceci est juste une d�claration de requ�te nomm�e, comme vu plus t�t. Vous pouvez r�f�rencer - cette requ�te nomm�e dans un mapping de classe :</para> + <para>Ceci est juste une déclaration de requête nommée, comme vu plus tôt. Vous pouvez référencer + cette requête nommée dans un mapping de classe :</para> <programlisting>&lt;class name="Person"&gt; &lt;id name="id"&gt; @@ -573,9 +575,9 @@ &lt;loader query-ref="person"/&gt; &lt;/class&gt;</programlisting> - <para>Ceci fonctionne m�me avec des proc�dures stock�es.</para> + <para>Ceci fonctionne même avec des procédures stockées.</para> - <para>Vous pouvez m�me d�finir une requ�te pour le chargement d'une collection :</para> + <para>Vous pouvez même définir une requête pour le chargement d'une collection :</para> <programlisting>&lt;set name="employments" inverse="true"&gt; &lt;key/&gt; @@ -591,7 +593,7 @@ ORDER BY STARTDATE ASC, EMPLOYEE ASC &lt;/sql-query&gt;</programlisting> - <para>Vous pourriez m�me d�finir un chargeur d'entit� qui charge une collection par jointure :</para> + <para>Vous pourriez même définir un chargeur d'entité qui charge une collection par jointure :</para> <programlisting>&lt;sql-query name="person"&gt; &lt;return alias="pers" class="Person"/&gt; @@ -603,4 +605,4 @@ WHERE ID=? &lt;/sql-query&gt;</programlisting> </sect1> -</chapter> \ No newline at end of file +</chapter> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/session_api.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/session_api.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/session_api.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,70 +1,72 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="objectstate"> <title>Travailler avec des objets</title> <para> - Hibernate est une solution de mapping objet/relationnel compl�te qui ne masque pas - seulement au d�velopppeur les d�tails du syst�me de gestion de base de donn�es sous-jacent, - mais offre aussi <emphasis>la gestion d'�tat</emphasis> des objets. C'est, contrairement - � la gestion de <literal>statements</literal> SQL dans les couches de persistance - habituelles JDBC/SQL, une vue orient�e objet tr�s naturelle de la persistance dans les + Hibernate est une solution de mapping objet/relationnel complète qui ne masque pas + seulement au développpeur les détails du système de gestion de base de données sous-jacent, + mais offre aussi <emphasis>la gestion d'état</emphasis> des objets. C'est, contrairement + à la gestion de <literal>statements</literal> SQL dans les couches de persistance + habituelles JDBC/SQL, une vue orientée objet très naturelle de la persistance dans les applications Java. </para> <para> - En d'autres mots, les d�veloppeurs d'applications Hibernate devrait toujours - r�fl�chir � <emphasis>l'�tat</emphasis> de leurs objets, et pas n�cessairement � - l'ex�cution des expressions SQL. Cette part est prise en charge pas Hibernate et - seulement importante pour les d�veloppeurs d'applications lors du r�glage de la - performance de leur syst�me. + En d'autres mots, les développeurs d'applications Hibernate devrait toujours + réfléchir à <emphasis>l'état</emphasis> de leurs objets, et pas nécessairement à + l'exécution des expressions SQL. Cette part est prise en charge pas Hibernate et + seulement importante pour les développeurs d'applications lors du réglage de la + performance de leur système. </para> <sect1 id="objectstate-overview"> - <title>�tats des objets Hibernate</title> + <title>États des objets Hibernate</title> <para> - Hibernate d�finit et comprend les �tats suivants : + Hibernate définit et comprend les états suivants : </para> <itemizedlist> <listitem> <para> - <emphasis>�ph�m�re</emphasis> (NdT : transient) - un objet est �ph�m�re s'il a juste - �t� instanci� en utilisant l'op�rateur <literal>new</literal>. Il n'a aucune - repr�sentation persistante dans la base de donn�es et aucune valeur d'identifiant - n'a �t� assign�e. Les instances �ph�m�res seront d�truites par le ramasse-miettes - si l'application n'en conserve aucune r�f�rence. Utilisez la <literal>Session</literal> + <emphasis>Éphémère</emphasis> (NdT : transient) - un objet est éphémère s'il a juste + été instancié en utilisant l'opérateur <literal>new</literal>. Il n'a aucune + représentation persistante dans la base de données et aucune valeur d'identifiant + n'a été assignée. Les instances éphémères seront détruites par le ramasse-miettes + si l'application n'en conserve aucune référence. Utilisez la <literal>Session</literal> d'Hibernate pour rendre un objet persistant (et laisser Hibernate s'occuper des - expressions SQL qui ont besoin d'�tre ex�cut�es pour cette transistion). + expressions SQL qui ont besoin d'être exécutées pour cette transistion). </para> </listitem> <listitem> <para> - <emphasis>Persistant</emphasis> - une instance persistante a une repr�sentation dans la - base de donn�es et une valeur d'identifiant. Elle pourrait avoir juste �t� sauvegard�e - ou charg�e, pourtant, elle est par d�finition dans la port�e d'une <literal>Session</literal>. - Hibernate d�tectera n'importe quels changements effectu�s sur un objet dans l'�tat - persistant et synchronisera l'�tat avec la base de donn�es lors de la fin l'unit� de travail. - Les d�veloppeurs n'ex�cutent pas d'expressions <literal>UPDATE</literal> ou - <literal>DELETE</literal> manuelles lorsqu'un objet devrait �tre rendu �ph�m�re. + <emphasis>Persistant</emphasis> - une instance persistante a une représentation dans la + base de données et une valeur d'identifiant. Elle pourrait avoir juste été sauvegardée + ou chargée, pourtant, elle est par définition dans la portée d'une <literal>Session</literal>. + Hibernate détectera n'importe quels changements effectués sur un objet dans l'état + persistant et synchronisera l'état avec la base de données lors de la fin l'unité de travail. + Les développeurs n'exécutent pas d'expressions <literal>UPDATE</literal> ou + <literal>DELETE</literal> manuelles lorsqu'un objet devrait être rendu éphémère. </para> </listitem> <listitem> <para> - <emphasis>D�tach�</emphasis> - une instance d�tach�e est un objet qui a �t� persistant, - mais dont sa <literal>Session</literal> a �t� ferm�e. La r�f�rence � l'objet est - encore valide, bien s�r, et l'instance d�tach�e pourrait m�me �tre modifi�e dans cet - �tat. Une instance d�tach�e peut �tre r�attach�e � une nouvelle <literal>Session</literal> + <emphasis>Détaché</emphasis> - une instance détachée est un objet qui a été persistant, + mais dont sa <literal>Session</literal> a été fermée. La référence à l'objet est + encore valide, bien sûr, et l'instance détachée pourrait même être modifiée dans cet + état. Une instance détachée peut être réattachée à une nouvelle <literal>Session</literal> plus tard dans le temps, la rendant (et toutes les modifications avec) de nouveau persistante. - Cette fonctionnalit� rend possible un mod�le de programmation pour de longues unit�s de travail - qui requi�rent un temps de r�flexion de l'utilisateur. Nous les appelons des <emphasis>conversations</emphasis>, - c'est-�-dire une unit� de travail du point de vue de l'utilisateur. + Cette fonctionnalité rend possible un modèle de programmation pour de longues unités de travail + qui requièrent un temps de réflexion de l'utilisateur. Nous les appelons des <emphasis>conversations</emphasis>, + c'est-à-dire une unité de travail du point de vue de l'utilisateur. </para> </listitem> </itemizedlist> <para> - Nous alons maintenant dicuster des �tats et des transitions d'�tat (et des m�thodes - d'Hibernate qui d�clenchent une transition) plus en d�tails. + Nous alons maintenant dicuster des états et des transitions d'état (et des méthodes + d'Hibernate qui déclenchent une transition) plus en détails. </para> </sect1> @@ -73,9 +75,9 @@ <title>Rendre des objets persistants</title> <para> - Les instances nouvellement instanci�es d'une classe persistante sont consid�r�es - <emphasis>�ph�m�res</emphasis> par Hibernate. Nous pouvons rendre une instance - �ph�m�re <emphasis>persistante</emphasis> en l'associant avec une session : + Les instances nouvellement instanciées d'une classe persistante sont considérées + <emphasis>éphémères</emphasis> par Hibernate. Nous pouvons rendre une instance + éphémère <emphasis>persistante</emphasis> en l'associant avec une session : </para> <programlisting><![CDATA[DomesticCat fritz = new DomesticCat(); @@ -85,17 +87,17 @@ Long generatedId = (Long) sess.save(fritz);]]></programlisting> <para> - Si <literal>Cat</literal> a un identifiant g�n�r�, l'identifiant est g�n�r� et assign� - au <literal>cat</literal> lorsque <literal>save()</literal> est appel�e. Si <literal>Cat</literal> - a un identifiant <literal>assigned</literal>, ou une clef compos�e, l'identifiant - devrait �tre assign� � l'instance de <literal>cat</literal> avant d'appeler <literal>save()</literal>. - Vous pouvez aussi utiliser <literal>persist()</literal> � la place de<literal>save()</literal>, - avec la s�mantique d�finie plus t�t dans le brouillon d'EJB3. + Si <literal>Cat</literal> a un identifiant généré, l'identifiant est généré et assigné + au <literal>cat</literal> lorsque <literal>save()</literal> est appelée. Si <literal>Cat</literal> + a un identifiant <literal>assigned</literal>, ou une clef composée, l'identifiant + devrait être assigné à l'instance de <literal>cat</literal> avant d'appeler <literal>save()</literal>. + Vous pouvez aussi utiliser <literal>persist()</literal> à la place de<literal>save()</literal>, + avec la sémantique définie plus tôt dans le brouillon d'EJB3. </para> <para> Alternativement, vous pouvez assigner l'identifiant en utilisant une version - surcharg�e de <literal>save()</literal>. + surchargée de <literal>save()</literal>. </para> <programlisting><![CDATA[DomesticCat pk = new DomesticCat(); @@ -107,23 +109,23 @@ sess.save( pk, new Long(1234) );]]></programlisting> <para> - Si l'objet que vous rendez persistant a des objets associ�s (par exemple, - la collection <literal>kittens</literal> dans l'exemple pr�c�dent), ces objets - peuvent �tre rendus persistants dans n'importe quel ordre que vous souhaitez - � moins que vous ayez une contrainte <literal>NOT NULL</literal> sur la - colonne de la clef �trang�re. Il n'y a jamais de risque de violer une - contrainte de clef �trang�re. Cependant, vous pourriez violer une contrainte + Si l'objet que vous rendez persistant a des objets associés (par exemple, + la collection <literal>kittens</literal> dans l'exemple précédent), ces objets + peuvent être rendus persistants dans n'importe quel ordre que vous souhaitez + à moins que vous ayez une contrainte <literal>NOT NULL</literal> sur la + colonne de la clef étrangère. Il n'y a jamais de risque de violer une + contrainte de clef étrangère. Cependant, vous pourriez violer une contrainte <literal>NOT NULL</literal> si vous appeliez <literal>save()</literal> sur les objets dans le mauvais ordre. </para> <para> - Habituellement, vous ne vous pr�occupez pas de ce d�tail, puisque vous - utiliserez tr�s probablement la fonctionnalit� de <emphasis>persistance - transitive</emphasis> d'Hibernate pour sauvegarder les objets associ�s - automatiquement. Alors, m�me les violations de contrainte <literal>NOT NULL</literal> + Habituellement, vous ne vous préoccupez pas de ce détail, puisque vous + utiliserez très probablement la fonctionnalité de <emphasis>persistance + transitive</emphasis> d'Hibernate pour sauvegarder les objets associés + automatiquement. Alors, même les violations de contrainte <literal>NOT NULL</literal> n'ont plus lieu - Hibernate prendra soin de tout. La persistance transitive est - trait�e plus loin dans ce chapitre. + traitée plus loin dans ce chapitre. </para> </sect1> @@ -132,10 +134,10 @@ <title>Chargement d'un objet</title> <para> - Les m�thodes <literal>load()</literal> de <literal>Session</literal> vous donnent - un moyen de r�cup�rer une instance persistante si vous connaissez d�j� son identifiant. - <literal>load()</literal> prend un objet de classe et chargera l'�tat dans une instance - nouvellement instanci�e de cette classe, dans un �tat persistant. + Les méthodes <literal>load()</literal> de <literal>Session</literal> vous donnent + un moyen de récupérer une instance persistante si vous connaissez déjà son identifiant. + <literal>load()</literal> prend un objet de classe et chargera l'état dans une instance + nouvellement instanciée de cette classe, dans un état persistant. </para> <programlisting><![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]></programlisting> @@ -145,7 +147,7 @@ DomesticCat pk = (DomesticCat) sess.load( Cat.class, new Long(pkId) );]]></programlisting> <para> - Alternativement, vous pouvez charger un �tat dans une instance donn�e : + Alternativement, vous pouvez charger un état dans une instance donnée : </para> <programlisting><![CDATA[Cat cat = new DomesticCat(); @@ -154,20 +156,20 @@ Set kittens = cat.getKittens();]]></programlisting> <para> - Notez que <literal>load()</literal> l�vera une exception irr�cup�rable s'il - n'y a pas de ligne correspondante dans la base de donn�es. Si la classe est mapp�e - avec un proxy, <literal>load()</literal> retourne juste un proxy non initialis� et - n'acc�de en fait pas � la base de donn�es jusqu'� ce que vous invoquiez une - m�thode du proxy. Ce comportement est tr�s utile si vous souhaitez cr�er - une association vers un objet sans r�ellement le charger � partir de la base de - donn�es. Cela permet aussi � de multiples instances d'�tre charg�es comme un lot - si <literal>batch-size</literal> est d�fini pour le mapping de la classe. + Notez que <literal>load()</literal> lèvera une exception irrécupérable s'il + n'y a pas de ligne correspondante dans la base de données. Si la classe est mappée + avec un proxy, <literal>load()</literal> retourne juste un proxy non initialisé et + n'accède en fait pas à la base de données jusqu'à ce que vous invoquiez une + méthode du proxy. Ce comportement est très utile si vous souhaitez créer + une association vers un objet sans réellement le charger à partir de la base de + données. Cela permet aussi à de multiples instances d'être chargées comme un lot + si <literal>batch-size</literal> est défini pour le mapping de la classe. </para> <para> - Si vous n'�tes pas certain qu'une ligne correspondante existe, vous devriez - utiliser la m�thode <literal>get()</literal>, laquelle acc�de � la base de - donn�es imm�diatement et retourne null s'il n'y a pas de ligne correspondante. + Si vous n'êtes pas certain qu'une ligne correspondante existe, vous devriez + utiliser la méthode <literal>get()</literal>, laquelle accède à la base de + données immédiatement et retourne null s'il n'y a pas de ligne correspondante. </para> <programlisting><![CDATA[Cat cat = (Cat) sess.get(Cat.class, id); @@ -178,23 +180,23 @@ return cat;]]></programlisting> <para> - Vous pouvez m�me charger un objet en employant un <literal>SELECT ... FOR UPDATE</literal> SQL, + Vous pouvez même charger un objet en employant un <literal>SELECT ... FOR UPDATE</literal> SQL, en utilisant un <literal>LockMode</literal>. Voir la documentation de l'API pour plus d'informations. </para> <programlisting><![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]></programlisting> <para> - Notez que n'importe quelles instances associ�es ou collections contenues - <emphasis>ne sont pas</emphasis> s�lectionn�es par <literal>FOR UPDATE</literal>, - � moins que vous ne d�cidiez de sp�cifier <literal>lock</literal> ou <literal>all</literal> + Notez que n'importe quelles instances associées ou collections contenues + <emphasis>ne sont pas</emphasis> sélectionnées par <literal>FOR UPDATE</literal>, + à moins que vous ne décidiez de spécifier <literal>lock</literal> ou <literal>all</literal> en tant que style de cascade pour l'association. </para> <para> - Il est possible de re-charger un objet et toutes ses collections � n'importe quel moment, - en utilisant la m�thode <literal>refresh()</literal>. C'est utile lorsque des "triggers" de - base de donn�es sont utilis�s pour initiliser certains propri�t�s de l'objet. + Il est possible de re-charger un objet et toutes ses collections à n'importe quel moment, + en utilisant la méthode <literal>refresh()</literal>. C'est utile lorsque des "triggers" de + base de données sont utilisés pour initiliser certains propriétés de l'objet. </para> <programlisting><![CDATA[sess.save(cat); @@ -202,34 +204,34 @@ sess.refresh(cat); //re-read the state (after the trigger executes)]]></programlisting> <para> - Une question importante appara�t g�n�ralement � ce point : combien (NdT : de donn�es) Hibernate - charge-t-il de la base de donn�es et combient de <literal>SELECT</literal>s utilisera-t-il ? - Cela d�pent de la <emphasis>strat�gie de r�cup�ration</emphasis> et cela est expliqu� dans + Une question importante apparaît généralement à ce point : combien (NdT : de données) Hibernate + charge-t-il de la base de données et combient de <literal>SELECT</literal>s utilisera-t-il ? + Cela dépent de la <emphasis>stratégie de récupération</emphasis> et cela est expliqué dans <xref linkend="performance-fetching"/>. </para> </sect1> <sect1 id="objectstate-querying" revision="1"> - <title>Requ�tage</title> + <title>Requêtage</title> <para> Si vous ne connaissez par les identifiants des objets que vous recherchez, vous - avez besoin d'une requ�te. Hibernate supporte un langage de requ�tes orient�es objet - facile � utiliser mais puissant. Pour la cr�ation de requ�tes par programmation, - Hibernate supporte une fonction de requ�tage sophistiqu� Criteria et Example (QBC et QBE). - Vous pouvez aussi exprimez votre requ�te dans le SQL natif de votre base de donn�es, - avec un support optionnel d'Hibernate pour la conversion des ensembles de r�sultats en + avez besoin d'une requête. Hibernate supporte un langage de requêtes orientées objet + facile à utiliser mais puissant. Pour la création de requêtes par programmation, + Hibernate supporte une fonction de requêtage sophistiqué Criteria et Example (QBC et QBE). + Vous pouvez aussi exprimez votre requête dans le SQL natif de votre base de données, + avec un support optionnel d'Hibernate pour la conversion des ensembles de résultats en objets. </para> <sect2 id="objectstate-querying-executing"> - <title>Ex�cution de requ�tes</title> + <title>Exécution de requêtes</title> <para> - Les requ�tes HQL et SQL natives sont repr�sent�es avec une instance de <literal>org.hibernate.Query</literal>. - L'interface offre des m�thodes pour la liaison des param�tres, la gestion des ensembles de resultats, et pour - l'ex�cution de la requ�te r�elle. Vous obtenez toujours une <literal>Query</literal> en utilisant la + Les requêtes HQL et SQL natives sont représentées avec une instance de <literal>org.hibernate.Query</literal>. + L'interface offre des méthodes pour la liaison des paramètres, la gestion des ensembles de resultats, et pour + l'exécution de la requête réelle. Vous obtenez toujours une <literal>Query</literal> en utilisant la <literal>Session</literal> courante : </para> @@ -254,26 +256,26 @@ .uniqueResult();]]></programlisting> <para> - Une requ�te est g�n�ralement ex�cut�e en invoquant <literal>list()</literal>, - le r�sultat de la requ�te sera charg�e compl�tement dans une collection en m�moire. - Les intances d'entit�s recup�r�es par une requ�te sont dans un �tat persistant. - La m�thode <literal>uniqueResult()</literal> offre un raccourci si vous - savez que votre requ�te retournera seulement un seul objet. + Une requête est généralement exécutée en invoquant <literal>list()</literal>, + le résultat de la requête sera chargée complètement dans une collection en mémoire. + Les intances d'entités recupérées par une requête sont dans un état persistant. + La méthode <literal>uniqueResult()</literal> offre un raccourci si vous + savez que votre requête retournera seulement un seul objet. </para> <sect3 id="objectstate-querying-executing-iterate"> - <title>It�ration de r�sultats</title> + <title>Itération de résultats</title> <para> - Occasionnellement, vous pourriez �tre capable d'obtenir de meilleures - performances en ex�cutant la requ�te avec la m�thode <literal>iterate()</literal>. - Ce sera g�n�ralement seulement le cas si vous esp�rez que les intances r�elles - d'entit� retourn�es par la requ�te soient d�j� charg�es dans la session ou le - cache de second niveau. Si elles ne sont pas cach�es, <literal>iterate()</literal> - sera plus lent que <literal>list()</literal> et pourrait n�cessiter plusieurs - acc�s � la base de donn�es pour une simple requ�te, g�n�ralement <emphasis>1</emphasis> + Occasionnellement, vous pourriez être capable d'obtenir de meilleures + performances en exécutant la requête avec la méthode <literal>iterate()</literal>. + Ce sera généralement seulement le cas si vous espérez que les intances réelles + d'entité retournées par la requête soient déjà chargées dans la session ou le + cache de second niveau. Si elles ne sont pas cachées, <literal>iterate()</literal> + sera plus lent que <literal>list()</literal> et pourrait nécessiter plusieurs + accès à la base de données pour une simple requête, généralement <emphasis>1</emphasis> pour le select initial qui retourne seulement les identifiants, et <emphasis>n</emphasis> - selects suppl�mentaires pour initialiser les instances r�elles. + selects supplémentaires pour initialiser les instances réelles. </para> <programlisting><![CDATA[// fetch ids @@ -291,11 +293,11 @@ </sect3> <sect3 id="objectstate-querying-executing-tuples"> - <title>Requ�tes qui retournent des tuples</title> + <title>Requêtes qui retournent des tuples</title> <para> - Les requ�tes d'Hibernate retournent parfois des tuples d'objets, auquel cas chaque tuple - est retourn� comme un tableau : + Les requêtes d'Hibernate retournent parfois des tuples d'objets, auquel cas chaque tuple + est retourné comme un tableau : </para> <programlisting><![CDATA[Iterator kittensAndMothers = sess.createQuery( @@ -313,12 +315,12 @@ </sect3> <sect3 id="objectstate-querying-executing-scalar" revision="1"> - <title>R�sultats scalaires</title> + <title>Résultats scalaires</title> <para> - Des requ�tes peuvent sp�cifier une propri�t� d'une classe dans la clause <literal>select</literal>. - Elles peuvent m�me appeler des fonctions d'aggr�gat SQL. Les propri�t�s ou les aggr�gats sont - consid�r�s comme des r�sultats "scalaires" (et pas des entit�s dans un �tat persistant). + Des requêtes peuvent spécifier une propriété d'une classe dans la clause <literal>select</literal>. + Elles peuvent même appeler des fonctions d'aggrégat SQL. Les propriétés ou les aggrégats sont + considérés comme des résultats "scalaires" (et pas des entités dans un état persistant). </para> <programlisting><![CDATA[Iterator results = sess.createQuery( @@ -338,46 +340,46 @@ </sect3> <sect3 id="objectstate-querying-executing-parameters"> - <title>Lier des param�tres</title> + <title>Lier des paramètres</title> <para> - Des m�thodes de <literal>Query</literal> sont fournies pour lier des - valeurs � des param�tres nomm�s ou � des param�tres de style JDBC <literal>?</literal>. - <emphasis>Contrairement � JDBC, les num�ros des param�tres d'Hibernate commencent � z�ro.</emphasis> - Les param�tres nomm�s sont des identifiants de la forme <literal>:nom</literal> dans la cha�ne de - caract�res de la requ�te. Les avantages des param�tres nomm�s sont : + Des méthodes de <literal>Query</literal> sont fournies pour lier des + valeurs à des paramètres nommés ou à des paramètres de style JDBC <literal>?</literal>. + <emphasis>Contrairement à JDBC, les numéros des paramètres d'Hibernate commencent à zéro.</emphasis> + Les paramètres nommés sont des identifiants de la forme <literal>:nom</literal> dans la chaîne de + caractères de la requête. Les avantages des paramètres nommés sont : </para> <itemizedlist spacing="compact"> <listitem> <para> - les param�tres nomm�s sont insensibles � l'ordre de leur place dans la cha�ne - de la requ�te + les paramètres nommés sont insensibles à l'ordre de leur place dans la chaîne + de la requête </para> </listitem> <listitem> <para> - ils peuvent appara�tre plusieurs fois dans la m�me requ�te + ils peuvent apparaître plusieurs fois dans la même requête </para> </listitem> <listitem> <para> - ils sont auto-document�s + ils sont auto-documentés </para> </listitem> </itemizedlist> - <programlisting><![CDATA[//param�tre nomme (pr�f�r�) + <programlisting><![CDATA[//paramètre nomme (préféré) Query q = sess.createQuery("from DomesticCat cat where cat.name = :name"); q.setString("name", "Fritz"); Iterator cats = q.iterate();]]></programlisting> - <programlisting><![CDATA[//param�tre positionnel + <programlisting><![CDATA[//paramètre positionnel Query q = sess.createQuery("from DomesticCat cat where cat.name = ?"); q.setString(0, "Izi"); Iterator cats = q.iterate();]]></programlisting> - <programlisting><![CDATA[//liste de param�tres nomm�s + <programlisting><![CDATA[//liste de paramètres nommés List names = new ArrayList(); names.add("Izi"); names.add("Fritz"); @@ -391,9 +393,9 @@ <title>Pagination</title> <para> - Si vous avez besoin de sp�cifier des liens sur votre ensemble de r�sultats (le nombre - maximum de lignes que vous voulez r�cup�rez et/ou la premi�re ligne que vous voulez r�cup�rer) - vous devriez utiliser des m�thodes de l'interface <literal>Query</literal> : + Si vous avez besoin de spécifier des liens sur votre ensemble de résultats (le nombre + maximum de lignes que vous voulez récupérez et/ou la première ligne que vous voulez récupérer) + vous devriez utiliser des méthodes de l'interface <literal>Query</literal> : </para> <programlisting><![CDATA[Query q = sess.createQuery("from DomesticCat cat"); @@ -402,19 +404,19 @@ List cats = q.list();]]></programlisting> <para> - Hibernate sait comment traduite cette requ�te de limite en SQL natif pour votre SGBD. + Hibernate sait comment traduite cette requête de limite en SQL natif pour votre SGBD. </para> </sect3> <sect3 id="objectstate-querying-executing-scrolling"> - <title>It�ration "scrollable"</title> + <title>Itération "scrollable"</title> <para> Si votre connecteur JDBC supporte les <literal>ResultSet</literal>s "scrollables", - l'interface <literal>Query</literal> peut �tre utilis�e pour obtenir un objet + l'interface <literal>Query</literal> peut être utilisée pour obtenir un objet <literal>ScrollableResults</literal>, lequel permet une navigation flexible dans les - r�sultats de la requ�te. + résultats de la requête. </para> <programlisting><![CDATA[Query q = sess.createQuery("select cat.name, cat from DomesticCat cat " + @@ -422,7 +424,7 @@ ScrollableResults cats = q.scroll(); if ( cats.first() ) { - // trouve le premier nom sur chaque page d'une liste alphab�tique de noms de chats + // trouve le premier nom sur chaque page d'une liste alphabétique de noms de chats firstNamesOfPages = new ArrayList(); do { String name = cats.getString(0); @@ -430,7 +432,7 @@ } while ( cats.scroll(PAGE_SIZE) ); - // Maintenant, obtiens la premi�re page de chats + // Maintenant, obtiens la première page de chats pageOfCats = new ArrayList(); cats.beforeFirst(); int i=0; @@ -440,20 +442,20 @@ cats.close()]]></programlisting> <para> - Notez qu'une connexion ouverte (et un curseur) est requise pour cette fonctionnalit�, + Notez qu'une connexion ouverte (et un curseur) est requise pour cette fonctionnalité, utilisez <literal>setMaxResult()</literal>/<literal>setFirstResult()</literal> si vous - avez besoin d'une fonctionnalit� de pagination hors ligne. + avez besoin d'une fonctionnalité de pagination hors ligne. </para> </sect3> <sect3 id="objectstate-querying-executing-named"> - <title>Externaliser des requ�tes nomm�es</title> + <title>Externaliser des requêtes nommées</title> <para> - Vous pouvez aussi d�finir des requ�tes nomm�es dans le document de mapping. - (Souvenez-vous d'utiliser une section <literal>CDATA</literal> si votre requ�te - contient des caract�res qui pourraient �tre interpr�t�s comme des �l�ments XML.) + Vous pouvez aussi définir des requêtes nommées dans le document de mapping. + (Souvenez-vous d'utiliser une section <literal>CDATA</literal> si votre requête + contient des caractères qui pourraient être interprétés comme des éléments XML.) </para> <programlisting><![CDATA[<query name="eg.DomesticCat.by.name.and.minimum.weight"><![CDATA[ @@ -463,7 +465,7 @@ ] ]></query>]]></programlisting> <para> - La liaison de param�tres et l'ex�cution sont fait par programmation : + La liaison de paramètres et l'exécution sont fait par programmation : </para> <programlisting><![CDATA[Query q = sess.getNamedQuery("eg.DomesticCat.by.name.and.minimum.weight"); @@ -472,9 +474,9 @@ List cats = q.list();]]></programlisting> <para> - Notez que le code r�el du programme est ind�pendant du langage de requ�te qui est - utilis�, vous pouvez aussi d�finir des requ�tes SQL nativez dans les m�ta-donn�es, ou - migrer des requ�tes existantes vers Hibernate en les pla�ant dans les fichiers de mapping. + Notez que le code réel du programme est indépendant du langage de requête qui est + utilisé, vous pouvez aussi définir des requêtes SQL nativez dans les méta-données, ou + migrer des requêtes existantes vers Hibernate en les plaçant dans les fichiers de mapping. </para> </sect3> @@ -484,9 +486,9 @@ <sect2 id="objectstate-filtering" revision="1"> <title>Filtrer des collections</title> <para> - Un <emphasis>filtre</emphasis> de collection est un type sp�cial de requ�te qui peut �tre - appliqu� � une collection persistante ou � un tableau. La cha�ne de requ�te peut se r�f�rer � - <literal>this</literal>, correspondant � l'�l�ment de la collection courant. + Un <emphasis>filtre</emphasis> de collection est un type spécial de requête qui peut être + appliqué à une collection persistante ou à un tableau. La chaîne de requête peut se référer à + <literal>this</literal>, correspondant à l'élément de la collection courant. </para> <programlisting><![CDATA[Collection blackKittens = session.createFilter( @@ -497,15 +499,15 @@ );]]></programlisting> <para> - La collection retourn�e est consid�r�e comme un bag, et c'est une copie de la - collection donn�e. La collection originale n'est pas modifi�e (c'est contraire - � l'implication du nom "filtre"; mais coh�rent avec le comportement attendu). + La collection retournée est considérée comme un bag, et c'est une copie de la + collection donnée. La collection originale n'est pas modifiée (c'est contraire + à l'implication du nom "filtre"; mais cohérent avec le comportement attendu). </para> <para> - Observez que les filtres ne n�cessitent pas une clause <literal>from</literal> (bien qu'ils - puissent en avoir une si besoin est). Les filtres ne sont pas limit�s � retourner des - �l�ments de la collection eux-m�mes. + Observez que les filtres ne nécessitent pas une clause <literal>from</literal> (bien qu'ils + puissent en avoir une si besoin est). Les filtres ne sont pas limités à retourner des + éléments de la collection eux-mêmes. </para> <programlisting><![CDATA[Collection blackKittenMates = session.createFilter( @@ -514,8 +516,8 @@ .list();]]></programlisting> <para> - M�me une requ�te de filtre vide est utile, par exemple pour charger un sous-ensemble - d'�l�ments dans une �norme collection : + Même une requête de filtre vide est utile, par exemple pour charger un sous-ensemble + d'éléments dans une énorme collection : </para> <programlisting><![CDATA[Collection tenKittens = session.createFilter( @@ -526,12 +528,12 @@ </sect2> <sect2 id="objecstate-querying-criteria" revision="1"> - <title>Requ�tes Criteria</title> + <title>Requêtes Criteria</title> <para> - HQL est extr�mement puissant mais certains d�veloppeurs pr�f�rent construire des - requ�tes dynamiquement, en utilisant l'API orient�e objet, plut�t que construire - des cha�nes de requ�tes. Hibernate fournit une API intuitive de requ�te <literal>Criteria</literal> + HQL est extrêmement puissant mais certains développeurs préfèrent construire des + requêtes dynamiquement, en utilisant l'API orientée objet, plutôt que construire + des chaînes de requêtes. Hibernate fournit une API intuitive de requête <literal>Criteria</literal> pour ces cas : </para> @@ -541,18 +543,18 @@ List cats = crit.list();]]></programlisting> <para> - Les APIs <literal>Criteria</literal> et <literal>Example</literal> associ� sont - trait�es plus en d�tail dans <xref linkend="querycriteria"/>. + Les APIs <literal>Criteria</literal> et <literal>Example</literal> associé sont + traitées plus en détail dans <xref linkend="querycriteria"/>. </para> </sect2> <sect2 id="objectstate-querying-nativesql" revision="2"> - <title>Requ�tes en SQL natif</title> + <title>Requêtes en SQL natif</title> <para> - Vous pouvez exprimer une requ�te en SQL, en utilisant <literal>createSQLQuery()</literal> - et laisser Hibernate s'occuper du mapping des r�sultats vers des objets. Notez que vous + Vous pouvez exprimer une requête en SQL, en utilisant <literal>createSQLQuery()</literal> + et laisser Hibernate s'occuper du mapping des résultats vers des objets. Notez que vous pouvez n'importe quand appeler <literal>session.connection()</literal> et utiliser directement la <literal>Connection</literal> JDBC. Si vous choisissez d'utiliser l'API Hibernate, vous devez mettre les alias SQL entre accolades : @@ -570,9 +572,9 @@ .list()]]></programlisting> <para> - Les requ�tes SQL peuvent contenir des param�tres nomm�s et positionnels, comme des - requ�tes Hibernate. Plus d'informations � propos des requ�tes SQL natives dans Hibernate - peuvent �tre trouv�es dans <xref linkend="querysql"/>. + Les requêtes SQL peuvent contenir des paramètres nommés et positionnels, comme des + requêtes Hibernate. Plus d'informations à propos des requêtes SQL natives dans Hibernate + peuvent être trouvées dans <xref linkend="querysql"/>. </para> </sect2> @@ -583,13 +585,13 @@ <title>Modifier des objets persistants</title> <para> - Les <emphasis>instances persistantes transactionnelles</emphasis> (c'est-�-dire des objets - charg�s, sauvegard�s, cr��s ou requ�t�s par la <literal>Session</literal>) peuvent �tre - manipul�es par l'application et n'importe quel changement vers l'�tat persistant sera - persist� lorsque la <literal>Session</literal> est <emphasis>"flush�e"</emphasis> (trait� - plus tard dans ce chapitre). Il n'y a pas besoin d'appeler une m�thode particuli�re - (comme <literal>update()</literal>, qui a un but diff�rent) pour rendre vos modifications - persistantes. Donc la mani�re la plus directe de mettre � jour l'�tat d'un objet est de + Les <emphasis>instances persistantes transactionnelles</emphasis> (c'est-à-dire des objets + chargés, sauvegardés, créés ou requêtés par la <literal>Session</literal>) peuvent être + manipulées par l'application et n'importe quel changement vers l'état persistant sera + persisté lorsque la <literal>Session</literal> est <emphasis>"flushée"</emphasis> (traité + plus tard dans ce chapitre). Il n'y a pas besoin d'appeler une méthode particulière + (comme <literal>update()</literal>, qui a un but différent) pour rendre vos modifications + persistantes. Donc la manière la plus directe de mettre à jour l'état d'un objet est de le charger avec <literal>load()</literal>, et puis le manipuler directement, tant que la <literal>Session</literal> est ouverte : </para> @@ -599,45 +601,45 @@ sess.flush(); // changes to cat are automatically detected and persisted]]></programlisting> <para> - Parfois ce mod�le de programmation est inefficace puisqu'il n�cessiterait un + Parfois ce modèle de programmation est inefficace puisqu'il nécessiterait un <literal>SELECT</literal> SQL (pour charger l'objet) et un <literal>UPDATE</literal> - SQL (pour persister son �tat mis � jour) dans la m�me session. Aussi Hibernate offre - une autre approche, en utilisant des instances d�tach�es. + SQL (pour persister son état mis à jour) dans la même session. Aussi Hibernate offre + une autre approche, en utilisant des instances détachées. </para> <para> - <emphasis>Notez que Hibernate n'offre par sa propre API pour l'ex�cution directe + <emphasis>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 + 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> + pour exécuter des expressions SQL, vous pouvez obtenir une <literal>Connection</literal> JDBC n'importe quand 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 d'Hibernate peuvent cependant fournir des fonctions d'op�ration de masse. - Voir <xref linkend="batch"/> pour les astuces possibles d'op�rations group�es.</emphasis> + 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 d'Hibernate peuvent cependant fournir des fonctions d'opération de masse. + Voir <xref linkend="batch"/> pour les astuces possibles d'opérations groupées.</emphasis> </para> </sect1> <sect1 id="objectstate-detached" revision="2"> - <title>Modifier des objets d�tach�s</title> + <title>Modifier des objets détachés</title> <para> - Beaucoup d'applications ont besoin de r�cup�rer un objet dans une transaction, - l'envoyer � la couche interfac�e avec l'utilisateur pour les manipulations, puis + Beaucoup d'applications ont besoin de récupérer un objet dans une transaction, + l'envoyer à la couche interfacée avec l'utilisateur pour les manipulations, puis sauvegarder les changements dans une nouvelle transaction. Les applications - qui utilisent cette approche dans un environnement � haute concurrence utilisent - g�n�ralement des donn�es versionn�es pour assurer l'isolation pour les "longues" - unit�s de travail. + qui utilisent cette approche dans un environnement à haute concurrence utilisent + généralement des données versionnées pour assurer l'isolation pour les "longues" + unités de travail. </para> <para> - Hibernate supporte ce mod�le en permettant pour le r�attachement d'instances d�tach�es - l'utilisation des m�thodes <literal>Session.update()</literal> ou <literal>Session.merge()</literal> : + Hibernate supporte ce modèle en permettant pour le réattachement d'instances détachées + l'utilisation des méthodes <literal>Session.update()</literal> ou <literal>Session.merge()</literal> : </para> - <programlisting><![CDATA[// dans la premi�re session + <programlisting><![CDATA[// dans la première session Cat cat = (Cat) firstSession.load(Cat.class, catId); Cat potentialMate = new Cat(); firstSession.save(potentialMate); @@ -650,64 +652,64 @@ secondSession.update(mate); // update mate]]></programlisting> <para> - Si le <literal>Cat</literal> avec l'identifiant <literal>catId</literal> avait d�j� - �t� charg� par <literal>secondSession</literal> lorsque l'application a essay� de le - r�attacher, une exception aurait �t� lev�e. + Si le <literal>Cat</literal> avec l'identifiant <literal>catId</literal> avait déjà + été chargé par <literal>secondSession</literal> lorsque l'application a essayé de le + réattacher, une exception aurait été levée. </para> <para> - Utilisez <literal>update()</literal> si vous �tes sure que la session ne contient pas - d�j� une instance persistante avec le m�me identifiant, et <literal>merge()</literal> - si vous voulez fusionner vos modifications n'importe quand sans consid�rer l'�tat de - la session. En d'autres mots, <literal>update()</literal> est g�n�ralement la premi�re m�thode - que vous devriez appeler dans une session fra�che, pour s'assurer que le r�attachement - de vos instances d�tach�es est la premi�re op�ration qui est ex�cut�e. + Utilisez <literal>update()</literal> si vous êtes sure que la session ne contient pas + déjà une instance persistante avec le même identifiant, et <literal>merge()</literal> + si vous voulez fusionner vos modifications n'importe quand sans considérer l'état de + la session. En d'autres mots, <literal>update()</literal> est généralement la première méthode + que vous devriez appeler dans une session fraîche, pour s'assurer que le réattachement + de vos instances détachées est la première opération qui est exécutée. </para> <para> - L'application devrait individuellement <literal>update()</literal> (NdT : mettre � jour) - les instances d�tach�es accessibles depuis l'instance d�tach�e donn�e si et - <emphasis>seulement</emphasis> si elle veut que leur �tat soit aussi mis � jour. Ceci - peut �tre automatis� bien s�r, en utilisant la <emphasis>persistance transitive</emphasis>, + L'application devrait individuellement <literal>update()</literal> (NdT : mettre à jour) + les instances détachées accessibles depuis l'instance détachée donnée si et + <emphasis>seulement</emphasis> si elle veut que leur état soit aussi mis à jour. Ceci + peut être automatisé bien sûr, en utilisant la <emphasis>persistance transitive</emphasis>, voir <xref linkend="objectstate-transitive"/>. </para> <para> - La m�thode <literal>lock()</literal> permet aussi � une application de r�associer un - objet avec une nouvelle session. Pourtant, l'instance d�tach�e doit �tre non modifi�e ! + La méthode <literal>lock()</literal> permet aussi à une application de réassocier un + objet avec une nouvelle session. Pourtant, l'instance détachée doit être non modifiée ! </para> - <programlisting><![CDATA[//r�associe : + <programlisting><![CDATA[//réassocie : sess.lock(fritz, LockMode.NONE); -//fait une v�rification de version, puis r�associe : +//fait une vérification de version, puis réassocie : sess.lock(izi, LockMode.READ); -//fait une v�rification de version, en utilisant SELECT ... FOR UPDATE, puis r�associe : +//fait une vérification de version, en utilisant SELECT ... FOR UPDATE, puis réassocie : sess.lock(pk, LockMode.UPGRADE);]]></programlisting> <para> - Notez que <literal>lock()</literal> peut �tre utilis� avec diff�rents + Notez que <literal>lock()</literal> peut être utilisé avec différents <literal>LockMode</literal>s, voir la documentation de l'API documentation et le chapitre - sur la gestion des transactions pour plus d'informations. Le r�attachement n'est pas le seul + sur la gestion des transactions pour plus d'informations. Le réattachement n'est pas le seul cas d'utilisation pour <literal>lock()</literal>. </para> <para> - D'autres mod�les pour de longues unit�s de travail sont trait�s dans <xref linkend="transactions-optimistic"/>. + D'autres modèles pour de longues unités de travail sont traités dans <xref linkend="transactions-optimistic"/>. </para> </sect1> <sect1 id="objectstate-saveorupdate"> - <title>D�tection automatique d'un �tat</title> + <title>Détection automatique d'un état</title> <para> - Les utilisateurs d'Hibernate ont demand� une m�thode dont l'intention g�n�rale - serait soit de sauvegarder une instance �ph�m�re en g�n�rant un nouvel identifiant, - soit mettre � jour/r�attacher les instances d�tach�es associ�es � l'identifiant courant. - La m�thode <literal>saveOrUpdate()</literal> impl�mente cette fonctionnalit�. + Les utilisateurs d'Hibernate ont demandé une méthode dont l'intention générale + serait soit de sauvegarder une instance éphémère en générant un nouvel identifiant, + soit mettre à jour/réattacher les instances détachées associées à l'identifiant courant. + La méthode <literal>saveOrUpdate()</literal> implémente cette fonctionnalité. </para> - <programlisting><![CDATA[// dans la premi�re session + <programlisting><![CDATA[// dans la première session Cat cat = (Cat) firstSession.load(Cat.class, catID); // dans une partie plus haute de l'application @@ -715,41 +717,41 @@ cat.setMate(mate); // plus tard, dans une nouvelle session -secondSession.saveOrUpdate(cat); // met � jour un �tat existant (cat a un identifiant non-null) +secondSession.saveOrUpdate(cat); // met à jour un état existant (cat a un identifiant non-null) secondSession.saveOrUpdate(mate); // sauvegarde les nouvelles instances (mate a un identiant null)]]></programlisting> <para> - L'usage et la s�mantique de <literal>saveOrUpdate()</literal> semble �tre confuse pour les - nouveaux utilisateurs. Premi�rement, aussi longtemps que vous n'essayez pas d'utiliser des + L'usage et la sémantique de <literal>saveOrUpdate()</literal> semble être confuse pour les + nouveaux utilisateurs. Premièrement, aussi longtemps que vous n'essayez pas d'utiliser des instances d'une session dans une autre, vous ne devriez pas avoir besoin d'utiliser <literal>update()</literal>, <literal>saveOrUpdate()</literal>, ou <literal>merge()</literal>. Certaines applications - n'utiliseront jamais ces m�thodes. + n'utiliseront jamais ces méthodes. </para> <para> - G�n�ralement <literal>update()</literal> ou <literal>saveOrUpdate()</literal> sont utilis�es dans - le sc�nario suivant : + Généralement <literal>update()</literal> ou <literal>saveOrUpdate()</literal> sont utilisées dans + le scénario suivant : </para> <itemizedlist spacing="compact"> <listitem> <para> - l'application charge un objet dans la premi�re session + l'application charge un objet dans la première session </para> </listitem> <listitem> <para> - l'objet est pass� � la couche utilisateur + l'objet est passé à la couche utilisateur </para> </listitem> <listitem> <para> - certaines modifications sont effectu�es sur l'objet + certaines modifications sont effectuées sur l'objet </para> </listitem> <listitem> <para> - l'objet est retourn� � la couche logique m�tier + l'objet est retourné à la couche logique métier </para> </listitem> <listitem> @@ -767,65 +769,65 @@ <itemizedlist spacing="compact"> <listitem> <para> - si l'objet est d�j� persistant dans cette session, ne rien faire + si l'objet est déjà persistant dans cette session, ne rien faire </para> </listitem> <listitem> <para> - si un autre objet associ� � la session a le m�me identifiant, lever une exception + si un autre objet associé à la session a le même identifiant, lever une exception </para> </listitem> <listitem> <para> - si l'objet n'a pas de propri�t� d'identifiant, appeler <literal>save()</literal> + si l'objet n'a pas de propriété d'identifiant, appeler <literal>save()</literal> </para> </listitem> <listitem> <para> - si l'identifiant de l'objet a une valeur assign�e � un objet nouvellement instanci�, + si l'identifiant de l'objet a une valeur assignée à un objet nouvellement instancié, appeler <literal>save()</literal> </para> </listitem> <listitem> <para> - si l'objet est versionn� (par <literal>&lt;version&gt;</literal> ou - <literal>&lt;timestamp&gt;</literal>), et la valeur de la propri�t� de version - est la m�me valeur que celle assign�e � un objet nouvellement instanci�, appeler + si l'objet est versionné (par <literal>&lt;version&gt;</literal> ou + <literal>&lt;timestamp&gt;</literal>), et la valeur de la propriété de version + est la même valeur que celle assignée à un objet nouvellement instancié, appeler <literal>save()</literal> </para> </listitem> <listitem> <para> - sinon mettre � jour l'objet avec <literal>update()</literal> + sinon mettre à jour l'objet avec <literal>update()</literal> </para> </listitem> </itemizedlist> <para> - et <literal>merge()</literal> est tr�s diff�rent : + et <literal>merge()</literal> est très différent : </para> <itemizedlist spacing="compact"> <listitem> <para> - s'il y a une instance persistante avec le m�me identifiant couramment - associ�e � la session, copier l'�tat de l'objet donn� dans l'instance persistante + s'il y a une instance persistante avec le même identifiant couramment + associée à la session, copier l'état de l'objet donné dans l'instance persistante </para> </listitem> <listitem> <para> - s'il n'y a pas d'instance persistante associ�e � cette session, essayer de le charger - � partir de la base de donn�es, ou cr�er une nouvelle instance persistante + s'il n'y a pas d'instance persistante associée à cette session, essayer de le charger + à partir de la base de données, ou créer une nouvelle instance persistante </para> </listitem> <listitem> <para> - l'instance persistante est retourn�e + l'instance persistante est retournée </para> </listitem> <listitem> <para> - l'instance donn�e ne devient pas associ�e � la session, elle reste d�tach�e + l'instance donnée ne devient pas associée à la session, elle reste détachée </para> </listitem> </itemizedlist> @@ -836,40 +838,40 @@ <title>Suppression d'objets persistants</title> <para> - <literal>Session.delete()</literal> supprimera l'�tat d'un objet de la base de donn�es. - Bien s�r, votre application pourrait encore conserver une r�f�rence vers un objet effac�. - Il est mieux de penser � <literal>delete()</literal> comme rendant une instance persistante - �ph�m�re. + <literal>Session.delete()</literal> supprimera l'état d'un objet de la base de données. + Bien sûr, votre application pourrait encore conserver une référence vers un objet effacé. + Il est mieux de penser à <literal>delete()</literal> comme rendant une instance persistante + éphémère. </para> <programlisting><![CDATA[sess.delete(cat);]]></programlisting> <para> Vous pouvez effacer des objets dans l'ordre que vous voulez, sans risque de violations - de contrainte de clef �trang�re. Il est encore possible de violer une contrainte <literal>NOT - NULL</literal> sur une colonne de clef �trang�re en effa�ant des objets dans le + de contrainte de clef étrangère. Il est encore possible de violer une contrainte <literal>NOT + NULL</literal> sur une colonne de clef étrangère en effaçant des objets dans le mauvais ordre, par exemple si vous effacer le parent, mais oubliez d'effacer les enfants. </para> </sect1> <sect1 id="objectstate-replicating" revision="1"> - <title>R�plication d'objets entre deux entrep�ts de donn�es</title> + <title>Réplication d'objets entre deux entrepôts de données</title> <para> Il est occasionnellement utile de pouvoir prendre un graphe d'instances persistantes - et de les rendre persistantes dans un entrep�t diff�rent, sans reg�n�rer les valeurs + et de les rendre persistantes dans un entrepôt différent, sans regénérer les valeurs des identifiants. </para> - <programlisting><![CDATA[//r�cup�re un cat de la base de donn�es + <programlisting><![CDATA[//récupère un cat de la base de données Session session1 = factory1.openSession(); Transaction tx1 = session1.beginTransaction(); Cat cat = session1.get(Cat.class, catId); tx1.commit(); session1.close(); -// r�concilie la seconde base de donn�es +// réconcilie la seconde base de données Session session2 = factory2.openSession(); Transaction tx2 = session2.beginTransaction(); session2.replicate(cat, ReplicationMode.LATEST_VERSION); @@ -877,41 +879,41 @@ session2.close();]]></programlisting> <para> - Le <literal>ReplicationMode</literal> d�termine comment <literal>replicate()</literal> - traitera les conflits avec les lignes existantes dans la base de donn�es. + Le <literal>ReplicationMode</literal> détermine comment <literal>replicate()</literal> + traitera les conflits avec les lignes existantes dans la base de données. </para> <itemizedlist spacing="compact"> <listitem> <para> <literal>ReplicationMode.IGNORE</literal> - ignore l'objet s'il y a une ligne - existante dans la base de donn�es avec le m�me identifiant + existante dans la base de données avec le même identifiant </para> </listitem> <listitem> <para> - <literal>ReplicationMode.OVERWRITE</literal> - �crase n'importe quelle ligne existante - dans la base de donn�es avec le m�me identifiant + <literal>ReplicationMode.OVERWRITE</literal> - écrase n'importe quelle ligne existante + dans la base de données avec le même identifiant </para> </listitem> <listitem> <para> - <literal>ReplicationMode.EXCEPTION</literal> - l�ve une exception s'il y une ligne dans - la base de donn�es avec le m�me identifiant + <literal>ReplicationMode.EXCEPTION</literal> - lève une exception s'il y une ligne dans + la base de données avec le même identifiant </para> </listitem> <listitem> <para> - <literal>ReplicationMode.LATEST_VERSION</literal> - �crase la ligne si son num�ro de version - est plus petit que le num�ro de version de l'objet, ou ignore l'objet sinon + <literal>ReplicationMode.LATEST_VERSION</literal> - écrase la ligne si son numéro de version + est plus petit que le numéro de version de l'objet, ou ignore l'objet sinon </para> </listitem> </itemizedlist> <para> - Les cas d'utilisation de cette fonctionnalit� incluent la r�conciliation de donn�es - entr�es dans diff�rentes base de donn�es, l'extension des informations de configuration - du syst�me durant une mise � jour du produit, retour en arri�re sur les changements effectu�s + Les cas d'utilisation de cette fonctionnalité incluent la réconciliation de données + entrées dans différentes base de données, l'extension des informations de configuration + du système durant une mise à jour du produit, retour en arrière sur les changements effectués durant des transactions non-ACID, et plus. </para> @@ -921,44 +923,44 @@ <title>Flush de la session</title> <para> - De temps en temps la <literal>Session</literal> ex�cutera les expressions SQL - requises pour syncrhoniser l'�tat de la connexion JDBC avec l'�tat des objets - retenus en m�moire. Ce processus, <emphasis>flush</emphasis>, arrive par d�faut aux + De temps en temps la <literal>Session</literal> exécutera les expressions SQL + requises pour syncrhoniser l'état de la connexion JDBC avec l'état des objets + retenus en mémoire. Ce processus, <emphasis>flush</emphasis>, arrive par défaut aux points suivants : </para> <itemizedlist spacing="compact"> <listitem> <para> - lors de certaines ex�cutions de requ�te + lors de certaines exécutions de requête </para> </listitem> <listitem> <para> - lors d'un appel � <literal>org.hibernate.Transaction.commit()</literal> + lors d'un appel à <literal>org.hibernate.Transaction.commit()</literal> </para> </listitem> <listitem> <para> - lors d'un appel � <literal>Session.flush()</literal> + lors d'un appel à <literal>Session.flush()</literal> </para> </listitem> </itemizedlist> <para> - Les expressions SQL sont effectu�es dans l'ordre suivant : + Les expressions SQL sont effectuées dans l'ordre suivant : </para> <orderedlist spacing="compact"> <listitem> <para> - insertion des entit�s, dans le m�me ordre que celui des - objets correspondants sauvegard�s par l'appel � <literal>Session.save()</literal> + insertion des entités, dans le même ordre que celui des + objets correspondants sauvegardés par l'appel à <literal>Session.save()</literal> </para> </listitem> <listitem> <para> - mise � jours des entit�s + mise à jours des entités </para> </listitem> <listitem> @@ -968,7 +970,7 @@ </listitem> <listitem> <para> - suppression, mise � jour et insertion des �l�ments des collections + suppression, mise à jour et insertion des éléments des collections </para> </listitem> <listitem> @@ -978,54 +980,54 @@ </listitem> <listitem> <para> - suppression des entit�s, dans le m�me ordre que celui des objets - correspondants qui ont �t� supprim�s par l'appel � <literal>Session.delete()</literal> + suppression des entités, dans le même ordre que celui des objets + correspondants qui ont été supprimés par l'appel à <literal>Session.delete()</literal> </para> </listitem> </orderedlist> <para> - (Une exception est que des objets utilisant la g�n�ration <literal>native</literal> - d'identifiants sont ins�r�s lorsqu'ils sont sauvegard�s.) + (Une exception est que des objets utilisant la génération <literal>native</literal> + d'identifiants sont insérés lorsqu'ils sont sauvegardés.) </para> <para> - Except� lorsque vous appelez <literal>flush()</literal> explicitement, il n'y - absolument aucune garantie � propos de <emphasis>quand</emphasis> la <literal>Session</literal> - ex�cute les appels JDBC, seulement sur l'<emphasis>ordre</emphasis> dans lequel ils sont - ex�cut�s. Cependant, Hibernate garantit que <literal>Query.list(..)</literal> ne - retournera jamais de donn�es p�rim�es, ni des donn�es fausses. + Excepté lorsque vous appelez <literal>flush()</literal> explicitement, il n'y + absolument aucune garantie à propos de <emphasis>quand</emphasis> la <literal>Session</literal> + exécute les appels JDBC, seulement sur l'<emphasis>ordre</emphasis> dans lequel ils sont + exécutés. Cependant, Hibernate garantit que <literal>Query.list(..)</literal> ne + retournera jamais de données périmées, ni des données fausses. </para> <para> - Il est possible de changer le comportement par d�faut, donc que le flush se produise - moins fr�quemment. La classe <literal>FlushMode</literal> d�finit trois modes diff�rents : + Il est possible de changer le comportement par défaut, donc que le flush se produise + moins fréquemment. La classe <literal>FlushMode</literal> définit trois modes différents : flush seulement lors du commit (et seulement quand l'API <literal>Transaction</literal> - d'Hibernate est utilis�e), flush automatiquement en utilisant la proc�dure expliqu�e, ou - jamais de flush � moins que <literal>flush()</literal> soit appel�e explicitement. - Le dernier mode est utile pour l'ex�cution de longues unit�s de travail, o� une - <literal>Session</literal> est gard�e ouverte et d�connect�e pour un long moment + d'Hibernate est utilisée), flush automatiquement en utilisant la procédure expliquée, ou + jamais de flush à moins que <literal>flush()</literal> soit appelée explicitement. + Le dernier mode est utile pour l'exécution de longues unités de travail, où une + <literal>Session</literal> est gardée ouverte et déconnectée pour un long moment (voir <xref linkend="transactions-optimistic-longsession"/>). </para> <programlisting><![CDATA[sess = sf.openSession(); Transaction tx = sess.beginTransaction(); -sess.setFlushMode(FlushMode.COMMIT); // permet aux requ�tes de retourner un �tat p�rim� +sess.setFlushMode(FlushMode.COMMIT); // permet aux requêtes de retourner un état périmé Cat izi = (Cat) sess.load(Cat.class, id); izi.setName(iznizi); -// pourrait retourner des donn�es p�rim�es +// pourrait retourner des données périmées sess.find("from Cat as cat left outer join cat.kittens kitten"); -// le changement pour izi n'est pas flush� ! +// le changement pour izi n'est pas flushé ! ... tx.commit(); // le flush se produit]]></programlisting> <para> - Durant le flush, une exception peut se produire (par exemple, si une op�ration de la + Durant le flush, une exception peut se produire (par exemple, si une opération de la DML viole une contrainte). Puisque les exceptions de gestion impliquent une certaine - compr�hension du comportement transactionnel d'Hibernate, nous le traitons dans + compréhension du comportement transactionnel d'Hibernate, nous le traitons dans <xref linkend="transactions"/>. </para> @@ -1035,59 +1037,59 @@ <title>Persistance transitive</title> <para> - Il est assez p�nible de sauvegarder, supprimer, ou r�attacher des objets - un par un, surtout si vous traitez un graphe d'objets associ�s. Un cas habituel - est une relation parent/enfant. Consid�rez l'exemple suivant : + Il est assez pénible de sauvegarder, supprimer, ou réattacher des objets + un par un, surtout si vous traitez un graphe d'objets associés. Un cas habituel + est une relation parent/enfant. Considérez l'exemple suivant : </para> <para> - Si les enfants de la relation parent/enfant �taient des types de valeur (par exemple, - une collection d'adresses ou de cha�nes de caract�res), leur cycle de vie d�pendraient + Si les enfants de la relation parent/enfant étaient des types de valeur (par exemple, + une collection d'adresses ou de chaînes de caractères), leur cycle de vie dépendraient du parent et aucune action ne serait requise pour "cascader" facilement les - changements d'�tat. Si le parent est sauvegard�, les objets enfants de type de valeur sont - sauvegard�s �galement, si le parent est supprim�, les enfants sont supprim�s, etc. Ceci - fonctionne m�me pour des op�rations telles que la suppression d'un enfant de la collection ; - Hibernate d�tectera cela et, puisque les objets de type de valeur ne peuvent pas avoir - des r�f�rences partag�es, supprimera l'enfant de la base de donn�es. + changements d'état. Si le parent est sauvegardé, les objets enfants de type de valeur sont + sauvegardés également, si le parent est supprimé, les enfants sont supprimés, etc. Ceci + fonctionne même pour des opérations telles que la suppression d'un enfant de la collection ; + Hibernate détectera cela et, puisque les objets de type de valeur ne peuvent pas avoir + des références partagées, supprimera l'enfant de la base de données. </para> <para> - Maintenant consid�rez le m�me sc�nario avec un parent et dont les objets enfants - sont des entit�s, et non des types de valeur (par exemple, des cat�gories et des - objets, ou un parent et des chatons). Les entit�s ont leur propre cycle de vie, - supportent les r�f�rences partag�es (donc supprimer une entit� de la collection - ne signifie pas qu'elle peut �tre supprim�e), et il n'y a par d�faut pas de - cascade d'�tat d'une entit� vers n'importe quelle entit� associ�e. Hibernate - n'impl�mente pas la <emphasis>persistance par accessibilit�</emphasis> par d�faut. + Maintenant considérez le même scénario avec un parent et dont les objets enfants + sont des entités, et non des types de valeur (par exemple, des catégories et des + objets, ou un parent et des chatons). Les entités ont leur propre cycle de vie, + supportent les références partagées (donc supprimer une entité de la collection + ne signifie pas qu'elle peut être supprimée), et il n'y a par défaut pas de + cascade d'état d'une entité vers n'importe quelle entité associée. Hibernate + n'implémente pas la <emphasis>persistance par accessibilité</emphasis> par défaut. </para> <para> - Pour chaque op�ration basique de la session d'Hibernate - incluant <literal>persist(), merge(), + Pour chaque opération basique de la session d'Hibernate - incluant <literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), evict(), replicate()</literal> - il y a un style de cascade correspondant. Respectivement, les styles de cascade s'appellent <literal>persist, merge, save-update, delete, lock, refresh, evict, replicate</literal>. Si vous voulez qu'une - op�ration soit cascad�e le long d'une association, vous devez l'indiquer dans le document de + opération soit cascadée le long d'une association, vous devez l'indiquer dans le document de mapping. Par exemple : </para> <programlisting><![CDATA[<one-to-one name="person" cascade="persist"/>]]></programlisting> <para> - Les styles de cascade peuvent �tre combin�s : + Les styles de cascade peuvent être combinés : </para> <programlisting><![CDATA[<one-to-one name="person" cascade="persist,delete,lock"/>]]></programlisting> <para> - Vous pouvez m�me utiliser <literal>cascade="all"</literal> pour sp�cifier que <emphasis>toutes</emphasis> - les op�rations devraient �tre cascad�es le long de l'association. La valeur par d�faut - <literal>cascade="none"</literal> sp�cifie qu'aucune op�ration ne sera cascad�e. + Vous pouvez même utiliser <literal>cascade="all"</literal> pour spécifier que <emphasis>toutes</emphasis> + les opérations devraient être cascadées le long de l'association. La valeur par défaut + <literal>cascade="none"</literal> spécifie qu'aucune opération ne sera cascadée. </para> <para> - Une style de cascade sp�cial, <literal>delete-orphan</literal>, s'applique seulement - aux associations un-vers-plusieurs, et indique que l'op�ration <literal>delete()</literal> - devrait �tre appliqu�e � n'importe quel enfant qui est supprim� de l'association. + Une style de cascade spécial, <literal>delete-orphan</literal>, s'applique seulement + aux associations un-vers-plusieurs, et indique que l'opération <literal>delete()</literal> + devrait être appliquée à n'importe quel enfant qui est supprimé de l'association. </para> @@ -1098,7 +1100,7 @@ <itemizedlist spacing="compact"> <listitem> <para> - Cela n'a g�n�ralement aucun sens d'activer la cascade sur une association + Cela n'a généralement aucun sens d'activer la cascade sur une association <literal>&lt;many-to-one&gt;</literal> ou <literal>&lt;many-to-many&gt;</literal>. Les cascades sont souvent utiles pour des associations <literal>&lt;one-to-one&gt;</literal> et <literal>&lt;one-to-many&gt;</literal>. @@ -1106,103 +1108,103 @@ </listitem> <listitem> <para> - Si la dur�e de vie de l'objet enfant est li�e � la dur�e de vie de l'objet parent, - faites en un <emphasis>objet du cycle de vie</emphasis> en sp�cifiant + Si la durée de vie de l'objet enfant est liée à la durée de vie de l'objet parent, + faites en un <emphasis>objet du cycle de vie</emphasis> en spécifiant <literal>cascade="all,delete-orphan"</literal>. </para> </listitem> <listitem> <para> Sinon, vous pourriez ne pas avoir besoin de cascade du tout. Mais si vous pensez que vous - travaillerez souvent avec le parent et les enfants ensemble dans la m�me transaction, et - que vous voulez vous �viter quelques frappes, consid�rez l'utilisation de + travaillerez souvent avec le parent et les enfants ensemble dans la même transaction, et + que vous voulez vous éviter quelques frappes, considérez l'utilisation de <literal>cascade="persist,merge,save-update"</literal>. </para> </listitem> </itemizedlist> <para> - Mapper une association (soit une simple association valu�e, soit une collection) avec + Mapper une association (soit une simple association valuée, soit une collection) avec <literal>cascade="all"</literal> marque l'association comme une relation de style - <emphasis>parent/enfant</emphasis> o� la sauvegarde/mise � jour/suppression du parent - entra�ne la sauvegarde/mise � jour/suppression de l'enfant ou des enfants. + <emphasis>parent/enfant</emphasis> où la sauvegarde/mise à jour/suppression du parent + entraîne la sauvegarde/mise à jour/suppression de l'enfant ou des enfants. </para> <para> - En outre, une simple r�f�rence � un enfant d'un parent persistant aura pour cons�quence - la sauvegarde/mise � jour de l'enfant. Cette m�taphore est cependant incompl�te. Un enfant - qui devient non r�f�renc� par son parent <emphasis>n'est pas</emphasis> automatiquement - supprim�e, except� dans le cas d'une association <literal>&lt;one-to-many&gt;</literal> - mapp�e avec <literal>cascade="delete-orphan"</literal>. La s�mantique pr�cise des op�rations + En outre, une simple référence à un enfant d'un parent persistant aura pour conséquence + la sauvegarde/mise à jour de l'enfant. Cette métaphore est cependant incomplète. Un enfant + qui devient non référencé par son parent <emphasis>n'est pas</emphasis> automatiquement + supprimée, excepté dans le cas d'une association <literal>&lt;one-to-many&gt;</literal> + mappée avec <literal>cascade="delete-orphan"</literal>. La sémantique précise des opérations de cascade pour une relation parent/enfant est la suivante : </para> <itemizedlist spacing="compact"> <listitem> <para> - Si un parent est pass� � <literal>persist()</literal>, tous les enfant sont pass�s � + Si un parent est passé à <literal>persist()</literal>, tous les enfant sont passés à <literal>persist()</literal> </para> </listitem> <listitem> <para> - Si un parent est pass� � <literal>merge()</literal>, tous les enfants sont pass�s � + Si un parent est passé à <literal>merge()</literal>, tous les enfants sont passés à <literal>merge()</literal> </para> </listitem> <listitem> <para> - Si un parent est pass� � <literal>save()</literal>, <literal>update()</literal> ou - <literal>saveOrUpdate()</literal>, tous les enfants sont pass�s � <literal>saveOrUpdate()</literal> + Si un parent est passé à <literal>save()</literal>, <literal>update()</literal> ou + <literal>saveOrUpdate()</literal>, tous les enfants sont passés à <literal>saveOrUpdate()</literal> </para> </listitem> <listitem> <para> - Si un enfant d�tach� ou �ph�m�re devient r�f�renc� par un parent persistant, - il est pass� � <literal>saveOrUpdate()</literal> + Si un enfant détaché ou éphémère devient référencé par un parent persistant, + il est passé à <literal>saveOrUpdate()</literal> </para> </listitem> <listitem> <para> - Si un parent est supprim�, tous les enfants sont pass�s � <literal>delete()</literal> + Si un parent est supprimé, tous les enfants sont passés à <literal>delete()</literal> </para> </listitem> <listitem> <para> - Si un enfant est d�r�f�renc� par un parent persistant, <emphasis>rien de sp�cial - n'arrive</emphasis> - l'application devrait explicitement supprimer l'enfant si n�cessaire - - � moins que <literal>cascade="delete-orphan"</literal> soit param�tr�, - au quel cas l'enfant "orphelin" est supprim�. + Si un enfant est déréférencé par un parent persistant, <emphasis>rien de spécial + n'arrive</emphasis> - l'application devrait explicitement supprimer l'enfant si nécessaire - + à moins que <literal>cascade="delete-orphan"</literal> soit paramétré, + au quel cas l'enfant "orphelin" est supprimé. </para> </listitem> </itemizedlist> <para> - Enfin, la cascade des op�rations peut �tre effectu�e sur un graphe donn� lors - de l'<emphasis>appel de l'op�ration</emphasis> or lors du <emphasis>flush</emphasis> - suivant. Toutes les op�rations, lorsque cascad�es, le sont sur toutes les entit�s - associ�es atteignables lorsque l'op�tation est ex�cut�e. Cependant - <literal>save-upate</literal> et <literal>delete-orphan</literal> sont cascad�es - � toutes les entit�s associ�es atteignables lors du flush de la + Enfin, la cascade des opérations peut être effectuée sur un graphe donné lors + de l'<emphasis>appel de l'opération</emphasis> or lors du <emphasis>flush</emphasis> + suivant. Toutes les opérations, lorsque cascadées, le sont sur toutes les entités + associées atteignables lorsque l'opétation est exécutée. Cependant + <literal>save-upate</literal> et <literal>delete-orphan</literal> sont cascadées + à toutes les entités associées atteignables lors du flush de la <literal>Session</literal>. </para> </sect1> <sect1 id="objectstate-metadata"> - <title>Utilisation des m�ta-donn�es</title> + <title>Utilisation des méta-données</title> <para> - Hibernate requiert un mod�le de m�ta-niveau tr�s riche de toutes les entit�s et types valu�s. - De temps en temps, ce mod�le est tr�s utile � l'application elle m�me. Par exemple, - l'application pourrait utiliser les m�ta-donn�es d'Hibernate pour impl�menter un algorithme - de copie en profondeur "intelligent" qui comprendrait quels objets devraient copi�s - (par exemple les types de valeur mutables) et lesquels ne devraient pas l'�tre (par exemple - les types de valeurs immutables et, possiblement, les entit�s associ�es). + Hibernate requiert un modèle de méta-niveau très riche de toutes les entités et types valués. + De temps en temps, ce modèle est très utile à l'application elle même. Par exemple, + l'application pourrait utiliser les méta-données d'Hibernate pour implémenter un algorithme + de copie en profondeur "intelligent" qui comprendrait quels objets devraient copiés + (par exemple les types de valeur mutables) et lesquels ne devraient pas l'être (par exemple + les types de valeurs immutables et, possiblement, les entités associées). </para> <para> - Hibernate expose les m�ta-donn�es via les interfaces <literal>ClassMetadata</literal> - et <literal>CollectionMetadata</literal> et la hi�rarchie <literal>Type</literal>. - Les instances des interfaces de m�ta-donn�es peuvent �tre obtenues � partir de la + Hibernate expose les méta-données via les interfaces <literal>ClassMetadata</literal> + et <literal>CollectionMetadata</literal> et la hiérarchie <literal>Type</literal>. + Les instances des interfaces de méta-données peuvent être obtenues à partir de la <literal>SessionFactory</literal>. </para> @@ -1213,7 +1215,7 @@ String[] propertyNames = catMeta.getPropertyNames(); Type[] propertyTypes = catMeta.getPropertyTypes(); -// r�cup�re une Map de toutes les propri�t�s qui ne sont pas des collections ou des associations +// récupère une Map de toutes les propriétés qui ne sont pas des collections ou des associations Map namedValues = new HashMap(); for ( int i=0; i<propertyNames.length; i++ ) { if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCollectionType() ) { Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/toolset_guide.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/toolset_guide.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/toolset_guide.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,85 +1,87 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="toolsetguide" revision="2"> <title>Guide des outils</title> <para> - Des outils en ligne de commande, des plugins Eclipse ainsu que des t�ches Ant permettent de g�rer de cycles de d�veloppement complet + Des outils en ligne de commande, des plugins Eclipse ainsu que des tâches Ant permettent de gérer de cycles de développement complet de projets utilisant Hibernate. </para> <para> - Les <emphasis>outils Hibernate</emphasis> actuels incluent des plugins pour l'IDE Eclipse ainsi que des t�ches Ant pour l'ing�nierie - inverse de bases de donn�es existantes : + Les <emphasis>outils Hibernate</emphasis> actuels incluent des plugins pour l'IDE Eclipse ainsi que des tâches Ant pour l'ingénierie + inverse de bases de données existantes : </para> <itemizedlist> <listitem><para> - <emphasis>Mapping Editor :</emphasis> un �diteur pour les fichiers de mapping XML Hibernate, supportant l'auto-compl�tion et la mise en valeur de la syntaxe. - Il supporte aussi l'auto-compl�tion automatique pour les noms de classes et les noms de propri�t�/champ, - le rendant beaucoup plus polyvalent qu'un �diteurXML normal. + <emphasis>Mapping Editor :</emphasis> un éditeur pour les fichiers de mapping XML Hibernate, supportant l'auto-complétion et la mise en valeur de la syntaxe. + Il supporte aussi l'auto-complétion automatique pour les noms de classes et les noms de propriété/champ, + le rendant beaucoup plus polyvalent qu'un éditeurXML normal. </para></listitem> <listitem><para> <emphasis>Console :</emphasis> la console est une nouvelle vue d'Eclipse. En plus de la vue d'ensemble arborescente de vos configurations de console, vous obtenez aussi une vue interactive de vos classes persistantes et de leurs relations. - La console vous permet d'ex�cuter des requ�te HQL dans votre base de donn�es et de parcourir les r�sultats directement dans Eclipse. + La console vous permet d'exécuter des requête HQL dans votre base de données et de parcourir les résultats directement dans Eclipse. </para></listitem> <listitem><para> <emphasis>Development Wizards :</emphasis> plusieurs assistants sont fournis avec les outils d'Hibernate - pour Eclipse ; vous pouvez utiliser un assistant pour g�n�rer rapidement les fichiers de configuration d'Hibernate (cfg.xml), - ou vous pouvez m�me compl�tement g�n�rer les fichiers de mapping Hibernate et les sources des POJOs � partir d'un sch�ma de base de donn�es existant. - L'assistant d'ing�nierie inverse supporte les mod�les utilisateur. + pour Eclipse ; vous pouvez utiliser un assistant pour générer rapidement les fichiers de configuration d'Hibernate (cfg.xml), + ou vous pouvez même complètement générer les fichiers de mapping Hibernate et les sources des POJOs à partir d'un schéma de base de données existant. + L'assistant d'ingénierie inverse supporte les modèles utilisateur. </para></listitem> <listitem><para> - <emphasis>T�ches Ant :</emphasis> + <emphasis>Tâches Ant :</emphasis> </para></listitem> </itemizedlist> <para> - Veuillez-vous r�f�rer au paquet <emphasis>outils Hibernate</emphasis> et sa documentation pour plus d'informations. + Veuillez-vous référer au paquet <emphasis>outils Hibernate</emphasis> et sa documentation pour plus d'informations. </para> <para> - Pourtant, le paquet principal d'Hibernate arrive avec un lot d'outils int�gr�s (il peut m�me �tre utilis� de "l'int�rieur" d'Hibernate � la vol�e) : + Pourtant, le paquet principal d'Hibernate arrive avec un lot d'outils intégrés (il peut même être utilisé de "l'intérieur" d'Hibernate à la volée) : <emphasis>SchemaExport</emphasis> aussi connu comme <literal>hbm2ddl</literal>. </para> <sect1 id="toolsetguide-s1" revision="2"> - <title>G�n�ration automatique du sch�ma</title> + <title>Génération automatique du schéma</title> <para> - La DDL peut �tre g�n�r�e � partir de vos fichiers de mapping par un utilitaire d'Hibernate. Le sch�ma g�n�r� - inclut les contraintes d'int�grit� r�f�rentielle (clefs primaires et �trang�res) pour les tables d'entit�s - et de collections. Les tables et les s�quences sont aussi cr��es pour les g�n�rateurs d'identifiant mapp�s. + La DDL peut être générée à partir de vos fichiers de mapping par un utilitaire d'Hibernate. Le schéma généré + inclut les contraintes d'intégrité référentielle (clefs primaires et étrangères) pour les tables d'entités + et de collections. Les tables et les séquences sont aussi créées pour les générateurs d'identifiant mappés. </para> <para> - Vous <emphasis>devez</emphasis> sp�cifier un <literal>Dialect</literal> SQL via la propri�t� + Vous <emphasis>devez</emphasis> spécifier un <literal>Dialect</literal> SQL via la propriété <literal>hibernate.dialect</literal> lors de l'utilisation de cet outils, puisque la DDL est - fortement d�pendante de la base de donn�es. + fortement dépendante de la base de données. </para> <para> - D'abord, personnalisez vos fichiers de mapping pour am�liorer le sch�ma g�n�r�. + D'abord, personnalisez vos fichiers de mapping pour améliorer le schéma généré. </para> <sect2 id="toolsetguide-s1-2" revision="3"> - <title>Personnaliser le sch�ma</title> + <title>Personnaliser le schéma</title> <para> - Plusieurs �l�ments du mapping hibernate d�finissent des attributs optionnels - nomm�s <literal>length</literal>, <literal>precision</literal> et <literal>scale</literal>. - Vous pouvez param�trer la longueur, la pr�cision,... d'une colonne avec ces attributs. + Plusieurs éléments du mapping hibernate définissent des attributs optionnels + nommés <literal>length</literal>, <literal>precision</literal> et <literal>scale</literal>. + Vous pouvez paramétrer la longueur, la précision,... d'une colonne avec ces attributs. </para> <programlisting><![CDATA[<property name="zip" length="5"/>]]></programlisting> <programlisting><![CDATA[<property name="balance" precision="12" scale="2"/>]]></programlisting> <para> - Certains �l�ments acceptent aussi un attribut <literal>not-null</literal> - (utilis� pour g�n�rer les contraintes de colonnes <literal>NOT NULL</literal>) et - un attribut <literal>unique</literal> (pour g�n�rer une contrainte de colonne + Certains éléments acceptent aussi un attribut <literal>not-null</literal> + (utilisé pour générer les contraintes de colonnes <literal>NOT NULL</literal>) et + un attribut <literal>unique</literal> (pour générer une contrainte de colonne <literal>UNIQUE</literal>). </para> @@ -87,10 +89,10 @@ <programlisting><![CDATA[<element column="serialNumber" type="long" not-null="true" unique="true"/>]]></programlisting> <para> - Un attribut <literal>unique-key</literal> peut �tre utilis� pour grouper les colonnes - en une seule contrainte d'unicit�. Actuellement, la valeur sp�cifi�e par - l'attribut <literal>unique-key</literal> n'est <emphasis>pas</emphasis> utilis�e pour - nommer la contrainte dans le DDL g�n�r�, elle sert juste � grouper les colonnes + Un attribut <literal>unique-key</literal> peut être utilisé pour grouper les colonnes + en une seule contrainte d'unicité. Actuellement, la valeur spécifiée par + l'attribut <literal>unique-key</literal> n'est <emphasis>pas</emphasis> utilisée pour + nommer la contrainte dans le DDL généré, elle sert juste à grouper les colonnes dans le fichier de mapping. </para> <programlisting><![CDATA[<many-to-one name="org" column="orgId" unique-key="OrgEmployeeId"/> @@ -98,8 +100,8 @@ <para> Un attribut <literal>index</literal> indique le nom d'un index qui sera - cr�� en utilisant la ou les colonnes mapp�es. Plusieurs colonnes - peuvent �tre group�es dans un m�me index, en sp�cifiant le m�me + créé en utilisant la ou les colonnes mappées. Plusieurs colonnes + peuvent être groupées dans un même index, en spécifiant le même nom d'index. </para> @@ -107,14 +109,14 @@ <property name="firstName" index="CustName"/>]]></programlisting> <para> - Un attribut <literal>foreign-key</literal> peut �tre utilis� pour surcharger le nom - des cl�s �trang�res g�n�r�es. + Un attribut <literal>foreign-key</literal> peut être utilisé pour surcharger le nom + des clés étrangères générées. </para> <programlisting><![CDATA[<many-to-one name="bar" column="barId" foreign-key="FKFooBar"/>]]></programlisting> <para> - Plusieurs �l�ments de mapping acceptent aussi un �l�ment fils <literal>&lt;column&gt;</literal>. + Plusieurs éléments de mapping acceptent aussi un élément fils <literal>&lt;column&gt;</literal>. Ceci est utile pour les type multi-colonnes: </para> @@ -125,9 +127,9 @@ </property>]]></programlisting> <para> - L'attribut <literal>default</literal> vous laisse sp�cifier une valeur par d�faut pour - une colonnes (vous devriez assigner la m�me valeur � la propri�t� mapp�e avant de sauvegarder une nouvelle instance - de la classe mapp�e). + L'attribut <literal>default</literal> vous laisse spécifier une valeur par défaut pour + une colonnes (vous devriez assigner la même valeur à la propriété mappée avant de sauvegarder une nouvelle instance + de la classe mappée). </para> <programlisting><![CDATA[<property name="credits" type="integer" insert="false"> @@ -140,7 +142,7 @@ <para> L'attribut <literal>sql-type</literal> laisse l'utilisateur surcharger le mapping - par d�faut du type Hibernate vers un type SQL. + par défaut du type Hibernate vers un type SQL. </para> <programlisting><![CDATA[<property name="balance" type="float"> @@ -149,7 +151,7 @@ <para> - L'attribut <literal>check</literal> permet de sp�cifier une contrainte de v�rification. + L'attribut <literal>check</literal> permet de spécifier une contrainte de vérification. </para> <programlisting><![CDATA[<property name="foo" type="integer"> @@ -172,53 +174,53 @@ <row> <entry>Attribut</entry> <entry>Valeur</entry> - <entry>Interpr�tation</entry> + <entry>Interprétation</entry> </row> </thead> <tbody> <row> <entry><literal>length</literal></entry> - <entry>num�rique</entry> + <entry>numérique</entry> <entry>taille d'une colonne</entry> </row> <row> <entry><literal>precision</literal></entry> - <entry>num�rique</entry> - <entry>pr�cision d�cimale de la colonne</entry> + <entry>numérique</entry> + <entry>précision décimale de la colonne</entry> </row> <row> <entry><literal>scale</literal></entry> - <entry>num�rique</entry> - <entry>scale d�cimale de la colonne</entry> + <entry>numérique</entry> + <entry>scale décimale de la colonne</entry> </row> <row> <entry><literal>not-null</literal></entry> <entry><literal>true|false</literal></entry> - <entry>sp�cifie que la colonne doit �tre non-nulle</entry> + <entry>spécifie que la colonne doit être non-nulle</entry> </row> <row> <entry><literal>unique</literal></entry> <entry><literal>true|false</literal></entry> - <entry>sp�cifie que la colonne doit avoir une contrainte d'unicit�</entry> + <entry>spécifie que la colonne doit avoir une contrainte d'unicité</entry> </row> <row> <entry><literal>index</literal></entry> <entry><literal>index_name</literal></entry> - <entry>sp�cifie le nom d'un index (multi-colonnes)</entry> + <entry>spécifie le nom d'un index (multi-colonnes)</entry> </row> <row> <entry><literal>unique-key</literal></entry> <entry><literal>unique_key_name</literal></entry> - <entry>sp�cifie le nom d'une contrainte d'unicit� multi-colonnes</entry> + <entry>spécifie le nom d'une contrainte d'unicité multi-colonnes</entry> </row> <row> <entry><literal>foreign-key</literal></entry> <entry><literal>foreign_key_name</literal></entry> <entry> - sp�cifie le nom d'une contrainte de cl� �trang�re g�n�r�e pour - une association, utilisez-la avec les �l�ments de mapping + spécifie le nom d'une contrainte de clé étrangère générée pour + une association, utilisez-la avec les éléments de mapping &lt;one-to-one&gt;, &lt;many-to-one&gt;, &lt;key&gt;, et &lt;many-to-many&gt; - Notez que les extr�mit�s <literal>inverse="true"</literal> + Notez que les extrêmités <literal>inverse="true"</literal> se seront pas prises en compte par <literal>SchemaExport</literal>. </entry> </row> @@ -226,22 +228,22 @@ <entry><literal>sql-type</literal></entry> <entry><literal>SQL column_type</literal></entry> <entry> - surcharge le type par d�faut (attribut de - l'�l�ment <literal>&lt;column&gt;</literal> uniquement) + surcharge le type par défaut (attribut de + l'élément <literal>&lt;column&gt;</literal> uniquement) </entry> </row> <row> <entry><literal>default</literal></entry> <entry>expression SQL</entry> <entry> - sp�cifie une valeur par d�faut pour la colonne + spécifie une valeur par défaut pour la colonne </entry> </row> <row> <entry><literal>check</literal></entry> <entry>SQL expression</entry> <entry> - cr�e une contrainte de v�rification sur la table ou la colonne + crée une contrainte de vérification sur la table ou la colonne </entry> </row> </tbody> @@ -249,7 +251,7 @@ </table> <para> - L'�l�ment <literal>&lt;comment&gt;</literal> vous permet de sp�cifier un commentaire pour le sch�ma g�n�r�. + L'élément <literal>&lt;comment&gt;</literal> vous permet de spécifier un commentaire pour le schéma généré. </para> <programlisting><![CDATA[<class name="Customer" table="CurCust"> @@ -264,19 +266,19 @@ </property>]]></programlisting> <para> - Ceci a pour r�sultat une expression + Ceci a pour résultat une expression <literal>comment on table</literal> ou - <literal>comment on column</literal> dans la DDL g�n�r�e (o� support�e). + <literal>comment on column</literal> dans la DDL générée (où supportée). </para> </sect2> <sect2 id="toolsetguide-s1-3" revision="2"> - <title>Ex�cuter l'outil</title> + <title>Exécuter l'outil</title> <para> - L'outil <literal>SchemaExport</literal> g�n�re un script DDL vers - la sortie standard et/ou ex�cute les ordres DDL. + L'outil <literal>SchemaExport</literal> génère un script DDL vers + la sortie standard et/ou exécute les ordres DDL. </para> <para> @@ -298,7 +300,7 @@ <tbody> <row> <entry><literal>--quiet</literal></entry> - <entry>ne pas �crire le script vers la sortie standard</entry> + <entry>ne pas écrire le script vers la sortie standard</entry> </row> <row> <entry><literal>--drop</literal></entry> @@ -306,42 +308,42 @@ </row> <row> <entry><literal>--create</literal></entry> - <entry>ne cr�� que les tables</entry> + <entry>ne créé que les tables</entry> </row> <row> <entry><literal>--text</literal></entry> - <entry>ne pas ex�cuter sur la base de donn�es</entry> + <entry>ne pas exécuter sur la base de données</entry> </row> <row> <entry><literal>--output=my_schema.ddl</literal></entry> - <entry>�crit le script ddl vers un fichier</entry> + <entry>écrit le script ddl vers un fichier</entry> </row> <row> <entry><literal>--naming=eg.MyNamingStrategy</literal></entry> - <entry>s�lectionne une <literal>NamingStrategy</literal></entry> + <entry>sélectionne une <literal>NamingStrategy</literal></entry> </row> <row> <entry><literal>--config=hibernate.cfg.xml</literal></entry> - <entry>lit la configuration Hibernate � partir d'un fichier XML</entry> + <entry>lit la configuration Hibernate à partir d'un fichier XML</entry> </row> <row> <entry><literal>--properties=hibernate.properties</literal></entry> - <entry>lit les propri�t�s de la base de donn�es � partir d'un fichier</entry> + <entry>lit les propriétés de la base de données à partir d'un fichier</entry> </row> <row> <entry><literal>--format</literal></entry> - <entry>formatte proprement le SQL g�n�r� dans le script</entry> + <entry>formatte proprement le SQL généré dans le script</entry> </row> <row> <entry><literal>--delimiter=x</literal></entry> - <entry>param�tre un d�limiteur de fin de ligne pour le script</entry> + <entry>paramètre un délimiteur de fin de ligne pour le script</entry> </row> </tbody> </tgroup> </table> <para> - Vous pouvez m�me int�grer <literal>SchemaExport</literal> dans votre application : + Vous pouvez même intégrer <literal>SchemaExport</literal> dans votre application : </para> <programlisting><![CDATA[Configuration cfg = ....; @@ -350,26 +352,26 @@ </sect2> <sect2 id="toolsetguide-s1-4"> - <title>Propri�t�s</title> + <title>Propriétés</title> <para> - Les propri�t�s de la base de donn�es peuvent �tre sp�cifi�es + Les propriétés de la base de données peuvent être spécifiées </para> <itemizedlist spacing="compact"> <listitem> - <para>comme propri�t�s syst�me avec <literal>-D</literal><emphasis>&lt;property&gt;</emphasis></para> + <para>comme propriétés système avec <literal>-D</literal><emphasis>&lt;property&gt;</emphasis></para> </listitem> <listitem> <para>dans <literal>hibernate.properties</literal></para> </listitem> <listitem> - <para>dans un fichier de propri�t�s d�clar� avec <literal>--properties</literal></para> + <para>dans un fichier de propriétés déclaré avec <literal>--properties</literal></para> </listitem> </itemizedlist> <para> - Les propri�t�s n�cessaires sont : + Les propriétés nécessaires sont : </para> <table frame="topbot"> @@ -379,7 +381,7 @@ <colspec colwidth="2*"/> <thead> <row> - <entry>Nom de la propri�t�</entry> + <entry>Nom de la propriété</entry> <entry>Description</entry> </row> </thead> @@ -394,7 +396,7 @@ </row> <row> <entry><literal>hibernate.connection.username</literal></entry> - <entry>utilisateur de la base de donn�es</entry> + <entry>utilisateur de la base de données</entry> </row> <row> <entry><literal>hibernate.connection.password</literal></entry> @@ -439,12 +441,12 @@ </sect2> <sect2 id="toolsetguide-s1-6" revision="2"> - <title>Mises � jour incr�mentales du sch�ma</title> + <title>Mises à jour incrémentales du schéma</title> <para> - L'outil <literal>SchemaUpdate</literal> mettra � jour un sch�ma existant - en effectuant les changement par "incr�ment". - Notez que <literal>SchemaUpdate</literal> d�pends beaucoup de l'API JDBC + L'outil <literal>SchemaUpdate</literal> mettra à jour un schéma existant + en effectuant les changement par "incrément". + Notez que <literal>SchemaUpdate</literal> dépends beaucoup de l'API JDBC metadata, il ne fonctionnera donc pas avec tous les drivers JDBC. </para> @@ -467,11 +469,11 @@ <tbody> <row> <entry><literal>--quiet</literal></entry> - <entry>ne pas �crire vers la sortie standard</entry> + <entry>ne pas écrire vers la sortie standard</entry> </row> <row> <entry><literal>--text</literal></entry> - <entry>ne pas exporter vers la base de donn�es</entry> + <entry>ne pas exporter vers la base de données</entry> </row> <row> <entry><literal>--naming=eg.MyNamingStrategy</literal></entry> @@ -479,14 +481,14 @@ </row> <row> <entry><literal>--properties=hibernate.properties</literal></entry> - <entry>lire les propri�t�s de la base de donn�es � partir d'un fichier</entry> + <entry>lire les propriétés de la base de données à partir d'un fichier</entry> </row> </tbody> </tgroup> </table> <para> - Vous pouvez int�grer <literal>SchemaUpdate</literal> dans votre application : + Vous pouvez intégrer <literal>SchemaUpdate</literal> dans votre application : </para> <programlisting><![CDATA[Configuration cfg = ....; @@ -495,7 +497,7 @@ </sect2> <sect2 id="toolsetguide-s1-7"> - <title>Utiliser Ant pour des mises � jour de sch�ma par incr�ment</title> + <title>Utiliser Ant pour des mises à jour de schéma par incrément</title> <para> Vous pouvez appeler <literal>SchemaUpdate</literal> depuis le script Ant : @@ -516,12 +518,12 @@ </target>]]></programlisting> <sect2 id="toolsetguide-s1-8" revision="1"> - <title>Validation du sch�ma</title> + <title>Validation du schéma</title> <para> - L'outil <literal>SchemaValidator</literal> validera que le sch�ma existant correspond � vos documents de mapping. - Notez que le <literal>SchemaValidator</literal> d�pends de l'API metadata de JDBC, il ne fonctionnera - donc pas avec tous les drivers JDBC. Cet outil est extr�mement utile pour tester. + L'outil <literal>SchemaValidator</literal> validera que le schéma existant correspond à vos documents de mapping. + Notez que le <literal>SchemaValidator</literal> dépends de l'API metadata de JDBC, il ne fonctionnera + donc pas avec tous les drivers JDBC. Cet outil est extrêmement utile pour tester. </para> <para> @@ -547,7 +549,7 @@ </row> <row> <entry><literal>--properties=hibernate.properties</literal></entry> - <entry>lit les propri�t�s dela base de donn�es depuis un fichier de propri�t�s</entry> + <entry>lit les propriétés dela base de données depuis un fichier de propriétés</entry> </row> <row> <entry><literal>--config=hibernate.cfg.xml</literal></entry> @@ -568,7 +570,7 @@ </sect2> <sect2 id="toolsetguide-s1-9"> - <title>Utiliser Ant pour la validation du Sch�ma</title> + <title>Utiliser Ant pour la validation du Schéma</title> <para> Vous pouvez appeler <literal>SchemaValidator</literal> depuis le script Ant: Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/transactions.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/transactions.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/transactions.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,129 +1,131 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="transactions" revision="2"> - <title>Transactions et acc�s concurrents</title> + <title>Transactions et accès concurrents</title> <para> - L'un des principaux avantages du m�canisme de contr�le des acc�s concurrents d'Hibernate est qu'il est tr�s - facile � comprendre. Hibernate utilise directement les connexions JDBC ainsi que les ressources JTA sans y - ajouter davantage de m�canisme de blocage. Nous vous recommandons de vous familiariser avec les sp�cifications - JDBC, ANSI et d'isolement de transaction de la base de donn�es que vous utilisez. + L'un des principaux avantages du mécanisme de contrôle des accès concurrents d'Hibernate est qu'il est très + facile à comprendre. Hibernate utilise directement les connexions JDBC ainsi que les ressources JTA sans y + ajouter davantage de mécanisme de blocage. Nous vous recommandons de vous familiariser avec les spécifications + JDBC, ANSI et d'isolement de transaction de la base de données que vous utilisez. </para> <para> - Hibernate ne v�rouille pas vos objets en m�moire. Votre application peut suivre le - comportement d�fini par le niveau d'isolation de vos transactions de base de donn�es. - Notez que gr�ce � la <literal>Session</literal>, qui est aussi un cache de scope transaction, Hibernate - fournit des lectures r�p�t�es pour les r�cup�ration par identifiants et les requ�tes - d'entit�s (pas celle de valeurs scalaires). + Hibernate ne vérouille pas vos objets en mémoire. Votre application peut suivre le + comportement défini par le niveau d'isolation de vos transactions de base de données. + Notez que grâce à la <literal>Session</literal>, qui est aussi un cache de scope transaction, Hibernate + fournit des lectures répétées pour les récupération par identifiants et les requêtes + d'entités (pas celle de valeurs scalaires). </para> <para> En addition au versionning pour le controle automatique de concurrence, Hibernate fournit - une API (mineure) pour le verrouillage perssimiste des enregistrements, en g�n�rant + une API (mineure) pour le verrouillage perssimiste des enregistrements, en générant une syntaxe <literal>SELECT FOR UPDATE</literal>. Le controle de concurrence optimiste - et cette API seront d�taill�s plus tard dans ce chapitre. + et cette API seront détaillés plus tard dans ce chapitre. </para> <para> - Nous aborderons la gestion des acc�s concurrents en discutant de la granularit� des objets <literal>Configuration</literal>, - <literal>SessionFactory</literal>, et <literal>Session</literal>, ainsi que de certains concepts relatifs � la base de donn�es + Nous aborderons la gestion des accès concurrents en discutant de la granularité des objets <literal>Configuration</literal>, + <literal>SessionFactory</literal>, et <literal>Session</literal>, ainsi que de certains concepts relatifs à la base de données et aux longues transactions applicatives. </para> <sect1 id="transactions-basics" revision="1"> - <title>Gestion de session et d�limitation de transactions</title> + <title>Gestion de session et délimitation de transactions</title> - <para>Il est important de savoir qu'un objet <literal>SessionFactory</literal> est un objet complexe et optimis� pour - fonctionner avec les threads(thread- safe). Il est co�teux � cr�er et est ainsi pr�vu pour n'�tre instanci� qu?une - seule fois via un objet <literal>Configuration</literal> au d�marrage de l'application, - et �tre partag� par tous les threads d'une application. + <para>Il est important de savoir qu'un objet <literal>SessionFactory</literal> est un objet complexe et optimisé pour + fonctionner avec les threads(thread- safe). Il est coûteux à créer et est ainsi prévu pour n'être instancié qu?une + seule fois via un objet <literal>Configuration</literal> au démarrage de l'application, + et être partagé par tous les threads d'une application. </para> - <para>Un objet <literal>Session</literal> est relativement simple et n'est threadsafe. Il est �galement peu - co�teux � cr�er. Il devrait n'�tre utilis� qu'une seule fois, pour un processus d'affaire ou une unit� de - travail ou une conversation et ensuite �tre rel�ch�. Un objet <literal>Session</literal> ne tentera pas + <para>Un objet <literal>Session</literal> est relativement simple et n'est threadsafe. Il est également peu + coûteux à créer. Il devrait n'être utilisé qu'une seule fois, pour un processus d'affaire ou une unité de + travail ou une conversation et ensuite être relâché. Un objet <literal>Session</literal> ne tentera pas d'obtenir de connexion ( <literal>Connection</literal> ) - JDBC (ou de <literal>Datasource</literal> ) si ce n'est pas n�cessaire. + JDBC (ou de <literal>Datasource</literal> ) si ce n'est pas nécessaire. </para> - <para>Afin de compl�ter ce tableau, vous devez �galement penser aux transactions de base de donn�es. Une - transaction de base de donn�es se doit d'�tre la plus courte possible afin de r�duire les risques de - collision sur des enregistrements verrouill�s. De longues transactions � la base de donn�es nuiront � - l'extensibilit� de vos applications lorsque confront�es � de hauts niveaux de charge. Par cons�quent, - il n'est jamais bon de maintenir une transaction ouverte pendant la dur�e de reflexion de l'utilisateur, - jusqu'a ce que l'unit� de travail soit achev�e. + <para>Afin de compléter ce tableau, vous devez également penser aux transactions de base de données. Une + transaction de base de données se doit d'être la plus courte possible afin de réduire les risques de + collision sur des enregistrements verrouillés. De longues transactions à la base de données nuiront à + l'extensibilité de vos applications lorsque confrontées à de hauts niveaux de charge. Par conséquent, + il n'est jamais bon de maintenir une transaction ouverte pendant la durée de reflexion de l'utilisateur, + jusqu'a ce que l'unité de travail soit achevée. </para> - <para>Maintenant, comment d�limiter une unit� de travail? Est-ce qu'une instance de <literal>Session</literal> peut avoir une dur�e - de vie d�passant plusieurs transactions � la base de donn�es, ou bien est-ce que celles-ci doivent �tre li�es une � une? - Quand faut-il ouvrir et fermer une <literal>Session</literal> ? Comment d�finir la d�marcation de vos transactions � la base de donn�es? + <para>Maintenant, comment délimiter une unité de travail? Est-ce qu'une instance de <literal>Session</literal> peut avoir une durée + de vie dépassant plusieurs transactions à la base de données, ou bien est-ce que celles-ci doivent être liées une à une? + Quand faut-il ouvrir et fermer une <literal>Session</literal> ? Comment définir la démarcation de vos transactions à la base de données? </para> <sect2 id="transactions-basics-uow" revision="1"> - <title>Unit� de travail</title> + <title>Unité de travail</title> <para> Il est important de mentionner que d'utiliser un paradigme <emphasis>session-par-operation</emphasis> est un anti-pattern. Autrement dit: n'ouvrez et ne fermez pas la - <literal>Session</literal> � chacun de vos acc�s simples � la base de donn�es dans un m�me thread! Bien s�r, le m�me raisonnement - s'applique sur la gestion des transactions � la base de donn�es. Les appels � la base de donn�es - devraient �tre faits en ordre et selon une s�quence d�finie. Ils devraient �galement �tre regroup�s en - des unit�s de travail atomiques. (Notez que l?utilisation d?une connexion auto-commit constitue le m�me - anti-pattern. Ce mode de fonctionnement existe pour les applications �mettant des commandes SQL � partir - d?une console. Hibernate d�sengage le mode auto-commit et s'attend � ce qu'un serveur d'applications le - fasse �galement.) - Les transactions avec la base de donn�es ne sont jamais optionnelles, toute communication - avec une base de donn�es doit se d�rouler dans une transaction, peu importe si vous lisez - ou �crivez des donn�es. Comme �voqu�, le comportement auto-commit pour lire les - donn�es devrait �tre �vit�, puisque plusieurs petites transactions ne seront jamais - aussi efficaces qu'une seule plus grosse clairement d�finie comme unit� de travail. - Ce dernier choix et en plus beaucoup plus facile a maintenir et � faire �voluer. + <literal>Session</literal> à chacun de vos accès simples à la base de données dans un même thread! Bien sûr, le même raisonnement + s'applique sur la gestion des transactions à la base de données. Les appels à la base de données + devraient être faits en ordre et selon une séquence définie. Ils devraient également être regroupés en + des unités de travail atomiques. (Notez que l?utilisation d?une connexion auto-commit constitue le même + anti-pattern. Ce mode de fonctionnement existe pour les applications émettant des commandes SQL à partir + d?une console. Hibernate désengage le mode auto-commit et s'attend à ce qu'un serveur d'applications le + fasse également.) + Les transactions avec la base de données ne sont jamais optionnelles, toute communication + avec une base de données doit se dérouler dans une transaction, peu importe si vous lisez + ou écrivez des données. Comme évoqué, le comportement auto-commit pour lire les + données devrait être évité, puisque plusieurs petites transactions ne seront jamais + aussi efficaces qu'une seule plus grosse clairement définie comme unité de travail. + Ce dernier choix et en plus beaucoup plus facile a maintenir et à faire évoluer. </para> <para> - Le pattern d'utilisation le plus fr�quemment rencontr� dans des applications clients serveur + Le pattern d'utilisation le plus fréquemment rencontré dans des applications clients serveur multi-usagers est le <emphasis>session-per-request</emphasis> - (litt�ralement : Session par requ�te). Dans ce mod�le, la requ�te d'un client est envoy�e � un serveur - (O� la couche de persistance est impl�ment�e via Hibernate), une nouvelle - <literal>Session</literal> est ouverte et toutes les op�rations d'acc�s � la base de donn�es sont ex�cut�es � l'int�rieur de - celle-ci. Lorsque le travail est termin� (et que les r�ponses � envoyer au client ont �t� pr�par�es), la - session est flush�e et ferm�e. Une seule transaction � la base de donn�es peut �tre utilis�e pour r�pondre - � la requ�te du client. La transaction est d�marr�e et valid�e au m�me moment o� la Session est ouverte - et ferm�e. La relation entre la <literal>Session</literal> et la <literal>Transaction</literal> est donc one-to-one. - Ce mod�le permet de r�pondre parfaitement aux attentes de la grande majorit� des + (littéralement : Session par requête). Dans ce modèle, la requête d'un client est envoyée à un serveur + (Où la couche de persistance est implémentée via Hibernate), une nouvelle + <literal>Session</literal> est ouverte et toutes les opérations d'accès à la base de données sont exécutées à l'intérieur de + celle-ci. Lorsque le travail est terminé (et que les réponses à envoyer au client ont été préparées), la + session est flushée et fermée. Une seule transaction à la base de données peut être utilisée pour répondre + à la requête du client. La transaction est démarrée et validée au même moment où la Session est ouverte + et fermée. La relation entre la <literal>Session</literal> et la <literal>Transaction</literal> est donc one-to-one. + Ce modèle permet de répondre parfaitement aux attentes de la grande majorité des applications. </para> <para> - Le d�fi r�side dans l'impl�mentation. Hibernate fournit une fonction de gestion de + Le défi réside dans l'implémentation. Hibernate fournit une fonction de gestion de la "session courante" pour simplifier ce pattern. Tout ce que vous devez faire - est d�marrer une transaction lorsqu'une requ�te est trait�e par le serveur, et - la terminer avant que la r�ponse ne soit envoy�e au client. Vous pouvez le faire - de la mani�re que vous voulez, les solutions communes sont un <literal>ServletFilter</literal>, - l'interception via AOP avec une pointcut sur les m�thodes de type "service", ou un conteneur - avec interception/proxy. Un conteneur EJB est un moyen standard d'impl�menter ce genre d'acpect - tranverse comme la d�marcation des transactions sur les EJBs session, de mani�re d�clarative - avec CMT. Si vous d�cidez d'utiliser la d�marcation programmatique des transactions, pr�ferrez - l'API Hibernate <literal>Transaction</literal> d�taill�e plus tard dans ce chapitre, afin de - facilit� l'utilisation et la portabilit� du code. + est démarrer une transaction lorsqu'une requête est traitée par le serveur, et + la terminer avant que la réponse ne soit envoyée au client. Vous pouvez le faire + de la manière que vous voulez, les solutions communes sont un <literal>ServletFilter</literal>, + l'interception via AOP avec une pointcut sur les méthodes de type "service", ou un conteneur + avec interception/proxy. Un conteneur EJB est un moyen standard d'implémenter ce genre d'acpect + tranverse comme la démarcation des transactions sur les EJBs session, de manière déclarative + avec CMT. Si vous décidez d'utiliser la démarcation programmatique des transactions, préferrez + l'API Hibernate <literal>Transaction</literal> détaillée plus tard dans ce chapitre, afin de + facilité l'utilisation et la portabilité du code. </para> <para> - Votre application peut acc�der la "session courante" pour ex�cuter une requ�te - en invoquant simplement <literal>sessionFactory.getCurrentSession()</literal> n'importe o� - et autant de fois que souhait�. Vous obtiendrez toujours une <literal>Session</literal> - dont le scope est la transaction courante avec la base de donn�es. Ceci doit �tre configur� + Votre application peut accéder la "session courante" pour exécuter une requête + en invoquant simplement <literal>sessionFactory.getCurrentSession()</literal> n'importe où + et autant de fois que souhaité. Vous obtiendrez toujours une <literal>Session</literal> + dont le scope est la transaction courante avec la base de données. Ceci doit être configuré soit dans les ressources local ou dans l'environnement JTA, voir <xref linkend="architecture-current-session"/>. </para> <para> - Il est parfois utile d'�tendre le scope d'une <literal>Session</literal> et d'une transaction - � la base de donn�es jusqu'� ce que "la vue soit rendue". Ceci est particuli�rement - utile dans des applications � base de servlet qui utilisent une phase de rendue s�par�e une fois - que la r�ponse a �t� pr�par�e. Etendre la transaction avec la base de donn�es jusqu'� la fin du - rendering de la vue est ais� si vous impl�mentez votre propre intercepteur. Cependant, + Il est parfois utile d'étendre le scope d'une <literal>Session</literal> et d'une transaction + à la base de données jusqu'à ce que "la vue soit rendue". Ceci est particulièrement + utile dans des applications à base de servlet qui utilisent une phase de rendue séparée une fois + que la réponse a été préparée. Etendre la transaction avec la base de données jusqu'à la fin du + rendering de la vue est aisé si vous implémentez votre propre intercepteur. Cependant, ce n'est pas facile si vous vous appuyez sur les EJBs avec CMT, puisqu'une transaction sera - achev�e au retour de la m�thode EJB, avant le rendu de la vue. Rendez vous sur le site + achevée au retour de la méthode EJB, avant le rendu de la vue. Rendez vous sur le site Hibernate et sur le forum pour des astuces et des exemples sur le pattern <emphasis>Open Session in View</emphasis> pattern.. </para> @@ -134,113 +136,113 @@ <para>Le paradigme <emphasis>session-per-request</emphasis> - n'est pas le seul �l�ment � utiliser dans le design de vos unit�s de travail. Plusieurs processus - d'affaire requi�rent toute une s�rie d'interactions avec l'utilisateur, entrelac�es d'acc�s � la base de - donn�e. Dans une application Web ou une application d'entreprise, il serait inacceptable que la dur�e de - vie d'une transaction s'�tale sur plusieurs interactions avec l'usager. Consid�rez l'exemple suivant: + n'est pas le seul élément à utiliser dans le design de vos unités de travail. Plusieurs processus + d'affaire requièrent toute une série d'interactions avec l'utilisateur, entrelacées d'accès à la base de + donnée. Dans une application Web ou une application d'entreprise, il serait inacceptable que la durée de + vie d'une transaction s'étale sur plusieurs interactions avec l'usager. Considérez l'exemple suivant: </para> <itemizedlist> <listitem> - <para>Un �cran s'affiche. Les donn�es vues par l'usager ont �t� charg�es dans l'instance d'un objet - <literal>Session</literal> , dans le cadre d'une transaction de base de donn�es. L'usager est libre de modifier ces objets. + <para>Un écran s'affiche. Les données vues par l'usager ont été chargées dans l'instance d'un objet + <literal>Session</literal> , dans le cadre d'une transaction de base de données. L'usager est libre de modifier ces objets. </para> </listitem> <listitem> - <para>L'usager clique "Sauvegarder" apr�s 5 minutes et souhaite persister les modifications qu'il a - apport�es. Il s'attend � �tre la seule personne a avoir modifi� ces donn�es et qu'aucune + <para>L'usager clique "Sauvegarder" après 5 minutes et souhaite persister les modifications qu'il a + apportées. Il s'attend à être la seule personne a avoir modifié ces données et qu'aucune modification conflictuelle ne se soit produite durant ce laps de temps.</para> </listitem> </itemizedlist> - <para>Ceci s'appelle une unit� de travail. Du point de vue de l'utilisateur: une + <para>Ceci s'appelle une unité de travail. Du point de vue de l'utilisateur: une <emphasis>conversation</emphasis> (ou <emphasis>transaction d'application</emphasis>). - Il y a plusieurs fa�on de mettre ceci en place dans votre application. + Il y a plusieurs façon de mettre ceci en place dans votre application. </para> - <para>Une premi�re impl�mentation na�ve pourrait consister � garder la - <literal>Session</literal> et la transaction � la base de donn�es ouvertes durant le temps de travail de l'usager, � maintenir les - enregistrements verrouill�s dans la base de donn�es afin d'�viter des modifications concurrentes et de - maintenir l'isolation et l'atomicit� de la transaction de l'usager. Ceci est un anti-pattern � �viter, - puisque le verrouillage des enregistrements dans la base de donn�es ne permettrait pas � l'application - de g�rer un grand nombre d'usagers concurrents. + <para>Une première implémentation naïve pourrait consister à garder la + <literal>Session</literal> et la transaction à la base de données ouvertes durant le temps de travail de l'usager, à maintenir les + enregistrements verrouillés dans la base de données afin d'éviter des modifications concurrentes et de + maintenir l'isolation et l'atomicité de la transaction de l'usager. Ceci est un anti-pattern à éviter, + puisque le verrouillage des enregistrements dans la base de données ne permettrait pas à l'application + de gérer un grand nombre d'usagers concurrents. </para> - <para>Il appara�t donc �vident qu'il faille utiliser plusieurs transactions BDD afin d'impl�menter la + <para>Il apparaît donc évident qu'il faille utiliser plusieurs transactions BDD afin d'implémenter la conversation. Dans ce cas, maintenir l'isolation des processus d'affaire devient - partiellement la responsabilit� de la couche applicative. Ainsi, la dur�e de vie d'une conversation - devrait englober celle d'une ou de plusieurs transactions de base de donn�es. Celle-ci sera - atomique seulement si l'�criture des donn�es mises � jour est faite exclusivement par la derni�re + partiellement la responsabilité de la couche applicative. Ainsi, la durée de vie d'une conversation + devrait englober celle d'une ou de plusieurs transactions de base de données. Celle-ci sera + atomique seulement si l'écriture des données mises à jour est faite exclusivement par la dernière transaction BDD la composant. Toutes les autres sous transactions BD ne doivent faire que la lecture de - donn�es. Ceci est relativement facile � mettre en place, surtout avec l'utilisation de certaines - fonctionnalit�s d'Hibernate: + données. Ceci est relativement facile à mettre en place, surtout avec l'utilisation de certaines + fonctionnalités d'Hibernate: </para> <itemizedlist> <listitem> <para> <emphasis>Versionnage Automatique</emphasis> - - Hibernate peut g�rer automatiquement les acc�s concurrents de mani�re optimiste et d�tecter si - une modification concurrente s'est produite durant le temps de r�flexion d'un usager. + - Hibernate peut gérer automatiquement les accès concurrents de manière optimiste et détecter si + une modification concurrente s'est produite durant le temps de réflexion d'un usager. </para> </listitem> <listitem> <para> - <emphasis>Objets D�tach�s</emphasis> - - Si vous d�cidez d'utiliser le paradigme - <emphasis>session-par-requ�te</emphasis> - discut� plus haut, toutes les entit�s charg�es en m�moire deviendront des objets d�tach�s durant - le temps de r�flexion de l'usager. Hibernate vous permet de rattacher ces objets et de persister - les modifications y ayant �t� apport�es. Ce pattern est appel�: + <emphasis>Objets Détachés</emphasis> + - Si vous décidez d'utiliser le paradigme + <emphasis>session-par-requête</emphasis> + discuté plus haut, toutes les entités chargées en mémoire deviendront des objets détachés durant + le temps de réflexion de l'usager. Hibernate vous permet de rattacher ces objets et de persister + les modifications y ayant été apportées. Ce pattern est appelé: <emphasis>session-per- request-with-detached-objects</emphasis> - (litt�ralement: session- par-requ�te-avec-objets-d�tach�s). Le versionnage automatique est - utilis� afin d'isoler les modifications concurrentes. + (littéralement: session- par-requête-avec-objets-détachés). Le versionnage automatique est + utilisé afin d'isoler les modifications concurrentes. </para> </listitem> <listitem> <para> <emphasis>Session Longues (conversation)</emphasis> - Une - <literal>Session</literal> Hibernate peut �tre d�connect�e de la couche JDBC sous-jacente apr�s que commit() ait �t� appel� - sur une transaction � la base de donn�es et reconnect�e lors d'une nouvelle requ�te-client. Ce + <literal>Session</literal> Hibernate peut être déconnectée de la couche JDBC sous-jacente après que commit() ait été appelé + sur une transaction à la base de données et reconnectée lors d'une nouvelle requête-client. Ce pattern s'appelle: <emphasis>session-per-conversation</emphasis> - (Litt�ralement: session-par- conversation) et rend superflu le rattachement des - objets. Le versionnage automatique est utilis� afin d'isoler les modifications concurrentes. + (Littéralement: session-par- conversation) et rend superflu le rattachement des + objets. Le versionnage automatique est utilisé afin d'isoler les modifications concurrentes. </para> </listitem> </itemizedlist> <para>Les deux patterns <emphasis>session-per-request-with- detached- objects</emphasis> - (session-par-requ�te-avec-objets- d�tach�s) et + (session-par-requête-avec-objets- détachés) et <emphasis>session-per-conversation</emphasis> - (session-par-conversation) ont chacun leurs avantages et d�savantages qui seront expos�s - dans ce m�me chapitre, dans la section au sujet du contr�le optimiste de concurrence. + (session-par-conversation) ont chacun leurs avantages et désavantages qui seront exposés + dans ce même chapitre, dans la section au sujet du contrôle optimiste de concurrence. </para> </sect2> <sect2 id="transactions-basics-identity"> - <title>L'identit� des objets</title> + <title>L'identité des objets</title> - <para>Une application peut acc�der � la m�me entit� persistante de mani�re concurrente dans deux - <literal>Session</literal> s diff�rentes. Toutefois, une instance d'une classe persistante n'est jamais partag�e par deux instances + <para>Une application peut accéder à la même entité persistante de manière concurrente dans deux + <literal>Session</literal> s différentes. Toutefois, une instance d'une classe persistante n'est jamais partagée par deux instances distinctes de la classe - <literal>Session</literal> . Il existe donc deux notions de l'identit� d'un objet: + <literal>Session</literal> . Il existe donc deux notions de l'identité d'un objet: </para> <variablelist spacing="compact"> <varlistentry> - <term>Identit� BD</term> + <term>Identité BD</term> <listitem> <para> <literal>foo.getId().equals( bar.getId() )</literal> </para> </listitem> </varlistentry> <varlistentry> - <term>Identit� JVM</term> + <term>Identité JVM</term> <listitem> <para> <literal>foo==bar</literal> </para> @@ -248,101 +250,101 @@ </varlistentry> </variablelist> - <para>Ainsi, pour des objets attach�s � une - <literal>Session</literal> <emphasis>pr�cise</emphasis> - (dans la cadre d'ex�cution (scope) d'une instance de - <literal>Session</literal> ), ces deux notions d'identit� sont �quivalentes et garanties par Hibernate. Par contre, si une - application peut acc�der de mani�re concurrente � la m�me entit� persistante dans deux sessions - diff�rentes, les deux instances seront en fait diff�rentes (en ce qui a trait � l'identit� JVM). Les - conflits sont r�solus automatiquement par approche optimiste gr�ce au syst�me de versionnage automatique + <para>Ainsi, pour des objets attachés à une + <literal>Session</literal> <emphasis>précise</emphasis> + (dans la cadre d'exécution (scope) d'une instance de + <literal>Session</literal> ), ces deux notions d'identité sont équivalentes et garanties par Hibernate. Par contre, si une + application peut accéder de manière concurrente à la même entité persistante dans deux sessions + différentes, les deux instances seront en fait différentes (en ce qui a trait à l'identité JVM). Les + conflits sont résolus automatiquement par approche optimiste grâce au système de versionnage automatique lorsque <literal>Session.flush()</literal> ou - <literal>Transaction.commit()</literal> est appel�. + <literal>Transaction.commit()</literal> est appelé. </para> - <para>Cette approche permet de rel�guer � Hibernate et � la base de donn�es sous-jacente le soin de g�rer - les probl�mes d'acc�s concurrents. Cette mani�re de faire assure �galement une meilleure extensibilit� - de l'application puisque assurer l'identit� JVM dans un thread ne n�cessite pas de m�canismes de - verrouillage co�teux ou d'autres dispositifs de synchronisation. Une application n'aura jamais le besoin - de synchroniser des objets d'affaire tant qu'elle peut garantir qu'un seul thread aura acc�s � une + <para>Cette approche permet de reléguer à Hibernate et à la base de données sous-jacente le soin de gérer + les problèmes d'accès concurrents. Cette manière de faire assure également une meilleure extensibilité + de l'application puisque assurer l'identité JVM dans un thread ne nécessite pas de mécanismes de + verrouillage coûteux ou d'autres dispositifs de synchronisation. Une application n'aura jamais le besoin + de synchroniser des objets d'affaire tant qu'elle peut garantir qu'un seul thread aura accès à une instance de - <literal>Session</literal> . Dans le cadre d'ex�cution d'un objet - <literal>Session</literal> , l'application peut utiliser en toute s�curit� <literal>== + <literal>Session</literal> . Dans le cadre d'exécution d'un objet + <literal>Session</literal> , l'application peut utiliser en toute sécurité <literal>== </literal> pour comparer des objets. </para> <para> - Une application qui utiliserait <literal>==</literal> � l'ext�rieur du cadre d'ex�cution d'une <literal>Session</literal> - pourrait obtenir des r�sultats inattendus et causer certains effets de bords. Par exemple, si vous mettez 2 - objets dans le m�me <literal>Set</literal> , ceux-ci pourraient avoir la m�me identit� BD (i.e. ils repr�sentent le m�me enregistrement), mais leur - identit� JVM pourrait �tre diff�rente (elle ne peut, par d�finition, pas �tre garantie sur deux objets - d�tach�s). Le d�veloppeur doit donc red�finir l'impl�mentation des m�thodes <literal>equals()</literal> et <literal>hashcode()</literal> - dans les classes persistantes et y adjoindre sa propre notion d'identit�. Il existe toutefois une - restriction: Il ne faut jamais utiliser uniquement l'identifiant de la base de donn�es dans l'impl�mentation - de l'�galit�; Il faut utiliser une cl� d'affaire, g�n�ralement une combinaison de plusieurs attributs - uniques, si possible immuables. Les identifiants de base de donn�es vont changer si un objet transitoire + Une application qui utiliserait <literal>==</literal> à l'extérieur du cadre d'exécution d'une <literal>Session</literal> + pourrait obtenir des résultats inattendus et causer certains effets de bords. Par exemple, si vous mettez 2 + objets dans le même <literal>Set</literal> , ceux-ci pourraient avoir la même identité BD (i.e. ils représentent le même enregistrement), mais leur + identité JVM pourrait être différente (elle ne peut, par définition, pas être garantie sur deux objets + détachés). Le développeur doit donc redéfinir l'implémentation des méthodes <literal>equals()</literal> et <literal>hashcode()</literal> + dans les classes persistantes et y adjoindre sa propre notion d'identité. Il existe toutefois une + restriction: Il ne faut jamais utiliser uniquement l'identifiant de la base de données dans l'implémentation + de l'égalité; Il faut utiliser une clé d'affaire, généralement une combinaison de plusieurs attributs + uniques, si possible immuables. Les identifiants de base de données vont changer si un objet transitoire (transient) devient persistant. Si une instance transitoire est contenue dans un <literal>Set</literal> , - changer le hashcode brisera le contrat du <literal>Set</literal> . Les attributs pour les cl�s d'affaire - n'ont pas � �tre aussi stables que des cl�s primaires de bases de - donn�es. Il suffit simplement qu'elles soient stables tant et aussi longtemps que les objets sont dans le - m�me <literal>Set</literal> . Veuillez consulter le site web Hibernate pour des discussions plus pointues � ce sujet. Notez que ce - concept n'est pas propre � Hibernate mais bien g�n�ral � l'impl�mentation de l'identit� et de l'�galit� en + changer le hashcode brisera le contrat du <literal>Set</literal> . Les attributs pour les clés d'affaire + n'ont pas à être aussi stables que des clés primaires de bases de + données. Il suffit simplement qu'elles soient stables tant et aussi longtemps que les objets sont dans le + même <literal>Set</literal> . Veuillez consulter le site web Hibernate pour des discussions plus pointues à ce sujet. Notez que ce + concept n'est pas propre à Hibernate mais bien général à l'implémentation de l'identité et de l'égalité en Java. </para> </sect2> <sect2 id="transactions-basics-issues"> - <title>Probl�mes communs</title> + <title>Problèmes communs</title> - <para>Bien qu'il puisse y avoir quelques rares exceptions � cette r�gle, il est recommand� de ne jamais utiliser + <para>Bien qu'il puisse y avoir quelques rares exceptions à cette règle, il est recommandé de ne jamais utiliser les anti-patterns <emphasis>session-per- user-session</emphasis> et <emphasis>session-per-application</emphasis> - . Vous trouverez ici- bas quelques probl�mes que vous risquez de rencontrer si vous en faite l?utilisation. - (Ces probl�mes pourraient quand m�me survenir avec des patterns recommand�s) Assurez-vous de bien comprendre - les implications de chacun des patterns avant de prendre votre d�cision. + . Vous trouverez ici- bas quelques problèmes que vous risquez de rencontrer si vous en faite l?utilisation. + (Ces problèmes pourraient quand même survenir avec des patterns recommandés) Assurez-vous de bien comprendre + les implications de chacun des patterns avant de prendre votre décision. </para> <itemizedlist> <listitem> <para>L'objet - <literal>Session</literal> n?est pas con�u pour �tre utilis� par de multiples threads. En cons�quence, les objets - potentiellement multi-thread comme les requ�tes HTTP, les EJB Session et Swing Worker, risquent de + <literal>Session</literal> n?est pas conçu pour être utilisé par de multiples threads. En conséquence, les objets + potentiellement multi-thread comme les requêtes HTTP, les EJB Session et Swing Worker, risquent de provoquer des conditions de course dans la - <literal>Session</literal> si celle-ci est partag�e. Dans un environnement web classique, il serait pr�f�rable de synchroniser - les acc�s � la session http afin d?�viter qu?un usager ne recharge une page assez rapidement pour - que deux requ�tes s?ex�cutant dans des threads concurrents n?utilisent la m�me + <literal>Session</literal> si celle-ci est partagée. Dans un environnement web classique, il serait préférable de synchroniser + les accès à la session http afin d?éviter qu?un usager ne recharge une page assez rapidement pour + que deux requêtes s?exécutant dans des threads concurrents n?utilisent la même <literal>Session</literal> . </para> </listitem> <listitem> - <para>Lorsque Hibernate lance une exception, le roll back de la transaction en cours doit �tre effectu� + <para>Lorsque Hibernate lance une exception, le roll back de la transaction en cours doit être effectué et la - <literal>Session</literal> doit �tre imm�diatement ferm�e. (Ceci sera explor� plus tard dans le chapitre.) Si la - <literal>Session</literal> est directement associ�e � une application, il faut arr�ter l?application. Le roll back de la - transaction ne remettra pas les objets dans leur �tat du d�but de la transaction. Ainsi, ceux-ci - pourraient �tre d�synchronis�s d?avec les enregistrements. (G�n�ralement, cela ne cause pas de r�els - probl�mes puisque la plupart des exceptions sont non traitables et requi�rent la reprise du - processus d?affaire ayant �chou�.) + <literal>Session</literal> doit être immédiatement fermée. (Ceci sera exploré plus tard dans le chapitre.) Si la + <literal>Session</literal> est directement associée à une application, il faut arrêter l?application. Le roll back de la + transaction ne remettra pas les objets dans leur état du début de la transaction. Ainsi, ceux-ci + pourraient être désynchronisés d?avec les enregistrements. (Généralement, cela ne cause pas de réels + problèmes puisque la plupart des exceptions sont non traitables et requièrent la reprise du + processus d?affaire ayant échoué.) </para> </listitem> <listitem> <para>La - <literal>Session</literal> met en m�moire cache tous les objets persistants (les objets surveill�s et dont l'�tat est g�r� par + <literal>Session</literal> met en mémoire cache tous les objets persistants (les objets surveillés et dont l'état est géré par Hibernate.) Si la - <literal>Session</literal> est ouverte ind�finiment ou si une trop grande quantit� d'objets y est charg�e, l?utilisation de la - m�moire peut potentiellement cro�tre jusqu?� atteindre le maximum allouable � l?application - (java.lang.OutOfMemoryError.) Une solution � ce probl�me est d?appeler les m�thodes + <literal>Session</literal> est ouverte indéfiniment ou si une trop grande quantité d'objets y est chargée, l?utilisation de la + mémoire peut potentiellement croître jusqu?à atteindre le maximum allouable à l?application + (java.lang.OutOfMemoryError.) Une solution à ce problème est d?appeler les méthodes <literal>Session.clear()</literal> et - <literal>Session.evict()</literal> pour g�rer la m�moire cache de la - <literal>Session</literal> . Vous pouvez �galement utiliser des stored procedures si vous devez lancer des traitements sur de - grandes quantit�s d?informations. Certaines solutions sont d�crites ici : + <literal>Session.evict()</literal> pour gérer la mémoire cache de la + <literal>Session</literal> . Vous pouvez également utiliser des stored procedures si vous devez lancer des traitements sur de + grandes quantités d?informations. Certaines solutions sont décrites ici : <xref linkend="batch"/> . Garder une - <literal>Session</literal> ouverte pour toute la dur�e d?une session usager augmente �galement consid�rablement le risque de - travailler avec de l?information p�rim�e. + <literal>Session</literal> ouverte pour toute la durée d?une session usager augmente également considérablement le risque de + travailler avec de l?information périmée. </para> </listitem> </itemizedlist> @@ -351,42 +353,42 @@ </sect1> <sect1 id="transactions-demarcation"> - <title>D�marcation des transactions</title> + <title>Démarcation des transactions</title> - <para>La d�marcation des transactions est importante dans le design d?une application. Aucune communication avec la - base de donn�es ne peut �tre effectu�e � l?ext�rieur du cadre d?une transaction. (Il semble que ce concept soit - mal compris par plusieurs d�veloppeurs trop habitu�s � utiliser le mode auto-commit.) M�me si certains niveaux - d'isolation et certaines possibilit�s offertes par les bases de donn�es permettent de l?�viter, il n'est jamais - d�savantageux de toujours explicitement indiquer les bornes de transaction pour les op�rations complexes comme - pour les op�rations simples de lecture.</para> + <para>La démarcation des transactions est importante dans le design d?une application. Aucune communication avec la + base de données ne peut être effectuée à l?extérieur du cadre d?une transaction. (Il semble que ce concept soit + mal compris par plusieurs développeurs trop habitués à utiliser le mode auto-commit.) Même si certains niveaux + d'isolation et certaines possibilités offertes par les bases de données permettent de l?éviter, il n'est jamais + désavantageux de toujours explicitement indiquer les bornes de transaction pour les opérations complexes comme + pour les opérations simples de lecture.</para> - <para>Une application utilisant Hibernate peut s'ex�cuter dans un environnement l�ger n?offrant pas la gestion + <para>Une application utilisant Hibernate peut s'exécuter dans un environnement léger n?offrant pas la gestion automatique des transactions (application autonome, application web simple ou applications Swing) ou dans un environnement J2EE offrant des services de gestion automatique des transactions JTA. Dans un environnement - simple, Hibernate a g�n�ralement la responsabilit� de la gestion de son propre pool de connexions � la base de - donn�es. Le d�veloppeur de l'application doit manuellement d�limiter les transactions. En d'autres mots, il - appartient au d�veloppeur de g�rer les appels � + simple, Hibernate a généralement la responsabilité de la gestion de son propre pool de connexions à la base de + données. Le développeur de l'application doit manuellement délimiter les transactions. En d'autres mots, il + appartient au développeur de gérer les appels à <literal>Transaction.begin()</literal> , <literal>Transaction.commit()</literal> et <literal>Transaction.rollback()</literal> . Un environnement transactionnel J2EE (serveur d'application J2EE) doit offrir la gestion des transactions au - niveau du container J2EE. Les bornes de transaction peuvent normalement �tre d�finies de mani�re d�clarative - dans les descripteurs de d�ploiement d'EJB Session, par exemple. La gestion programmatique des transactions n'y - est donc pas n�cessaire. M�me les appels � + niveau du container J2EE. Les bornes de transaction peuvent normalement être définies de manière déclarative + dans les descripteurs de déploiement d'EJB Session, par exemple. La gestion programmatique des transactions n'y + est donc pas nécessaire. Même les appels à <literal>Session.flush()</literal> sont faits automatiquement. </para> - <para>Il peut �tre requis d'avoir une couche de persistance portable. Hibernate offre donc une API appel�e + <para>Il peut être requis d'avoir une couche de persistance portable. Hibernate offre donc une API appelée <literal>Transaction</literal> - qui sert d'enveloppe pour le syst�me de transaction natif de l'environnement de d�ploiement. Il n'est pas - obligatoire d'utiliser cette API mais il est fortement conseill� de le faire, sauf lors de l'utilisation de CMT - Session Bean (EJB avec transactions g�r�es automatiquement par le container EJB). + qui sert d'enveloppe pour le système de transaction natif de l'environnement de déploiement. Il n'est pas + obligatoire d'utiliser cette API mais il est fortement conseillé de le faire, sauf lors de l'utilisation de CMT + Session Bean (EJB avec transactions gérées automatiquement par le container EJB). </para> - <para>Il existe quatre �tapes disctinctes lors de la fermeture d'une + <para>Il existe quatre étapes disctinctes lors de la fermeture d'une <literal>Session</literal> </para> @@ -405,17 +407,17 @@ </listitem> </itemizedlist> - <para>La synchronisation de bdd depuis la session (flush) a d�j� �t� expliqu�, nous nous attarderons maintenant � la d�marcation des - transactions et � la gestion des exceptions dans les environnements l�gers et les environnements J2EE.</para> + <para>La synchronisation de bdd depuis la session (flush) a déjà été expliqué, nous nous attarderons maintenant à la démarcation des + transactions et à la gestion des exceptions dans les environnements légers et les environnements J2EE.</para> <sect2 id="transactions-demarcation-nonmanaged" revision="2"> - <title>Environnement non manag�</title> + <title>Environnement non managé</title> <para> - Si la couche de persistance Hibernate s'ex�cute dans un environnement non manag�, les connexions � la base de - donn�es seront g�n�ralement prises en charge par le m�canisme de pool d'Hibernate. La gestion de la session - et de la transaction se fera donc de la mani�re suivante:</para> + Si la couche de persistance Hibernate s'exécute dans un environnement non managé, les connexions à la base de + données seront généralement prises en charge par le mécanisme de pool d'Hibernate. La gestion de la session + et de la transaction se fera donc de la manière suivante:</para> <programlisting><![CDATA[// Non-managed environment idiom Session sess = factory.openSession(); @@ -437,16 +439,16 @@ }]]></programlisting> <para> - Vous n'avez pas � invoquer <literal>flush()</literal> explicitement sur la <literal>Session</literal> - - l'appel de <literal>commit()</literal> d�clenchera automatiquement la synchronisation (selon le <xref linkend="objectstate-flushing">FlushMode</xref> - de la session. Un appel � <literal>close()</literal> marque la fin de la session. - La cons�quence directe est que la connexion � la base de donn�es sera relach�e par la session. - Ce code est portable est fonctionne dans les environnements non manag� ET les environnements JTA. + Vous n'avez pas à invoquer <literal>flush()</literal> explicitement sur la <literal>Session</literal> - + l'appel de <literal>commit()</literal> déclenchera automatiquement la synchronisation (selon le <xref linkend="objectstate-flushing">FlushMode</xref> + de la session. Un appel à <literal>close()</literal> marque la fin de la session. + La conséquence directe est que la connexion à la base de données sera relachée par la session. + Ce code est portable est fonctionne dans les environnements non managé ET les environnements JTA. </para> <para> Une solution plus flexible est la gestion par contexte fourni par Hibernate que nous avons - d�j� rencontr�: + déjà rencontré: </para> <programlisting><![CDATA[// Non-managed environment idiom with getCurrentSession() @@ -465,18 +467,18 @@ <para> Vous ne verrez probablement jamais ces exemples de code dans les applications; - les exceptions fatales (exceptions du syst�me) ne devraient �tre trait�es que - dans la couche la plus "haute". En d'autres termes, le code qui ex�cute les appels - � Hibernate (� la couche de persistance) et le code qui g�re les - <literal>RuntimeException</literal> (qui ne peut g�n�ralement effectuer qu'un nettoyage et une sortie) - sont dans des couches diff�rentes. La gestion du contexte courant par Hibernate peut - simplifier notablement ce design, puisque vous devez acc�der � la gestion des exceptions - de la <literal>SessionFactory</literal>, ce qui est d�crit plus tard dans ce chapitre. + les exceptions fatales (exceptions du système) ne devraient être traitées que + dans la couche la plus "haute". En d'autres termes, le code qui exécute les appels + à Hibernate (à la couche de persistance) et le code qui gère les + <literal>RuntimeException</literal> (qui ne peut généralement effectuer qu'un nettoyage et une sortie) + sont dans des couches différentes. La gestion du contexte courant par Hibernate peut + simplifier notablement ce design, puisque vous devez accéder à la gestion des exceptions + de la <literal>SessionFactory</literal>, ce qui est décrit plus tard dans ce chapitre. </para> <para> - Notez que vous devriez s�lectionner <literal>org.hibernate.transaction.JDBCTransactionFactory</literal> - (le d�faut), pour le second exemple <literal>"thread"</literal> comme + Notez que vous devriez sélectionner <literal>org.hibernate.transaction.JDBCTransactionFactory</literal> + (le défaut), pour le second exemple <literal>"thread"</literal> comme <literal>hibernate.current_session_context_class</literal>. </para> @@ -485,13 +487,13 @@ <sect2 id="transactions-demarcation-jta" revision="2"> <title>Utilisation de JTA</title> - <para>Si votre couche de persistance s'ex�cute dans un serveur d'application (par exemple, derri�re un EJB - Session Bean), toutes les datasource utilis�es par Hibernate feront automatiquement partie de transactions - JTA globales. Hibernate propose deux strat�gies pour r�ussir cette int�gration.</para> + <para>Si votre couche de persistance s'exécute dans un serveur d'application (par exemple, derrière un EJB + Session Bean), toutes les datasource utilisées par Hibernate feront automatiquement partie de transactions + JTA globales. Hibernate propose deux stratégies pour réussir cette intégration.</para> <para> - Si vous utilisez des transactions g�r�es par un EJB (bean managed transactions - BMT), Hibernate informera - le serveur d'application du d�but et de la fin des transactions si vous utilisez l'API <literal>Transaction</literal> . + Si vous utilisez des transactions gérées par un EJB (bean managed transactions - BMT), Hibernate informera + le serveur d'application du début et de la fin des transactions si vous utilisez l'API <literal>Transaction</literal> . Ainsi, le code de gestion des transactions sera identique dans les deux types d'environnements. </para> @@ -531,8 +533,8 @@ }]]></programlisting> <para> - Avec CMT, la d�marcation des transactions est faite dans les descripteurs de d�ploiement des Beans Sessions et non - de mani�re programmmatique, ceci r�duit le code: + Avec CMT, la démarcation des transactions est faite dans les descripteurs de déploiement des Beans Sessions et non + de manière programmmatique, ceci réduit le code: </para> <programlisting><![CDATA[// CMT idiom @@ -543,31 +545,31 @@ ]]></programlisting> <para> - Dans un EJB CMT m�me le rollback intervient automatiquement, puisqu'une <literal>RuntimeException</literal> - non trait�e et soulev�e par une m�thode d'un bean session indique au conteneur d'annuler la transaction - globale. <emphasis>Ceci veut donc dire que vous n'avez pas � utiliser l'API <literal>Transaction</literal> d'Hibernate + Dans un EJB CMT même le rollback intervient automatiquement, puisqu'une <literal>RuntimeException</literal> + non traitée et soulevée par une méthode d'un bean session indique au conteneur d'annuler la transaction + globale. <emphasis>Ceci veut donc dire que vous n'avez pas à utiliser l'API <literal>Transaction</literal> d'Hibernate dans CMT.</emphasis> </para> <para> Notez que le fichier de configuration Hibernate devrait contenir les valeurs <literal>org.hibernate.transaction.JTATransactionFactory</literal> dans un environnement BMT ou - <literal>org.hibernate.transaction.CMTTransactionFactory</literal> dans un environnement CMT l� o� vous + <literal>org.hibernate.transaction.CMTTransactionFactory</literal> dans un environnement CMT là où vous configurez votre transaction factory Hibernate. - N'oubliez pas non plus de sp�cifier le param�tre <literal>org.hibernate.transaction.manager_lookup_class</literal> . - De plus, assurez vous de fixez votre <literal>hibernate.current_session_context_class</literal> soit � <literal>"jta"</literal> - ou de ne pas le configurer (compatibilit� avec les versions pr�c�dentes). + N'oubliez pas non plus de spécifier le paramètre <literal>org.hibernate.transaction.manager_lookup_class</literal> . + De plus, assurez vous de fixez votre <literal>hibernate.current_session_context_class</literal> soit à <literal>"jta"</literal> + ou de ne pas le configurer (compatibilité avec les versions précédentes). </para> <para> - La m�thode <literal>getCurrentSession()</literal> a un inconv�nient dans les environnement JTA. - Il y a une astuce qui est d'utiliser un mode de lib�ration de connexion <literal>after_statement</literal> , - qui est alors utilis� par d�faut. Du � une �trange limitation de la spec JTA, il n'est pas possible + La méthode <literal>getCurrentSession()</literal> a un inconvénient dans les environnement JTA. + Il y a une astuce qui est d'utiliser un mode de libération de connexion <literal>after_statement</literal> , + qui est alors utilisé par défaut. Du à une étrange limitation de la spec JTA, il n'est pas possible pour Hibernate de nettoyer et ferme automatiquement un <literal>ScrollableResults</literal> ouvert - ou une instance d'<literal>Iterator</literal> retourn�s <literal>scroll()</literal> ou - <literal>iterate()</literal>. Vous <emphasis>devez</emphasis> lib�rer le curseur base de donn�es + ou une instance d'<literal>Iterator</literal> retournés <literal>scroll()</literal> ou + <literal>iterate()</literal>. Vous <emphasis>devez</emphasis> libérer le curseur base de données sous jacent ou invoquer <literal>Hibernate.close(Iterator)</literal> explicitement depuis un - bloc <literal>finally</literal>. (Bien sur, la plupart des applications peuvent �viter + bloc <literal>finally</literal>. (Bien sur, la plupart des applications peuvent éviter d'uiliser <literal>scroll()</literal> ou <literal>iterate()</literal> dans un code CMT.) </para> @@ -578,33 +580,33 @@ <para> Si une <literal>Session</literal> lance une exception (incluant les exceptions du type <literal>SQLException</literal> - ou d'un sous-type), vous devez imm�diatement faire le rollback de la transaction, appeler <literal>Session.close()</literal> - et rel�cher les r�f�rences sur l'objet <literal>Session</literal> . La <literal>Session</literal> contient des m�thodes - pouvant la mettre dans un �tat inutilisable. Vous devez consid�rer qu'<emphasis>aucune</emphasis> - exception lanc�e par Hibernate n'est traitable. Assurez-vous de fermer la session en faisant l'appel � + ou d'un sous-type), vous devez immédiatement faire le rollback de la transaction, appeler <literal>Session.close()</literal> + et relâcher les références sur l'objet <literal>Session</literal> . La <literal>Session</literal> contient des méthodes + pouvant la mettre dans un état inutilisable. Vous devez considérer qu'<emphasis>aucune</emphasis> + exception lancée par Hibernate n'est traitable. Assurez-vous de fermer la session en faisant l'appel à <literal>close()</literal> dans un bloc <literal>finally</literal> . </para> <para> L'exception <literal>HibernateException</literal> , qui englobe la plupart des exceptions pouvant survenir dans la - couche de persistance Hibernate, est une exception non v�rifi�e (Ceci n'�tait pas le cas dans certaines versions ant�rieures de Hibernate.) Il est de - notre avis que nous ne devrions pas forcer un d�veloppeur � g�rer une exception qu'il ne peut de toute fa�on - pas traiter dans une couche technique. Dans la plupart des applications, les exceptions non v�rifi�es et les - exceptions fatales sont g�r�es en amont du processus (dans les couches hautes) et un message d'erreur est - alors affich� � l'usager (ou un traitement alternatif est invoqu�.) Veuillez noter qu'Hibernate peut - �galement lancer des exceptions non v�rifi�es d'un autre type que <literal>HibernateException</literal> . Celles-ci sont - �galement non traitables et vous devez les traiter comme telles. + couche de persistance Hibernate, est une exception non vérifiée (Ceci n'était pas le cas dans certaines versions antérieures de Hibernate.) Il est de + notre avis que nous ne devrions pas forcer un développeur à gérer une exception qu'il ne peut de toute façon + pas traiter dans une couche technique. Dans la plupart des applications, les exceptions non vérifiées et les + exceptions fatales sont gérées en amont du processus (dans les couches hautes) et un message d'erreur est + alors affiché à l'usager (ou un traitement alternatif est invoqué.) Veuillez noter qu'Hibernate peut + également lancer des exceptions non vérifiées d'un autre type que <literal>HibernateException</literal> . Celles-ci sont + également non traitables et vous devez les traiter comme telles. </para> <para> - Hibernate englobe les <literal>SQLException</literal> s lanc�es lors des interactions directes avec la base de donn�es + Hibernate englobe les <literal>SQLException</literal> s lancées lors des interactions directes avec la base de données dans des exceptions de type: <literal>JDBCException</literal> . En fait, Hibernate essaiera de convertir l'exception dans un sous-type plus significatif de <literal>JDBCException</literal> . L'exception <literal>SQLException</literal> sous-jacente - est toujours disponible via la m�thode <literal>JDBCException.getCause()</literal> . Cette conversion est faite par un objet - de type <literal>SQLExceptionConverter</literal> , qui est rattach� � l'objet <literal>SessionFactory</literal> . - Par d�faut, le <literal>SQLExceptionConverter</literal> est associ� au dialecte de BD configur� dans Hibernate. Toutefois, - il est possible de fournir sa propre impl�mentation de l'interface. (Veuillez vous r�f�rer � la javadoc sur la classe - <literal>SQLExceptionConverterFactory</literal> pour plus de d�tails. Les sous-types standard de <literal>JDBCException</literal> sont: + est toujours disponible via la méthode <literal>JDBCException.getCause()</literal> . Cette conversion est faite par un objet + de type <literal>SQLExceptionConverter</literal> , qui est rattaché à l'objet <literal>SessionFactory</literal> . + Par défaut, le <literal>SQLExceptionConverter</literal> est associé au dialecte de BD configuré dans Hibernate. Toutefois, + il est possible de fournir sa propre implémentation de l'interface. (Veuillez vous référer à la javadoc sur la classe + <literal>SQLExceptionConverterFactory</literal> pour plus de détails. Les sous-types standard de <literal>JDBCException</literal> sont: </para> <itemizedlist spacing="compact"> @@ -615,22 +617,22 @@ </listitem> <listitem> <para> - <literal>SQLGrammarException</literal> - Indique un probl�me de grammaire ou de syntaxe avec la requ�te SQL envoy�e. + <literal>SQLGrammarException</literal> - Indique un problème de grammaire ou de syntaxe avec la requête SQL envoyée. </para> </listitem> <listitem> <para> - <literal>ConstraintViolationException</literal> - Indique une violation de contrainte d'int�grit�. + <literal>ConstraintViolationException</literal> - Indique une violation de contrainte d'intégrité. </para> </listitem> <listitem> <para> - <literal>LockAcquisitionException</literal> - Indique une erreur de verrouillage lors de l'�x�cution de la requ�te. + <literal>LockAcquisitionException</literal> - Indique une erreur de verrouillage lors de l'éxécution de la requête. </para> </listitem> <listitem> <para> - <literal>GenericJDBCException</literal> - Indique une erreur g�n�rique JDBC d'une autre cat�gorie. + <literal>GenericJDBCException</literal> - Indique une erreur générique JDBC d'une autre catégorie. </para> </listitem> </itemizedlist> @@ -641,20 +643,20 @@ <title>Timeout de transaction</title> <para>L'un des avantages fournis par les environnements transactionnels JTA (tels les containers EJB) est la - gestion du timeout de transaction. La gestion des d�passements de temps de transaction vise � s'assurer - qu'une transaction agissant incorrectement ne viendra pas bloquer ind�finiment les ressources de - l'application. Hibernate ne peut fournir cette fonctionnalit� dans un environnement transactionnel non-JTA. - Par contre, Hibernate g�re les op�rations d'acc�s aux donn�es en allouant un temps maximal aux requ�tes pour - s'ex�cuter. Ainsi, une requ�te cr�ant de l'inter blocage ou retournant de tr�s grandes quantit�s - d'information pourrait �tre interrompue. Dans un environnement transactionnel JTA, Hibernate peut d�l�guer - au gestionnaire de transaction le soin de g�rer les d�passements de temps. Cette fonctionnalit� est + gestion du timeout de transaction. La gestion des dépassements de temps de transaction vise à s'assurer + qu'une transaction agissant incorrectement ne viendra pas bloquer indéfiniment les ressources de + l'application. Hibernate ne peut fournir cette fonctionnalité dans un environnement transactionnel non-JTA. + Par contre, Hibernate gère les opérations d'accès aux données en allouant un temps maximal aux requêtes pour + s'exécuter. Ainsi, une requête créant de l'inter blocage ou retournant de très grandes quantités + d'information pourrait être interrompue. Dans un environnement transactionnel JTA, Hibernate peut déléguer + au gestionnaire de transaction le soin de gérer les dépassements de temps. Cette fonctionnalité est abstraite par l'objet <literal>Transaction</literal> . </para> <programlisting><![CDATA[ Session sess = factory.openSession(); try { - //mettre le timeout � 3 secondes. + //mettre le timeout à 3 secondes. sess.getTransaction().setTimeout(3); sess.getTransaction().begin(); @@ -675,8 +677,8 @@ <para> - Notez que <literal>setTimeout()</literal> ne peut pas �tre appel� d'un EJB CMT, puisque le timeout - des transaction doit �tre sp�cifi� de mani�re d�clarative. + Notez que <literal>setTimeout()</literal> ne peut pas être appelé d'un EJB CMT, puisque le timeout + des transaction doit être spécifié de manière déclarative. </para> </sect2> @@ -684,34 +686,34 @@ </sect1> <sect1 id="transactions-optimistic"> - <title>Contr�le de consurrence optimiste</title> + <title>Contrôle de consurrence optimiste</title> - <para>La gestion optimiste des acc�s concurrents avec versionnage est la seule approche pouvant garantir - l'extensibilit� des applications � haut niveau de charge. Le syst�me de versionnage utilise des num�ros de - version ou l'horodatage pour d�tecter les mises � jour causant des conflits avec d'autres actualisations - ant�rieures. Hibernate propose trois approches pour l'�criture de code applicatif utilisant la gestion optimiste - d'acc�s concurrents. Le cas d'utilisation d�crit plus bas fait mention de conversation, - mais le versionnage peut �galement am�liorer la qualit� d'une application en pr�venant la perte de mises � + <para>La gestion optimiste des accès concurrents avec versionnage est la seule approche pouvant garantir + l'extensibilité des applications à haut niveau de charge. Le système de versionnage utilise des numéros de + version ou l'horodatage pour détecter les mises à jour causant des conflits avec d'autres actualisations + antérieures. Hibernate propose trois approches pour l'écriture de code applicatif utilisant la gestion optimiste + d'accès concurrents. Le cas d'utilisation décrit plus bas fait mention de conversation, + mais le versionnage peut également améliorer la qualité d'une application en prévenant la perte de mises à jour.</para> <sect2 id="transactions-optimistic-manual"> <title>Gestion du versionnage au niveau applicatif</title> - <para>Dans cet exemple d'impl�mentation utilisant peu les fonctionnalit�s d'Hibernate, chaque interaction avec - la base de donn�es se fait en utilisant une nouvelle <literal>Session</literal> et le d�veloppeur doit recharger - les donn�es persistantes � partir de la BD avant de les manipuler. Cette - impl�mentation force l'application � v�rifier la version des objets afin de maintenir l'isolation - transactionnelle. Cette approche, semblable � celle retrouv�e pour les EJB, est la moins efficace de celles - pr�sent�es dans ce chapitre. + <para>Dans cet exemple d'implémentation utilisant peu les fonctionnalités d'Hibernate, chaque interaction avec + la base de données se fait en utilisant une nouvelle <literal>Session</literal> et le développeur doit recharger + les données persistantes à partir de la BD avant de les manipuler. Cette + implémentation force l'application à vérifier la version des objets afin de maintenir l'isolation + transactionnelle. Cette approche, semblable à celle retrouvée pour les EJB, est la moins efficace de celles + présentées dans ce chapitre. </para> <programlisting> - <![CDATA[// foo est une instance charg�e ant�rieurement par une autre + <![CDATA[// foo est une instance chargée antérieurement par une autre Session session = factory.openSession(); Transaction t = session.beginTransaction(); int oldVersion = foo.getVersion(); - session.load( foo, foo.getKey() ); // Charger l'�tat courant + session.load( foo, foo.getKey() ); // Charger l'état courant if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException(); @@ -720,26 +722,26 @@ t.commit(); session.close();]]></programlisting> - <para>Le mapping de la propri�t� <literal>version</literal> est fait via <literal>&lt;version&gt;</literal> et - Hibernate l'incr�mentera automatiquement � chaque flush() si l'entit� doit �tre mise � jour. + <para>Le mapping de la propriété <literal>version</literal> est fait via <literal>&lt;version&gt;</literal> et + Hibernate l'incrémentera automatiquement à chaque flush() si l'entité doit être mise à jour. </para> - <para>Bien s�r, si votre application ne fait pas face � beaucoup d'acc�s concurrents et ne n�cessite pas - l'utilisation du versionnage, cette approche peut �galement �tre utilis�e, il n'y a qu'� ignorer le code - reli� au versionnage. Dans ce cas, la strat�gie du + <para>Bien sûr, si votre application ne fait pas face à beaucoup d'accès concurrents et ne nécessite pas + l'utilisation du versionnage, cette approche peut également être utilisée, il n'y a qu'à ignorer le code + relié au versionnage. Dans ce cas, la stratégie du <emphasis>last commit wins</emphasis> - (litt�ralement: le dernier commit l'emporte) sera utilis�e pour les conversations (longues transactions applicatives). - Gardez � l'esprit que cette approche pourrait rendre perplexe les utilisateurs de l'application car ils - pourraient perdre des donn�es mises � jour sans qu'aucun message d'erreur ne leur soit pr�sent� et sans - avoir la possibilit� de fusionner les donn�es. + (littéralement: le dernier commit l'emporte) sera utilisée pour les conversations (longues transactions applicatives). + Gardez à l'esprit que cette approche pourrait rendre perplexe les utilisateurs de l'application car ils + pourraient perdre des données mises à jour sans qu'aucun message d'erreur ne leur soit présenté et sans + avoir la possibilité de fusionner les données. </para> - <para>Il est clair que la gestion manuelle de la v�rification du versionnage des objets ne peut �tre effectu�e + <para>Il est clair que la gestion manuelle de la vérification du versionnage des objets ne peut être effectuée que dans certains cas triviaux et que cette approche n'est pas valable pour la plupart des applications. De - mani�re g�n�rale, les applications ne cherchent pas � actualiser de simples objets sans relations, elles le - font g�n�ralement pour de larges graphes d'objets. Pour toute application utilisant le paradigme des conversations - ou des objets d�tach�s, Hibernate peut g�rer automatiquement la v�rification des versions + manière générale, les applications ne cherchent pas à actualiser de simples objets sans relations, elles le + font généralement pour de larges graphes d'objets. Pour toute application utilisant le paradigme des conversations + ou des objets détachés, Hibernate peut gérer automatiquement la vérification des versions d'objets.</para> </sect2> @@ -747,87 +749,87 @@ <sect2 id="transactions-optimistic-longsession"> <title>Les sessions longues et le versionnage automatique.</title> - <para>Dans ce sc�nario, une seule instance de <literal>Session</literal> et des objets persistants est utilis�e - pour toute l'application. Hibernate v�rifie la version des objets + <para>Dans ce scénario, une seule instance de <literal>Session</literal> et des objets persistants est utilisée + pour toute l'application. Hibernate vérifie la version des objets persistants avant d'effectuer le flush() et lance une exception si une modification concurrente est - d�tect�e. Il appartient alors au d�veloppeur de g�rer l'exception. Les traitements alternatifs g�n�ralement - propos�s sont alors de permettre � l'usager de faire la fusion des donn�es ou de lui offrir de recommencer - son travail � partie des donn�es les plus r�centes dans la BD. + détectée. Il appartient alors au développeur de gérer l'exception. Les traitements alternatifs généralement + proposés sont alors de permettre à l'usager de faire la fusion des données ou de lui offrir de recommencer + son travail à partie des données les plus récentes dans la BD. </para> - <para>Il est � noter que lorsqu'une application est en attente d'une action de la part de l?usager, La <literal>Session</literal> - n'est pas connect�e � la couche JDBC sous-jacente. C'est la mani�re la plus efficace de g�rer les acc�s � la - base de donn�es. L'application ne devrait pas se pr�occuper du versionnage des objets, de la r�association - des objets d�tach�s, ni du rechargement de tous les objets � chaque transaction. + <para>Il est à noter que lorsqu'une application est en attente d'une action de la part de l?usager, La <literal>Session</literal> + n'est pas connectée à la couche JDBC sous-jacente. C'est la manière la plus efficace de gérer les accès à la + base de données. L'application ne devrait pas se préoccuper du versionnage des objets, de la réassociation + des objets détachés, ni du rechargement de tous les objets à chaque transaction. </para> <programlisting> - <![CDATA[// foo est une instance charg�e ant�rieurement par une autre session + <![CDATA[// foo est une instance chargée antérieurement par une autre session session.reconnect();// Obtention d'une nouvelle connexion JDBC Transaction t = session.beginTransaction(); foo.setProperty("bar"); - t.commit(); //Terminer la transaction, propager les changements et v�rifier les versions. + t.commit(); //Terminer la transaction, propager les changements et vérifier les versions. session.disconnect(); // Retourner la connexion JDBC ]]></programlisting> - <para>L'objet <literal>foo</literal> sait quel objet <literal>Session</literal> l'a charg�. <literal>Session.reconnect()</literal> - obtient une nouvelle connexion (celle-ci peut �tre �galement fournie) et permet � la session de continuer - son travail. La m�thode <literal>Session.disconnect()</literal> d�connecte la session de la connexion JDBC et - retourne celle-ci au pool de connexion (� moins que vous ne - lui ayez fourni vous m�me la connexion.) Apr�s la reconnexion, afin de forcer la v�rification du versionnage - de certaines entit�s que vous ne cherchez pas � actualiser, vous pouvez faire un appel � <literal>Session.lock()</literal> - en mode <literal>LockMode.READ</literal> pour tout objet ayant pu �tre modifi� par une autre transaction. Il n'est pas n�cessaire de verrouiller les - donn�es que vous d�sirez mettre � jour. + <para>L'objet <literal>foo</literal> sait quel objet <literal>Session</literal> l'a chargé. <literal>Session.reconnect()</literal> + obtient une nouvelle connexion (celle-ci peut être également fournie) et permet à la session de continuer + son travail. La méthode <literal>Session.disconnect()</literal> déconnecte la session de la connexion JDBC et + retourne celle-ci au pool de connexion (à moins que vous ne + lui ayez fourni vous même la connexion.) Après la reconnexion, afin de forcer la vérification du versionnage + de certaines entités que vous ne cherchez pas à actualiser, vous pouvez faire un appel à <literal>Session.lock()</literal> + en mode <literal>LockMode.READ</literal> pour tout objet ayant pu être modifié par une autre transaction. Il n'est pas nécessaire de verrouiller les + données que vous désirez mettre à jour. </para> - <para>Si des appels implicites aux m�thodes <literal>disconnect()</literal> et <literal>reconnect()</literal> sont trop - co�teux, vous pouvez les �viter en utilisant <literal>hibernate.connection.release_mode</literal> . + <para>Si des appels implicites aux méthodes <literal>disconnect()</literal> et <literal>reconnect()</literal> sont trop + coûteux, vous pouvez les éviter en utilisant <literal>hibernate.connection.release_mode</literal> . </para> - <para>Ce pattern peut pr�senter des probl�mes si la <literal>Session</literal> est trop volumineuse pour �tre - stock�e entre les actions de l'usager. Plus sp�cifiquement, une session <literal>HttpSession</literal> se doit - d'�tre la plus petite possible. Puisque la <literal>Session</literal> joue obligatoirement le r�le de m�moire - cache de premier niveau et contient � ce titre tous les objets - charg�s, il est pr�f�rable de n'utiliser cette strat�gie que pour quelques cycles de requ�tes car les objets - risquent d'y �tre rapidement p�rim�s. + <para>Ce pattern peut présenter des problèmes si la <literal>Session</literal> est trop volumineuse pour être + stockée entre les actions de l'usager. Plus spécifiquement, une session <literal>HttpSession</literal> se doit + d'être la plus petite possible. Puisque la <literal>Session</literal> joue obligatoirement le rôle de mémoire + cache de premier niveau et contient à ce titre tous les objets + chargés, il est préférable de n'utiliser cette stratégie que pour quelques cycles de requêtes car les objets + risquent d'y être rapidement périmés. </para> - <para>Notez que la <literal>Session</literal> d�connect�e devrait �tre conserv�e pr�s de la couche de persistance. Autrement dit, utilisez un EJB stateful - pour conserver la <literal>Session</literal> et �vitez de la s�rialiser et de la transf�rer � la couche de pr�sentation (i.e. Il est pr�f�rable de ne pas + <para>Notez que la <literal>Session</literal> déconnectée devrait être conservée près de la couche de persistance. Autrement dit, utilisez un EJB stateful + pour conserver la <literal>Session</literal> et évitez de la sérialiser et de la transférer à la couche de présentation (i.e. Il est préférable de ne pas la conserver dans la session <literal>HttpSession</literal> .) </para> </sect2> <sect2 id="transactions-optimistic-detached"> - <title>Les objets d�tach�s et le versionnage automatique</title> + <title>Les objets détachés et le versionnage automatique</title> - <para>Chaque interaction avec le syst�me de persistance se fait via une nouvelle <literal>Session</literal> . - Toutefois, les m�mes instances d'objets persistants sont r�utilis�es pour chacune de ces interactions. - L'application doit pouvoir manipuler l'�tat des instances d�tach�es ayant �t� charg�es ant�rieurement via - une autre session. Pour ce faire, ces objets persistants doivent �tre rattach�s � la <literal>Session</literal> + <para>Chaque interaction avec le système de persistance se fait via une nouvelle <literal>Session</literal> . + Toutefois, les mêmes instances d'objets persistants sont réutilisées pour chacune de ces interactions. + L'application doit pouvoir manipuler l'état des instances détachées ayant été chargées antérieurement via + une autre session. Pour ce faire, ces objets persistants doivent être rattachés à la <literal>Session</literal> courante en utilisant <literal>Session.update()</literal> , <literal>Session.saveOrUpdate()</literal> , ou <literal>Session.merge()</literal> . </para> <programlisting> - <![CDATA[// foo est une instance charg�e ant�rieurement par une autre session + <![CDATA[// foo est une instance chargée antérieurement par une autre session foo.setProperty("bar"); session = factory.openSession(); Transaction t = session.beginTransaction(); - session.saveOrUpdate(foo); //Utiliser merge() si "foo" pourrait avoir �t� charg� pr�c�dement + session.saveOrUpdate(foo); //Utiliser merge() si "foo" pourrait avoir été chargé précédement t.commit(); session.close();]]> </programlisting> - <para>Encore une fois, Hibernate v�rifiera la version des instances devant �tre actualis�es durant le flush(). - Une exception sera lanc�e si des conflits sont d�tect�s.</para> + <para>Encore une fois, Hibernate vérifiera la version des instances devant être actualisées durant le flush(). + Une exception sera lancée si des conflits sont détectés.</para> - <para>Vous pouvez �galement utiliser <literal>lock()</literal> au lieu de <literal>update()</literal> et - utiliser le mode <literal>LockMode.READ</literal> (qui lancera une v�rification de version, en ignorant tous les niveaux de m�moire cache) si vous �tes - certain que l'objet n'a pas �t� modifi�. + <para>Vous pouvez également utiliser <literal>lock()</literal> au lieu de <literal>update()</literal> et + utiliser le mode <literal>LockMode.READ</literal> (qui lancera une vérification de version, en ignorant tous les niveaux de mémoire cache) si vous êtes + certain que l'objet n'a pas été modifié. </para> </sect2> @@ -835,40 +837,40 @@ <sect2 id="transactions-optimistic-customizing"> <title>Personnaliser le versionnage automatique</title> - <para>Vous pouvez d�sactiver l'incr�mentation automatique du num�ro de version de certains attributs et - collections en mettant la valeur du param�tre de mapping <literal>optimistic-lock</literal> � - false. Hibernate cessera ainsi d'incr�menter leur num�ro de version s'ils sont mis � jour. + <para>Vous pouvez désactiver l'incrémentation automatique du numéro de version de certains attributs et + collections en mettant la valeur du paramètre de mapping <literal>optimistic-lock</literal> à + false. Hibernate cessera ainsi d'incrémenter leur numéro de version s'ils sont mis à jour. </para> - <para>Certaines entreprises poss�dent de vieux syst�mes dont les sch�mas de bases de donn�es sont statiques et - ne peuvent �tre modifi�s. Il existe aussi des cas o� plusieurs applications doivent acc�der � la m�me base - de donn�es, mais certaines d'entre elles ne peuvent g�rer les num�ros de version ou les champs horodat�s. - Dans les deux cas, le versionnage ne peut �tre implant� par le rajout d'une colonne dans la base de donn�es. - Afin de forcer la v�rification de version dans un syst�me sans en faire le mapping, mais en for�ant une - comparaison des �tats de tous les attributs d'une entit�, vous pouvez utiliser l'attribut <literal>optimistic- lock="all"</literal> - sous l'�l�ment <literal>&lt;class&gt;</literal> . Veuillez noter que cette mani�re de g�rer le versionnage ne peut �tre utilis�e que si l'application - utilises de longues sessions, lui permettant de comparer l'ancien �tat et le nouvel �tat d'une entit�. + <para>Certaines entreprises possèdent de vieux systèmes dont les schémas de bases de données sont statiques et + ne peuvent être modifiés. Il existe aussi des cas où plusieurs applications doivent accéder à la même base + de données, mais certaines d'entre elles ne peuvent gérer les numéros de version ou les champs horodatés. + Dans les deux cas, le versionnage ne peut être implanté par le rajout d'une colonne dans la base de données. + Afin de forcer la vérification de version dans un système sans en faire le mapping, mais en forçant une + comparaison des états de tous les attributs d'une entité, vous pouvez utiliser l'attribut <literal>optimistic- lock="all"</literal> + sous l'élément <literal>&lt;class&gt;</literal> . Veuillez noter que cette manière de gérer le versionnage ne peut être utilisée que si l'application + utilises de longues sessions, lui permettant de comparer l'ancien état et le nouvel état d'une entité. L'utilisation d'un pattern <literal>session-per-request-with-detached- objects</literal> devient alors impossible. </para> - <para>Il peut �tre souhaitable de permettre les modifications concurrentes lorsque des champs distincts sont - modifi�s. En mettant la propri�t� <literal>optimistic-lock="dirty"</literal> dans l'�l�ment <literal>&lt;class&gt;</literal> , - Hibernate ne fera la comparaison que des champs devant �tre actualis�s lors du flush(). + <para>Il peut être souhaitable de permettre les modifications concurrentes lorsque des champs distincts sont + modifiés. En mettant la propriété <literal>optimistic-lock="dirty"</literal> dans l'élément <literal>&lt;class&gt;</literal> , + Hibernate ne fera la comparaison que des champs devant être actualisés lors du flush(). </para> - <para>Dans les deux cas: en utilisant une colonne de version/horodat�e ou via la comparaison de l'�tat complet - de l'objet ou de ses champs modifi�s, Hibernate ne cr�era qu'une seule commande d'UPDATE par entit� avec la - clause WHERE appropri�e pour mettre � jour l'entit� + <para>Dans les deux cas: en utilisant une colonne de version/horodatée ou via la comparaison de l'état complet + de l'objet ou de ses champs modifiés, Hibernate ne créera qu'une seule commande d'UPDATE par entité avec la + clause WHERE appropriée pour mettre à jour l'entité <emphasis>ET</emphasis> - en v�rifier la version. Si vous utilisez la persistance transitive pour propager l'�v�nement de rattachement - � des entit�s associ�es, il est possible qu'Hibernate g�n�re des commandes d'UPDATE inutiles. Ceci n'est - g�n�ralement pas un probl�me, mais certains d�clencheurs + en vérifier la version. Si vous utilisez la persistance transitive pour propager l'évènement de rattachement + à des entités associées, il est possible qu'Hibernate génère des commandes d'UPDATE inutiles. Ceci n'est + généralement pas un problème, mais certains déclencheurs <emphasis>on update</emphasis> - dans la base de donn�es pourraient �tre activ�s m�me si aucun changement n'�tait r�ellement persist� sur des - objets associ�s. Vous pouvez personnaliser ce comportement en indiquant <literal>select-before- update="true"</literal> - dans l'�l�ment de mapping <literal>&lt;class&gt;</literal> . Ceci forcera Hibernate � faire le SELECT de l'instance - afin de s'assurer que l'entit� doit r�ellement �tre - actualis�e avant de lancer la commande d'UPDATE. + dans la base de données pourraient être activés même si aucun changement n'était réellement persisté sur des + objets associés. Vous pouvez personnaliser ce comportement en indiquant <literal>select-before- update="true"</literal> + dans l'élément de mapping <literal>&lt;class&gt;</literal> . Ceci forcera Hibernate à faire le SELECT de l'instance + afin de s'assurer que l'entité doit réellement être + actualisée avant de lancer la commande d'UPDATE. </para> </sect2> @@ -878,19 +880,19 @@ <sect1 id="transactions-locking"> <title>Verouillage pessimiste</title> - <para>Il n'est n�cessaire de s'attarder � la strat�gie de verrouillage des entit�s dans une application utilisant - Hibernate. Il est g�n�ralement suffisant de d�finir le niveau d'isolation pour les connexions JDBC et de laisser - ensuite la base de donn�e effectuer son travail. Toutefois, certains utilisateurs avanc�s peuvent vouloir - obtenir un verrouillage pessimiste exclusif sur un enregistrement et le r�obtenir au lancement d'une nouvelle + <para>Il n'est nécessaire de s'attarder à la stratégie de verrouillage des entités dans une application utilisant + Hibernate. Il est généralement suffisant de définir le niveau d'isolation pour les connexions JDBC et de laisser + ensuite la base de donnée effectuer son travail. Toutefois, certains utilisateurs avancés peuvent vouloir + obtenir un verrouillage pessimiste exclusif sur un enregistrement et le réobtenir au lancement d'une nouvelle transaction.</para> - <para>Hibernate utilisera toujours le m�canisme de verrouillage de la base de donn�es et ne verrouillera jamais les - objets en m�moire!</para> + <para>Hibernate utilisera toujours le mécanisme de verrouillage de la base de données et ne verrouillera jamais les + objets en mémoire!</para> <para>La classe <literal>LockMode</literal> - d�finit les diff�rents niveaux de verrouillage pouvant �tre obtenus par Hibernate. Le verrouillage est obtenu - par les m�canismes suivants: + définit les différents niveaux de verrouillage pouvant être obtenus par Hibernate. Le verrouillage est obtenu + par les mécanismes suivants: </para> <itemizedlist spacing="compact"> @@ -901,48 +903,48 @@ </listitem> <listitem> <para> - <literal>LockMode.UPGRADE</literal> peut �tre obtenu de mani�re explicite via la requ�te en utilisant - <literal>SELECT ... FOR UPDATE</literal> sur une base de donn�es supportant cette syntaxe. + <literal>LockMode.UPGRADE</literal> peut être obtenu de manière explicite via la requête en utilisant + <literal>SELECT ... FOR UPDATE</literal> sur une base de données supportant cette syntaxe. </para> </listitem> <listitem> <para> - <literal>LockMode.UPGRADE_NOWAIT</literal> peut �tre obtenu de mani�re explicite en utilisant + <literal>LockMode.UPGRADE_NOWAIT</literal> peut être obtenu de manière explicite en utilisant <literal>SELECT ... FOR UPDATE NOWAIT</literal> sur Oracle. </para> </listitem> <listitem> <para> - <literal>LockMode.READ</literal> est obtenu automatiquement quand Hibernate lit des donn�es dans un contexte d'isolation + <literal>LockMode.READ</literal> est obtenu automatiquement quand Hibernate lit des données dans un contexte d'isolation <literal>Repeatable Read</literal> ou - <literal>Serializable</literal> . Peut �tre r�obtenu explicitement via une requ�te. + <literal>Serializable</literal> . Peut être réobtenu explicitement via une requête. </para> </listitem> <listitem> <para> - <literal>LockMode.NONE</literal> repr�sente l'absence de verouillage. Tous les objets migrent vers ce mode a la fin d'une - <literal>Transaction</literal> . Les objets associ�s � une session via un appel � - <literal>saveOrUpdate()</literal> commencent �galement leur cycle de vie dans cet �tat. + <literal>LockMode.NONE</literal> représente l'absence de verouillage. Tous les objets migrent vers ce mode a la fin d'une + <literal>Transaction</literal> . Les objets associés à une session via un appel à + <literal>saveOrUpdate()</literal> commencent également leur cycle de vie dans cet état. </para> </listitem> </itemizedlist> - <para>Les niveaux de verrouillage peuvent �tre explicitement obtenus de l'une des mani�res suivantes:</para> + <para>Les niveaux de verrouillage peuvent être explicitement obtenus de l'une des manières suivantes:</para> <itemizedlist spacing="compact"> <listitem> - <para>Un appel � - <literal>Session.load()</literal> , en sp�cifiant un niveau verrouillage + <para>Un appel à + <literal>Session.load()</literal> , en spécifiant un niveau verrouillage <literal>LockMode</literal> . </para> </listitem> <listitem> - <para>Un appel � + <para>Un appel à <literal>Session.lock()</literal> . </para> </listitem> <listitem> - <para>Une appel � + <para>Une appel à <literal>Query.setLockMode()</literal> . </para> </listitem> @@ -950,23 +952,23 @@ <para>Si <literal>Session.load()</literal> - est appel� avec le param�tre de niveau de verouillage + est appelé avec le paramètre de niveau de verouillage <literal>UPGRADE</literal> ou <literal>UPGRADE_NOWAIT</literal> - et que l'objet demand� n'est pas pr�sent dans la session, celui-ci sera charg� � l'aide d'une requ�te + et que l'objet demandé n'est pas présent dans la session, celui-ci sera chargé à l'aide d'une requête <literal>SELECT ... FOR UPDATE</literal> - . Si la m�thode + . Si la méthode <literal>load()</literal> - est appel�e pour un objet d�j� en session avec un verrouillage moindre que celui demand�, Hibernate appellera la - m�thode + est appelée pour un objet déjà en session avec un verrouillage moindre que celui demandé, Hibernate appellera la + méthode <literal>lock()</literal> pour cet objet. </para> <para> <literal>Session.lock()</literal> - effectue une v�rification de version si le niveau de verrouillage est + effectue une vérification de version si le niveau de verrouillage est <literal>READ</literal> , <literal>UPGRADE</literal> @@ -976,94 +978,94 @@ <literal>UPGRADE</literal> ou <literal>UPGRADE_NOWAIT</literal> - , une requ�te + , une requête <literal>SELECT ... FOR UPDATE</literal> - sera utilis�e.) + sera utilisée.) </para> - <para>Si une base de donn�es ne supporte pas le niveau de verrouillage demand�, Hibernate utilisera un niveau - alternatif convenable au lieux de lancer une exception. Ceci assurera la portabilit� de votre + <para>Si une base de données ne supporte pas le niveau de verrouillage demandé, Hibernate utilisera un niveau + alternatif convenable au lieux de lancer une exception. Ceci assurera la portabilité de votre application.</para> </sect1> <sect1 id="transactions-connection-release"> - <title>Mode de lib�ration de Connection</title> + <title>Mode de libération de Connection</title> <para> Le comportement original (2.x) d'Hibernate pour la gestion des connexions JDBC - �tait que la <literal>Session</literal> obtenait une connexion d�s qu'elle en avait - besoin et la lib�rait une fois la session ferm�e. - Hibernate 3 a introduit les modes de lib�ration de connexion pour indiquer � la session - comment g�rer les transactions JDBC. Notez que la discussion suivante n'est pertinente - que pour des connexions fournies par un <literal>ConnectionProvider</literal>, celles g�r�es - par l'utilisateur sont en dehors du scope de cette discussion. Les diff�rents modes - sont d�finies par <literal>org.hibernate.ConnectionReleaseMode</literal>: + était que la <literal>Session</literal> obtenait une connexion dès qu'elle en avait + besoin et la libérait une fois la session fermée. + Hibernate 3 a introduit les modes de libération de connexion pour indiquer à la session + comment gérer les transactions JDBC. Notez que la discussion suivante n'est pertinente + que pour des connexions fournies par un <literal>ConnectionProvider</literal>, celles gérées + par l'utilisateur sont en dehors du scope de cette discussion. Les différents modes + sont définies par <literal>org.hibernate.ConnectionReleaseMode</literal>: </para> <itemizedlist spacing="compact"> <listitem> <para> - <literal>ON_CLOSE</literal> - est essentiellement le comportement pass�. + <literal>ON_CLOSE</literal> - est essentiellement le comportement passé. La session Hibernate obtient une connexion lorsqu'elle en a besoin et la garde - jusqu'� ce que la session se ferme. + jusqu'à ce que la session se ferme. </para> </listitem> <listitem> <para> - <literal>AFTER_TRANSACTION</literal> - indique de relacher la connexion apr�s qu'une - <literal>org.hibernate.Transaction</literal> se soit achev�e. + <literal>AFTER_TRANSACTION</literal> - indique de relacher la connexion après qu'une + <literal>org.hibernate.Transaction</literal> se soit achevée. </para> </listitem> <listitem> <para> - <literal>AFTER_STATEMENT</literal> (aussi appel� lib�ration brutale) - indique de relacher - les connexions apr�s chaque ex�cution d'un statement. Ce relachement aggressif est annul� - si ce statement laisse des ressources associ�es � une session donn�e ouvertes, actuellement + <literal>AFTER_STATEMENT</literal> (aussi appelé libération brutale) - indique de relacher + les connexions après chaque exécution d'un statement. Ce relachement aggressif est annulé + si ce statement laisse des ressources associées à une session donnée ouvertes, actuellement ceci n'arrive que lors de l'utilisation de <literal>org.hibernate.ScrollableResults</literal>. </para> </listitem> </itemizedlist> <para> - Le param�tre de configuration <literal>hibernate.connection.release_mode</literal> est utilis� - pour sp�cifier quel mode de lib�ration doit �tre utiliser. Les valeurs possibles sont: + Le paramètre de configuration <literal>hibernate.connection.release_mode</literal> est utilisé + pour spécifier quel mode de libération doit être utiliser. Les valeurs possibles sont: </para> <itemizedlist spacing="compact"> <listitem> <para> - <literal>auto</literal> (valeur par d�faut) - ce choix d�l�gue le choix de lib�ration - � la m�thode <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal> + <literal>auto</literal> (valeur par défaut) - ce choix délègue le choix de libération + à la méthode <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal> Pour la JTATransactionFactory, elle retourne ConnectionReleaseMode.AFTER_STATEMENT; pour JDBCTransactionFactory, elle retourne ConnectionReleaseMode.AFTER_TRANSACTION. C'est rarement - une bonne id�e de changer ce comportement par d�faut puisque les erreurs soulev�es par ce - param�trage tend � prouver une erreur dans le code de l'utilisateur. + une bonne idée de changer ce comportement par défaut puisque les erreurs soulevées par ce + paramétrage tend à prouver une erreur dans le code de l'utilisateur. </para> </listitem> <listitem> <para> - <literal>on_close</literal> - indique d'utiliser ConnectionReleaseMode.ON_CLOSE. Ce param�trage - existe pour garantir la compatibilit� avec les versions pr�c�dentes, mais ne devrait plus �tre utilis�. + <literal>on_close</literal> - indique d'utiliser ConnectionReleaseMode.ON_CLOSE. Ce paramétrage + existe pour garantir la compatibilité avec les versions précédentes, mais ne devrait plus être utilisé. </para> </listitem> <listitem> <para> <literal>after_transaction</literal> - indique d'utiliser ConnectionReleaseMode.AFTER_TRANSACTION. - Ne devrait pas �tre utilis� dans les environnements JTA. Notez aussi qu'avec - ConnectionReleaseMode.AFTER_TRANSACTION, si une session est consid�r�e comme �tant en mode auto-commit - les connexions seront relach�es comme si le mode �tait AFTER_STATEMENT. + Ne devrait pas être utilisé dans les environnements JTA. Notez aussi qu'avec + ConnectionReleaseMode.AFTER_TRANSACTION, si une session est considérée comme étant en mode auto-commit + les connexions seront relachées comme si le mode était AFTER_STATEMENT. </para> </listitem> <listitem> <para> <literal>after_statement</literal> - indique d'utiliser ConnectionReleaseMode.AFTER_STATEMENT. - Additonnellement, le <literal>ConnectionProvider</literal> utilis� est consult� pour savoir s'il supporte - ce param�trage (<literal>supportsAggressiveRelease()</literal>). Si ce n'est pas le cas, le mode de - lib�ration est r� initialis� � ConnectionReleaseMode.AFTER_TRANSACTION. - Ce param�trage n'est s�r que dans les environnements o� il est possible d'obtenir � nouveau - la m�me connexion JDBC � chaque fois que l'on fait un appel de <literal>ConnectionProvider.getConnection()</literal> - ou dans les envrionnements auto-commit o� il n'est pas important d'obtenir plusieurs fois la - m�me connexion. + Additonnellement, le <literal>ConnectionProvider</literal> utilisé est consulté pour savoir s'il supporte + ce paramétrage (<literal>supportsAggressiveRelease()</literal>). Si ce n'est pas le cas, le mode de + libération est ré initialisé à ConnectionReleaseMode.AFTER_TRANSACTION. + Ce paramétrage n'est sûr que dans les environnements où il est possible d'obtenir à nouveau + la même connexion JDBC à chaque fois que l'on fait un appel de <literal>ConnectionProvider.getConnection()</literal> + ou dans les envrionnements auto-commit où il n'est pas important d'obtenir plusieurs fois la + même connexion. </para> </listitem> </itemizedlist> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/tutorial.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/tutorial.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/tutorial.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,53 +1,55 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="tutorial"> - <title>Introduction � Hibernate</title> + <title>Introduction à Hibernate</title> <sect1 id="tutorial-intro" revision="1"> - <title>Pr�face</title> + <title>Préface</title> <para> - Ce chapitre est un didacticiel introductif destin� aux nouveaux utilisateurs - d'Hibernate. Nous commen�ons avec une simple application en ligne de commande - utilisant une base de donn�es en m�moire, et la d�veloppons en �tapes faciles - � comprendre. + Ce chapitre est un didacticiel introductif destiné aux nouveaux utilisateurs + d'Hibernate. Nous commençons avec une simple application en ligne de commande + utilisant une base de données en mémoire, et la développons en étapes faciles + à comprendre. </para> <para> - Ce didacticiel est destin� aux nouveaux utilisateurs d'Hibernate mais requiert - des connaissances Java et SQL. Il est bas� sur un didacticiel de Michael Gloegl, - les biblioth�ques tierces que nous nommons sont pour les JDK 1.4 et 5.0. Vous - pourriez avoir besoin d'autres biblioth�ques pour le JDK 1.3. + Ce didacticiel est destiné aux nouveaux utilisateurs d'Hibernate mais requiert + des connaissances Java et SQL. Il est basé sur un didacticiel de Michael Gloegl, + les bibliothèques tierces que nous nommons sont pour les JDK 1.4 et 5.0. Vous + pourriez avoir besoin d'autres bibliothèques pour le JDK 1.3. </para> <para> - Le code source de ce tutoriel est inclus dans la distribution dans le r�pertoire + Le code source de ce tutoriel est inclus dans la distribution dans le répertoire <literal>doc/reference/tutorial/</literal>. </para> </sect1> <sect1 id="tutorial-firstapp" revision="1"> - <title>Partie 1 - Premi�re application Hibernate</title> + <title>Partie 1 - Première application Hibernate</title> <para> - D'abord, nous cr�erons une simple application Hibernate en console. Nous utilisons - une base de donn�es en m�moire (HSQL DB), donc nous n'avons pas � installer de - serveur de base de donn�es. + D'abord, nous créerons une simple application Hibernate en console. Nous utilisons + une base de données en mémoire (HSQL DB), donc nous n'avons pas à installer de + serveur de base de données. </para> <para> - Supposons que nous ayons besoin d'une petite application de base de donn�es qui - puisse stocker des �v�nements que nous voulons suivre, et des informations � propos - des h�tes de ces �v�nements. + Supposons que nous ayons besoin d'une petite application de base de données qui + puisse stocker des événements que nous voulons suivre, et des informations à propos + des hôtes de ces événements. </para> <para> - La premi�re chose que nous faisons est de configurer notre r�pertoire de - d�veloppement et de mettre toutes les biblioth�ques dont nous avons besoin dedans. - T�l�chargez la distribution Hibernate � partir du site web d'Hibernate. - Extrayez le paquet et placez toutes les biblioth�ques requises trouv�es dans - <literal>/lib</literal> dans le r�pertoire <literal>/lib</literal> de votre - nouveau r�pertoire de travail. Il devrait ressembler � �a : + La première chose que nous faisons est de configurer notre répertoire de + développement et de mettre toutes les bibliothèques dont nous avons besoin dedans. + Téléchargez la distribution Hibernate à partir du site web d'Hibernate. + Extrayez le paquet et placez toutes les bibliothèques requises trouvées dans + <literal>/lib</literal> dans le répertoire <literal>/lib</literal> de votre + nouveau répertoire de travail. Il devrait ressembler à ça : </para> <programlisting><![CDATA[. @@ -65,25 +67,25 @@ log4j.jar ]]></programlisting> <para> - Ceci est l'ensemble minimum de biblioth�ques requises (notez que nous avons aussi - copi� hibernate3.jar, l'archive principale) pour Hibernate. Lisez le fichier - <literal>README.txt</literal> dans le r�pertoire <literal>lib/</literal> de la - distribution Hibernate pour plus d'informations � propos des bilioth�ques tierces - requises et optionnelles. (En fait, log4j n'est pas requis mais pr�f�r� par beaucoup - de d�veloppeurs.) + Ceci est l'ensemble minimum de bibliothèques requises (notez que nous avons aussi + copié hibernate3.jar, l'archive principale) pour Hibernate. Lisez le fichier + <literal>README.txt</literal> dans le répertoire <literal>lib/</literal> de la + distribution Hibernate pour plus d'informations à propos des biliothèques tierces + requises et optionnelles. (En fait, log4j n'est pas requis mais préféré par beaucoup + de développeurs.) </para> <para> - Ensuite, nous cr�ons une classe qui r�pr�sente l'�v�nement que nous voulons - stocker dans notre base de donn�es. + Ensuite, nous créons une classe qui réprésente l'événement que nous voulons + stocker dans notre base de données. </para> <sect2 id="tutorial-firstapp-firstclass" revision="1"> - <title>La premi�re classe</title> + <title>La première classe</title> <para> - Notre premi�re classe persistante est une simple classe JavaBean avec - quelques propri�t�s : + Notre première classe persistante est une simple classe JavaBean avec + quelques propriétés : </para> <programlisting><![CDATA[package events; @@ -125,51 +127,51 @@ <para> Vous pouvez voir que cette classe utilise les conventions de nommage standard JavaBean - pour les m�thodes getter/setter des propri�t�s, ainsi qu'une visibilit� priv�e - pour les champs. Ceci est la conception recommand�e - mais pas obligatoire. Hibernate peut - aussi acc�der aux champs directement, le b�n�fice des m�thodes d'acc�s est la robustesse + pour les méthodes getter/setter des propriétés, ainsi qu'une visibilité privée + pour les champs. Ceci est la conception recommandée - mais pas obligatoire. Hibernate peut + aussi accéder aux champs directement, le bénéfice des méthodes d'accès est la robustesse pour la refonte de code. Le constructeur sans argument est requis pour instancier un objet de cette classe via reflexion. </para> <para> - La propri�t� <literal>id</literal> contient la valeur d'un identifiant unique pour un - �v�nement particulier. Toutes les classes d'entit�s persistantes (ainsi que les classes - d�pendantes de moindre importance) auront besoin d'une telle propri�t� identifiante si nous - voulons utiliser l'ensemble complet des fonctionnalit�s d'Hibernate. En fait, la plupart des + La propriété <literal>id</literal> contient la valeur d'un identifiant unique pour un + événement particulier. Toutes les classes d'entités persistantes (ainsi que les classes + dépendantes de moindre importance) auront besoin d'une telle propriété identifiante si nous + voulons utiliser l'ensemble complet des fonctionnalités d'Hibernate. En fait, la plupart des applications (surtout les applications web) ont besoin de distinguer des objets par des - identifiants, donc vous devriez consid�rer �a comme une fonctionnalit� plut�t que comme une - limitation. Cependant, nous ne manipulons g�n�ralement pas l'identit� d'un objet, dor�navant - la m�thode setter devrait �tre priv�e. Seul Hibernate assignera les identifiants lorsqu'un - objet est sauvegard�. Vous pouvez voir qu'Hibernate peut acc�der aux m�thodes publiques, - priv�es et prot�g�es, ainsi qu'aux champs (publics, priv�s, prot�g�s) directement. Le choix - vous est laiss�, et vous pouvez l'ajuster � la conception de votre application. + identifiants, donc vous devriez considérer ça comme une fonctionnalité plutôt que comme une + limitation. Cependant, nous ne manipulons généralement pas l'identité d'un objet, dorénavant + la méthode setter devrait être privée. Seul Hibernate assignera les identifiants lorsqu'un + objet est sauvegardé. Vous pouvez voir qu'Hibernate peut accéder aux méthodes publiques, + privées et protégées, ainsi qu'aux champs (publics, privés, protégés) directement. Le choix + vous est laissé, et vous pouvez l'ajuster à la conception de votre application. </para> <para> Le constructeur sans argument est requis pour toutes les classes persistantes ; - Hibernate doit cr�er des objets pour vous en utilisant la r�flexion Java. Le - constructeur peut �tre priv�, cependant, la visibilit� du paquet est requise - pour la g�n�ration de proxy � l'ex�cution et une r�cup�ration des donn�es efficaces + Hibernate doit créer des objets pour vous en utilisant la réflexion Java. Le + constructeur peut être privé, cependant, la visibilité du paquet est requise + pour la génération de proxy à l'exécution et une récupération des données efficaces sans instrumentation du bytecode. </para> <para> - Placez ce fichier source Java dans un r�pertoire appel� <literal>src</literal> - dans le dossier de d�veloppement. Ce r�pertoire devrait maintenant ressembler - � �a : + Placez ce fichier source Java dans un répertoire appelé <literal>src</literal> + dans le dossier de développement. Ce répertoire devrait maintenant ressembler + à ça : </para> <programlisting><![CDATA[. +lib - <Hibernate et biblioth�ques tierces> + <Hibernate et bibliothèques tierces> +src +events Event.java]]></programlisting> <para> - Dans la prochaine �tape, nous informons Hibernate de cette classe persistante. + Dans la prochaine étape, nous informons Hibernate de cette classe persistante. </para> </sect2> @@ -179,13 +181,13 @@ <para> Hibernate a besoin de savoir comment charger et stocker des objets d'une classe - persistante. C'est l� qu'intervient le fichier de mapping Hibernate. Le fichier - de mapping indique � Hibernate � quelle table dans la base de donn�es il doit - acc�der, et quelles colonnes de cette table il devra utiliser. + persistante. C'est là qu'intervient le fichier de mapping Hibernate. Le fichier + de mapping indique à Hibernate à quelle table dans la base de données il doit + accéder, et quelles colonnes de cette table il devra utiliser. </para> <para> - La structure basique de ce fichier de mapping ressemble � �a : + La structure basique de ce fichier de mapping ressemble à ça : </para> <programlisting><![CDATA[<?xml version="1.0"?> @@ -198,29 +200,29 @@ </hibernate-mapping>]]></programlisting> <para> - Notez que la DTD Hibernate est tr�s sophistiqu�e. Vous pouvez l'utiliser - pour l'auto-compl�tement des �l�ments et des attributs de mapping XML dans - votre �diteur ou votre IDE. Vous devriez aussi ouvrir le fichier DTD dans - votre �diteur de texte - c'est le moyen le plus facile d'obtenir une vue - d'ensemble de tous les �l�ments et attributs, et de voir les valeurs par - d�faut, ainsi que quelques commentaires. Notez qu'Hibernate ne chargera - pas le fichier DTD � partir du web, mais regardera d'abord dans le classpath + Notez que la DTD Hibernate est très sophistiquée. Vous pouvez l'utiliser + pour l'auto-complétement des éléments et des attributs de mapping XML dans + votre éditeur ou votre IDE. Vous devriez aussi ouvrir le fichier DTD dans + votre éditeur de texte - c'est le moyen le plus facile d'obtenir une vue + d'ensemble de tous les éléments et attributs, et de voir les valeurs par + défaut, ainsi que quelques commentaires. Notez qu'Hibernate ne chargera + pas le fichier DTD à partir du web, mais regardera d'abord dans le classpath de l'application. Le fichier DTD est inclus dans <literal>hibernate3.jar</literal> - ainsi que dans le r�pertoire <literal>src</literal> de la distribution + ainsi que dans le répertoire <literal>src</literal> de la distribution Hibernate. </para> <para> - Nous omettrons la d�claration de la DTD dans les exemples futurs pour - raccourcir le code. Bien s�r il n'est pas optionnel. + Nous omettrons la déclaration de la DTD dans les exemples futurs pour + raccourcir le code. Bien sûr il n'est pas optionnel. </para> <para> Entre les deux balises <literal>hibernate-mapping</literal>, incluez un - �l�ment <literal>class</literal>. Toutes les classes d'entit�s persistantes - (encore une fois, il pourrait y avoir des classes d�pendantes plus tard, - qui ne sont pas des entit�s m�re) ont besoin d'un mapping vers une table - de la base de donn�es SQL : + élément <literal>class</literal>. Toutes les classes d'entités persistantes + (encore une fois, il pourrait y avoir des classes dépendantes plus tard, + qui ne sont pas des entités mère) ont besoin d'un mapping vers une table + de la base de données SQL : </para> <programlisting><![CDATA[<hibernate-mapping> @@ -232,13 +234,13 @@ </hibernate-mapping>]]></programlisting> <para> - Plus loin, nous disons � Hibernate comment persister et charger un objet de la classe + Plus loin, nous disons à Hibernate comment persister et charger un objet de la classe <literal>Event</literal> dans la table <literal>EVENTS</literal>, chaque instance est - repr�sent�e par une ligne dans cette table. Maintenant nous continuons avec le mapping de - la propri�t� de l'identifiant unique vers la clef primaire de la table. De plus, comme + représentée par une ligne dans cette table. Maintenant nous continuons avec le mapping de + la propriété de l'identifiant unique vers la clef primaire de la table. De plus, comme nous ne voulons pas nous occuper de la gestion de cet identifiant, nous utilisons une - strat�gie de g�n�ration d'identifiant d'Hibernate pour la colonne de la clef primaire - subrog�e : + stratégie de génération d'identifiant d'Hibernate pour la colonne de la clef primaire + subrogée : </para> <programlisting><![CDATA[<hibernate-mapping> @@ -252,22 +254,22 @@ </hibernate-mapping>]]></programlisting> <para> - L'�l�ment <literal>id</literal> est la d�claration de la propri�t� de l'identifiant, - <literal>name="id"</literal> d�clare le nom de la propri�t� Java - Hibernate - utilisera les m�thodes getter et setter pour acc�der � la propri�t�. L'attribut - <literal>column</literal> indique � Hibernate quelle colonne de la table - <literal>EVENTS</literal> nous utilisons pour cette clef primaire. L'�l�ment - <literal>generator</literal> imbriqu� sp�cifie la strat�gie de g�n�ration de - l'identifiant, dans ce cas nous avons utilis� <literal>increment</literal>, - laquelle est une m�thode tr�s simple utile surtout pour les tests - (et didacticiels). Hibernate supporte aussi les identifiants g�n�r�s par les - bases de donn�es, globalement uniques, ainsi que les identifiants assign�s par - l'application (ou n'importe quelle strat�gie que vous avez �crit en extension). + L'élément <literal>id</literal> est la déclaration de la propriété de l'identifiant, + <literal>name="id"</literal> déclare le nom de la propriété Java - Hibernate + utilisera les méthodes getter et setter pour accéder à la propriété. L'attribut + <literal>column</literal> indique à Hibernate quelle colonne de la table + <literal>EVENTS</literal> nous utilisons pour cette clef primaire. L'élément + <literal>generator</literal> imbriqué spécifie la stratégie de génération de + l'identifiant, dans ce cas nous avons utilisé <literal>increment</literal>, + laquelle est une méthode très simple utile surtout pour les tests + (et didacticiels). Hibernate supporte aussi les identifiants générés par les + bases de données, globalement uniques, ainsi que les identifiants assignés par + l'application (ou n'importe quelle stratégie que vous avez écrit en extension). </para> <para> - Finalement nous incluons des d�clarations pour les propri�t�s persistantes de la classe - dans le fichier de mapping. Par d�faut, aucune propri�t� de la classe n'est consid�r�e + Finalement nous incluons des déclarations pour les propriétés persistantes de la classe + dans le fichier de mapping. Par défaut, aucune propriété de la classe n'est considérée comme persistante : </para> @@ -285,50 +287,50 @@ </hibernate-mapping>]]></programlisting> <para> - Comme avec l'�l�ment <literal>id</literal>, l'attribut <literal>name</literal> - de l'�l�ment <literal>property</literal> indique � Hibernate quels getters/setters + Comme avec l'élément <literal>id</literal>, l'attribut <literal>name</literal> + de l'élément <literal>property</literal> indique à Hibernate quels getters/setters utiliser. </para> <para> - Pourquoi le mapping de la propri�t� <literal>date</literal> inclut + Pourquoi le mapping de la propriété <literal>date</literal> inclut l'attribut <literal>column</literal>, mais pas <literal>title</literal> ? - Sans l'attribut <literal>column</literal> Hibernate utilise par d�faut - le nom de la propri�t� comme nom de colonne. Ca fonctionne bien pour + Sans l'attribut <literal>column</literal> Hibernate utilise par défaut + le nom de la propriété comme nom de colonne. Ca fonctionne bien pour <literal>title</literal>. Cependant, <literal>date</literal> est un mot clef - r�serv� dans la plupart des bases de donn�es, donc nous utilisons un nom - diff�rent pour le mapping. + réservé dans la plupart des bases de données, donc nous utilisons un nom + différent pour le mapping. </para> <para> - La prochaine chose int�ressante est que le mapping de <literal>title</literal> - manque aussi d'un attribut <literal>type</literal>. Les types que nous d�clarons + La prochaine chose intéressante est que le mapping de <literal>title</literal> + manque aussi d'un attribut <literal>type</literal>. Les types que nous déclarons et utilisons dans les fichiers de mapping ne sont pas, comme vous pourriez vous - y attendre, des types de donn�es Java. Ce ne sont pas, non plus, des types de - base de donn�es SQL. Ces types sont donc appel�s des <emphasis>types de mapping + y attendre, des types de données Java. Ce ne sont pas, non plus, des types de + base de données SQL. Ces types sont donc appelés des <emphasis>types de mapping Hibernate</emphasis>, des convertisseurs qui peuvent traduire des types Java en - types SQL et vice versa. De plus, Hibernate tentera de d�terminer la bonne conversion - et le type de mapping lui-m�me si l'attribut <literal>type</literal> n'est pas - pr�sent dans le mapping. Dans certains cas, cette d�tection automatique (utilisant - la r�flexion sur la classe Java) pourrait ne pas donner la valeur attendue ou - dont vous avez besoin. C'est le cas avec la propri�t� <literal>date</literal>. - Hibernate ne peut pas savoir si la propri�t� "mappera" une colonne SQL de type + types SQL et vice versa. De plus, Hibernate tentera de déterminer la bonne conversion + et le type de mapping lui-même si l'attribut <literal>type</literal> n'est pas + présent dans le mapping. Dans certains cas, cette détection automatique (utilisant + la réflexion sur la classe Java) pourrait ne pas donner la valeur attendue ou + dont vous avez besoin. C'est le cas avec la propriété <literal>date</literal>. + Hibernate ne peut pas savoir si la propriété "mappera" une colonne SQL de type <literal>date</literal>, <literal>timestamp</literal> ou <literal>time</literal>. - Nous d�clarons que nous voulons conserver des informations avec une date compl�te - et l'heure en mappant la propri�t� avec un <literal>timestamp</literal>. + Nous déclarons que nous voulons conserver des informations avec une date complète + et l'heure en mappant la propriété avec un <literal>timestamp</literal>. </para> <para> - Ce fichier de mapping devrait �tre sauvegard� en tant que <literal>Event.hbm.xml</literal>, - juste dans le r�pertoire � c�t� du fichier source de la classe Java <literal>Event</literal>. - Le nommage des fichiers de mapping peut �tre arbitraire, cependant le suffixe - <literal>hbm.xml</literal> est devenu une convention dans la communaut� des - d�veloppeurs Hibernate. La structure du r�pertoire devrait ressembler � �a : + Ce fichier de mapping devrait être sauvegardé en tant que <literal>Event.hbm.xml</literal>, + juste dans le répertoire à côté du fichier source de la classe Java <literal>Event</literal>. + Le nommage des fichiers de mapping peut être arbitraire, cependant le suffixe + <literal>hbm.xml</literal> est devenu une convention dans la communauté des + développeurs Hibernate. La structure du répertoire devrait ressembler à ça : </para> <programlisting><![CDATA[. +lib - <Hibernate et biblioth�ques tierces> + <Hibernate et bibliothèques tierces> +src Event.java Event.hbm.xml]]></programlisting> @@ -344,39 +346,39 @@ <para> Nous avons maintenant une classe persistante et son fichier de mapping. Il est temps de - configurer Hibernate. Avant �a, nous avons besoin d'une base de donn�es. HSQL DB, un - SGBD SQL bas� sur Java et travaillant en m�moire, peut �tre t�l�charg� � partir du site + configurer Hibernate. Avant ça, nous avons besoin d'une base de données. HSQL DB, un + SGBD SQL basé sur Java et travaillant en mémoire, peut être téléchargé à partir du site web de HSQL. En fait, vous avez seulement besoin de <literal>hsqldb.jar</literal>. Placez - ce fichier dans le r�pertoire <literal>lib/</literal> du dossier de d�veloppement. + ce fichier dans le répertoire <literal>lib/</literal> du dossier de développement. </para> <para> - Cr�ez un r�pertoire appel� <literal>data</literal> � la racine du r�pertoire de d�veloppement - - c'est l� que HSQL DB stockera ses fichiers de donn�es. D�marrez maintenant votre base de donn�es - en ex�cutant <literal>java -classpath lib/hsqldb.jar org.hsqldb.Server</literal> dans votre r�pertoire de travail. - Vous observez qu'elle d�marre et ouvre une socket TCP/IP, c'est l� que notre application - se connectera plus tard. Si vous souhaitez d�marrez � partir d'une nouvelle base de donn�es - pour ce tutoriel (faites <literal>CTRL + C</literal> dans la fen�tre the window), effacez - le r�pertoire <literal>data/</literal> et red�marrez HSQL DB � nouveau. + Créez un répertoire appelé <literal>data</literal> à la racine du répertoire de développement - + c'est là que HSQL DB stockera ses fichiers de données. Démarrez maintenant votre base de données + en exécutant <literal>java -classpath lib/hsqldb.jar org.hsqldb.Server</literal> dans votre répertoire de travail. + Vous observez qu'elle démarre et ouvre une socket TCP/IP, c'est là que notre application + se connectera plus tard. Si vous souhaitez démarrez à partir d'une nouvelle base de données + pour ce tutoriel (faites <literal>CTRL + C</literal> dans la fenêtre the window), effacez + le répertoire <literal>data/</literal> et redémarrez HSQL DB à nouveau. </para> <para> - Hibernate est la couche de votre application qui se connecte � cette base de donn�es, - donc il a besoin des informations de connexion. Les connexions sont �tablies � travers + Hibernate est la couche de votre application qui se connecte à cette base de données, + donc il a besoin des informations de connexion. Les connexions sont établies à travers un pool de connexions JDBC, que nous devons aussi configurer. La distribution Hibernate - contient diff�rents outils de gestion de pools de connexions JDBC open source, mais - pour ce didacticiel nous utiliserons le pool de connexions int�gr� � Hibernate. Notez - que vous devez copier les biblioth�ques requises dans votre classpath et utiliser - une configuration de pool de connexions diff�rente si vous voulez utiliser - un logiciel de gestion de pools JDBC tiers avec une qualit� de production. + contient différents outils de gestion de pools de connexions JDBC open source, mais + pour ce didacticiel nous utiliserons le pool de connexions intégré à Hibernate. Notez + que vous devez copier les bibliothèques requises dans votre classpath et utiliser + une configuration de pool de connexions différente si vous voulez utiliser + un logiciel de gestion de pools JDBC tiers avec une qualité de production. </para> <para> Pour la configuration d'Hibernate, nous pouvons utiliser un simple fichier <literal>hibernate.properties</literal>, un fichier <literal>hibernate.cfg.xml</literal> - l�g�rement plus sophistiqu�, ou m�me une configuration compl�te par programmation. La - plupart des utilisateurs pr�f�rent le fichier de configuration XML : + légèrement plus sophistiqué, ou même une configuration complète par programmation. La + plupart des utilisateurs préfèrent le fichier de configuration XML : </para> <programlisting><![CDATA[<?xml version='1.0' encoding='utf-8'?> @@ -418,28 +420,28 @@ </hibernate-configuration>]]></programlisting> <para> - Notez que cette configuration XML utilise une DTD diff�rente. Nous configurons + Notez que cette configuration XML utilise une DTD différente. Nous configurons une <literal>SessionFactory</literal> d'Hibernate - une fabrique globale responsable - d'une base de donn�es particuli�re. Si vous avez plusieurs base de donn�es, utilisez - plusieurs configurations <literal>&lt;session-factory&gt;</literal>, g�n�ralement - dans des fichiers de configuration diff�rents (pour un d�marrage plus facile). + d'une base de données particulière. Si vous avez plusieurs base de données, utilisez + plusieurs configurations <literal>&lt;session-factory&gt;</literal>, généralement + dans des fichiers de configuration différents (pour un démarrage plus facile). </para> <para> - Les quatre premiers �l�ments <literal>property</literal> contiennent la configuration - n�cessaire pour la connexion JDBC. L'�l�ment <literal>property</literal> du dialecte - sp�cifie quelle variante du SQL Hibernate va g�n�rer. La gestion automatique des sessions - d'Hibernate pour les contextes de persistance sera d�taill�e tr�s vite. - L'option <literal>hbm2ddl.auto</literal> active la g�n�ration automatique des sch�mas de - base de donn�es - directement dans la base de donn�es. Cela peut bien s�r aussi �tre - d�sactiv� (en supprimant l'option de configuration) ou redirig� vers un fichier avec - l'aide de la t�che Ant <literal>SchemaExport</literal>. Finalement, nous ajoutons + Les quatre premiers éléments <literal>property</literal> contiennent la configuration + nécessaire pour la connexion JDBC. L'élément <literal>property</literal> du dialecte + spécifie quelle variante du SQL Hibernate va générer. La gestion automatique des sessions + d'Hibernate pour les contextes de persistance sera détaillée très vite. + L'option <literal>hbm2ddl.auto</literal> active la génération automatique des schémas de + base de données - directement dans la base de données. Cela peut bien sûr aussi être + désactivé (en supprimant l'option de configuration) ou redirigé vers un fichier avec + l'aide de la tâche Ant <literal>SchemaExport</literal>. Finalement, nous ajoutons le(s) fichier(s) de mapping pour les classes persistantes. </para> <para> - Copiez ce fichier dans le r�pertoire source, il terminera dans la racine - du classpath. Hibernate cherchera automatiquement, au d�marrage, un fichier appel� + Copiez ce fichier dans le répertoire source, il terminera dans la racine + du classpath. Hibernate cherchera automatiquement, au démarrage, un fichier appelé <literal>hibernate.cfg.xml</literal> dans la racine du classpath. </para> @@ -450,16 +452,16 @@ <para> Nous allons maintenant construire le didacticiel avec Ant. Vous aurez besoin d'avoir Ant - d'install� - r�cup�rez-le � partir de <ulink url="http://ant.apache.org/bindownload.cgi"> la page - de t�l�chargement de Ant</ulink>. Comment installer Ant ne sera pas couvert ici. R�f�rez-vous - au <ulink url="http://ant.apache.org/manual/index.html">manuel d'Ant</ulink>. Apr�s que - vous aurez install� Ant, nous pourrons commencer � cr�er le fichier de construction. Il - s'appellera <literal>build.xml</literal> et sera plac� directement dans le r�pertoire de - d�veloppement. + d'installé - récupérez-le à partir de <ulink url="http://ant.apache.org/bindownload.cgi"> la page + de téléchargement de Ant</ulink>. Comment installer Ant ne sera pas couvert ici. Référez-vous + au <ulink url="http://ant.apache.org/manual/index.html">manuel d'Ant</ulink>. Après que + vous aurez installé Ant, nous pourrons commencer à créer le fichier de construction. Il + s'appellera <literal>build.xml</literal> et sera placé directement dans le répertoire de + développement. </para> <para> - Un fichier de construction basique ressemble � �a : + Un fichier de construction basique ressemble à ça : </para> <programlisting><![CDATA[<project name="hibernate-tutorial" default="compile"> @@ -496,9 +498,9 @@ </project>]]></programlisting> <para> - Cela dira � Ant d'ajouter tous les fichiers du r�pertoire lib finissant par - <literal>.jar</literal> dans le classpath utilis� pour la compilation. Cela copiera aussi - tous les fichiers source non Java dans le r�pertoire cible, par exemple les fichiers de + Cela dira à Ant d'ajouter tous les fichiers du répertoire lib finissant par + <literal>.jar</literal> dans le classpath utilisé pour la compilation. Cela copiera aussi + tous les fichiers source non Java dans le répertoire cible, par exemple les fichiers de configuration et de mapping d'Hibernate. Si vous lancez Ant maintenant, vous devriez obtenir cette sortie : </para> @@ -518,23 +520,23 @@ </sect2> <sect2 id="tutorial-firstapp-helpers" revision="3"> - <title>D�marrage et aides</title> + <title>Démarrage et aides</title> <para> Il est temps de charger et de stocker quelques objets <literal>Event</literal>, - mais d'abord nous devons compl�ter la configuration avec du code - d'infrastructure. Nous devons d�marrer Hibernate. Ce d�marrage inclut la construction + mais d'abord nous devons compléter la configuration avec du code + d'infrastructure. Nous devons démarrer Hibernate. Ce démarrage inclut la construction d'un objet <literal>SessionFactory</literal> global et le stocker quelque part - facile d'acc�s dans le code de l'application. Une <literal>SessionFactory</literal> + facile d'accès dans le code de l'application. Une <literal>SessionFactory</literal> peut ouvrir des nouvelles <literal>Session</literal>s. Une <literal>Session</literal> - repr�sente une unit� de travail simplement "thread�e", la <literal>SessionFactory</literal> - est un objet global "thread-safe", instanci� une seule fois. + représente une unité de travail simplement "threadée", la <literal>SessionFactory</literal> + est un objet global "thread-safe", instancié une seule fois. </para> <para> - Nous cr�erons une classe d'aide <literal>HibernateUtil</literal> qui s'occupe du - d�marrage et rend la gestion des <literal>Session</literal>s plus facile. - Regardons l'impl�mentation : + Nous créerons une classe d'aide <literal>HibernateUtil</literal> qui s'occupe du + démarrage et rend la gestion des <literal>Session</literal>s plus facile. + Regardons l'implémentation : </para> <programlisting><![CDATA[package util; @@ -547,7 +549,7 @@ static { try { - // Cr�ation de la SessionFactory � partir de hibernate.cfg.xml + // Création de la SessionFactory à partir de hibernate.cfg.xml sessionFactory = new Configuration().configure().buildSessionFactory(); } catch (Throwable ex) { // Make sure you log the exception, as it might be swallowed @@ -565,21 +567,21 @@ <para> Cette classe ne produit pas seulement la <literal>SessionFactory</literal> globale - dans un initialiseur statique (appel� une seule fois par la JVM lorsque la classe - est charg�e), elle masque le fait qu'elle exploite un singleton. Elle pourrait aussi + dans un initialiseur statique (appelé une seule fois par la JVM lorsque la classe + est chargée), elle masque le fait qu'elle exploite un singleton. Elle pourrait aussi obtenir la <literal>SessionFactory</literal> depuis JNDI dans un serveur d'applications. </para> <para> Si vous nommez la <literal>SessionFactory</literal> dans votre fichier de configuration, - Hibernate tentera la r�cup�ration depuis JNDI. Pour �viter ce code, vous pouvez aussi - utiliser un d�ploiement JMX et laisser le conteneur (compatible JMX) instancier et lier - un <literal>HibernateService</literal> � JNDI. Ces options avanc�es sont d�taill�es dans - la documentation de r�f�rence Hibernate. + Hibernate tentera la récupération depuis JNDI. Pour éviter ce code, vous pouvez aussi + utiliser un déploiement JMX et laisser le conteneur (compatible JMX) instancier et lier + un <literal>HibernateService</literal> à JNDI. Ces options avancées sont détaillées dans + la documentation de référence Hibernate. </para> <para> - Placez <literal>HibernateUtil.java</literal> dans le r�pertoire source de d�veloppement, + Placez <literal>HibernateUtil.java</literal> dans le répertoire source de développement, et ensuite <literal>Event.java</literal> : </para> @@ -597,19 +599,19 @@ build.xml]]></programlisting> <para> - Cela devrait encore compiler sans probl�me. Nous avons finalement besoin de configurer - le syst�me de "logs" - Hibernate utilise commons-logging et vous laisse le choix entre - log4j et le syst�me de logs du JDK 1.4. La plupart des d�veloppeurs pr�f�rent log4j : + Cela devrait encore compiler sans problème. Nous avons finalement besoin de configurer + le système de "logs" - Hibernate utilise commons-logging et vous laisse le choix entre + log4j et le système de logs du JDK 1.4. La plupart des développeurs préfèrent log4j : copiez <literal>log4j.properties</literal> de la distribution d'Hibernate (il est dans - le r�pertoire <literal>etc/</literal>) dans votre r�pertoire <literal>src</literal>, - puis faites de m�me avec <literal>hibernate.cfg.xml</literal>. Regardez la configuration - d'exemple et changez les param�tres si vous voulez une sortie plus verbeuse. Par d�faut, - seul le message de d�marrage d'Hibernate est affich� sur la sortie standard. + le répertoire <literal>etc/</literal>) dans votre répertoire <literal>src</literal>, + puis faites de même avec <literal>hibernate.cfg.xml</literal>. Regardez la configuration + d'exemple et changez les paramètres si vous voulez une sortie plus verbeuse. Par défaut, + seul le message de démarrage d'Hibernate est affiché sur la sortie standard. </para> <para> - L'infrastructure de ce didacticiel est compl�te - et nous sommes pr�ts � effectuer un - travail r�el avec Hibernate. + L'infrastructure de ce didacticiel est complète - et nous sommes prêts à effectuer un + travail réel avec Hibernate. </para> </sect2> @@ -619,7 +621,7 @@ <para> Finalement nous pouvons utiliser Hibernate pour charger et stocker des objets. - Nous �crivons une classe <literal>EventManager</literal> avec une m�thode + Nous écrivons une classe <literal>EventManager</literal> avec une méthode <literal>main()</literal> : </para> @@ -658,45 +660,45 @@ }]]></programlisting> <para> - Nous cr�ons un nouvel objet <literal>Event</literal>, et le remettons � Hibernate. - Hibernate s'occupe maintenant du SQL et ex�cute les <literal>INSERT</literal>s - dans la base de donn�es. Regardons le code de gestion de la <literal>Session</literal> - et de la <literal>Transaction</literal> avant de lancer �a. + Nous créons un nouvel objet <literal>Event</literal>, et le remettons à Hibernate. + Hibernate s'occupe maintenant du SQL et exécute les <literal>INSERT</literal>s + dans la base de données. Regardons le code de gestion de la <literal>Session</literal> + et de la <literal>Transaction</literal> avant de lancer ça. </para> <para> - Une <literal>Session</literal> est une unit� de travail. Pour le moment, nous allons faire - les choses simplement et assumer une granularit� un-un entre une <literal>Session</literal> - hibernate et une transaction � la base de donn�es. Pour isoler notre code du syst�me de transaction - sous-jacent (dans notre cas, du pure JDBC, mais cela pourrait �tre JTA), nous utilisons l'API + Une <literal>Session</literal> est une unité de travail. Pour le moment, nous allons faire + les choses simplement et assumer une granularité un-un entre une <literal>Session</literal> + hibernate et une transaction à la base de données. Pour isoler notre code du système de transaction + sous-jacent (dans notre cas, du pure JDBC, mais cela pourrait être JTA), nous utilisons l'API <literal>Transaction</literal> qui est disponible depuis la <literal>Session</literal> Hibernate. </para> <para> - Que fait <literal>sessionFactory.getCurrentSession()</literal> ? Premi�rement, vous pouvez - l'invoquer autant de fois que vous le voulez et n'importe o� du moment que vous avez votre - <literal>SessionFactory</literal> (facile gr�ce � <literal>HibernateUtil</literal>). - La m�thode <literal>getCurrentSession()</literal> renvoie toujours l'unit� de travail courante. - Souvenez vous que nous avons bascul� notre option de configuration au m�canisme bas� sur le "thread" - dans <literal>hibernate.cfg.xml</literal>. Par cons�quent, le scope de l'unit� de travail - courante est le thread java courant d'ex�cution. Ceci n'est pas totalement vrai. Une - <literal>Session</literal> commence lorsqu'elle est vraiment utilis�e la premi�re fois, - Lorsque nous appelons pour la premi�re fois <literal>getCurrentSession()</literal>. - Ensuite, elle est li�e, par Hibernate, au thread courant. Lorsque la transaction s'ach�ve - (commit ou rollback), Hibernate d�lie la <literal>Session</literal> du thread et la ferme + Que fait <literal>sessionFactory.getCurrentSession()</literal> ? Premièrement, vous pouvez + l'invoquer autant de fois que vous le voulez et n'importe où du moment que vous avez votre + <literal>SessionFactory</literal> (facile grâce à <literal>HibernateUtil</literal>). + La méthode <literal>getCurrentSession()</literal> renvoie toujours l'unité de travail courante. + Souvenez vous que nous avons basculé notre option de configuration au mécanisme basé sur le "thread" + dans <literal>hibernate.cfg.xml</literal>. Par conséquent, le scope de l'unité de travail + courante est le thread java courant d'exécution. Ceci n'est pas totalement vrai. Une + <literal>Session</literal> commence lorsqu'elle est vraiment utilisée la première fois, + Lorsque nous appelons pour la première fois <literal>getCurrentSession()</literal>. + Ensuite, elle est liée, par Hibernate, au thread courant. Lorsque la transaction s'achève + (commit ou rollback), Hibernate délie la <literal>Session</literal> du thread et la ferme pour vous. Si vous invoquez <literal>getCurrentSession()</literal> une autre fois, vous obtenez - une nouvelle <literal>Session</literal> et pouvez entamer une nouvelle unit� de travail. - Ce mod�le de programmation "<emphasis>thread-bound</emphasis>" est le moyen le plus + une nouvelle <literal>Session</literal> et pouvez entamer une nouvelle unité de travail. + Ce modèle de programmation "<emphasis>thread-bound</emphasis>" est le moyen le plus populaire d'utiliser Hibernate. </para> <para> - Lisez <xref linkend="transactions"/> pour plus d'informations sur la gestion des transactions et leur d�marcations. - Nous n'avons pas g�r� les erreurs et rollback sur l'exemple pr�c�dent. + Lisez <xref linkend="transactions"/> pour plus d'informations sur la gestion des transactions et leur démarcations. + Nous n'avons pas géré les erreurs et rollback sur l'exemple précédent. </para> <para> - Pour lancer cette premi�re routine, nous devons ajouter une cible appelable dans + Pour lancer cette première routine, nous devons ajouter une cible appelable dans le fichier de construction de Ant : </para> @@ -708,28 +710,28 @@ </target>]]></programlisting> <para> - La valeur de l'argument <literal>action</literal> correspond � la ligne de commande + La valeur de l'argument <literal>action</literal> correspond à la ligne de commande qui appelle la cible : </para> <programlisting><![CDATA[C:\hibernateTutorial\>ant run -Daction=store]]></programlisting> <para> - Vous devriez voir, apr�s la compilation, Hibernate d�marrer et, en fonction de votre - configuration, beaucoup de traces sur la sortie. � la fin vous trouverez la ligne suivante : + Vous devriez voir, après la compilation, Hibernate démarrer et, en fonction de votre + configuration, beaucoup de traces sur la sortie. À la fin vous trouverez la ligne suivante : </para> <programlisting><![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]></programlisting> <para> - C'est l'<literal>INSERT</literal> ex�cut� par Hibernate, les points d'interrogation - repr�sentent les param�tres JDBC li�s. Pour voir les valeurs li�es aux arguments, ou - pour r�duire la verbosit� des traces, v�rifier votre <literal>log4j.properties</literal>. + C'est l'<literal>INSERT</literal> exécuté par Hibernate, les points d'interrogation + représentent les paramètres JDBC liés. Pour voir les valeurs liées aux arguments, ou + pour réduire la verbosité des traces, vérifier votre <literal>log4j.properties</literal>. </para> <para> - Maintenant nous aimerions aussi lister les �v�nements stock�s, donc nous ajoutons une - option � la m�thode principale : + Maintenant nous aimerions aussi lister les événements stockés, donc nous ajoutons une + option à la méthode principale : </para> <programlisting><![CDATA[if (args[0].equals("store")) { @@ -745,7 +747,7 @@ }]]></programlisting> <para> - Nous ajoutons aussi une nouvelle m�thode <literal>listEvents()</literal> : + Nous ajoutons aussi une nouvelle méthode <literal>listEvents()</literal> : </para> <programlisting><![CDATA[private List listEvents() { @@ -762,33 +764,33 @@ }]]></programlisting> <para> - Ce que nous faisons ici c'est utiliser une requ�te HQL (Hibernate Query Language) pour - charger tous les objets <literal>Event</literal> existants de la base de donn�es. - Hibernate g�n�rera le SQL appropri�, l'enverra � la base de donn�es et peuplera des - objets <literal>Event</literal> avec les donn�es. Vous pouvez cr�er des requ�tes plus - complexes avec HQL, bien s�r. + Ce que nous faisons ici c'est utiliser une requête HQL (Hibernate Query Language) pour + charger tous les objets <literal>Event</literal> existants de la base de données. + Hibernate générera le SQL approprié, l'enverra à la base de données et peuplera des + objets <literal>Event</literal> avec les données. Vous pouvez créer des requêtes plus + complexes avec HQL, bien sûr. </para> <para> - Maintenant, pour ex�cuter et tester tout �a, suivez ces �tapes : + Maintenant, pour exécuter et tester tout ça, suivez ces étapes : </para> <itemizedlist> <listitem> <para> - Ex�cutez <literal>ant run -Daction=store</literal> pour stocker quelque - chose dans la base de donn�es et, bien s�r, pour g�n�rer, avant, le sch�ma - de la base de donn�es gr�ce � hbm2ddl. + Exécutez <literal>ant run -Daction=store</literal> pour stocker quelque + chose dans la base de données et, bien sûr, pour générer, avant, le schéma + de la base de données grâce à hbm2ddl. </para> </listitem> <listitem> <para> - Maintenant d�sactivez hbm2ddl en commentant la propri�t� dans votre fichier - <literal>hibernate.cfg.xml</literal>. G�n�ralement vous la laissez seulement - activ�e dans des tests unitaires en continu, mais une autre ex�cution de hbm2ddl - <emphasis>effacerait</emphasis> tout ce que vous avez stock� - le param�tre de + Maintenant désactivez hbm2ddl en commentant la propriété dans votre fichier + <literal>hibernate.cfg.xml</literal>. Généralement vous la laissez seulement + activée dans des tests unitaires en continu, mais une autre exécution de hbm2ddl + <emphasis>effacerait</emphasis> tout ce que vous avez stocké - le paramètre de configuration <literal>create</literal> se traduit en fait par "supprimer toutes les - tables du sch�ma, puis re-cr�er toutes les tables, lorsque la SessionFactory est + tables du schéma, puis re-créer toutes les tables, lorsque la SessionFactory est construite". </para> </listitem> @@ -796,7 +798,7 @@ <para> Si maintenant vous appelez Ant avec <literal>-Daction=list</literal>, vous devriez voir - les �v�nements que vous avez stock�s jusque l�. Vous pouvez bien s�r aussi appeler l'action + les événements que vous avez stockés jusque là. Vous pouvez bien sûr aussi appeler l'action <literal>store</literal> plusieurs fois. </para> @@ -808,16 +810,16 @@ <title>Partie 2 - Mapper des associations</title> <para> - Nous avons mapp� une classe d'une entit� persistante vers une table. Partons de l� et - ajoutons quelques associations de classe. D'abord nous ajouterons des gens � notre - application, et stockerons une liste d'�v�nements auxquels ils participent. + Nous avons mappé une classe d'une entité persistante vers une table. Partons de là et + ajoutons quelques associations de classe. D'abord nous ajouterons des gens à notre + application, et stockerons une liste d'événements auxquels ils participent. </para> <sect2 id="tutorial-associations-mappinguser" revision="1"> <title>Mapper la classe Person</title> <para> - La premi�re version de la classe <literal>Person</literal> est simple : + La première version de la classe <literal>Person</literal> est simple : </para> <programlisting><![CDATA[package events; @@ -836,8 +838,8 @@ }]]></programlisting> <para> - Cr�ez un nouveau fichier de mapping appel� <literal>Person.hbm.xml</literal> - (n'oubliez pas la r�f�rence � la DTD) + Créez un nouveau fichier de mapping appelé <literal>Person.hbm.xml</literal> + (n'oubliez pas la référence à la DTD) </para> <programlisting><![CDATA[<hibernate-mapping> @@ -854,35 +856,35 @@ </hibernate-mapping>]]></programlisting> <para> - Finalement, ajoutez la nouveau mapping � la configuration d'Hibernate : + Finalement, ajoutez la nouveau mapping à la configuration d'Hibernate : </para> <programlisting><![CDATA[<mapping resource="events/Event.hbm.xml"/> <mapping resource="events/Person.hbm.xml"/>]]></programlisting> <para> - Nous allons maintenant cr�er une association entre ces deux entit�s. �videmment, - des personnes peuvent participer aux �v�nements, et des �v�nements ont des participants. - Les questions de conception que nous devons traiter sont : direction, cardinalit� et comportement + Nous allons maintenant créer une association entre ces deux entités. Évidemment, + des personnes peuvent participer aux événements, et des événements ont des participants. + Les questions de conception que nous devons traiter sont : direction, cardinalité et comportement de la collection. </para> </sect2> <sect2 id="tutorial-associations-unidirset" revision="2"> - <title>Une association unidirectionnelle bas�e sur Set</title> + <title>Une association unidirectionnelle basée sur Set</title> <para> - Nous allons ajouter une collection d'�v�nements � la classe <literal>Person</literal>. De - cette mani�re nous pouvons facilement naviguer dans les �v�nements d'une personne - particuli�re, sans ex�cuter une requ�te explicite - en appelant + Nous allons ajouter une collection d'événements à la classe <literal>Person</literal>. De + cette manière nous pouvons facilement naviguer dans les événements d'une personne + particulière, sans exécuter une requête explicite - en appelant <literal>aPerson.getEvents()</literal>. Nous utilisons une collection Java, un - <literal>Set</literal>, parce que la collection ne contiendra pas d'�l�ments dupliqu�s et + <literal>Set</literal>, parce que la collection ne contiendra pas d'éléments dupliqués et l'ordre ne nous importe pas. </para> <para> - Nous avons besoin d'une association unidirectionnelle, pluri-valu�e, impl�ment�e avec - un <literal>Set</literal>. �crivons le code pour �a dans les classes Java et mappons les : + Nous avons besoin d'une association unidirectionnelle, pluri-valuée, implémentée avec + un <literal>Set</literal>. Écrivons le code pour ça dans les classes Java et mappons les : </para> <programlisting><![CDATA[public class Person { @@ -899,15 +901,15 @@ }]]></programlisting> <para> - D'abord nous mappons cette association, mais pensez � l'autre c�t�. Clairement, nous pouvons - la laisser unidirectionnelle. Ou alors, nous pourrions cr�er une autre collection sur - <literal>Event</literal>, si nous voulons �tre capable de la parcourir de mani�re - bidirectionnelle, c'est-�-dire avoir <literal>anEvent.getParticipants()</literal>. - Ce n'est pas n�cessaire d'un point de vue fonctionnel. Vous pourrez toujours ex�cuter une requ�te - explicite pour r�cup�rer les participants d'un "event" particulier. Ce choix de conception - vous est laiss�, mais ce qui reste certains est la cardinalit� de l'association: "plusieurs" - des deux c�t�s, nous appelons cela une association <emphasis>many-to-many</emphasis>. - Par cons�quent nous utilisons un mapping Hibernate many-to-many: + D'abord nous mappons cette association, mais pensez à l'autre côté. Clairement, nous pouvons + la laisser unidirectionnelle. Ou alors, nous pourrions créer une autre collection sur + <literal>Event</literal>, si nous voulons être capable de la parcourir de manière + bidirectionnelle, c'est-à-dire avoir <literal>anEvent.getParticipants()</literal>. + Ce n'est pas nécessaire d'un point de vue fonctionnel. Vous pourrez toujours exécuter une requête + explicite pour récupérer les participants d'un "event" particulier. Ce choix de conception + vous est laissé, mais ce qui reste certains est la cardinalité de l'association: "plusieurs" + des deux côtés, nous appelons cela une association <emphasis>many-to-many</emphasis>. + Par conséquent nous utilisons un mapping Hibernate many-to-many: </para> <programlisting><![CDATA[<class name="events.Person" table="PERSON"> @@ -927,18 +929,18 @@ <para> Hibernate supporte toutes sortes de mapping de collection, un <literal>&lt;set&gt;</literal> - �tant le plus commun. Pour une association many-to-many (ou une relation - d'entit� <emphasis>n:m</emphasis>), une table d'association est requise. Chaque ligne dans cette table repr�sente un lien entre une personne et un �v�nement. Le nom de la table est - configur� avec l'attribut <literal>table</literal> de l'�l�ment <literal>set</literal>. Le - nom de la colonne identifiant dans l'association, du c�t� de la personne, est d�fini avec - l'�l�ment <literal>&lt;key&gt;</literal>, et le nom de la colonne pour l'�v�nement dans + étant le plus commun. Pour une association many-to-many (ou une relation + d'entité <emphasis>n:m</emphasis>), une table d'association est requise. Chaque ligne dans cette table représente un lien entre une personne et un événement. Le nom de la table est + configuré avec l'attribut <literal>table</literal> de l'élément <literal>set</literal>. Le + nom de la colonne identifiant dans l'association, du côté de la personne, est défini avec + l'élément <literal>&lt;key&gt;</literal>, et le nom de la colonne pour l'événement dans l'attribut <literal>column</literal> de <literal>&lt;many-to-many&gt;</literal>. Vous - devez aussi donner � Hibernate la classe des objets de votre collection (c'est-�-dire : la - classe de l'autre c�t� de la collection). + devez aussi donner à Hibernate la classe des objets de votre collection (c'est-à-dire : la + classe de l'autre côté de la collection). </para> <para> - Le sch�ma de base de donn�es pour ce mapping est donc : + Le schéma de base de données pour ce mapping est donc : </para> <programlisting><![CDATA[ @@ -961,7 +963,7 @@ <title>Travailler avec l'association</title> <para> - R�unissons quelques personnes et quelques �v�nements dans une nouvelle m�thode dans + Réunissons quelques personnes et quelques événements dans une nouvelle méthode dans <literal>EventManager</literal> : </para> @@ -979,27 +981,27 @@ }]]></programlisting> <para> - Apr�s le chargement d'une <literal>Person</literal> et d'un <literal>Event</literal>, modifiez - simplement la collection en utilisant les m�thodes normales de la collection. Comme vous - pouvez le voir, il n'y a pas d'appel explicite � <literal>update()</literal> ou - <literal>save()</literal>, Hibernate d�tecte automatiquement que la collection a �t� - modifi�e et a besoin d'�tre mise � jour. Ceci est appel� <emphasis>la v�rification sale + Après le chargement d'une <literal>Person</literal> et d'un <literal>Event</literal>, modifiez + simplement la collection en utilisant les méthodes normales de la collection. Comme vous + pouvez le voir, il n'y a pas d'appel explicite à <literal>update()</literal> ou + <literal>save()</literal>, Hibernate détecte automatiquement que la collection a été + modifiée et a besoin d'être mise à jour. Ceci est appelé <emphasis>la vérification sale automatique</emphasis> (NdT : "automatic dirty checking"), et vous pouvez aussi l'essayer en - modifiant le nom ou la propri�t� date de n'importe lequel de vos objets. Tant qu'ils sont dans - un �tat <emphasis>persistant</emphasis>, c'est-�-dire, li�s � une <literal>Session</literal> Hibernate - particuli�re (c-�-d qu'ils ont juste �t� charg�s ou sauvegard�s dans une unit� de travail), - Hibernate surveille les changements et ex�cute le SQL correspondant. Le processus de - synchronisation de l'�tat de la m�moire avec la base de donn�es, g�n�ralement seulement � la fin - d'une unit� de travail, est appel� <emphasis>flushing</emphasis>. Dans notre code, l'unit� de travail - s'ach�ve par un commit (ou rollback) de la transaction avec la base de donn�es - comme d�fini + modifiant le nom ou la propriété date de n'importe lequel de vos objets. Tant qu'ils sont dans + un état <emphasis>persistant</emphasis>, c'est-à-dire, liés à une <literal>Session</literal> Hibernate + particulière (c-à-d qu'ils ont juste été chargés ou sauvegardés dans une unité de travail), + Hibernate surveille les changements et exécute le SQL correspondant. Le processus de + synchronisation de l'état de la mémoire avec la base de données, généralement seulement à la fin + d'une unité de travail, est appelé <emphasis>flushing</emphasis>. Dans notre code, l'unité de travail + s'achève par un commit (ou rollback) de la transaction avec la base de données - comme défini par notre option <literal>thread</literal> de configuration pour la classe <literal>CurrentSessionContext</literal>. </para> <para> - Vous pourriez bien s�r charger une personne et un �v�nement dans diff�rentes unit�s de travail. Ou - vous modifiez un objet � l'ext�rieur d'une <literal>Session</literal>, s'il n'est pas dans un �tat - persistant (s'il �tait persistant avant, nous appelons cet �tat <emphasis>d�tach�</emphasis>). - Vous pouvez m�me modifier une collection lorsqu'elle est d�tach�e: + Vous pourriez bien sûr charger une personne et un événement dans différentes unités de travail. Ou + vous modifiez un objet à l'extérieur d'une <literal>Session</literal>, s'il n'est pas dans un état + persistant (s'il était persistant avant, nous appelons cet état <emphasis>détaché</emphasis>). + Vous pouvez même modifier une collection lorsqu'elle est détachée: </para> <programlisting><![CDATA[private void addPersonToEvent(Long personId, Long eventId) { @@ -1031,10 +1033,10 @@ }]]></programlisting> <para> - L'appel � <literal>update</literal> rend un objet d�tach� � nouveau persistant, vous pourriez - dire qu'il le lie � une unit� de travail, ainsi toutes les modifications (ajout, suppression) que vous avez faites - pendant qu'il �tait d�tach� peuvent �tre sauvegard�es dans la base de donn�es - (il se peut que vous ayez besoin de modifier quelques unes des m�thodes pr�c�dentes + L'appel à <literal>update</literal> rend un objet détaché à nouveau persistant, vous pourriez + dire qu'il le lie à une unité de travail, ainsi toutes les modifications (ajout, suppression) que vous avez faites + pendant qu'il était détaché peuvent être sauvegardées dans la base de données + (il se peut que vous ayez besoin de modifier quelques unes des méthodes précédentes pour retourner cet identifiant). </para> @@ -1045,31 +1047,31 @@ System.out.println("Added person " + personId + " to event " + eventId);]]></programlisting> <para> - Ce n'est pas tr�s utile dans notre situation actuelle, mais c'est un concept important + Ce n'est pas très utile dans notre situation actuelle, mais c'est un concept important que vous pouvez mettre dans votre propre application. - Pour le moment, compl�tez cet exercice en ajoutant une nouvelle action � la m�thode - principale des <literal>EventManager</literal>s et appelez la � partir de la ligne de - commande. Si vous avez besoin des identifiants d'une personne et d'un �v�nement - la - m�thode <literal>save()</literal> les retourne. + Pour le moment, complétez cet exercice en ajoutant une nouvelle action à la méthode + principale des <literal>EventManager</literal>s et appelez la à partir de la ligne de + commande. Si vous avez besoin des identifiants d'une personne et d'un événement - la + méthode <literal>save()</literal> les retourne. </para> <para> - C'�tait un exemple d'une association entre deux classes de m�me importance, deux entit�s. - Comme mentionn� plus t�t, il y a d'autres classes et d'autres types dans un mod�le typique, - g�n�ralement "moins importants". Vous en avez d�j� vu certains, comme un <literal>int</literal> + C'était un exemple d'une association entre deux classes de même importance, deux entités. + Comme mentionné plus tôt, il y a d'autres classes et d'autres types dans un modèle typique, + généralement "moins importants". Vous en avez déjà vu certains, comme un <literal>int</literal> ou une <literal>String</literal>. Nous appelons ces classes des <emphasis>types de valeur</emphasis>, - et leurs instances <emphasis>d�pendent</emphasis> d'une entit� particuli�re. Des instances de ces - types n'ont pas leur propre identit�, elles ne sont pas non plus partag�es entre des entit�s (deux - personnes ne r�f�rencent pas le m�me objet <literal>firstname</literal>, m�me si elles ont le - m�me pr�nom). Bien s�r, des types de valeur ne peuvent pas seulement �tre trouv�s dans - le JDK (en fait, dans une application Hibernate toutes les classes du JDK sont consid�r�es - comme des types de valeur), vous pouvez aussi �crire vous-m�me des classes d�pendantes, + et leurs instances <emphasis>dépendent</emphasis> d'une entité particulière. Des instances de ces + types n'ont pas leur propre identité, elles ne sont pas non plus partagées entre des entités (deux + personnes ne référencent pas le même objet <literal>firstname</literal>, même si elles ont le + même prénom). Bien sûr, des types de valeur ne peuvent pas seulement être trouvés dans + le JDK (en fait, dans une application Hibernate toutes les classes du JDK sont considérées + comme des types de valeur), vous pouvez aussi écrire vous-même des classes dépendantes, <literal>Address</literal> ou <literal>MonetaryAmount</literal>, par exemple. </para> <para> - Vous pouvez aussi concevoir une collection de types de valeur. C'est conceptuellement tr�s - diff�rent d'une collection de r�f�rences vers d'autres entit�s, mais tr�s ressemblant en Java. + Vous pouvez aussi concevoir une collection de types de valeur. C'est conceptuellement très + différent d'une collection de références vers d'autres entités, mais très ressemblant en Java. </para> </sect2> @@ -1078,7 +1080,7 @@ <title>Collection de valeurs</title> <para> - Nous ajoutons une collection d'objets de type de valeur � l'entit� <literal>Person</literal>. + Nous ajoutons une collection d'objets de type de valeur à l'entité <literal>Person</literal>. Nous voulons stocker des adresses email, donc le type que nous utilisons est <literal>String</literal>, et la collection est encore un <literal>Set</literal> : </para> @@ -1102,19 +1104,19 @@ </set>]]></programlisting> <para> - La diff�rence compar�e au mapping vu plus t�t est la partie <literal>element</literal>, - laquelle dit � Hibernate que la collection ne contient pas de r�f�rences vers une autre entit�, - mais une collection d'�l�ments de type <literal>String</literal> (le nom en minuscule vous + La différence comparée au mapping vu plus tôt est la partie <literal>element</literal>, + laquelle dit à Hibernate que la collection ne contient pas de références vers une autre entité, + mais une collection d'éléments de type <literal>String</literal> (le nom en minuscule vous indique que c'est un type/convertisseur du mapping Hibernate). Une fois encore, l'attribut - <literal>table</literal> de l'�l�ment <literal>set</literal> d�termine le nom de la table pour la - collection. L'�l�ment <literal>key</literal> d�finit le nom de la colonne de la clef �trang�re - dans la table de la collection. L'attribut <literal>column</literal> dans l'�l�ment - <literal>element</literal> d�finit le nom de la colonne o� les valeurs de <literal>String</literal> - seront r�ellement stock�es. + <literal>table</literal> de l'élément <literal>set</literal> détermine le nom de la table pour la + collection. L'élément <literal>key</literal> définit le nom de la colonne de la clef étrangère + dans la table de la collection. L'attribut <literal>column</literal> dans l'élément + <literal>element</literal> définit le nom de la colonne où les valeurs de <literal>String</literal> + seront réellement stockées. </para> <para> - Regardons le sch�ma mis � jour : + Regardons le schéma mis à jour : </para> <programlisting><![CDATA[ @@ -1133,14 +1135,14 @@ <para> Vous pouvez voir que la clef primaire de la table de la collection est en fait une - clef compos�e, utilisant deux colonnes. Ceci implique aussi qu'il ne peut pas y avoir - d'adresses email dupliqu�es par personne, ce qui est exactement la s�mantique dont + clef composée, utilisant deux colonnes. Ceci implique aussi qu'il ne peut pas y avoir + d'adresses email dupliquées par personne, ce qui est exactement la sémantique dont nous avons besoin pour un ensemble en Java. </para> <para> - Vous pouvez maintenant tester et ajouter des �l�ments � cette collection, juste comme - nous l'avons fait avant en liant des personnes et des �v�nements. C'est le m�me code + Vous pouvez maintenant tester et ajouter des éléments à cette collection, juste comme + nous l'avons fait avant en liant des personnes et des événements. C'est le même code en Java. </para> @@ -1158,9 +1160,9 @@ }]]></programlisting> <para> - Cette fois ci, nous n'avons pas utilis� une requ�te de chargement agressif (<emphasis>fetch</emphasis>) - pour initialiser la collection. Par cons�quent, l'invocation du getter d�clenchera un - select suppl�mentaire pour l'initialiser. Traquez les logs SQL et tentez d'optimiser + Cette fois ci, nous n'avons pas utilisé une requête de chargement agressif (<emphasis>fetch</emphasis>) + pour initialiser la collection. Par conséquent, l'invocation du getter déclenchera un + select supplémentaire pour l'initialiser. Traquez les logs SQL et tentez d'optimiser ce cas avec un chargement aggressif. </para> @@ -1171,15 +1173,15 @@ <para> Ensuite nous allons mapper une association bidirectionnelle - faire fonctionner - l'association entre une personne et un �v�nement � partir des deux c�t�s en Java. - Bien s�r, le sch�ma de la base de donn�es ne change pas, nous avons toujours une pluralit� - many-to-many. Une base de donn�es relationnelle est plus flexible qu'un langage de - programmation r�seau, donc elle n'a pas besoin de direction de navigation - les donn�es - peuvent �tre vues et r�cup�r�es de toutes les mani�res possibles. + l'association entre une personne et un événement à partir des deux côtés en Java. + Bien sûr, le schéma de la base de données ne change pas, nous avons toujours une pluralité + many-to-many. Une base de données relationnelle est plus flexible qu'un langage de + programmation réseau, donc elle n'a pas besoin de direction de navigation - les données + peuvent être vues et récupérées de toutes les manières possibles. </para> <para> - D'abord, ajouter une collection de participants � la classe <literal>Event</literal> : + D'abord, ajouter une collection de participants à la classe <literal>Event</literal> : </para> <programlisting><![CDATA[private Set participants = new HashSet(); @@ -1193,7 +1195,7 @@ }]]></programlisting> <para> - Maintenant mapper ce c�t� de l'association aussi, dans <literal>Event.hbm.xml</literal>. + Maintenant mapper ce côté de l'association aussi, dans <literal>Event.hbm.xml</literal>. </para> <programlisting><![CDATA[<set name="participants" table="PERSON_EVENT" inverse="true"> @@ -1204,16 +1206,16 @@ <para> Comme vous le voyez, ce sont des mappings de <literal>set</literal>s normaux dans les deux documents de mapping. Notez que les noms de colonne dans <literal>key</literal> et - <literal>many-to-many</literal> sont invers�s dans les 2 documents de mapping. L'ajout - le plus important ici est l'attribut <literal>inverse="true"</literal> dans l'�l�ment + <literal>many-to-many</literal> sont inversés dans les 2 documents de mapping. L'ajout + le plus important ici est l'attribut <literal>inverse="true"</literal> dans l'élément <literal>set</literal> du mapping de la collection des <literal>Event</literal>s. </para> <para> - Ce que signifie qu'Hibernate devrait prendre l'autre c�t� - la classe <literal>Person</literal> - - s'il a besoin de renseigner des informations � propos du lien entre les deux. Ce sera - beaucoup plus facile � comprendre une fois que vous verrez comment le lien bidirectionnel - entre les deux entit�s est cr��. + Ce que signifie qu'Hibernate devrait prendre l'autre côté - la classe <literal>Person</literal> - + s'il a besoin de renseigner des informations à propos du lien entre les deux. Ce sera + beaucoup plus facile à comprendre une fois que vous verrez comment le lien bidirectionnel + entre les deux entités est créé. </para> </sect2> @@ -1222,19 +1224,19 @@ <title>Travailler avec des liens bidirectionnels</title> <para> - Premi�rement, gardez � l'esprit qu'Hibernate n'affecte pas la s�mantique normale de Java. - Comment avons-nous cr�� un lien entre une <literal>Person</literal> et un <literal>Event</literal> - dans l'exemple unidirectionnel ? Nous avons ajout� une instance de <literal>Event</literal> - � la collection des r�f�rences d'�v�nement d'une instance de <literal>Person</literal>. Donc, - �videmment, si vous voulons rendre ce lien bidirectionnel, nous devons faire la m�me chose de - l'autre c�t� - ajouter une r�f�rence de <literal>Person</literal> � la collection d'un - <literal>Event</literal>. Cette "configuration du lien des deux c�t�s" est absolument - n�cessaire et vous ne devriez jamais oublier de le faire. + Premièrement, gardez à l'esprit qu'Hibernate n'affecte pas la sémantique normale de Java. + Comment avons-nous créé un lien entre une <literal>Person</literal> et un <literal>Event</literal> + dans l'exemple unidirectionnel ? Nous avons ajouté une instance de <literal>Event</literal> + à la collection des références d'événement d'une instance de <literal>Person</literal>. Donc, + évidemment, si vous voulons rendre ce lien bidirectionnel, nous devons faire la même chose de + l'autre côté - ajouter une référence de <literal>Person</literal> à la collection d'un + <literal>Event</literal>. Cette "configuration du lien des deux côtés" est absolument + nécessaire et vous ne devriez jamais oublier de le faire. </para> <para> - Beaucoup de d�veloppeurs programment de mani�re d�fensive et cr�ent des - m�thodes de gestion de lien pour affecter correctement les deux c�t�s, + Beaucoup de développeurs programment de manière défensive et créent des + méthodes de gestion de lien pour affecter correctement les deux côtés, par exemple dans <literal>Person</literal> : </para> @@ -1257,25 +1259,25 @@ }]]></programlisting> <para> - Notez que les m�thodes get et set pour la collection sont maintenant prot�g�es - ceci permet � des - classes du m�me paquet et aux sous-classes d'acc�der encore aux m�thodes, mais emp�che n'importe qui - d'autre de mettre le d�sordre directement dans les collections (enfin, presque). Vous devriez - probablement faire de m�me avec la collection de l'autre c�t�. + Notez que les méthodes get et set pour la collection sont maintenant protégées - ceci permet à des + classes du même paquet et aux sous-classes d'accéder encore aux méthodes, mais empêche n'importe qui + d'autre de mettre le désordre directement dans les collections (enfin, presque). Vous devriez + probablement faire de même avec la collection de l'autre côté. </para> <para> - Et � propos de l'attribut de mapping <literal>inverse</literal> ? Pour vous, et pour Java, un lien - bidirectionnel est simplement une mani�re de configurer correctement les r�f�rences des deux c�t�s. + Et à propos de l'attribut de mapping <literal>inverse</literal> ? Pour vous, et pour Java, un lien + bidirectionnel est simplement une manière de configurer correctement les références des deux côtés. Hibernate n'a cependant pas assez d'informations pour ordonner correctement les expressions SQL - <literal>INSERT</literal> et <literal>UPDATE</literal> (pour �viter les violations de contrainte), et - a besoin d'aide pour g�rer proprement les associations bidirectionnelles. Rendre - <literal>inverse</literal> un c�t� d'une assocation dit � Hibernate de l'ignorer essentiellement, pour - le consid�rer comme un <emphasis>miroir</emphasis> de l'autre c�t�. C'est tout ce qui est n�cessaire � - Hibernate pour d�couvrir tout des probl�mes de transformation d'un mod�le de navigation - directionnelle vers un sch�ma SQL de base de donn�es. Les r�gles dont vous devez vous souvenir sont : - toutes les associations bidirectionnelles ont besoin d'un c�t� marqu� <literal>inverse</literal>. - Dans une association un-vers-plusieurs vous pouvez choisir n'importe quel c�t�, il n'y a pas de - diff�rence. + <literal>INSERT</literal> et <literal>UPDATE</literal> (pour éviter les violations de contrainte), et + a besoin d'aide pour gérer proprement les associations bidirectionnelles. Rendre + <literal>inverse</literal> un côté d'une assocation dit à Hibernate de l'ignorer essentiellement, pour + le considérer comme un <emphasis>miroir</emphasis> de l'autre côté. C'est tout ce qui est nécessaire à + Hibernate pour découvrir tout des problèmes de transformation d'un modèle de navigation + directionnelle vers un schéma SQL de base de données. Les règles dont vous devez vous souvenir sont : + toutes les associations bidirectionnelles ont besoin d'un côté marqué <literal>inverse</literal>. + Dans une association un-vers-plusieurs vous pouvez choisir n'importe quel côté, il n'y a pas de + différence. </para> <!-- <para> @@ -1292,15 +1294,15 @@ <para> Une application web Hibernate utilise la <literal>Session</literal> et <literal>Transaction</literal> comme une application standalone. Cependant, quelques patterns sont utiles. Nous allons coder une - <literal>EventManagerServlet</literal>. Cette servlet peut lister tous les �v�nements stock�s dans - la base de donn�es, et fournir une formulaire HTML pour saisir d'autres �v�nements. + <literal>EventManagerServlet</literal>. Cette servlet peut lister tous les évènements stockés dans + la base de données, et fournir une formulaire HTML pour saisir d'autres évènements. </para> <sect2 id="tutorial-webapp-servlet"> <title>Ecrire la servlet de base</title> <para> - Cr�ons une nouvelle classe dans notre r�pertoire source, dans le package <literal>events</literal>: + Créons une nouvelle classe dans notre répertoire source, dans le package <literal>events</literal>: </para> <programlisting><![CDATA[package events; @@ -1317,12 +1319,12 @@ <para> Le <literal>dateFormatter</literal> est un outil que nous utiliserons plus tard pour convertir les objets - <literal>Date</literal> depuis et vers des chaines de caract�res. Il est propice de n'avoir qu'un + <literal>Date</literal> depuis et vers des chaines de caractères. Il est propice de n'avoir qu'un formatter comme membre de la servlet. </para> <para> - La servlet n'accepte que les requ�tes HTTP <literal>GET</literal>, la m�thode � impl�menter est donc + La servlet n'accepte que les requêtes HTTP <literal>GET</literal>, la méthode à implémenter est donc <literal>doGet()</literal>: </para> @@ -1350,37 +1352,37 @@ }]]></programlisting> <para> - La pattern que nous utilisons ici est appel� <emphasis>session-per-request</emphasis>. - Lorsqu'une requ�te touche la servlet, une nouvelle <literal>Session</literal> hibernate est - ouverte � l'invocationde <literal>getCurrentSession()</literal> sur la - <literal>SessionFactory</literal>. Ensuite, une transaction avec la base de donn�es est d�marr�e&mdash; - tous les acc�s � la base de donn�es interviennent au sein de la transactiton, peu importe que les donn�es - soient lues ou �crites (nous n'utilisons pas le mode auto-commit dans les applications). + La pattern que nous utilisons ici est appelé <emphasis>session-per-request</emphasis>. + Lorsqu'une requête touche la servlet, une nouvelle <literal>Session</literal> hibernate est + ouverte à l'invocationde <literal>getCurrentSession()</literal> sur la + <literal>SessionFactory</literal>. Ensuite, une transaction avec la base de données est démarrée&mdash; + tous les accès à la base de données interviennent au sein de la transactiton, peu importe que les données + soient lues ou écrites (nous n'utilisons pas le mode auto-commit dans les applications). </para> <para> - Ensuite, les actions possibles de la requ�tes sont ex�cut�es et la r�ponse HTML + Ensuite, les actions possibles de la requêtes sont exécutées et la réponse HTML est rendue. Nous en parlerons plus tard. </para> <para> - Enfin, l'unit� de travail s'ach�ve lorsque l'ex�cution et le rendu sont achev�s. - Si un probl�me survient lors de ces deux phases, une exception est soulev�e et la - transaction avec la base de donn�es subit un rollback. Voila pour le pattern - <literal>session-per-request</literal>. Au lieu d'un code de d�marcation de transaction - au sein de chaque servlet, vous pouvez �crire un filtre de servlet. - Voir le site Hibernate et le Wiki pour plus d'information sur ce pattern, appel� - <emphasis>Open Session in View</emphasis>&mdash; vous en aurez besoin d�s que vous + Enfin, l'unité de travail s'achève lorsque l'exécution et le rendu sont achevés. + Si un problème survient lors de ces deux phases, une exception est soulevée et la + transaction avec la base de données subit un rollback. Voila pour le pattern + <literal>session-per-request</literal>. Au lieu d'un code de démarcation de transaction + au sein de chaque servlet, vous pouvez écrire un filtre de servlet. + Voir le site Hibernate et le Wiki pour plus d'information sur ce pattern, appelé + <emphasis>Open Session in View</emphasis>&mdash; vous en aurez besoin dès que vous utiliserez des JSPs et non plus des servlets pour le rendu de vos vues. </para> </sect2> <sect2 id="tutorial-webapp-processing"> - <title>Proc�der et rendre</title> + <title>Procéder et rendre</title> <para> - Impl�mentons l'ex�cution de la requ�te et le rendu de la page. + Implémentons l'exécution de la requête et le rendu de la page. </para> <programlisting><![CDATA[// Write HTML header @@ -1412,10 +1414,10 @@ <para> Ce style de code avec un mix de Java et d'HTML ne serait pas scalable - dans une application plus complexe&mdash;gardez � l'esprit que nous ne faisons qu'illustrer - les concepts basiques d'Hibernate dans ce tutoriel. Ce code affiche une en t�te et un pied de page - HTML. Dans cette page, sont affich�s un formulaire pour la saisie d'�v�nements ainsi - qu'une liste de tous les �v�nements de la base de donn�es. La premi�re m�thode + dans une application plus complexe&mdash;gardez à l'esprit que nous ne faisons qu'illustrer + les concepts basiques d'Hibernate dans ce tutoriel. Ce code affiche une en tête et un pied de page + HTML. Dans cette page, sont affichés un formulaire pour la saisie d'évènements ainsi + qu'une liste de tous les évènements de la base de données. La première méthode est triviale est ne fait que sortir de l'HTML: </para> @@ -1429,9 +1431,9 @@ }]]></programlisting> <para> - La m�thode <literal>listEvents()</literal> utilise la - <literal>Session</literal> Hibernate li�e au thread courant pour ex�cuter la - requ�te: + La méthode <literal>listEvents()</literal> utilise la + <literal>Session</literal> Hibernate liée au thread courant pour exécuter la + requête: </para> <programlisting><![CDATA[private void listEvents(PrintWriter out) { @@ -1456,7 +1458,7 @@ }]]></programlisting> <para> - FEnfin, l'action <literal>store</literal> renvoie � la m�thode + FEnfin, l'action <literal>store</literal> renvoie à la méthode <literal>createAndStoreEvent()</literal>, qui utilise aussi la <literal>Session</literal> du thread courant: </para> @@ -1471,23 +1473,23 @@ }]]></programlisting> <para> - La servlet est faite. Une requ�te � la servlet sera ex�cut�e par une seule + La servlet est faite. Une requête à la servlet sera exécutée par une seule <literal>Session</literal> et <literal>Transaction</literal>. Comme pour une application - standalone, Hibernate peut automatiquement lier ces objets au thread courant d'ex�cution. - Cela vous laisse la libert� de s�parer votre code en couches et d'acc�der � la + standalone, Hibernate peut automatiquement lier ces objets au thread courant d'exécution. + Cela vous laisse la liberté de séparer votre code en couches et d'accéder à la <literal>SessionFactory</literal> par le moyen que vous voulez. - G�n�ralement, vous utiliserez des conceptions plus sophistiqu�es et d�placerez - le code d'acc�s aux donn�es dans une couche DAO. Voir le wiki Hibernate pour plus + Généralement, vous utiliserez des conceptions plus sophistiquées et déplacerez + le code d'accès aux données dans une couche DAO. Voir le wiki Hibernate pour plus d'exemples. </para> </sect2> <sect2 id="tutorial-webapp-deploy"> - <title>D�ployer et tester</title> + <title>Déployer et tester</title> <para> - Pour d�ployer cette application, vous devez cr�er une archive Web, un War. Ajoutez + Pour déployer cette application, vous devez créer une archive Web, un War. Ajoutez la cible Ant suivante dans votre <literal>build.xml</literal>: </para> @@ -1502,9 +1504,9 @@ </target>]]></programlisting> <para> - Cette cible cr�� un fichier nomm� <literal>hibernate-tutorial.war</literal> - dans le r�pertoire de votre projet. Elle package les biblioth�ques et le descripteur <literal>web.xml</literal> - qui est attendu dans le r�pertoire racine de votre projet: + Cette cible créé un fichier nommé <literal>hibernate-tutorial.war</literal> + dans le répertoire de votre projet. Elle package les bibliothèques et le descripteur <literal>web.xml</literal> + qui est attendu dans le répertoire racine de votre projet: </para> <programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?> @@ -1525,27 +1527,27 @@ </web-app>]]></programlisting> <para> - Avant de compiler et d�ployer l'application web, notez qu'une biblioth�que suppl�mentaire - est requise: <literal>servlet.jar</literal>. C'est le kit de d�veloppement de Servlet Java, - si vous ne disposez pas de cette biblioth�que, prenez la sur le + Avant de compiler et déployer l'application web, notez qu'une bibliothèque supplémentaire + est requise: <literal>servlet.jar</literal>. C'est le kit de développement de Servlet Java, + si vous ne disposez pas de cette bibliothèque, prenez la sur le <ulink url="http://java.sun.com/products/servlet/archive.html">site de Sun</ulink> et copiez la - dans votre r�pertoire des biblioth�ques. Cependant, elle ne sera utilis�e uniquement pour la + dans votre répertoire des bibliothèques. Cependant, elle ne sera utilisée uniquement pour la compilation et sera exclue du paackage WAR. </para> <para> - Pour construire et d�ployer, appelez <literal>ant war</literal> dans votre projet et - copier le fichier <literal>hibernate-tutorial.war</literal> dans le r�pertoire <literal>webapp</literal> de tomcat - Si vous n'avez pas install� Tomcat, t�l�chargez le et suivez la notice d'installation. - Vous n'avez pas � modifier la configuration Tomcat pour d�ployer cette application. + Pour construire et déployer, appelez <literal>ant war</literal> dans votre projet et + copier le fichier <literal>hibernate-tutorial.war</literal> dans le répertoire <literal>webapp</literal> de tomcat + Si vous n'avez pas installé Tomcat, téléchargez le et suivez la notice d'installation. + Vous n'avez pas à modifier la configuration Tomcat pour déployer cette application. </para> <para> - Une fois l'application d�ploy�e et Tomcat lanc�, acc�dez � l'application via + Une fois l'application déployée et Tomcat lancé, accédez à l'application via <literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. Assurez vous de consulter les traces tomcat pour observer l'initialisation - d'Hibernate � la premi�re requ�te touchant votre servlet (l'initialisation statique dans <literal>HibernateUtil</literal> - est invoqu�e) et pour v�rifier qu'aucune exception ne survienne. + d'Hibernate à la première requête touchant votre servlet (l'initialisation statique dans <literal>HibernateUtil</literal> + est invoquée) et pour vérifier qu'aucune exception ne survienne. </para> </sect2> @@ -1553,22 +1555,22 @@ </sect1> <sect1 id="tutorial-summary" revision="1"> - <title>R�sum�</title> + <title>Résumé</title> <para> - Ce didacticiel a couvert les bases de l'�criture d'une simple application Hibernate ainsi qu'une petite application web. + Ce didacticiel a couvert les bases de l'écriture d'une simple application Hibernate ainsi qu'une petite application web. </para> <para> - Si vous �tes d�j� confiants avec Hibernate, continuez � parcourir les sujets que vous trouvez - int�ressants � travers la table des mati�res de la documentation de r�f�rence - les plus - demand�s sont le traitement transactionnel (<xref linkend="transactions"/>), la performance - des r�cup�rations d'information (<xref linkend="performance"/>), ou l'utilisation de l'API - (<xref linkend="objectstate"/>) et les fonctionnalit�s des requ�tes (<xref linkend="objectstate-querying"/>). + Si vous êtes déjà confiants avec Hibernate, continuez à parcourir les sujets que vous trouvez + intéressants à travers la table des matières de la documentation de référence - les plus + demandés sont le traitement transactionnel (<xref linkend="transactions"/>), la performance + des récupérations d'information (<xref linkend="performance"/>), ou l'utilisation de l'API + (<xref linkend="objectstate"/>) et les fonctionnalités des requêtes (<xref linkend="objectstate-querying"/>). </para> <para> - N'oubliez pas de v�rifier le site web d'Hibernate pour d'autres didacticiels (plus sp�cialis�s). + N'oubliez pas de vérifier le site web d'Hibernate pour d'autres didacticiels (plus spécialisés). </para> </sect1> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/content/xml.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/content/xml.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/content/xml.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,50 +1,52 @@ -<?xml version="1.0" encoding="iso-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + <chapter id="xml"> <title>Mapping XML</title> <para><emphasis> - Notez que cette fonctionnalit� est exp�rimentale dans Hibernate 3.0 et - est en d�veloppement extr�mement actif. + Notez que cette fonctionnalité est expérimentale dans Hibernate 3.0 et + est en développement extrêmement actif. </emphasis></para> <sect1 id="xml-intro" revision="1"> - <title>Travailler avec des donn�es XML</title> + <title>Travailler avec des données XML</title> <para> - Hibernate vous laisse travailler avec des donn�es XML persistantes de la - m�me mani�re que vous travaillez avec des POJOs persistants. Un arbre XML - peut �tre vu comme une autre mani�re de repr�senter les donn�es relationnelles - au niveau objet, � la place des POJOs. + Hibernate vous laisse travailler avec des données XML persistantes de la + même manière que vous travaillez avec des POJOs persistants. Un arbre XML + peut être vu comme une autre manière de représenter les données relationnelles + au niveau objet, à la place des POJOs. </para> <para> Hibernate supporte dom4j en tant qu'API pour la manipulation des arbres XML. - Vous pouvez �crire des requ�tes qui r�cup�rent des arbres dom4j � partie de la - base de donn�es, et avoir toutes les modifications que vous faites sur l'arbre - automatiquement synchronis�es dans la base de donn�es. Vous pouvez m�me prendre - un document XML, l'analyser en utilisant dom4j, et l'�crire dans la base de - donn�es via les op�rations basiques d'Hibernate : + Vous pouvez écrire des requêtes qui récupèrent des arbres dom4j à partie de la + base de données, et avoir toutes les modifications que vous faites sur l'arbre + automatiquement synchronisées dans la base de données. Vous pouvez même prendre + un document XML, l'analyser en utilisant dom4j, et l'écrire dans la base de + données via les opérations basiques d'Hibernate : <literal>persist(), saveOrUpdate(), merge(), delete(), replicate()</literal> - (merge() n'est pas encore support�). + (merge() n'est pas encore supporté). </para> <para> - Cette fonctionnalit� a plusieurs applications dont l'import/export de donn�es, - l'externalisation d'entit�s via JMS ou SOAP et les rapports XSLT. + Cette fonctionnalité a plusieurs applications dont l'import/export de données, + l'externalisation d'entités via JMS ou SOAP et les rapports XSLT. </para> <para> - Un simple mapping peut �tre utilis� pour simultan�ment mapper les propri�t�s - d'une classe et les noeuds d'un document XML vers la base de donn�es, ou, - si il n'y a pas de classe � mapper, il peut �tre utilis� juste pour mapper + Un simple mapping peut être utilisé pour simultanément mapper les propriétés + d'une classe et les noeuds d'un document XML vers la base de données, ou, + si il n'y a pas de classe à mapper, il peut être utilisé juste pour mapper le XML. </para> <sect2 id="xml-intro-mapping"> - <title>Sp�cifier le mapping XML et le mapping d'une classe ensemble</title> + <title>Spécifier le mapping XML et le mapping d'une classe ensemble</title> <para> - Voici un exemple de mapping d'un POJO et du XML simultan�ment : + Voici un exemple de mapping d'un POJO et du XML simultanément : </para> <programlisting><![CDATA[<class name="Account" @@ -70,7 +72,7 @@ </sect2> <sect2 id="xml-onlyxml"> - <title>Sp�cifier seulement un mapping XML</title> + <title>Spécifier seulement un mapping XML</title> <para> Voici un exemple dans lequel il n'y a pas de class POJO : @@ -101,10 +103,10 @@ </class>]]></programlisting> <para> - Ce mapping vous permet d'acc�der aux donn�es comme un arbre dom4j, ou comme - un graphe de paire nom de propri�t�/valeur (<literal>Map</literal>s java). Les - noms des propri�t�s sont des constructions purement logiques qui peuvent �tre - r�f�r�es des dans requ�tes HQL. + Ce mapping vous permet d'accéder aux données comme un arbre dom4j, ou comme + un graphe de paire nom de propriété/valeur (<literal>Map</literal>s java). Les + noms des propriétés sont des constructions purement logiques qui peuvent être + référées des dans requêtes HQL. </para> </sect2> @@ -112,45 +114,45 @@ </sect1> <sect1 id="xml-mapping" revision="1"> - <title>M�tadonn�es du mapping XML</title> + <title>Métadonnées du mapping XML</title> <para> - Plusieurs �l�ments du mapping Hibernate acceptent l'attribut <literal>node</literal>. - Ceci vous permet de sp�cifier le nom d'un attribut XML ou d'un �l�ment qui - contient la propri�t� ou les donn�es de l'entit�. Le format de l'attribut - <literal>node</literal> doit �tre un des suivants : + Plusieurs éléments du mapping Hibernate acceptent l'attribut <literal>node</literal>. + Ceci vous permet de spécifier le nom d'un attribut XML ou d'un élément qui + contient la propriété ou les données de l'entité. Le format de l'attribut + <literal>node</literal> doit être un des suivants : </para> <itemizedlist spacing="compact"> <listitem> - <para><literal>"element-name"</literal> - mappe vers l'�l�ment XML nomm�</para> + <para><literal>"element-name"</literal> - mappe vers l'élément XML nommé</para> </listitem> <listitem> - <para><literal>"@attribute-name"</literal> - mappe vers l'attribut XML nomm�</para> + <para><literal>"@attribute-name"</literal> - mappe vers l'attribut XML nommé</para> </listitem> <listitem> - <para><literal>"."</literal> - mappe vers le parent de l'�l�ment</para> + <para><literal>"."</literal> - mappe vers le parent de l'élément</para> </listitem> <listitem> <para> <literal>"element-name/@attribute-name"</literal> - - mappe vers l'�l�ment nomm� de l'attribut nomm� + mappe vers l'élément nommé de l'attribut nommé </para> </listitem> </itemizedlist> <para> - Pour des collections et de simples associations valu�es, il y a un attribut - <literal>embed-xml</literal> suppl�mentaire. Si <literal>embed-xml="true"</literal>, - qui est la valeur par d�faut, l'arbre XML pour l'entit� associ�e (ou la collection - des types de valeurs) sera embarqu�e directement dans l'arbre XML pour l'entit� qui - poss�de l'association. Sinon, si <literal>embed-xml="false"</literal>, alors - seule la valeur de l'identifiant r�f�renc� appara�tra dans le XML pour de simples - associations de points, et les collections n'appra�tront simplement pas. + Pour des collections et de simples associations valuées, il y a un attribut + <literal>embed-xml</literal> supplémentaire. Si <literal>embed-xml="true"</literal>, + qui est la valeur par défaut, l'arbre XML pour l'entité associée (ou la collection + des types de valeurs) sera embarquée directement dans l'arbre XML pour l'entité qui + possède l'association. Sinon, si <literal>embed-xml="false"</literal>, alors + seule la valeur de l'identifiant référencé apparaîtra dans le XML pour de simples + associations de points, et les collections n'appraîtront simplement pas. </para> <para> - Vous devriez faire attention � ne pas laisser <literal>embed-xml="true"</literal> + Vous devriez faire attention à ne pas laisser <literal>embed-xml="true"</literal> pour trop d'associations, puisque XML ne traite pas bien les liens circurlaires. </para> @@ -190,14 +192,14 @@ </class>]]></programlisting> <para> - dans ce cas, nous avons d�cid� d'embarquer la collection d'identifiants de compte, - mais pas les donn�es actuelles du compte. La requ�te HQL suivante : + dans ce cas, nous avons décidé d'embarquer la collection d'identifiants de compte, + mais pas les données actuelles du compte. La requête HQL suivante : </para> <programlisting><![CDATA[from Customer c left join fetch c.accounts where c.lastName like :lastName]]></programlisting> <para> - devrait retourner l'ensemble de donn�es suivant : + devrait retourner l'ensemble de données suivant : </para> <programlisting><![CDATA[<customer id="123456789"> @@ -213,8 +215,8 @@ <para> Si vous positionnez <literal>embed-xml="true"</literal> sur le mapping - <literal>&lt;one-to-many&gt;</literal>, les donn�es pourraient - ressembler plus � �a : + <literal>&lt;one-to-many&gt;</literal>, les données pourraient + ressembler plus à ça : </para> <programlisting><![CDATA[<customer id="123456789"> @@ -238,11 +240,11 @@ <sect1 id="xml-manipulation" revision="1"> - <title>Manipuler des donn�es XML</title> + <title>Manipuler des données XML</title> <para> - Relisons et mettons � jour des documents XML dans l'application. Nous faisons - �a en obtenant une session dom4j : + Relisons et mettons à jour des documents XML dans l'application. Nous faisons + ça en obtenant une session dom4j : </para> <programlisting><![CDATA[Document doc = ....; @@ -281,9 +283,9 @@ session.close();]]></programlisting> <para> - Il est extr�mement utile de combiner cette fonctionnalit� avec l'op�ration - <literal>replicate()</literal> d'Hibernate pour impl�menter des imports/exports - de donn�es XML. + Il est extrêmement utile de combiner cette fonctionnalité avec l'opération + <literal>replicate()</literal> d'Hibernate pour implémenter des imports/exports + de données XML. </para> </sect1> Modified: core/trunk/documentation/manual/fr-FR/src/main/docbook/legal_notice.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/legal_notice.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/legal_notice.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,4 +1,4 @@ -<?xml version='1.0'?> +<?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> <!-- @@ -49,4 +49,4 @@ <para> CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E </para> -</legalnotice> \ No newline at end of file +</legalnotice> Deleted: core/trunk/documentation/manual/fr-FR/src/main/docbook/translators.xml =================================================================== --- core/trunk/documentation/manual/fr-FR/src/main/docbook/translators.xml 2007-10-19 04:15:16 UTC (rev 14113) +++ core/trunk/documentation/manual/fr-FR/src/main/docbook/translators.xml 2007-10-19 04:36:47 UTC (rev 14114) @@ -1,34 +0,0 @@ -<?xml version='1.0'?> - -<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> - -<authorgroup id="AuthorGroup"> - <othercredit class="translator"> - <firstname>Vincent</firstname> - <surname>Ricard</surname> - </othercredit> - <othercredit class="translator"> - <firstname>Sebastien</firstname> - <surname>Cesbron</surname> - </othercredit> - <othercredit class="translator"> - <firstname>Michael</firstname> - <surname>Courcy</surname> - </othercredit> - <othercredit class="translator"> - <firstname>Vincent</firstname> - <surname>Giguère</surname> - </othercredit> - <othercredit class="translator"> - <firstname>Baptiste</firstname> - <surname>Mathus</surname> - </othercredit> - <othercredit class="translator"> - <firstname>Emmanuel</firstname> - <surname>Bernard</surname> - </othercredit> - <othercredit class="translator"> - <firstname>Anthony</firstname> - <surname>Patricio</surname> - </othercredit> -</authorgroup> \ No newline at end of file