|
|
Hibernate example source code file (query_sql.po)
This example Hibernate source code file (query_sql.po) is included in the DevDaily.com
"Java Source Code
Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.
The Hibernate query_sql.po source code
# translation of query_sql.po to French
# Myriam Malga <mmalga@redhat.com>, 2007.
# Xi HUANG <xhuang@redhat.com>, 2007.
# Corina Roe <croe@redhat.com>, 2009, 2010.
# translation of Collection_Mapping.po to
msgid ""
msgstr ""
"Project-Id-Version: query_sql\n"
"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
"POT-Creation-Date: 2010-07-20 21:02+0000\n"
"PO-Revision-Date: 2010-01-05 09:47+1000\n"
"Last-Translator: Corina Roe <croe@redhat.com>\n"
"Language-Team: French <i18@redhat.com>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: KBabel 1.11.4\n"
#. Tag: title
#: query_sql.xml:31
#, no-c-format
msgid "Native SQL"
msgstr "SQL natif"
#. Tag: para
#: query_sql.xml:33
#, no-c-format
msgid ""
"You can also express queries in the native SQL dialect of your database. "
"This is useful if you want to utilize database-specific features such as "
"query hints or the <literal>CONNECT keyword in Oracle. It also "
"provides a clean migration path from a direct SQL/JDBC based application to "
"Hibernate."
msgstr ""
"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 d'Oracle. Cette fonctionnalité offre par ailleurs "
"un moyen de migration plus propre et doux d'une application basée "
"directement sur SQL/JDBC vers Hibernate. "
#. Tag: para
#: query_sql.xml:39
#, no-c-format
msgid ""
"Hibernate3 allows you to specify handwritten SQL, including stored "
"procedures, for all create, update, delete, and load operations."
msgstr ""
"Hibernate3 vous permet de spécifier du SQL écrit à la main (y compris les "
"procédures stockées) pour toutes les opérations de création, mise à jour, "
"suppression et chargement. "
#. Tag: title
#: query_sql.xml:43
#, no-c-format
msgid "Using a <literal>SQLQuery"
msgstr "Utiliser une requête <literal>SQLQuery"
#. Tag: para
#: query_sql.xml:45
#, no-c-format
msgid ""
"Execution of native SQL queries is controlled via the <literal>SQLQuerySession."
"createSQLQuery()</literal>. The following sections describe how to use this "
"API for querying."
msgstr ""
"L'exécution des requêtes en SQL natif est contrôlée par l'interface "
"<literal>SQLQuery, qui est obtenue en appelant Session."
"createSQLQuery()</literal>. Ce qui suit décrit comment utiliser cette API "
"pour les requêtes."
#. Tag: title
#: query_sql.xml:51
#, no-c-format
msgid "Scalar queries"
msgstr "Requêtes scalaires"
#. Tag: para
#: query_sql.xml:53
#, no-c-format
msgid "The most basic SQL query is to get a list of scalars (values)."
msgstr ""
"La requête SQL la plus basique permet de récupérer une liste de (valeurs) "
"scalaires."
#. Tag: programlisting
#: query_sql.xml:56
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n"
"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();"
msgstr ""
#. Tag: para
#: query_sql.xml:58
#, no-c-format
msgid ""
"These will return a List of Object arrays (Object[]) with scalar values for "
"each column in the CATS table. Hibernate will use ResultSetMetadata to "
"deduce the actual order and types of the returned scalar values."
msgstr ""
"Ces deux requêtes retourneront un tableau d'objets (Object[]) avec les "
"valeurs scalaires de chacune des colonnes de la table CATS. Hibernate "
"utilisera le ResultSetMetadata pour déduire l'ordre final et le type des "
"valeurs scalaires retournées. "
#. Tag: para
#: query_sql.xml:63
#, no-c-format
msgid ""
"To avoid the overhead of using <literal>ResultSetMetadata, or "
"simply to be more explicit in what is returned, one can use "
"<literal>addScalar():"
msgstr ""
"Pour éviter l'overhead lié à <literal>ResultSetMetadata ou "
"simplement pour être plus explicite dans ce qui est retourné, vous pouvez "
"utiliser <literal>addScalar(). "
#. Tag: programlisting
#: query_sql.xml:67
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT * FROM CATS\")\n"
" .addScalar(\"ID\", Hibernate.LONG)\n"
" .addScalar(\"NAME\", Hibernate.STRING)\n"
" .addScalar(\"BIRTHDATE\", Hibernate.DATE)"
msgstr ""
#. Tag: para
#: query_sql.xml:69 query_sql.xml:116 query_sql.xml:197 query_sql.xml:349
#, no-c-format
msgid "This query specified:"
msgstr "Cette requête spécifie :"
#. Tag: para
#: query_sql.xml:73 query_sql.xml:120 query_sql.xml:353
#, no-c-format
msgid "the SQL query string"
msgstr "la chaîne de requêtes SQL"
#. Tag: para
#: query_sql.xml:77
#, no-c-format
msgid "the columns and types to return"
msgstr "les colonnes et les types retournés"
#. Tag: para
#: query_sql.xml:81
#, no-c-format
msgid ""
"This will return Object arrays, but now it will not use "
"<literal>ResultSetMetadata but will instead explicitly get the ID, "
"NAME and BIRTHDATE column as respectively a Long, String and a Short from "
"the underlying resultset. This also means that only these three columns will "
"be returned, even though the query is using <literal>* and could "
"return more than the three listed columns."
msgstr ""
"Cela retournera toujours un tableau d'objets, mais sans utiliser le "
"<literal>ResultSetMetdata. Il récupérera à la place explicitement "
"les colonnes ID, NAME et BIRTHDATE comme étant respectivement de type Long, "
"String et Short, depuis l'ensemble de résultats sous-jacent. Cela signifie "
"aussi que seules ces trois colonnes seront retournées même si la requête "
"utilise <literal>* et pourait retourner plus que les trois "
"colonnes listées."
#. Tag: para
#: query_sql.xml:89
#, no-c-format
msgid ""
"It is possible to leave out the type information for all or some of the "
"scalars."
msgstr ""
"Il est possible de ne pas définir l'information sur le type pour toutes ou "
"une partie des scalaires."
#. Tag: programlisting
#: query_sql.xml:92
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT * FROM CATS\")\n"
" .addScalar(\"ID\", Hibernate.LONG)\n"
" .addScalar(\"NAME\")\n"
" .addScalar(\"BIRTHDATE\")"
msgstr ""
#. Tag: para
#: query_sql.xml:94
#, no-c-format
msgid ""
"This is essentially the same query as before, but now "
"<literal>ResultSetMetaData is used to determine the type of NAME "
"and BIRTHDATE, where as the type of ID is explicitly specified."
msgstr ""
"Il s'agit essentiellement de la même requête que précédemment, mais le "
"<literal>ResultSetMetaData est utilisé pour décider des types de "
"NAME et BIRTHDATE alors que le type de ID est explicitement spécifié. "
#. Tag: para
#: query_sql.xml:99
#, no-c-format
msgid ""
"How the java.sql.Types returned from ResultSetMetaData is mapped to "
"Hibernate types is controlled by the Dialect. If a specific type is not "
"mapped, or does not result in the expected type, it is possible to customize "
"it via calls to <literal>registerHibernateType in the Dialect."
msgstr ""
"Les java.sql.Types retournés par le ResultSetMetaData sont mappés aux types "
"Hibernate via le Dialect. Si un type spécifique n'est pas mappé ou est mappé "
"à un type non souhaité, il est possible de le personnaliser en invoquant "
"<literal>registerHibernateType dans le Dialect. "
#. Tag: title
#: query_sql.xml:107
#, no-c-format
msgid "Entity queries"
msgstr "Requêtes d'entités"
#. Tag: para
#: query_sql.xml:109
#, no-c-format
msgid ""
"The above queries were all about returning scalar values, basically "
"returning the \"raw\" values from the resultset. The following shows how to "
"get entity objects from a native sql query via <literal>addEntity()."
#. Tag: programlisting
#: query_sql.xml:114
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n"
"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity(Cat."
"class);"
msgstr ""
#. Tag: para
#: query_sql.xml:124
#, no-c-format
msgid "the entity returned by the query"
msgstr "L'entité retournée par la requête"
#. Tag: para
#: query_sql.xml:128
#, no-c-format
msgid ""
"Assuming that Cat is mapped as a class with the columns ID, NAME and "
"BIRTHDATE the above queries will both return a List where each element is a "
"Cat entity."
msgstr ""
"Avec Cat mappé comme classe avec les colonnes ID, NAME et BIRTHDATE, les "
"requêtes précédentes retournent toutes deux, une liste où chaque élément est "
"une entité Cat."
#. Tag: para
#: query_sql.xml:132
#, no-c-format
msgid ""
"If the entity is mapped with a <literal>many-to-one to another "
"entity it is required to also return this when performing the native query, "
"otherwise a database specific \"column not found\" error will occur. The "
"additional columns will automatically be returned when using the * notation, "
"but we prefer to be explicit as in the following example for a <literal>many-"
"to-one</literal> to a Dog:"
msgstr ""
"Si l'entité est mappée avec un <literal>many-to-one vers une autre "
"entité, il est requis de retourner aussi cette entité en exécutant la "
"requête native, sinon une erreur \"column not found\" spécifique à la base "
"de données sera soulevée. Les colonnes additionnelles seront automatiquement "
"retournées en utilisant la notation *, mais nous préférons être explicites "
"comme dans l'exemple suivant avec le <literal>many-to-one vers "
"<literal>Dog:"
#. Tag: programlisting
#: query_sql.xml:140
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS\")."
"addEntity(Cat.class);"
msgstr ""
#. Tag: para
#: query_sql.xml:142
#, no-c-format
msgid "This will allow cat.getDog() to function properly."
msgstr "Ceci permet à cat.getDog() de fonctionner normalement."
#. Tag: title
#: query_sql.xml:146
#, no-c-format
msgid "Handling associations and collections"
msgstr "Gérer les associations et collections"
#. Tag: para
#: query_sql.xml:148
#, no-c-format
msgid ""
"It is possible to eagerly join in the <literal>Dog to avoid the "
"possible extra roundtrip for initializing the proxy. This is done via the "
"<literal>addJoin() method, which allows you to join in an "
"association or collection."
msgstr ""
"Il est possible de charger agressivement <literal>Dog pour éviter "
"le chargement de proxies c'est-à-dire un aller-retour supplémentaire vers la "
"base de données. Ceci est effectué via la méthode <literal>addJoin()'s will have their "
"<literal>dog property fully initialized without any extra "
"roundtrip to the database. Notice that you added an alias name (\"cat\") to "
"be able to specify the target property path of the join. It is possible to "
"do the same eager joining for collections, e.g. if the <literal>CatDog instead."
msgstr ""
"Dans cet exemple, les <literal>Cat retournés auront leur propriété "
"<literal>dog entièrement initialisée sans aucun aller-retour "
"supplémentaire vers la base de données. Notez que nous avons ajouté un alias "
"(\"cat\") pour être capable de spécifier le chemin de la propriété cible de "
"la jointure. Il est possible de faire la même jointure agressive pour les "
"collections, par ex. si le <literal>Cat a un un-à-plusieurs vers "
"<literal>Dog. "
#. Tag: programlisting
#: query_sql.xml:163
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, D_ID, D_NAME, CAT_ID FROM "
"CATS c, DOGS d WHERE c.ID = d.CAT_ID\")\n"
" .addEntity(\"cat\", Cat.class)\n"
" .addJoin(\"cat.dogs\");"
msgstr ""
#. Tag: para
#: query_sql.xml:165
#, no-c-format
msgid ""
"At this stage you are reaching the limits of what is possible with native "
"queries, without starting to enhance the sql queries to make them usable in "
"Hibernate. Problems can arise when returning multiple entities of the same "
"type or when the default alias/column names are not enough."
msgstr ""
"À ce stade, nous arrivons aux limites de ce qui est possible avec les "
"requêtes natives sans modifier les requêtes SQL pour les rendre utilisables "
"par Hibernate; les problèmes surviennent lorsque nous essayons de retourner "
"des entités du même type ou lorsque les alias/colonnes par défaut ne sont "
"plus suffisants."
#. Tag: title
#: query_sql.xml:173
#, no-c-format
msgid "Returning multiple entities"
msgstr "Retour d'entités multiples"
#. Tag: para
#: query_sql.xml:175
#, no-c-format
msgid ""
"Until now, the result set column names are assumed to be the same as the "
"column names specified in the mapping document. This can be problematic for "
"SQL queries that join multiple tables, since the same column names can "
"appear in more than one table."
msgstr ""
"Jusqu'à présent, les colonnes de l'ensemble de résultats sont supposées être "
"les mêmes que les noms de colonnes spécifiés dans les documents de mapping. "
"Ceci peut être problématique pour les requêtes SQL qui effectuent de "
"multiples jointures vers différentes tables, puisque les mêmes colonnes "
"peuvent apparaître dans plus d'une table. "
#. Tag: para
#: query_sql.xml:180
#, no-c-format
msgid ""
"Column alias injection is needed in the following query (which most likely "
"will fail):"
msgstr ""
"L'injection d'alias de colonne est requise pour la requête suivante (qui "
"risque de ne pas fonctionner) :"
#. Tag: programlisting
#: query_sql.xml:183
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT c.*, m.* FROM CATS c, CATS m WHERE c.MOTHER_ID "
"= c.ID\")\n"
" .addEntity(\"cat\", Cat.class)\n"
" .addEntity(\"mother\", Cat.class)"
msgstr ""
#. Tag: para
#: query_sql.xml:185
#, no-c-format
msgid ""
"The query was intended to return two Cat instances per row: a cat and its "
"mother. The query will, however, fail because there is a conflict of names; "
"the instances are mapped to the same column names. Also, on some databases "
"the returned column aliases will most likely be on the form \"c.ID\", \"c."
"NAME\", etc. which are not equal to the columns specified in the mappings "
"(\"ID\" and \"NAME\")."
msgstr ""
"Le but de cette requête est de retourner deux instances de Cat par ligne, un "
"chat et sa mère. Cela échouera puisqu'il y a conflit de noms puisqu'ils sont "
"mappés au même nom de colonne et que sur certaines base de données, les "
"alias de colonnes retournés seront plutôt de la forme \"c.ID\", \"c.NAME\", "
"etc. qui ne sont pas égaux aux colonnes spécifiées dans les mappings (\"ID\" "
"et \"NAME\"). "
#. Tag: para
#: query_sql.xml:192
#, no-c-format
msgid "The following form is not vulnerable to column name duplication:"
msgstr ""
"La forme suivante n'est pas vulnérable à la duplication des noms de "
"colonnes :"
#. Tag: programlisting
#: query_sql.xml:195
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT {cat.*}, {mother.*} FROM CATS c, CATS m WHERE "
"c.MOTHER_ID = c.ID\")\n"
" .addEntity(\"cat\", Cat.class)\n"
" .addEntity(\"mother\", Cat.class)"
msgstr ""
#. Tag: para
#: query_sql.xml:201
#, no-c-format
msgid ""
"the SQL query string, with placeholders for Hibernate to inject column "
"aliases"
msgstr ""
"la requête SQL, avec des réceptacles pour que Hibernate injecte les alias de "
"colonnes"
#. Tag: para
#: query_sql.xml:206
#, no-c-format
msgid "the entities returned by the query"
msgstr "les entités retournées par la requête"
#. Tag: para
#: query_sql.xml:210
#, no-c-format
msgid ""
"The {cat.*} and {mother.*} notation used above is a shorthand for \"all "
"properties\". Alternatively, you can list the columns explicitly, but even "
"in this case Hibernate injects the SQL column aliases for each property. The "
"placeholder for a column alias is just the property name qualified by the "
"table alias. In the following example, you retrieve Cats and their mothers "
"from a different table (cat_log) to the one declared in the mapping "
"metadata. You can even use the property aliases in the where clause."
msgstr ""
"Les notations {cat.*} et {mother.*} utilisées ci-dessus sont un équivalent à "
"'toutes les propriétés'. Alternativement, vous pouvez lister les colonnes "
"explicitement, mais même dans ce cas, nous laissons Hibernate injecter les "
"alias de colonne pour chaque propriété. Le paramètre fictif pour un alias de "
"colonne est simplement le nom de la propriété qualifié par l'alias de la "
"table. Dans l'exemple suivant, nous récupérons les Cats et leur mère depuis "
"une table différente (cat_log) de celle déclarée dans les mappages. Notez "
"que nous pouvons aussi utiliser les alias de propriété dans la clause where "
"si désiré. "
#. Tag: programlisting
#: query_sql.xml:219
#, no-c-format
msgid ""
"String sql = \"SELECT ID as {c.id}, NAME as {c.name}, \" +\n"
" \"BIRTHDATE as {c.birthDate}, MOTHER_ID as {c.mother}, {mother.*} "
"\" +\n"
" \"FROM CAT_LOG c, CAT_LOG m WHERE {c.mother} = c.ID\";\n"
"\n"
"List loggedCats = sess.createSQLQuery(sql)\n"
" .addEntity(\"cat\", Cat.class)\n"
" .addEntity(\"mother\", Cat.class).list()"
msgstr ""
#. Tag: title
#: query_sql.xml:222
#, no-c-format
msgid "Alias and property references"
msgstr "Références d'alias et de propriété"
#. Tag: para
#: query_sql.xml:224
#, no-c-format
msgid ""
"In most cases the above alias injection is needed. For queries relating to "
"more complex mappings, like composite properties, inheritance "
"discriminators, collections etc., you can use specific aliases that allow "
"Hibernate to inject the proper aliases."
msgstr ""
"Pour la plupart des cas précédents, l'injection d'alias est requise, mais "
"pour les requêtes relatives à des mappings plus complexes, comme les "
"propriétés composites, les discriminants d'héritage, les collections etc., "
"il y a des alias spécifiques à utiliser pour permettre à Hibernate "
"l'injection des alias appropriés. "
#. Tag: para
#: query_sql.xml:229
#, no-c-format
msgid ""
"The following table shows the different ways you can use the alias "
"injection. Please note that the alias names in the result are simply "
"examples; each alias will have a unique and probably different name when "
"used."
msgstr ""
"Le tableau suivant montre les diverses possibilités d'utilisation "
"d'injection d'alias. Note : les noms d'alias dans le résultat sont des "
"exemples, chaque alias aura un nom unique et probablement différent "
"lorsqu'ils seront utilisés. "
#. Tag: title
#: query_sql.xml:235
#, no-c-format
msgid "Alias injection names"
msgstr "Nom d'injection d'alias"
#. Tag: entry
#: query_sql.xml:246
#, no-c-format
msgid "Description"
msgstr "Description"
#. Tag: entry
#: query_sql.xml:248
#, no-c-format
msgid "Syntax"
msgstr "Syntaxe"
#. Tag: entry
#: query_sql.xml:250
#, no-c-format
msgid "Example"
msgstr "Exemple"
#. Tag: entry
#: query_sql.xml:256
#, no-c-format
msgid "A simple property"
msgstr "Une propriété simple"
#. Tag: literal
#: query_sql.xml:258
#, fuzzy, no-c-format
msgid "{[aliasname].[propertyname]"
msgstr "<literal>{[aliasname].[propertyname]"
#. Tag: literal
#: query_sql.xml:260
#, fuzzy, no-c-format
msgid "A_NAME as {item.name}"
msgstr "<literal>A_NAME as {item.name}"
#. Tag: entry
#: query_sql.xml:264
#, no-c-format
msgid "A composite property"
msgstr "Une propriété composite"
#. Tag: literal
#: query_sql.xml:266
#, fuzzy, no-c-format
msgid "{[aliasname].[componentname].[propertyname]}"
msgstr "<literal>{[aliasname].[componentname].[propertyname]}"
#. Tag: literal
#: query_sql.xml:268
#, fuzzy, no-c-format
msgid "CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}"
msgstr ""
"<literal>CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}"
#. Tag: literal
#: query_sql.xml:277
#, fuzzy, no-c-format
msgid "DISC as {item.class}"
msgstr "<literal>DISC as {item.class}"
#. Tag: entry
#: query_sql.xml:281
#, no-c-format
msgid "All properties of an entity"
msgstr "Toutes les propriétés d'une entité"
#. Tag: literal
#: query_sql.xml:283 query_sql.xml:331
#, fuzzy, no-c-format
msgid "{[aliasname].*}"
msgstr "<literal>{[aliasname].*}"
#. Tag: literal
#: query_sql.xml:285
#, no-c-format
msgid "{item.*}"
msgstr ""
#. Tag: entry
#: query_sql.xml:289
#, no-c-format
msgid "A collection key"
msgstr "La clé d'une collection"
#. Tag: literal
#: query_sql.xml:291
#, fuzzy, no-c-format
msgid "{[aliasname].key}"
msgstr "<literal>{[aliasname].key}"
#. Tag: literal
#: query_sql.xml:293
#, fuzzy, no-c-format
msgid "ORGID as {coll.key}"
msgstr "<literal>ORGID as {coll.key}"
#. Tag: entry
#: query_sql.xml:297
#, no-c-format
msgid "The id of an collection"
msgstr "L'id d'une collection"
#. Tag: literal
#: query_sql.xml:299
#, fuzzy, no-c-format
msgid "{[aliasname].id}"
msgstr "<literal>{[aliasname].id}"
#. Tag: literal
#: query_sql.xml:301
#, fuzzy, no-c-format
msgid "EMPID as {coll.id}"
msgstr "<literal>EMPID as {coll.id}"
#. Tag: entry
#: query_sql.xml:305
#, no-c-format
msgid "The element of an collection"
msgstr "L'élément d'une collection"
#. Tag: literal
#: query_sql.xml:307
#, fuzzy, no-c-format
msgid "{[aliasname].element}"
msgstr "<literal>{[aliasname].element}"
#. Tag: literal
#: query_sql.xml:309
#, fuzzy, no-c-format
msgid "XID as {coll.element}"
msgstr "<literal>XID as {coll.element}"
#. Tag: entry
#: query_sql.xml:313
#, no-c-format
msgid "property of the element in the collection"
msgstr "Propriété de l'élément dans une collection "
#. Tag: literal
#: query_sql.xml:315
#, fuzzy, no-c-format
msgid "{[aliasname].element.[propertyname]}"
msgstr "<literal>{[aliasname].element.[propertyname]}"
#. Tag: literal
#: query_sql.xml:317
#, fuzzy, no-c-format
msgid "NAME as {coll.element.name}"
msgstr "<literal>XID as {coll.element}"
#. Tag: entry
#: query_sql.xml:321
#, no-c-format
msgid "All properties of the element in the collection"
msgstr "Toutes les propriétés d'un élément dans la collection"
#. Tag: literal
#: query_sql.xml:323
#, fuzzy, no-c-format
msgid "{[aliasname].element.*}"
msgstr "<literal>{[aliasname].element.*}"
#. Tag: literal
#: query_sql.xml:325
#, fuzzy, no-c-format
msgid "{coll.element.*}"
msgstr "<literal>{coll.element.*}"
#. Tag: entry
#: query_sql.xml:329
#, fuzzy, no-c-format
msgid "All properties of the collection"
msgstr "Toutes les propriétés d'une collection"
#. Tag: literal
#: query_sql.xml:333
#, fuzzy, no-c-format
msgid "{coll.*}"
msgstr "<literal>{coll.element.*}"
#. Tag: title
#: query_sql.xml:342
#, no-c-format
msgid "Returning non-managed entities"
msgstr "Retour d'entités non gérées"
#. Tag: para
#: query_sql.xml:344
#, no-c-format
msgid ""
"It is possible to apply a ResultTransformer to native SQL queries, allowing "
"it to return non-managed entities."
msgstr ""
"Il est possible d'appliquer un ResultTransformer à une requête native SQL. "
"Ce qui permet, par exemple, de retourner des entités non gérées. "
#. Tag: programlisting
#: query_sql.xml:347
#, no-c-format
msgid ""
"sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n"
" .setResultTransformer(Transformers.aliasToBean(CatDTO.class))"
msgstr ""
#. Tag: para
#: query_sql.xml:357
#, no-c-format
msgid "a result transformer"
msgstr "un transformateur de résultat"
#. Tag: para
#: query_sql.xml:361
#, no-c-format
msgid ""
"The above query will return a list of <literal>CatDTO which has "
"been instantiated and injected the values of NAME and BIRTHNAME into its "
"corresponding properties or fields."
msgstr ""
"La requête précédente retournera la liste de <literal>CatDTO qui "
"ont été instanciés et dans lesquels les valeurs de NAME et BIRTHNAME auront "
"été injectées dans leurs propriétés ou champs correspondants."
#. Tag: title
#: query_sql.xml:367
#, no-c-format
msgid "Handling inheritance"
msgstr "Gérer l'héritage"
#. Tag: para
#: query_sql.xml:369
#, no-c-format
msgid ""
"Native SQL queries which query for entities that are mapped as part of an "
"inheritance must include all properties for the baseclass and all its "
"subclasses."
msgstr ""
"Les requêtes natives SQL qui interrogent des entités mappées en tant que "
"part d'un héritage doivent inclure toutes les propriétés de la classe de "
"base et de toutes ses sous classes. "
#. Tag: title
#: query_sql.xml:375
#, no-c-format
msgid "Parameters"
msgstr "Paramètres"
#. Tag: para
#: query_sql.xml:377
#, no-c-format
msgid "Native SQL queries support positional as well as named parameters:"
msgstr ""
"Les requêtes natives SQL supportent aussi bien les paramètres de position "
"que les paramètres nommés : "
#. Tag: programlisting
#: query_sql.xml:380
#, no-c-format
msgid ""
"Query query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like ?\")."
"addEntity(Cat.class);\n"
"List pusList = query.setString(0, \"Pus%\").list();\n"
" \n"
"query = sess.createSQLQuery(\"SELECT * FROM CATS WHERE NAME like :name\")."
"addEntity(Cat.class);\n"
"List pusList = query.setString(\"name\", \"Pus%\").list();"
msgstr ""
#. Tag: title
#: query_sql.xml:385
#, no-c-format
msgid "Named SQL queries"
msgstr "Requêtes SQL nommées"
#. Tag: para
#: query_sql.xml:387
#, fuzzy, no-c-format
msgid ""
"Named SQL queries can also be defined in the mapping document and called in "
"exactly the same way as a named HQL query (see <xref linkend=\"objectstate-"
"querying-executing-named\"/>). In this case, you do <emphasis>not "
"need to call <literal>addEntity()."
msgstr ""
"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'une requête HQL nommée. Dans ce "
"cas, nous <emphasis>n'avons pas besoin d'appeler "
"<literal>addEntity(). "
#. Tag: title
#: query_sql.xml:394
#, no-c-format
msgid "Named sql query using the <sql-query> maping element"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:397
#, no-c-format
msgid ""
"<sql-query name=\"persons\">\n"
" <return alias=\"person\" class=\"eg.Person\"/>\n"
" SELECT person.NAME AS {person.name},\n"
" person.AGE AS {person.age},\n"
" person.SEX AS {person.sex}\n"
" FROM PERSON person\n"
" WHERE person.NAME LIKE :namePattern\n"
"</sql-query>"
msgstr ""
#. Tag: title
#: query_sql.xml:401
#, no-c-format
msgid "Execution of a named query"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:403
#, no-c-format
msgid ""
"List people = sess.getNamedQuery(\"persons\")\n"
" .setString(\"namePattern\", namePattern)\n"
" .setMaxResults(50)\n"
" .list();"
msgstr ""
#. Tag: para
#: query_sql.xml:406
#, no-c-format
msgid ""
"The <literal><return-join> element is use to join "
"associations and the <literal><load-collection> element is "
"used to define queries which initialize collections,"
msgstr ""
"Les éléments <literal><return-join> et <load-"
"collection></literal> sont respectivement utilisés pour lier des "
"associations et définir des requêtes qui initialisent des collections,"
#. Tag: title
#: query_sql.xml:411
#, no-c-format
msgid "Named sql query with association"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:413
#, no-c-format
msgid ""
"<sql-query name=\"personsWith\">\n"
" <return alias=\"person\" class=\"eg.Person\"/>\n"
" <return-join alias=\"address\" property=\"person.mailingAddress\"/"
">\n"
" SELECT person.NAME AS {person.name},\n"
" person.AGE AS {person.age},\n"
" person.SEX AS {person.sex},\n"
" address.STREET AS {address.street},\n"
" address.CITY AS {address.city},\n"
" address.STATE AS {address.state},\n"
" address.ZIP AS {address.zip}\n"
" FROM PERSON person\n"
" JOIN ADDRESS address\n"
" ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n"
" WHERE person.NAME LIKE :namePattern\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:416
#, no-c-format
msgid ""
"A named SQL query may return a scalar value. You must declare the column "
"alias and Hibernate type using the <literal><return-scalar> "
"element:"
msgstr ""
"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><return-scalar> :"
#. Tag: title
#: query_sql.xml:421
#, no-c-format
msgid "Named query returning a scalar"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:423
#, no-c-format
msgid ""
"<sql-query name=\"mySqlQuery\">\n"
" <return-scalar column=\"name\" type=\"string\"/>\n"
" <return-scalar column=\"age\" type=\"long\"/>\n"
" SELECT p.NAME AS name, \n"
" p.AGE AS age,\n"
" FROM PERSON p WHERE p.NAME LIKE 'Hiber%'\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:426
#, no-c-format
msgid ""
"You can externalize the resultset mapping information in a <literal><"
"resultset></literal> element which will allow you to either reuse them "
"across several named queries or through the <literal>setResultSetMapping() pour soit les réutiliser dans "
"différentes requêtes nommées, soit à travers l'API "
"<literal>setResultSetMapping(). "
#. Tag: title
#: query_sql.xml:432
#, no-c-format
msgid "<resultset> mapping used to externalize mapping information"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:435
#, no-c-format
msgid ""
"<resultset name=\"personAddress\">\n"
" <return alias=\"person\" class=\"eg.Person\"/>\n"
" <return-join alias=\"address\" property=\"person.mailingAddress\"/"
">\n"
"</resultset>\n"
"\n"
"<sql-query name=\"personsWith\" resultset-ref=\"personAddress\">\n"
" SELECT person.NAME AS {person.name},\n"
" person.AGE AS {person.age},\n"
" person.SEX AS {person.sex},\n"
" address.STREET AS {address.street},\n"
" address.CITY AS {address.city},\n"
" address.STATE AS {address.state},\n"
" address.ZIP AS {address.zip}\n"
" FROM PERSON person\n"
" JOIN ADDRESS address\n"
" ON person.ID = address.PERSON_ID AND address.TYPE='MAILING'\n"
" WHERE person.NAME LIKE :namePattern\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:438
#, no-c-format
msgid ""
"You can, alternatively, use the resultset mapping information in your hbm "
"files directly in java code."
msgstr ""
"Vous pouvez également utiliser les informations de mapping de l'ensemble de "
"résultats dans vos fichiers hbm directement dans le code java. "
#. Tag: title
#: query_sql.xml:442
#, no-c-format
msgid "Programmatically specifying the result mapping information"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:445
#, no-c-format
msgid ""
"List cats = sess.createSQLQuery(\n"
" \"select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten."
"mother = cat.id\"\n"
" )\n"
" .setResultSetMapping(\"catAndKitten\")\n"
" .list();"
msgstr ""
#. Tag: para
#: query_sql.xml:448
#, no-c-format
msgid ""
"So far we have only looked at externalizing SQL queries using Hibernate "
"mapping files. The same concept is also available with anntations and is "
"called named native queries. You can use <classname>@NamedNativeQuery@NamedNativeQueries) in conjunction with "
"<literal>@SqlResultSetMapping (@SqlResultSetMappings@NamedQuery, "
"<classname>@NamedNativeQuery and @SqlResultSetMapping parameter is defined in "
"<literal>@NamedNativeQuery. It represents the name of a defined "
"<literal>@SqlResultSetMapping. The resultset mapping declares the "
"entities retrieved by this native query. Each field of the entity is bound "
"to an SQL alias (or column name). All fields of the entity including the "
"ones of subclasses and the foreign key columns of related entities have to "
"be present in the SQL query. Field definitions are optional provided that "
"they map to the same column name as the one declared on the class property. "
"In the example 2 entities, <literal>Night and Area element should be used for each "
"foreign key column. The <literal>@FieldResult name is composed of "
"the property name for the relationship, followed by a dot (\".\"), followed "
"by the name or the field or property of the primary key. This can be seen in "
"<xref linkend=\"example-field-result-annotation-with-associations\"/>."
msgstr ""
#. Tag: title
#: query_sql.xml:490
#, no-c-format
msgid ""
"Named SQL query using <classname>@NamedNativeQuery together with "
"<classname>@SqlResultSetMapping"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:493
#, no-c-format
msgid ""
"@NamedNativeQuery(name=\"night&area\", query=\"select night.id nid, "
"night.night_duration, \"\n"
" + \" night.night_date, area.id aid, night.area_id, area.name \"\n"
" + \"from Night night, Area area where night.area_id = area.id\", \n"
" resultSetMapping=\"joinMapping\")\n"
"@SqlResultSetMapping(name=\"joinMapping\", entities={\n"
" @EntityResult(entityClass=Night.class, fields = {\n"
" @FieldResult(name=\"id\", column=\"nid\"),\n"
" @FieldResult(name=\"duration\", column=\"night_duration\"),\n"
" @FieldResult(name=\"date\", column=\"night_date\"),\n"
" @FieldResult(name=\"area\", column=\"area_id\"),\n"
" discriminatorColumn=\"disc\"\n"
" }),\n"
" @EntityResult(entityClass=org.hibernate.test.annotations.query.Area."
"class, fields = {\n"
" @FieldResult(name=\"id\", column=\"aid\"),\n"
" @FieldResult(name=\"name\", column=\"name\")\n"
" })\n"
" }\n"
")"
msgstr ""
#. Tag: title
#: query_sql.xml:497
#, no-c-format
msgid "Implicit result set mapping"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:499
#, no-c-format
msgid ""
"@Entity\n"
"@SqlResultSetMapping(name=\"implicit\",\n"
" entities=@EntityResult(entityClass=SpaceShip.class))\n"
"@NamedNativeQuery(name=\"implicitSample\", \n"
" query=\"select * from SpaceShip\", \n"
" resultSetMapping=\"implicit\")\n"
"public class SpaceShip {\n"
" private String name;\n"
" private String model;\n"
" private double speed;\n"
"\n"
" @Id\n"
" public String getName() {\n"
" return name;\n"
" }\n"
"\n"
" public void setName(String name) {\n"
" this.name = name;\n"
" }\n"
"\n"
" @Column(name=\"model_txt\")\n"
" public String getModel() {\n"
" return model;\n"
" }\n"
"\n"
" public void setModel(String model) {\n"
" this.model = model;\n"
" }\n"
"\n"
" public double getSpeed() {\n"
" return speed;\n"
" }\n"
"\n"
" public void setSpeed(double speed) {\n"
" this.speed = speed;\n"
" }\n"
"}"
msgstr ""
#. Tag: title
#: query_sql.xml:503
#, no-c-format
msgid "Using dot notation in @FieldResult for specifying associations"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:506
#, no-c-format
msgid ""
"@Entity\n"
"@SqlResultSetMapping(name=\"compositekey\",\n"
" entities=@EntityResult(entityClass=SpaceShip.class,\n"
" fields = {\n"
" @FieldResult(name=\"name\", column = \"name\"),\n"
" @FieldResult(name=\"model\", column = \"model\"),\n"
" @FieldResult(name=\"speed\", column = \"speed\"),\n"
" @FieldResult(name=\"captain.firstname\", column = "
"\"firstn\"),\n"
" @FieldResult(name=\"captain.lastname\", column = \"lastn"
"\"),\n"
" @FieldResult(name=\"dimensions.length\", column = "
"\"length\"),\n"
" @FieldResult(name=\"dimensions.width\", column = \"width"
"\")\n"
" }),\n"
" columns = { @ColumnResult(name = \"surface\"),\n"
" @ColumnResult(name = \"volume\") } )\n"
"\n"
"@NamedNativeQuery(name=\"compositekey\",\n"
" query=\"select name, model, speed, lname as lastn, fname as firstn, "
"length, width, length * width as surface from SpaceShip\", \n"
" resultSetMapping=\"compositekey\")\n"
"} )\n"
"public class SpaceShip {\n"
" private String name;\n"
" private String model;\n"
" private double speed;\n"
" private Captain captain;\n"
" private Dimensions dimensions;\n"
"\n"
" @Id\n"
" public String getName() {\n"
" return name;\n"
" }\n"
"\n"
" public void setName(String name) {\n"
" this.name = name;\n"
" }\n"
"\n"
" @ManyToOne(fetch= FetchType.LAZY)\n"
" @JoinColumns( {\n"
" @JoinColumn(name=\"fname\", referencedColumnName = \"firstname"
"\"),\n"
" @JoinColumn(name=\"lname\", referencedColumnName = \"lastname"
"\")\n"
" } )\n"
" public Captain getCaptain() {\n"
" return captain;\n"
" }\n"
"\n"
" public void setCaptain(Captain captain) {\n"
" this.captain = captain;\n"
" }\n"
"\n"
" public String getModel() {\n"
" return model;\n"
" }\n"
"\n"
" public void setModel(String model) {\n"
" this.model = model;\n"
" }\n"
"\n"
" public double getSpeed() {\n"
" return speed;\n"
" }\n"
"\n"
" public void setSpeed(double speed) {\n"
" this.speed = speed;\n"
" }\n"
"\n"
" public Dimensions getDimensions() {\n"
" return dimensions;\n"
" }\n"
"\n"
" public void setDimensions(Dimensions dimensions) {\n"
" this.dimensions = dimensions;\n"
" }\n"
"}\n"
"\n"
"@Entity\n"
"@IdClass(Identity.class)\n"
"public class Captain implements Serializable {\n"
" private String firstname;\n"
" private String lastname;\n"
"\n"
" @Id\n"
" public String getFirstname() {\n"
" return firstname;\n"
" }\n"
"\n"
" public void setFirstname(String firstname) {\n"
" this.firstname = firstname;\n"
" }\n"
"\n"
" @Id\n"
" public String getLastname() {\n"
" return lastname;\n"
" }\n"
"\n"
" public void setLastname(String lastname) {\n"
" this.lastname = lastname;\n"
" }\n"
"}"
msgstr ""
#. Tag: para
#: query_sql.xml:510
#, no-c-format
msgid ""
"If you retrieve a single entity using the default mapping, you can specify "
"the <literal>resultClass attribute instead of "
"<literal>resultSetMapping:"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:514
#, no-c-format
msgid ""
"@NamedNativeQuery(name=\"implicitSample\", query=\"select * from SpaceShip"
"\", resultClass=SpaceShip.class)\n"
"public class SpaceShip {"
msgstr ""
#. Tag: para
#: query_sql.xml:517
#, no-c-format
msgid ""
"In some of your native queries, you'll have to return scalar values, for "
"example when building report queries. You can map them in the "
"<literal>@SqlResultsetMapping through @ColumnResult"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:527
#, no-c-format
msgid ""
"@SqlResultSetMapping(name=\"scalar\", columns=@ColumnResult(name=\"dimension"
"\"))\n"
"@NamedNativeQuery(name=\"scalar\", query=\"select length*width as dimension "
"from SpaceShip\", resultSetMapping=\"scalar\")"
msgstr ""
#. Tag: para
#: query_sql.xml:530
#, no-c-format
msgid ""
"An other query hint specific to native queries has been introduced: "
"<literal>org.hibernate.callable which can be true or false "
"depending on whether the query is a stored procedure or not."
msgstr ""
#. Tag: title
#: query_sql.xml:535
#, no-c-format
msgid "Using return-property to explicitly specify column/alias names"
msgstr ""
"Utilisation de return-property pour spécifier explicitement les noms des "
"colonnes/alias"
#. Tag: para
#: query_sql.xml:538
#, no-c-format
msgid ""
"You can explicitly tell Hibernate what column aliases to use with "
"<literal><return-property>, instead of using the {}"
"</literal>-syntax to let Hibernate inject its own aliases.For example:"
msgstr ""
"Avec <literal><return-property> vous pouvez explicitement "
"dire à Hibernate quels alias de colonne utiliser, plutôt que d'employer la "
"syntaxe <literal>{} pour laisser Hibernate injecter ses propres "
"alias. Par exemple :"
#. Tag: programlisting
#: query_sql.xml:543
#, no-c-format
msgid ""
"<sql-query name=\"mySqlQuery\">\n"
" <return alias=\"person\" class=\"eg.Person\">\n"
" <return-property name=\"name\" column=\"myName\"/>\n"
" <return-property name=\"age\" column=\"myAge\"/>\n"
" <return-property name=\"sex\" column=\"mySex\"/>\n"
" </return>\n"
" SELECT person.NAME AS myName,\n"
" person.AGE AS myAge,\n"
" person.SEX AS mySex,\n"
" FROM PERSON person WHERE person.NAME LIKE :name\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:545
#, no-c-format
msgid ""
"<literal><return-property> also works with multiple columns. "
"This solves a limitation with the <literal>{}-syntax which cannot "
"allow fine grained control of multi-column properties."
msgstr ""
"<literal><return-property> fonctionne aussi avec de "
"multiples colonnes. Cela résout une limitation de la syntaxe <literal>{} was used in "
"combination with the <literal>{}-syntax for injection. This allows "
"users to choose how they want to refer column and properties."
msgstr ""
"Notez que dans cet exemple nous avons utilisé <literal><return-"
"property></literal> en combinaison avec la syntaxe {} "
"pour l'injection. Cela autorise les utilisateurs à choisir comment ils "
"veulent référencer les colonnes et les propriétés. "
#. Tag: para
#: query_sql.xml:557
#, no-c-format
msgid ""
"If your mapping has a discriminator you must use <literal><return-"
"discriminator></literal> to specify the discriminator column."
msgstr ""
"Si votre mapping a un discriminant vous devez utiliser <literal><return-"
"discriminator></literal> pour spécifier la colonne discriminante."
#. Tag: title
#: query_sql.xml:563
#, no-c-format
msgid "Using stored procedures for querying"
msgstr "Utilisation de procédures stockées pour les requêtes"
#. Tag: para
#: query_sql.xml:565
#, no-c-format
msgid ""
"Hibernate3 provides support for queries via stored procedures and functions. "
"Most of the following documentation is equivalent for both. The stored "
"procedure/function must return a resultset as the first out-parameter to be "
"able to work with Hibernate. An example of such a stored function in Oracle "
"9 and higher is as follows:"
msgstr ""
"Hibernate 3 introduit le support des requêtes via les procédures stockées et "
"les fonctions. La documentation suivante est valable pour les deux. Les "
"procédures stockées/fonctions doivent retourner un ensemble de résultats en "
"tant que premier paramètre sortant (out-parameter\") pour être capable de "
"fonctionner avec Hibernate. Voici un exemple d'une telle procédure stockée "
"en Oracle 9 et version supérieure : "
#. Tag: programlisting
#: query_sql.xml:571
#, no-c-format
msgid ""
"CREATE OR REPLACE FUNCTION selectAllEmployments\n"
" RETURN SYS_REFCURSOR\n"
"AS\n"
" st_cursor SYS_REFCURSOR;\n"
"BEGIN\n"
" OPEN st_cursor FOR\n"
" SELECT EMPLOYEE, EMPLOYER,\n"
" STARTDATE, ENDDATE,\n"
" REGIONCODE, EID, VALUE, CURRENCY\n"
" FROM EMPLOYMENT;\n"
" RETURN st_cursor;\n"
" END;"
msgstr ""
#. Tag: para
#: query_sql.xml:573
#, no-c-format
msgid "To use this query in Hibernate you need to map it via a named query."
msgstr ""
"Pour utiliser cette requête dans Hibernate vous avez besoin de la mapper via "
"une requête nommée."
#. Tag: programlisting
#: query_sql.xml:576
#, no-c-format
msgid ""
"<sql-query name=\"selectAllEmployees_SP\" callable=\"true\">\n"
" <return alias=\"emp\" class=\"Employment\">\n"
" <return-property name=\"employee\" column=\"EMPLOYEE\"/>\n"
" <return-property name=\"employer\" column=\"EMPLOYER\"/>\n"
" <return-property name=\"startDate\" column=\"STARTDATE\"/>\n"
" <return-property name=\"endDate\" column=\"ENDDATE\"/>\n"
" <return-property name=\"regionCode\" column=\"REGIONCODE\"/>\n"
" <return-property name=\"id\" column=\"EID\"/>\n"
" <return-property name=\"salary\">\n"
" <return-column name=\"VALUE\"/>\n"
" <return-column name=\"CURRENCY\"/>\n"
" </return-property>\n"
" </return>\n"
" { ? = call selectAllEmployments() }\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:578
#, no-c-format
msgid ""
"Stored procedures currently only return scalars and entities. <literal><"
"return-join></literal> and <load-collection> are "
"not supported."
msgstr ""
"Notez que les procédures stockées ne retournent, pour le moment, que des "
"scalaires et des entités. <literal><return-join> et "
"<literal><load-collection> ne sont pas supportés. "
#. Tag: title
#: query_sql.xml:583
#, no-c-format
msgid "Rules/limitations for using stored procedures"
msgstr "Règles/limitations lors de l'utilisation des procédures stockées"
#. Tag: para
#: query_sql.xml:585
#, no-c-format
msgid ""
"You cannot use stored procedures with Hibernate unless you follow some "
"procedure/function rules. If they do not follow those rules they are not "
"usable with Hibernate. If you still want to use these procedures you have to "
"execute them via <literal>session.connection(). The rules are "
"different for each database, since database vendors have different stored "
"procedure semantics/syntax."
msgstr ""
"Pour 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 néanmoins, vous désirez utiliser ces "
"procédures vous devez les exécuter via <literal>session.connection(). "
#. Tag: para
#: query_sql.xml:596
#, no-c-format
msgid ""
"The recommended call form is standard SQL92: <literal>{ ? = call functionName"
"(<parameters>) }</literal> or { ? = call procedureName(<"
"parameters>}</literal>. Native call syntax is not supported."
msgstr ""
"La forme d'appel recommandée est le SQL92 standard : <literal>{ ? = call "
"functionName(<parameters>) }</literal> or { ? = call "
"procedureName(<parameters>}</literal>. La syntaxe d'appel native n'est "
"pas supportée."
#. Tag: para
#: query_sql.xml:601
#, no-c-format
msgid "For Oracle the following rules apply:"
msgstr "Pour Oracle les règles suivantes sont applicables :"
#. Tag: para
#: query_sql.xml:605
#, no-c-format
msgid ""
"A function must return a result set. The first parameter of a procedure must "
"be an <literal>OUT that returns a result set. This is done by "
"using a <literal>SYS_REFCURSOR type in Oracle 9 or 10. In Oracle "
"you need to define a <literal>REF CURSOR type. See Oracle "
"literature for further information."
msgstr ""
"La procédure doit retourner un ensemble de résultats. Le premier paramètre "
"d'une procédure doit être un <literal>OUT qui retourne un ensemble "
"de résultats. Ceci est effectué en retournant un <literal>SYS_REFCURSOR, consultez la documentation Oracle. "
#. Tag: para
#: query_sql.xml:614
#, no-c-format
msgid "For Sybase or MS SQL server the following rules apply:"
msgstr "Pour Sybase ou MS SQL server les règles suivantes sont applicables :"
#. Tag: para
#: query_sql.xml:618
#, no-c-format
msgid ""
"The procedure must return a result set. Note that since these servers can "
"return multiple result sets and update counts, Hibernate will iterate the "
"results and take the first result that is a result set as its return value. "
"Everything else will be discarded."
msgstr ""
"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ésultats comme valeur de retour. Tout le "
"reste sera ignoré. "
#. Tag: para
#: query_sql.xml:626
#, no-c-format
msgid ""
"If you can enable <literal>SET NOCOUNT ON in your procedure it "
"will probably be more efficient, but this is not a requirement."
msgstr ""
"Si vous pouvez activer <literal>SET NOCOUNT ON dans votre "
"procédure, elle sera probablement plus efficace, mais ce n'est pas une "
"obligation."
#. Tag: title
#: query_sql.xml:636
#, no-c-format
msgid "Custom SQL for create, update and delete"
msgstr "SQL personnalisé pour créer, mettre à jour et effacer"
#. Tag: para
#: query_sql.xml:638
#, no-c-format
msgid ""
"Hibernate3 can use custom SQL for create, update, and delete operations. The "
"SQL can be overridden at the statement level or inidividual column level. "
"This section describes statement overrides. For columns, see <xref linkend="
"\"mapping-column-read-and-write\"/>. <xref linkend=\"example-custom-crdu-via-"
"annotations\"/> shows how to define custom SQL operatons using annotations."
msgstr ""
#. Tag: title
#: query_sql.xml:646
#, no-c-format
msgid "Custom CRUD via annotations"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:648
#, no-c-format
msgid ""
"@Entity\n"
"@Table(name=\"CHAOS\")\n"
"@SQLInsert( sql=\"INSERT INTO CHAOS(size, name, nickname, id) VALUES(?,upper"
"(?),?,?)\")\n"
"@SQLUpdate( sql=\"UPDATE CHAOS SET size = ?, name = upper(?), nickname = ? "
"WHERE id = ?\")\n"
"@SQLDelete( sql=\"DELETE CHAOS WHERE id = ?\")\n"
"@SQLDeleteAll( sql=\"DELETE CHAOS\")\n"
"@Loader(namedQuery = \"chaos\")\n"
"@NamedNativeQuery(name=\"chaos\", query=\"select id, size, name, lower"
"( nickname ) as nickname from CHAOS where id= ?\", resultClass = Chaos."
"class)\n"
"public class Chaos {\n"
" @Id\n"
" private Long id;\n"
" private Long size;\n"
" private String name;\n"
" private String nickname;"
msgstr ""
#. Tag: para
#: query_sql.xml:651
#, no-c-format
msgid ""
"<literal>@SQLInsert, @SQLUpdate, "
"<literal>@SQLDelete, @SQLDeleteAll respectively "
"override the INSERT, UPDATE, DELETE, and DELETE all statement. The same can "
"be achieved using Hibernate mapping files and the <literal><sql-insert>"
"</literal>, <sql-update> and <sql-"
"delete></literal> nodes. This can be seen in attribute to true. In "
"annotations as well as in xml."
msgstr ""
#. Tag: para
#: query_sql.xml:670
#, no-c-format
msgid ""
"To check that the execution happens correctly, Hibernate allows you to "
"define one of those three strategies:"
msgstr ""
#. Tag: para
#: query_sql.xml:675
#, no-c-format
msgid ""
"none: no check is performed: the store procedure is expected to fail upon "
"issues"
msgstr ""
#. Tag: para
#: query_sql.xml:680
#, no-c-format
msgid "count: use of rowcount to check that the update is successful"
msgstr ""
#. Tag: para
#: query_sql.xml:685
#, no-c-format
msgid ""
"param: like COUNT but using an output parameter rather that the standard "
"mechanism"
msgstr ""
#. Tag: para
#: query_sql.xml:690
#, no-c-format
msgid ""
"To define the result check style, use the <literal>check parameter "
"which is again available in annoations as well as in xml."
msgstr ""
#. Tag: para
#: query_sql.xml:693
#, no-c-format
msgid ""
"You can use the exact same set of annotations respectively xml nodes to "
"override the collection related statements -see <xref linkend=\"example-"
"overriding-sql-collections-annotations\"/>."
msgstr ""
#. Tag: title
#: query_sql.xml:698
#, no-c-format
msgid "Overriding SQL statements for collections using annotations"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:701
#, no-c-format
msgid ""
"@OneToMany\n"
"@JoinColumn(name=\"chaos_fk\")\n"
"@SQLInsert( sql=\"UPDATE CASIMIR_PARTICULE SET chaos_fk = ? where id = ?\")\n"
"@SQLDelete( sql=\"UPDATE CASIMIR_PARTICULE SET chaos_fk = null where id = ?"
"\")\n"
"private Set<CasimirParticle> particles = new HashSet<"
"CasimirParticle>();"
msgstr ""
#. Tag: para
#: query_sql.xml:705
#, fuzzy, no-c-format
msgid ""
"The parameter order is important and is defined by the order Hibernate "
"handles properties. You can see the expected order by enabling debug logging "
"for the <literal>org.hibernate.persister.entity level. With this "
"level enabled Hibernate will print out the static SQL that is used to "
"create, update, delete etc. entities. (To see the expected sequence, "
"remember to not include your custom SQL through annotations or mapping files "
"as that will override the Hibernate generated static sql)"
msgstr ""
"Vous pouvez voir l'ordre attendu en activant la journalisation de débogage "
"pour le niveau <literal>org.hibernate.persister.entity. 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 mappage car cela surchargera le SQL statique généré par "
"Hibernate."
#. Tag: para
#: query_sql.xml:715
#, no-c-format
msgid ""
"Overriding SQL statements for secondary tables is also possible using "
"<literal>@org.hibernate.annotations.Table and either (or all) "
"attributes <literal>sqlInsert, sqlUpdate, "
"<literal>sqlDelete:"
msgstr ""
#. Tag: title
#: query_sql.xml:721
#, no-c-format
msgid "Overriding SQL statements for secondary tables"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:723
#, no-c-format
msgid ""
"@Entity\n"
"@SecondaryTables({\n"
" @SecondaryTable(name = \"`Cat nbr1`\"),\n"
" @SecondaryTable(name = \"Cat2\"})\n"
"@org.hibernate.annotations.Tables( {\n"
" @Table(appliesTo = \"Cat\", comment = \"My cat table\" ),\n"
" @Table(appliesTo = \"Cat2\", foreignKey = @ForeignKey(name=\"FK_CAT2_CAT"
"\"), fetch = FetchMode.SELECT,\n"
" sqlInsert=@SQLInsert(sql=\"insert into Cat2(storyPart2, id) values"
"(upper(?), ?)\") )\n"
"} )\n"
"public class Cat implements Serializable {"
msgstr ""
#. Tag: para
#: query_sql.xml:726
#, no-c-format
msgid ""
"The previous example also shows that you can give a comment to a given table "
"(primary or secondary): This comment will be used for DDL generation."
msgstr ""
#. Tag: para
#: query_sql.xml:731
#, fuzzy, no-c-format
msgid ""
"The SQL is directly executed in your database, so you can use any dialect "
"you like. This will, however, reduce the portability of your mapping if you "
"use database specific SQL."
msgstr ""
"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 mappage si vous utilisez du SQL spécifique à votre base "
"de données. "
#. Tag: para
#: query_sql.xml:736
#, fuzzy, no-c-format
msgid ""
"Last but not least, stored procedures are in most cases required to return "
"the number of rows inserted, updated and deleted. Hibernate always registers "
"the first statement parameter as a numeric output parameter for the CUD "
"operations:"
msgstr ""
"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 vérifie plusieurs fois le succès de "
"l'expression. Hibernate inscrit toujours le premier paramètre de "
"l'expression comme un paramètre de sortie numérique pour les opérations "
"CUD : "
#. Tag: title
#: query_sql.xml:742
#, no-c-format
msgid "Stored procedures and their return value"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:744
#, no-c-format
msgid ""
"CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)\n"
" RETURN NUMBER IS\n"
"BEGIN\n"
"\n"
" update PERSON\n"
" set\n"
" NAME = uname,\n"
" where\n"
" ID = uid;\n"
"\n"
" return SQL%ROWCOUNT;\n"
"\n"
"END updatePerson;"
msgstr ""
#. Tag: title
#: query_sql.xml:749
#, no-c-format
msgid "Custom SQL for loading"
msgstr "SQL personnalisé pour le chargement"
#. Tag: para
#: query_sql.xml:751
#, no-c-format
msgid ""
"You can also declare your own SQL (or HQL) queries for entity loading. As "
"with inserts, updates, and deletes, this can be done at the individual "
"column level as described in <xref linkend=\"mapping-column-read-and-write\"/"
"> or at the statement level. Here is an example of a statement level "
"override:"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:757
#, no-c-format
msgid ""
"<sql-query name=\"person\">\n"
" <return alias=\"pers\" class=\"Person\" lock-mode=\"upgrade\"/>\n"
" SELECT NAME AS {pers.name}, ID AS {pers.id}\n"
" FROM PERSON\n"
" WHERE ID=?\n"
" FOR UPDATE\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:759
#, no-c-format
msgid ""
"This is just a named query declaration, as discussed earlier. You can "
"reference this named query in a class mapping:"
msgstr ""
"Ceci est juste une déclaration de requête nommée, comme vu précédemment. "
"Vous pouvez référencer cette requête nommée dans un mappage de classe : "
#. Tag: programlisting
#: query_sql.xml:762
#, no-c-format
msgid ""
"<class name=\"Person\">\n"
" <id name=\"id\">\n"
" <generator class=\"increment\"/>\n"
" </id>\n"
" <property name=\"name\" not-null=\"true\"/>\n"
" <loader query-ref=\"person\"/>\n"
"</class>"
msgstr ""
#. Tag: para
#: query_sql.xml:764
#, no-c-format
msgid "This even works with stored procedures."
msgstr "Ceci fonctionne même avec des procédures stockées."
#. Tag: para
#: query_sql.xml:766
#, no-c-format
msgid "You can even define a query for collection loading:"
msgstr ""
"Vous pouvez même définir une requête pour le chargement d'une collection : "
#. Tag: programlisting
#: query_sql.xml:768
#, no-c-format
msgid ""
"<set name=\"employments\" inverse=\"true\">\n"
" <key/>\n"
" <one-to-many class=\"Employment\"/>\n"
" <loader query-ref=\"employments\"/>\n"
"</set>"
msgstr ""
#. Tag: programlisting
#: query_sql.xml:770
#, no-c-format
msgid ""
"<sql-query name=\"employments\">\n"
" <load-collection alias=\"emp\" role=\"Person.employments\"/>\n"
" SELECT {emp.*}\n"
" FROM EMPLOYMENT emp\n"
" WHERE EMPLOYER = :id\n"
" ORDER BY STARTDATE ASC, EMPLOYEE ASC\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:772
#, no-c-format
msgid ""
"You can also define an entity loader that loads a collection by join "
"fetching:"
msgstr ""
"Vous pourriez même définir un chargeur d'entité qui charge une collection "
"par jointure : "
#. Tag: programlisting
#: query_sql.xml:775
#, no-c-format
msgid ""
"<sql-query name=\"person\">\n"
" <return alias=\"pers\" class=\"Person\"/>\n"
" <return-join alias=\"emp\" property=\"pers.employments\"/>\n"
" SELECT NAME AS {pers.*}, {emp.*}\n"
" FROM PERSON pers\n"
" LEFT OUTER JOIN EMPLOYMENT emp\n"
" ON pers.ID = emp.PERSON_ID\n"
" WHERE ID=?\n"
"</sql-query>"
msgstr ""
#. Tag: para
#: query_sql.xml:777
#, no-c-format
msgid ""
"The annotation equivalent <literal><loader> is the @Loader "
"annotation as seen in <xref linkend=\"example-custom-crdu-via-annotations\"/"
">."
msgstr ""
#, fuzzy
#~ msgid "<literal>A_NAME as {item.name}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>{[aliasname].class}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>DISC as {item.class}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>{[aliasname].*}"
#~ msgstr "<literal>{item.*}"
#~ msgid "<literal>{item.*}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>{[aliasname].key}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>ORGID as {coll.key}"
#~ msgstr "<literal>{coll.*}"
#, fuzzy
#~ msgid "<literal>{[aliasname].id}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>EMPID as {coll.id}"
#~ msgstr "<literal>{coll.*}"
#, fuzzy
#~ msgid "<literal>{[aliasname].element}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>XID as {coll.element}"
#~ msgstr "<literal>{coll.*}"
#, fuzzy
#~ msgid "<literal>NAME as {coll.element.name}"
#~ msgstr "<literal>NAME as {coll.element.name}"
#, fuzzy
#~ msgid "<literal>{[aliasname].element.*}"
#~ msgstr "<literal>{item.*}"
#, fuzzy
#~ msgid "<literal>{coll.element.*}"
#~ msgstr "<literal>{coll.*}"
#~ msgid "<literal>{coll.*}"
#~ msgstr "<literal>{coll.*}"
#, fuzzy
#~ msgid ""
#~ "The class and collection persisters in Hibernate already contain a set of "
#~ "configuration time generated strings (insertsql, deletesql, updatesql "
#~ "etc.). The mapping tags <literal><sql-insert>, "
#~ "<literal><sql-delete>, and <sql-update>, <sql-delete>"
#~ "</literal>, et <sql-update> surchargent ces "
#~ "chaînes de caractères :"
#~ msgid ""
#~ "Stored procedures are supported if the <literal>callable "
#~ "attribute is set:"
#~ msgstr ""
#~ "Les procédures stockées sont supportées si l'attribut <literal>callable
Other Hibernate examples (source code examples)
Here is a short list of links related to this Hibernate query_sql.po source code file:
|
The search page
Other Hibernate source code examples at this package level
Click here to learn more about this project
