session_api.po

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

"            \"select kitten, mother from Cat kitten join kitten.mother mother"
"\")\n"
"            .list()\n"
"            .iterator();\n"
"\n"
"while ( kittensAndMothers.hasNext() ) {\n"
"    Object[] tuple = (Object[]) kittensAndMothers.next();\n"
"    Cat kitten = (Cat) tuple[0];\n"
"    Cat mother = (Cat) tuple[1];\n"
"    ....\n"
"}]]>"
msgstr ""

#. Tag: title
#: session_api.xml:284
#, no-c-format
msgid "Scalar results"
msgstr "スカラーの結果"

#. Tag: para
#: session_api.xml:286
#, no-c-format
msgid ""
"Queries may specify a property of a class in the <literal>select</literal> "
"clause. They may even call SQL aggregate functions. Properties or aggregates "
"are considered \"scalar\" results (and not entities in persistent state)."
msgstr ""
"クエリでは、 <literal>select</literal> 節でクラスのプロパティを指定できま"
"す。 SQLの集合関数を呼ぶこともできます。プロパティや集合関数は、 （永続状態の"
"エンティティではなく）「スカラー値」であると見なされます。"

#. Tag: programlisting
#: session_api.xml:292
#, no-c-format
msgid ""
"<![CDATA[Iterator results = sess.createQuery(\n"
"        \"select cat.color, min(cat.birthdate), count(cat) from Cat cat \" "
"+\n"
"        \"group by cat.color\")\n"
"        .list()\n"
"        .iterator();\n"
"\n"
"while ( results.hasNext() ) {\n"
"    Object[] row = (Object[]) results.next();\n"
"    Color type = (Color) row[0];\n"
"    Date oldest = (Date) row[1];\n"
"    Integer count = (Integer) row[2];\n"
"    .....\n"
"}]]>"
msgstr ""

#. Tag: title
#: session_api.xml:297
#, no-c-format
msgid "Bind parameters"
msgstr "パラメータのバインド"

#. Tag: para
#: session_api.xml:299
#, 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 ""
"<literal>Query</literal> は、名前付きのパラメータやJDBCスタイルの <literal>?"
"</literal> パラメータに値をバインドするためのメソッドを持っています。 "
"<emphasis>JDBCとは違い、Hibernateはパラメータにゼロから番号を振っていきます。"
"</emphasis> 名前付きのパラメータとは、クエリ文字列のなかにある <literal>:"
"name</literal> 形式の識別子です。 名前付きパラメータの利点は次の通りです。"

#. Tag: para
#: session_api.xml:309
#, no-c-format
msgid ""
"named parameters are insensitive to the order they occur in the query string"
msgstr "名前付きパラメータは、クエリ文字列に登場する順番と無関係です"

#. Tag: para
#: session_api.xml:315
#, no-c-format
msgid "they may occur multiple times in the same query"
msgstr "同じクエリ内に複数回登場することができます"

#. Tag: para
#: session_api.xml:320
#, no-c-format
msgid "they are self-documenting"
msgstr "自分自身を説明します"

#. Tag: programlisting
#: session_api.xml:326
#, 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:328
#, 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:330
#, 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:335
#, no-c-format
msgid "Pagination"
msgstr "ページ分け"

#. Tag: para
#: session_api.xml:337
#, 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 ""
"ResultSetに制限（復元したい最大行数や復元したい最初の行）を加える必要があれ"
"ば、 以下のように、 <literal>Query</literal> インターフェイスのメソッドを使い"
"ます。"

#. Tag: programlisting
#: session_api.xml:343
#, 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:345
#, no-c-format
msgid ""
"Hibernate knows how to translate this limit query into the native SQL of "
"your DBMS."
msgstr ""
"制限付きのクエリをDBMSのネイティブなSQLに変換する方法を、Hibernateは知ってい"
"ます。"

#. Tag: title
#: session_api.xml:353
#, no-c-format
msgid "Scrollable iteration"
msgstr "スクロール可能なイテレーション"

#. Tag: para
#: session_api.xml:355
#, 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 ""
"JDBCドライバがスクロール可能な <literal>ResultSet</literal> をサポートしてい"
"れば、 <literal>Query</literal> インターフェイスを使って、 "
"<literal>ScrollableResults</literal> オブジェクトを 取得できます。それを使う"
"と、クエリの結果に対して柔軟にナビゲーションできます。"

#. Tag: programlisting
#: session_api.xml:362
#, 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:364
#, 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 ""
"この機能にはオープン状態のデータベースコネクションが必要であることに注意して"
"ください。 もし、オフラインのページ分け機能が必要であれば、 "
"<literal>setMaxResult()</literal> / <literal>setFirstResult()</literal> を使"
"いましょう。"

#. Tag: title
#: session_api.xml:373
#, no-c-format
msgid "Externalizing named queries"
msgstr "名前付きクエリの外出し"

#. Tag: para
#: session_api.xml:375
#, 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 ""
"マッピングドキュメントに名前付きのクエリを定義することができます。 （マーク"
"アップと解釈される文字がクエリに含まれるなら、 <literal>CDATA</literal> セク"
"ションを 使うことを忘れないようにしましょう。）"

#. Tag: programlisting
#: session_api.xml:381
#, 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:383
#, no-c-format
msgid "Parameter binding and executing is done programatically:"
msgstr ""
"パラメータのバインディングと実行は、以下のようなプログラムで行われます。"

#. Tag: programlisting
#: session_api.xml:387
#, 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:389
#, 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 ""
"実際のプログラムコードは、使われるクエリ言語に依存していないことに注意しま"
"しょう。 メタデータには、ネイティブSQLクエリを定義することもできます。 また、"
"既存のクエリをマッピングファイルに移すことで、 Hibernateに移行することもでき"
"ます。"

#. Tag: para
#: session_api.xml:395
#, 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 ""
"<literal>&lt;hibernate-mapping&gt;</literal> の中のクエリ定義は、クエリに対す"
"る ユニークな名前が必要なことにも注意してください。それに対して、 "
"<literal>&lt;class&gt;</literal> の中の クエリ定義は、クラスの完全限定名が前"
"に付けられるので、自動的にユニークな名前になります。 例： <literal>eg.Cat."
"ByNameAndMaximumWeight</literal>"

#. Tag: title
#: session_api.xml:408
#, no-c-format
msgid "Filtering collections"
msgstr "コレクションのフィルタリング"

#. Tag: para
#: session_api.xml:409
#, no-c-format