session_api.po

hibernate-distribution-3.3.1.GA-dist.zip源码

#. Tag: title
#: session_api.xml:321
#, no-c-format
msgid "Bind parameters"
msgstr "Lier des paramètres"

#. Tag: para
#: session_api.xml:323
#, no-c-format
msgid ""
"Methods on <literal>Query</literal> are provided for binding values to named "
"parameters or JDBC-style <literal>?</literal> parameters. <emphasis>Contrary "
"to JDBC, Hibernate numbers parameters from zero.</emphasis> Named parameters "
"are identifiers of the form <literal>:name</literal> in the query string. "
"The advantages of named parameters are:"
msgstr ""
"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 :"

#. Tag: para
#: session_api.xml:333
#, no-c-format
msgid ""
"named parameters are insensitive to the order they occur in the query string"
msgstr ""
"les paramètres nommés sont insensibles à l'ordre de leur place dans la "
"chaîne de la requête"

#. Tag: para
#: session_api.xml:339
#, no-c-format
msgid "they may occur multiple times in the same query"
msgstr "ils peuvent apparaître plusieurs fois dans la même requête"

#. Tag: para
#: session_api.xml:344
#, no-c-format
msgid "they are self-documenting"
msgstr "ils sont auto-documentés"

#. Tag: programlisting
#: session_api.xml:350
#, no-c-format
msgid ""
"<![CDATA[//named parameter (preferred)\n"
"Query q = sess.createQuery(\"from DomesticCat cat where cat.name = :name"
"\");\n"
"q.setString(\"name\", \"Fritz\");\n"
"Iterator cats = q.iterate();]]>"
msgstr ""

#. Tag: programlisting
#: session_api.xml:352
#, no-c-format
msgid ""
"<![CDATA[//positional parameter\n"
"Query q = sess.createQuery(\"from DomesticCat cat where cat.name = ?\");\n"
"q.setString(0, \"Izi\");\n"
"Iterator cats = q.iterate();]]>"
msgstr ""

#. Tag: programlisting
#: session_api.xml:354
#, no-c-format
msgid ""
"<![CDATA[//named parameter list\n"
"List names = new ArrayList();\n"
"names.add(\"Izi\");\n"
"names.add(\"Fritz\");\n"
"Query q = sess.createQuery(\"from DomesticCat cat where cat.name in (:"
"namesList)\");\n"
"q.setParameterList(\"namesList\", names);\n"
"List cats = q.list();]]>"
msgstr ""

#. Tag: title
#: session_api.xml:359
#, no-c-format
msgid "Pagination"
msgstr "Pagination"

#. Tag: para
#: session_api.xml:361
#, no-c-format
msgid ""
"If you need to specify bounds upon your result set (the maximum number of "
"rows you want to retrieve and / or the first row you want to retrieve) you "
"should use methods of the <literal>Query</literal> interface:"
msgstr ""
"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> :"

#. Tag: programlisting
#: session_api.xml:367
#, no-c-format
msgid ""
"<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\");\n"
"q.setFirstResult(20);\n"
"q.setMaxResults(10);\n"
"List cats = q.list();]]>"
msgstr ""

#. Tag: para
#: session_api.xml:369
#, no-c-format
msgid ""
"Hibernate knows how to translate this limit query into the native SQL of "
"your DBMS."
msgstr ""
"Hibernate sait comment traduite cette requête de limite en SQL natif pour "
"votre SGBD."

#. Tag: title
#: session_api.xml:377
#, no-c-format
msgid "Scrollable iteration"
msgstr "Itération \"scrollable\""

#. Tag: para
#: session_api.xml:379
#, no-c-format
msgid ""
"If your JDBC driver supports scrollable <literal>ResultSet</literal>s, the "
"<literal>Query</literal> interface may be used to obtain a "
"<literal>ScrollableResults</literal> object, which allows flexible "
"navigation of the query results."
msgstr ""
"Si votre connecteur JDBC supporte les <literal>ResultSet</literal>s "
"\"scrollables\", 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."

#. Tag: programlisting
#: session_api.xml:386
#, no-c-format
msgid ""
"<![CDATA[Query q = sess.createQuery(\"select cat.name, cat from DomesticCat "
"cat \" +\n"
"                            \"order by cat.name\");\n"
"ScrollableResults cats = q.scroll();\n"
"if ( cats.first() ) {\n"
"\n"
"    // find the first name on each page of an alphabetical list of cats by "
"name\n"
"    firstNamesOfPages = new ArrayList();\n"
"    do {\n"
"        String name = cats.getString(0);\n"
"        firstNamesOfPages.add(name);\n"
"    }\n"
"    while ( cats.scroll(PAGE_SIZE) );\n"
"\n"
"    // Now get the first page of cats\n"
"    pageOfCats = new ArrayList();\n"
"    cats.beforeFirst();\n"
"    int i=0;\n"
"    while( ( PAGE_SIZE > i++ ) && cats.next() ) pageOfCats.add( cats.get"
"(1) );\n"
"\n"
"}\n"
"cats.close()]]>"
msgstr ""

#. Tag: para
#: session_api.xml:388
#, no-c-format
msgid ""
"Note that an open database connection (and cursor) is required for this "
"functionality, use <literal>setMaxResult()</literal>/<literal>setFirstResult"
"()</literal> if you need offline pagination functionality."
msgstr ""
"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."

#. Tag: title
#: session_api.xml:397
#, no-c-format
msgid "Externalizing named queries"
msgstr "Externaliser des requêtes nommées"

#. Tag: para
#: session_api.xml:399
#, no-c-format
msgid ""
"You may also define named queries in the mapping document. (Remember to use "
"a <literal>CDATA</literal> section if your query contains characters that "
"could be interpreted as markup.)"
msgstr ""
"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.)"

#. Tag: programlisting
#: session_api.xml:405
#, no-c-format
msgid ""
"<![CDATA[<query name=\"ByNameAndMaximumWeight\"><![CDATA[\n"
"    from eg.DomesticCat as cat\n"
"        where cat.name = ?\n"
"        and cat.weight > ?\n"
"] ]></query>]]>"
msgstr ""

#. Tag: para
#: session_api.xml:407
#, no-c-format
msgid "Parameter binding and executing is done programatically:"
msgstr "La liaison de paramètres et l'exécution sont fait par programmation :"

#. Tag: programlisting
#: session_api.xml:411
#, no-c-format
msgid ""
"<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n"
"q.setString(0, name);\n"
"q.setInt(1, minWeight);\n"
"List cats = q.list();]]>"
msgstr ""

#. Tag: para
#: session_api.xml:413
#, no-c-format
msgid ""
"Note that the actual program code is independent of the query language that "
"is used, you may also define native SQL queries in metadata, or migrate "
"existing queries to Hibernate by placing them in mapping files."
msgstr ""
"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."

#. Tag: para
#: session_api.xml:419
#, no-c-format
msgid ""
"Also note that a query declaration inside a <literal>&lt;hibernate-"
"mapping&gt;</literal> element requires a global unique name for the query, "
"while a query declaration inside a <literal>&lt;class&gt;</literal> element "
"is made unique automatically by prepending the fully qualified name of the "
"class, for example <literal>eg.Cat.ByNameAndMaximumWeight</literal>."
msgstr ""
"UNTRANSLATED! Also note that a query declaration inside a <literal>&lt;"
"hibernate-mapping&gt;</literal> element requires a global unique name for "
"the query, while a query declaration inside a <literal>&lt;class&gt;</"
"literal> element is made unique automatically by prepending the fully "
"qualified name of the class, for example <literal>eg.Cat."
"ByNameAndMaximumWeight</literal>."

#. Tag: title
#: session_api.xml:432
#, no-c-format
msgid "Filtering collections"
msgstr "Filtrer des collections"

#. Tag: para
#: session_api.xml:433
#, no-c-format
msgid ""
"A collection <emphasis>filter</emphasis> is a special type of query that may "
"be applied to a persistent collection or array. The query string may refer "
"to <literal>this</literal>, meaning the current collection element."
msgstr ""
"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."

#. Tag: programlisting
#: session_api.xml:439
#, no-c-format
msgid ""
"<![CDATA[Collection blackKittens = session.createFilter(\n"
"    pk.getKittens(), \n"
"    \"where this.color = ?\")\n"
"    .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) )\n"
"    .list()\n"
");]]>"
msgstr ""

#. Tag: para
#: session_api.xml:441
#, no-c-format
msgid ""
"The returned collection is considered a bag, and it's a copy of the given "
"collection. The original collection is not modified (this is contrary to the "
"implication of the name \"filter\", but consistent with expected behavior)."
msgstr ""
"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)."

#. Tag: para
#: session_api.xml:447
#, no-c-format
msgid ""
"Observe that filters do not require a <literal>from</literal> clause (though "
"they may have one if required). Filters are not limited to returning the "
"collection elements themselves."
msgstr ""
"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."

#. Tag: programlisting
#: session_api.xml:452
#, no-c-format
msgid ""
"<![CDATA[Collection blackKittenMates = session.createFilter(\n"
"    pk.getKittens(), \n"
"    \"select this.mate where this.color = eg.Color.BLACK.intValue\")\n"
"    .list();]]>"
msgstr ""

#. Tag: para
#: session_api.xml:454
#, no-c-format
msgid ""
"Even an empty filter query is useful, e.g. to load a subset of elements in a "
"huge collection:"
msgstr ""
"Même une requête de filtre vide est utile, par exemple pour charger un sous-"
"ensemble d'éléments dans une énorme collection :"

#. Tag: programlisting
#: session_api.xml:459
#, no-c-format
msgid ""
"<![CDATA[Collection tenKittens = session.createFilter(\n"
"    mother.getKittens(), \"\")\n"
"    .setFirstResult(0).setMaxResults(10)\n"
"    .list();]]>"
msgstr ""