Author: xhuang(a)jboss.com Date: 2007-10-25 03:57:28 -0400 (Thu, 25 Oct 2007) New Revision: 14132 Modified: core/trunk/documentation/manual/translations/ja-JP/content/architecture.po core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/batch.po core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/configuration.po core/trunk/documentation/manual/translations/ja-JP/content/events.po core/trunk/documentation/manual/translations/ja-JP/content/example_mappings.po core/trunk/documentation/manual/translations/ja-JP/content/example_parentchild.po core/trunk/documentation/manual/translations/ja-JP/content/example_weblog.po core/trunk/documentation/manual/translations/ja-JP/content/filters.po core/trunk/documentation/manual/translations/ja-JP/content/inheritance_mapping.po core/trunk/documentation/manual/translations/ja-JP/content/performance.po core/trunk/documentation/manual/translations/ja-JP/content/persistent_classes.po core/trunk/documentation/manual/translations/ja-JP/content/preface.po core/trunk/documentation/manual/translations/ja-JP/content/query_criteria.po core/trunk/documentation/manual/translations/ja-JP/content/query_hql.po core/trunk/documentation/manual/translations/ja-JP/content/query_sql.po core/trunk/documentation/manual/translations/ja-JP/content/session_api.po core/trunk/documentation/manual/translations/ja-JP/content/toolset_guide.po core/trunk/documentation/manual/translations/ja-JP/content/transactions.po core/trunk/documentation/manual/translations/ja-JP/content/tutorial.po core/trunk/documentation/manual/translations/ja-JP/content/xml.po Log: merge with latest English XML Modified: core/trunk/documentation/manual/translations/ja-JP/content/architecture.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/architecture.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/architecture.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,216 +1,634 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:21 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: architecture.xml:21 +#, no-c-format msgid "Architecture" -msgstr "" +msgstr "アーキテクチャ" -#: index.docbook:24 +#. Tag: title +#: architecture.xml:24 +#, no-c-format msgid "Overview" -msgstr "" +msgstr "概観" -#: index.docbook:26 +#. Tag: para +#: architecture.xml:26 +#, no-c-format msgid "A (very) high-level view of the Hibernate architecture:" -msgstr "" +msgstr "Hibernateアーキテクチャの（非常に）高いレベルからのビュー：" -#: index.docbook:39 -msgid "This diagram shows Hibernate using the database and configuration data to provide persistence services (and persistent objects) to the application." +#. Tag: para +#: architecture.xml:39 +#, no-c-format +msgid "" +"This diagram shows Hibernate using the database and configuration data to " +"provide persistence services (and persistent objects) to the application." msgstr "" +"この図はHibernateが、アプリケーションに対して永続化サービス （と永続オブジェ" +"クト）を提供するために、データベースと設定データを使うことを 示しています。" -#: index.docbook:44 -msgid "We would like to show a more detailed view of the runtime architecture. Unfortunately, Hibernate is flexible and supports several approaches. We will show the two extremes. The \"lite\" architecture has the application provide its own JDBC connections and manage its own transactions. This approach uses a minimal subset of Hibernate's APIs:" +#. Tag: para +#: architecture.xml:44 +#, no-c-format +msgid "" +"We would like to show a more detailed view of the runtime architecture. " +"Unfortunately, Hibernate is flexible and supports several approaches. We " +"will show the two extremes. The \"lite\" architecture has the application " +"provide its own JDBC connections and manage its own transactions. This " +"approach uses a minimal subset of Hibernate's APIs:" msgstr "" +"ここで実行時アーキテクチャのより詳細なビューをお見せしましょう。 あいにく、" +"Hibernateは柔軟であり、いろいろなアプローチをサポートしています。 ここでは、2" +"つの極端な例をお見せします。 「軽い」アーキテクチャでは、アプリケーションが自" +"前のJDBCコネクションを用意し、 アプリケーション自身がトランザクションを管理し" +"ます。 この方法は、Hibernate APIの最小限のサブセットを使います：" -#: index.docbook:61 -msgid "The \"full cream\" architecture abstracts the application away from the underlying JDBC/JTA APIs and lets Hibernate take care of the details." +#. Tag: para +#: architecture.xml:61 +#, no-c-format +msgid "" +"The \"full cream\" architecture abstracts the application away from the " +"underlying JDBC/JTA APIs and lets Hibernate take care of the details." msgstr "" +"「重い」アーキテクチャは、アプリケーションから、その下に位置するJDBCやJTAの" +"APIを 取り払って抽象化し、その詳細の面倒をHibernateに見させます。" -#: index.docbook:75 +#. Tag: para +#: architecture.xml:75 +#, fuzzy, no-c-format msgid "Heres some definitions of the objects in the diagrams:" -msgstr "" +msgstr "以下は、上の図に含まれるオブジェクトの定義です： <placeholder-1/>" -#: index.docbook:80 +#. Tag: term +#: architecture.xml:80 +#, no-c-format msgid "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" -msgstr "" +msgstr "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)" -#: index.docbook:82 -msgid "A threadsafe (immutable) cache of compiled mappings for a single database. A factory for <literal>Session</literal> and a client of <literal>ConnectionProvider</literal>. Might hold an optional (second-level) cache of data that is reusable between transactions, at a process- or cluster-level." +#. Tag: para +#: architecture.xml:82 +#, no-c-format +msgid "" +"A threadsafe (immutable) cache of compiled mappings for a single database. A " +"factory for <literal>Session</literal> and a client of " +"<literal>ConnectionProvider</literal>. Might hold an optional (second-level) " +"cache of data that is reusable between transactions, at a process- or " +"cluster-level." msgstr "" +"1つのデータベースに対するコンパイルされたマッピングの スレッドセーフな（更新" +"不能の）キャッシュ。 <literal>Session</literal> のファクトリであり、 " +"<literal>ConnectionProvider</literal> のクライアント。 オプションとして、プロ" +"セスまたはクラスタレベルにおいて、 トランザクション間で再利用可能なデータの" +"（二次）キャッシュを持ちます。" -#: index.docbook:92 +#. Tag: term +#: architecture.xml:92 +#, no-c-format msgid "Session (<literal>org.hibernate.Session</literal>)" -msgstr "" +msgstr "Session (<literal>org.hibernate.Session</literal>)" -#: index.docbook:94 -msgid "A single-threaded, short-lived object representing a conversation between the application and the persistent store. Wraps a JDBC connection. Factory for <literal>Transaction</literal>. Holds a mandatory (first-level) cache of persistent objects, used when navigating the object graph or looking up objects by identifier." +#. Tag: para +#: architecture.xml:94 +#, no-c-format +msgid "" +"A single-threaded, short-lived object representing a conversation between " +"the application and the persistent store. Wraps a JDBC connection. Factory " +"for <literal>Transaction</literal>. Holds a mandatory (first-level) cache of " +"persistent objects, used when navigating the object graph or looking up " +"objects by identifier." msgstr "" +"アプリケーションと永続ストアとの対話を表す、 シングルスレッドで短命のオブジェ" +"クト。 JDBCコネクションをラップします。 <literal>Transaction</literal> のファ" +"クトリです。 永続オブジェクトの必須の（一次）キャッシュを保持します。 この" +"キャッシュはオブジェクトグラフをナビゲーションする時や、 識別子でオブジェクト" +"を検索する時に使われます。" -#: index.docbook:104 +#. Tag: term +#: architecture.xml:104 +#, no-c-format msgid "Persistent objects and collections" -msgstr "" +msgstr "Persistent objects と Collections" -#: index.docbook:106 -msgid "Short-lived, single threaded objects containing persistent state and business function. These might be ordinary JavaBeans/POJOs, the only special thing about them is that they are currently associated with (exactly one) <literal>Session</literal>. As soon as the <literal>Session</literal> is closed, they will be detached and free to use in any application layer (e.g. directly as data transfer objects to and from presentation)." +#. Tag: para +#: architecture.xml:106 +#, no-c-format +msgid "" +"Short-lived, single threaded objects containing persistent state and " +"business function. These might be ordinary JavaBeans/POJOs, the only special " +"thing about them is that they are currently associated with (exactly one) " +"<literal>Session</literal>. As soon as the <literal>Session</literal> is " +"closed, they will be detached and free to use in any application layer (e.g. " +"directly as data transfer objects to and from presentation)." msgstr "" +"永続化状態とビジネスメソッドを持つ、短命でシングルスレッドのオブジェクト。 こ" +"れは通常のJavaBeans/POJOのこともありますが、特徴的なことは、 その時点での（た" +"だ1つの） <literal>Session</literal> と関連していることです。 " +"<literal>Session</literal> がクローズされるとすぐに、 それらは切り離されて他" +"のアプリケーション層から自由に使うことができます。 （例えばデータ・トランス" +"ファ・オブジェクトとして、 プレゼンテーション層から、またはプレゼンテーション" +"層へ直接使用できます。）" -#: index.docbook:117 +#. Tag: term +#: architecture.xml:117 +#, no-c-format msgid "Transient and detached objects and collections" -msgstr "" +msgstr "Transient と detached な objects と Collections" -#: index.docbook:119 -msgid "Instances of persistent classes that are not currently associated with a <literal>Session</literal>. They may have been instantiated by the application and not (yet) persisted or they may have been instantiated by a closed <literal>Session</literal>." +#. Tag: para +#: architecture.xml:119 +#, no-c-format +msgid "" +"Instances of persistent classes that are not currently associated with a " +"<literal>Session</literal>. They may have been instantiated by the " +"application and not (yet) persisted or they may have been instantiated by a " +"closed <literal>Session</literal>." msgstr "" +"現時点では <literal>Session</literal> と関連していない、 永続クラスのインスタ" +"ンス。 すでにアプリケーション側でインスタンス化されていて、まだ永続化されてい" +"ないか、 クローズされた <literal>Session</literal> でインスタンス化されたかの" +"どちらかです。" -#: index.docbook:128 +#. Tag: term +#: architecture.xml:128 +#, no-c-format msgid "Transaction (<literal>org.hibernate.Transaction</literal>)" -msgstr "" +msgstr "Transaction (<literal>org.hibernate.Transaction</literal>)" -#: index.docbook:130 -msgid "(Optional) A single-threaded, short-lived object used by the application to specify atomic units of work. Abstracts application from underlying JDBC, JTA or CORBA transaction. A <literal>Session</literal> might span several <literal>Transaction</literal>s in some cases. However, transaction demarcation, either using the underlying API or <literal>Transaction</literal>, is never optional!" +#. Tag: para +#: architecture.xml:130 +#, no-c-format +msgid "" +"(Optional) A single-threaded, short-lived object used by the application to " +"specify atomic units of work. Abstracts application from underlying JDBC, " +"JTA or CORBA transaction. A <literal>Session</literal> might span several " +"<literal>Transaction</literal>s in some cases. However, transaction " +"demarcation, either using the underlying API or <literal>Transaction</" +"literal>, is never optional!" msgstr "" +"(オプション)原子性を持つ作業単位(Unit of Work)を指定するために、アプリケー" +"ションが使用する、 シングルスレッドで短命なオブジェクト。 下に位置するJDBC、" +"JTA、CORBAトランザクションからアプリケーションを抽象化します。 " +"<literal>Session</literal> は、時には いくつかの <literal>Transaction</" +"literal> をまたがるかもしれません。 しかし、下の層のAPIを使うにせよ、 " +"<literal>Transaction</literal> を使うにせよ、 トランザクション境界を設定する" +"ことは、決してオプションではありません！。" -#: index.docbook:141 -msgid "ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</literal>)" +#. Tag: term +#: architecture.xml:141 +#, no-c-format +msgid "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" msgstr "" +"ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</" +"literal>)" -#: index.docbook:143 -msgid "(Optional) A factory for (and pool of) JDBC connections. Abstracts application from underlying <literal>Datasource</literal> or <literal>DriverManager</literal>. Not exposed to application, but can be extended/implemented by the developer." +#. Tag: para +#: architecture.xml:143 +#, no-c-format +msgid "" +"(Optional) A factory for (and pool of) JDBC connections. Abstracts " +"application from underlying <literal>Datasource</literal> or " +"<literal>DriverManager</literal>. Not exposed to application, but can be " +"extended/implemented by the developer." msgstr "" +"(オプション)JDBCコネクション（とそのプール）のファクトリ。 下の層に位置する " +"<literal>Datasource</literal> や <literal>DriverManager</literal> からアプリ" +"ケーションを抽象化します。 アプリケーションには公開されませんが、開発者が継承" +"または実装することは可能です。" -#: index.docbook:151 -msgid "TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" +#. Tag: term +#: architecture.xml:151 +#, no-c-format +msgid "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" msgstr "" +"TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)" -#: index.docbook:153 -msgid "(Optional) A factory for <literal>Transaction</literal> instances. Not exposed to the application, but can be extended/implemented by the developer." +#. Tag: para +#: architecture.xml:153 +#, no-c-format +msgid "" +"(Optional) A factory for <literal>Transaction</literal> instances. Not " +"exposed to the application, but can be extended/implemented by the developer." msgstr "" +"(オプション) <literal>Transaction</literal> インスタンスのファクトリ。 アプリ" +"ケーションには公開されませんが、開発者が継承または実装することは可能です。" -#: index.docbook:160 +#. Tag: emphasis +#: architecture.xml:160 +#, no-c-format msgid "Extension Interfaces" -msgstr "" +msgstr "Extension Interfaces" -#: index.docbook:162 -msgid "Hibernate offers many optional extension interfaces you can implement to customize the behavior of your persistence layer. See the API documentation for details." +#. Tag: para +#: architecture.xml:162 +#, no-c-format +msgid "" +"Hibernate offers many optional extension interfaces you can implement to " +"customize the behavior of your persistence layer. See the API documentation " +"for details." msgstr "" +"Hibernateは、永続層の振る舞いをカスタマイズするために、 多くのオプション拡張" +"インタフェースを用意しています。 詳細はAPIドキュメントを参照してください。" -#: index.docbook:171 -msgid "Given a \"lite\" architecture, the application bypasses the <literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or <literal>ConnectionProvider</literal> APIs to talk to JTA or JDBC directly." +#. Tag: para +#: architecture.xml:171 +#, no-c-format +msgid "" +"Given a \"lite\" architecture, the application bypasses the " +"<literal>Transaction</literal>/<literal>TransactionFactory</literal> and/or " +"<literal>ConnectionProvider</literal> APIs to talk to JTA or JDBC directly." msgstr "" +"「軽い」アーキテクチャでは、アプリケーションは直接JTAやJDBCと対話するため" +"に、 <literal>Transaction</literal> や <literal>TransactionFactory</literal> " +"や <literal>ConnectionProvider</literal> をバイパスします。" -#: index.docbook:179 +#. Tag: title +#: architecture.xml:179 +#, no-c-format msgid "Instance states" -msgstr "" +msgstr "インスタンスの状態" -#: index.docbook:180 -msgid "An instance of a persistent classes may be in one of three different states, which are defined with respect to a <emphasis>persistence context</emphasis>. The Hibernate <literal>Session</literal> object is the persistence context:" +#. Tag: para +#: architecture.xml:180 +#, no-c-format +msgid "" +"An instance of a persistent classes may be in one of three different states, " +"which are defined with respect to a <emphasis>persistence context</" +"emphasis>. The Hibernate <literal>Session</literal> object is the " +"persistence context:" msgstr "" +"永続クラスのインスタンスは、次の３つの異なる状態のどれかになります。 それ" +"は、 <emphasis>永続コンテキスト</emphasis> によって決まります。 Hibernateの " +"<literal>Session</literal> オブジェクトが、永続コンテキストになります。" -#: index.docbook:188 +#. Tag: term +#: architecture.xml:188 +#, no-c-format msgid "transient" -msgstr "" +msgstr "transient" -#: index.docbook:190 -msgid "The instance is not, and has never been associated with any persistence context. It has no persistent identity (primary key value)." +#. Tag: para +#: architecture.xml:190 +#, no-c-format +msgid "" +"The instance is not, and has never been associated with any persistence " +"context. It has no persistent identity (primary key value)." msgstr "" +"この状態のインスタンスは、現在もそして過去においても、 永続コンテキストに関連" +"づいていません。また、永続ID（主キーの値）を 持っていません。" -#: index.docbook:198 +#. Tag: term +#: architecture.xml:198 +#, no-c-format msgid "persistent" -msgstr "" +msgstr "persistent" -#: index.docbook:200 -msgid "The instance is currently associated with a persistence context. It has a persistent identity (primary key value) and, perhaps, a corresponding row in the database. For a particular persistence context, Hibernate <emphasis>guarantees</emphasis> that persistent identity is equivalent to Java identity (in-memory location of the object)." +#. Tag: para +#: architecture.xml:200 +#, no-c-format +msgid "" +"The instance is currently associated with a persistence context. It has a " +"persistent identity (primary key value) and, perhaps, a corresponding row in " +"the database. For a particular persistence context, Hibernate " +"<emphasis>guarantees</emphasis> that persistent identity is equivalent to " +"Java identity (in-memory location of the object)." msgstr "" +"この状態のインスタンスは、その時点で永続コンテキストに関連づいています。 ま" +"た、永続ID（主キーの値）を持ち、 たいていはデータベースに対応する行を持ってい" +"るでしょう。 個々の永続コンテキストのなかでは、永続IDが JavaのID（オブジェク" +"トのメモリ上の位置）と同じであることを Hibernateが <emphasis>保証</emphasis> " +"します。" -#: index.docbook:212 +#. Tag: term +#: architecture.xml:212 +#, no-c-format msgid "detached" -msgstr "" +msgstr "detached" -#: index.docbook:214 -msgid "The instance was once associated with a persistence context, but that context was closed, or the instance was serialized to another process. It has a persistent identity and, perhaps, a corrsponding row in the database. For detached instances, Hibernate makes no guarantees about the relationship between persistent identity and Java identity." +#. Tag: para +#: architecture.xml:214 +#, no-c-format +msgid "" +"The instance was once associated with a persistence context, but that " +"context was closed, or the instance was serialized to another process. It " +"has a persistent identity and, perhaps, a corrsponding row in the database. " +"For detached instances, Hibernate makes no guarantees about the relationship " +"between persistent identity and Java identity." msgstr "" +"この状態のインスタンスは、かつて永続コンテキストに関連づけられたが、 そのコン" +"テキストがクローズされたか、あるいは、 他のプロセスにそのインスタンスがシリア" +"ライズされたかです。 このインスタンスは、永続IDを持ち、たいていはデータベース" +"に 対応する行を持っているでしょう。分離インスタンスに対しては、 永続IDとJava" +"のIDとの関連は、Hibernateが保証しません。" -#: index.docbook:229 +#. Tag: title +#: architecture.xml:229 +#, no-c-format msgid "JMX Integration" -msgstr "" +msgstr "JMXとの統合" -#: index.docbook:231 -msgid "JMX is the J2EE standard for management of Java components. Hibernate may be managed via a JMX standard service. We provide an MBean implementation in the distribution, <literal>org.hibernate.jmx.HibernateService</literal>." +#. Tag: para +#: architecture.xml:231 +#, no-c-format +msgid "" +"JMX is the J2EE standard for management of Java components. Hibernate may be " +"managed via a JMX standard service. We provide an MBean implementation in " +"the distribution, <literal>org.hibernate.jmx.HibernateService</literal>." msgstr "" +"JMXはJavaコンポーネント管理のJ2EE標準です。 JMX標準サービスを通して、" +"Hibernateは管理されます。 ディストリビューションの中に <literal>org." +"hibernate.jmx.HibernateService</literal> という MBean実装を用意しています。" -#: index.docbook:237 -msgid "For an example how to deploy Hibernate as a JMX service on the JBoss Application Server, please see the JBoss User Guide. On JBoss AS, you also get these benefits if you deploy using JMX:" +#. Tag: para +#: architecture.xml:237 +#, no-c-format +msgid "" +"For an example how to deploy Hibernate as a JMX service on the JBoss " +"Application Server, please see the JBoss User Guide. On JBoss AS, you also " +"get these benefits if you deploy using JMX:" msgstr "" +"JBoss アプリケーションサーバー上にHibernateをJMXサービスとしてデプロイする方" +"法の例としては、 JBoss ユーザガイドを参照してください。 JBoss アプリケーショ" +"ンサーバーにおいて、 JMXを使ってデプロイすると、次のメリットが得られます。" -#: index.docbook:245 -msgid "<emphasis>Session Management:</emphasis> The Hibernate <literal>Session</literal>'s life cycle can be automatically bound to the scope of a JTA transaction. This means you no longer have to manually open and close the <literal>Session</literal>, this becomes the job of a JBoss EJB interceptor. You also don't have to worry about transaction demarcation in your code anymore (unless you'd like to write a portable persistence layer of course, use the optional Hibernate <literal>Transaction</literal> API for this). You call the <literal>HibernateContext</literal> to access a <literal>Session</literal>." +#. Tag: para +#: architecture.xml:245 +#, no-c-format +msgid "" +"<emphasis>Session Management:</emphasis> The Hibernate <literal>Session</" +"literal>'s life cycle can be automatically bound to the scope of a JTA " +"transaction. This means you no longer have to manually open and close the " +"<literal>Session</literal>, this becomes the job of a JBoss EJB interceptor. " +"You also don't have to worry about transaction demarcation in your code " +"anymore (unless you'd like to write a portable persistence layer of course, " +"use the optional Hibernate <literal>Transaction</literal> API for this). You " +"call the <literal>HibernateContext</literal> to access a <literal>Session</" +"literal>." msgstr "" +"<emphasis>セッション管理:</emphasis> Hibernateの <literal>Session</literal> " +"のライフサイクルは、 自動的にJTAトランザクションのスコープに結びつけられま" +"す。これは、もはや手動で <literal>Session</literal> をオープンしたり、クロー" +"ズしたりする必要がないことを意味します。 これは、JBoss EJB インターセプタの仕" +"事になります。 また、コードのどこでトランザクション境界を設定するかについ" +"て、 もはや悩む必要がありません（もちろん移植可能な永続層を書かかなくていいの" +"ならば、 オプションのHibernateの <literal>Transaction</literal> を使用してく" +"ださい。） <literal>Session</literal> にアクセスするためには、 " +"<literal>HibernateContext</literal> を コールしてください。" -#: index.docbook:257 -msgid "<emphasis>HAR deployment:</emphasis> Usually you deploy the Hibernate JMX service using a JBoss service deployment descriptor (in an EAR and/or SAR file), it supports all the usual configuration options of a Hibernate <literal>SessionFactory</literal>. However, you still have to name all your mapping files in the deployment descriptor. If you decide to use the optional HAR deployment, JBoss will automatically detect all mapping files in your HAR file." +#. Tag: para +#: architecture.xml:257 +#, no-c-format +msgid "" +"<emphasis>HAR deployment:</emphasis> Usually you deploy the Hibernate JMX " +"service using a JBoss service deployment descriptor (in an EAR and/or SAR " +"file), it supports all the usual configuration options of a Hibernate " +"<literal>SessionFactory</literal>. However, you still have to name all your " +"mapping files in the deployment descriptor. If you decide to use the " +"optional HAR deployment, JBoss will automatically detect all mapping files " +"in your HAR file." msgstr "" +"<emphasis>HAR デプロイ:</emphasis> 通常、(EAR または SAR ファイルにある）" +"JBoss サービス デプロイメントディスクリプタを使って、Hibernate JMX サービスを" +"デプロイします。 それは、Hibernateの <literal>SessionFactory</literal> の全て" +"の一般的な設定オプションを サポートします。しかし依然としてデプロイメントディ" +"スクリプタのなかにすべてのマッピングファイルの 名前を挙げる必要があります。 " +"もし、オプションのHARデプロイメントを使うことを決めたなら、 JBossは自動的に" +"HARファイルのなかの全てのマッピングファイルを検出します。" -#: index.docbook:268 -msgid "Consult the JBoss AS user guide for more information about these options." +#. Tag: para +#: architecture.xml:268 +#, no-c-format +msgid "" +"Consult the JBoss AS user guide for more information about these options." msgstr "" +"これらのオプションについての詳細な情報は、JBossアプリケーションサーバユーザガ" +"イドを 参考にしてください。" -#: index.docbook:272 -msgid "Another feature available as a JMX service are runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\"/>." +#. Tag: para +#: architecture.xml:272 +#, no-c-format +msgid "" +"Another feature available as a JMX service are runtime Hibernate statistics. " +"See <xref linkend=\"configuration-optional-statistics\"/>." msgstr "" +"JMXサービスとして利用可能な他の機能に、Hibernate実行時統計情報があります。 " +"<xref linkend=\"configuration-optional-statistics\"/> を見てください。" -#: index.docbook:279 +#. Tag: title +#: architecture.xml:279 +#, no-c-format msgid "JCA Support" -msgstr "" +msgstr "JCA サポート" -#: index.docbook:280 -msgid "Hibernate may also be configured as a JCA connector. Please see the website for more details. Please note that Hibernate JCA support is still considered experimental." +#. Tag: para +#: architecture.xml:280 +#, no-c-format +msgid "" +"Hibernate may also be configured as a JCA connector. Please see the website " +"for more details. Please note that Hibernate JCA support is still considered " +"experimental." msgstr "" +"Hibernate は JCA コネクタとしても設定できます。詳細については、Webサイトを見" +"てください。 Hibernate JCA サポートは、今のところ実験段階として考えられている" +"ことに注意してください。" -#: index.docbook:287 +#. Tag: title +#: architecture.xml:287 +#, no-c-format msgid "Contextual Sessions" -msgstr "" +msgstr "コンテキスト上のセッション" -#: index.docbook:288 -msgid "Most applications using Hibernate need some form of \"contextual\" sessions, where a given session is in effect throughout the scope of a given context. However, across applications the definition of what constitutes a context is typically different; and different contexts define different scopes to the notion of current. Applications using Hibernate prior to version 3.0 tended to utilize either home-grown <literal>ThreadLocal</literal>-based contextual sessions, helper classes such as <literal>HibernateUtil</literal>, or utilized third-party frameworks (such as Spring or Pico) which provided proxy/interception-based contextual sessions." +#. Tag: para +#: architecture.xml:288 +#, no-c-format +msgid "" +"Most applications using Hibernate need some form of \"contextual\" sessions, " +"where a given session is in effect throughout the scope of a given context. " +"However, across applications the definition of what constitutes a context is " +"typically different; and different contexts define different scopes to the " +"notion of current. Applications using Hibernate prior to version 3.0 tended " +"to utilize either home-grown <literal>ThreadLocal</literal>-based contextual " +"sessions, helper classes such as <literal>HibernateUtil</literal>, or " +"utilized third-party frameworks (such as Spring or Pico) which provided " +"proxy/interception-based contextual sessions." msgstr "" +"Hibernate を使ったアプリケーションは、ほとんど、なんらかの形で\"コンテキスト" +"上の\"セッションが必要になります。 「コンテキスト上のセッション」は、特定のコ" +"ンテキストのスコープのなかで有効なセッションのことです。 しかし、通常アプリ" +"ケーションごとにコンテキストを構成するものの定義は異なります。 しかも、異なる" +"複数のコンテキストは、現時点に対して異なるスコープを定義します。 バージョン" +"3.0より前の Hibernate では、自作の <literal>ThreadLocal</literal> ベースの" +"「コンテキスト上のセッション」を 利用するか、 <literal>HibernateUtil</" +"literal> のようなヘルパークラスを利用するか、 proxy/interception ベースの「コ" +"ンテキスト上のセッション」を提供する （Spring や Pico のような）サードパー" +"ティのフレームワークを利用するかのいずれかでした。" -#: index.docbook:297 -msgid "Starting with version 3.0.1, Hibernate added the <literal>SessionFactory.getCurrentSession()</literal> method. Initially, this assumed usage of <literal>JTA</literal> transactions, where the <literal>JTA</literal> transaction defined both the scope and context of a current session. The Hibernate team maintains that, given the maturity of the numerous stand-alone <literal>JTA TransactionManager</literal> implementations out there, most (if not all) applications should be using <literal>JTA</literal> transaction management whether or not they are deployed into a <literal>J2EE</literal> container. Based on that, the <literal>JTA</literal>-based contextual sessions is all you should ever need to use." +#. Tag: para +#: architecture.xml:297 +#, no-c-format +msgid "" +"Starting with version 3.0.1, Hibernate added the <literal>SessionFactory." +"getCurrentSession()</literal> method. Initially, this assumed usage of " +"<literal>JTA</literal> transactions, where the <literal>JTA</literal> " +"transaction defined both the scope and context of a current session. The " +"Hibernate team maintains that, given the maturity of the numerous stand-" +"alone <literal>JTA TransactionManager</literal> implementations out there, " +"most (if not all) applications should be using <literal>JTA</literal> " +"transaction management whether or not they are deployed into a " +"<literal>J2EE</literal> container. Based on that, the <literal>JTA</literal>-" +"based contextual sessions is all you should ever need to use." msgstr "" +"バージョン 3.0.1 から、Hibernate には <literal>SessionFactory." +"getCurrentSession()</literal> が 加わりました。 これは、 <literal>JTA</" +"literal> トランザクションの使用を前提にしています。 <literal>JTA</literal> ト" +"ランザクションは、現在のセッションのスコープとコンテキストの両方を定義しま" +"す。 Hibernate チームは、次のことを主張します。 巨大なスタンドアロンの " +"<literal>JTA TransactionManager</literal> 実装が成熟したら、 <literal>J2EE</" +"literal> コンテナ上にデプロイされるかどうかにかかわらず、 ほとんどの（すべて" +"とは言わないが）アプリケーションが、 <literal>JTA</literal> トランザクション" +"管理を使用すべきであると。 この考えに基づくと、 <literal>JTA</literal> ベース" +"の「コンテキスト上のセッション」を 使うしかないでしょう。" -#: index.docbook:307 -msgid "However, as of version 3.1, the processing behind <literal>SessionFactory.getCurrentSession()</literal> is now pluggable. To that end, a new extension interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) and a new configuration parameter (<literal>hibernate.current_session_context_class</literal>) have been added to allow pluggability of the scope and context of defining current sessions." +#. Tag: para +#: architecture.xml:307 +#, no-c-format +msgid "" +"However, as of version 3.1, the processing behind <literal>SessionFactory." +"getCurrentSession()</literal> is now pluggable. To that end, a new extension " +"interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) " +"and a new configuration parameter (<literal>hibernate." +"current_session_context_class</literal>) have been added to allow " +"pluggability of the scope and context of defining current sessions." msgstr "" +"しかし、バージョン 3.1 からは、 <literal>SessionFactory.getCurrentSession()</" +"literal> の後の処理が、 プラガブルになりました。 これを受けて、現在のセッショ" +"ンを定義するスコープとコンテキストのプラガビリティを可能にするために、 新しい" +"拡張インタフェース ( <literal>org.hibernate.context.CurrentSessionContext</" +"literal> ) と 新しい構成パラメータ ( <literal>hibernate." +"current_session_context_class</literal> ) が追加されました。" -#: index.docbook:314 -msgid "See the Javadocs for the <literal>org.hibernate.context.CurrentSessionContext</literal> interface for a detailed discussion of its contract. It defines a single method, <literal>currentSession()</literal>, by which the implementation is responsible for tracking the current contextual session. Out-of-the-box, Hibernate comes with three implementations of this interface." +#. Tag: para +#: architecture.xml:314 +#, no-c-format +msgid "" +"See the Javadocs for the <literal>org.hibernate.context." +"CurrentSessionContext</literal> interface for a detailed discussion of its " +"contract. It defines a single method, <literal>currentSession()</literal>, " +"by which the implementation is responsible for tracking the current " +"contextual session. Out-of-the-box, Hibernate comes with three " +"implementations of this interface." msgstr "" +"<literal>org.hibernate.context.CurrentSessionContext</literal> インタフェース" +"の規約についての 詳細な内容は Javadoc を参照してください。 それには、 " +"<literal>currentSession()</literal> という1つのメソッドが定義されており、 そ" +"の実装は、現在の「コンテキスト上のセッション」を追跡することに責任を持ちま" +"す。 そのまま使えるように、Hibernateはこのインタフェースの実装を2つ提供してい" +"ます。" -#: index.docbook:324 -msgid "<literal>org.hibernate.context.JTASessionContext</literal> - current sessions are tracked and scoped by a <literal>JTA</literal> transaction. The processing here is exactly the same as in the older JTA-only approach. See the Javadocs for details." +#. Tag: para +#: architecture.xml:324 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.JTASessionContext</literal> - current " +"sessions are tracked and scoped by a <literal>JTA</literal> transaction. The " +"processing here is exactly the same as in the older JTA-only approach. See " +"the Javadocs for details." msgstr "" +"<literal>org.hibernate.context.JTASessionContext</literal> - <literal>JTA</" +"literal> トランザクションによって、現在のセッションが追跡され、 スコープを決" +"められます。この処理は、古いJTAだけのアプローチとまったく同じです。 詳細は" +"Javadocを参照してください。" -#: index.docbook:332 -msgid "<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - current sessions are tracked by thread of execution. Again, see the Javadocs for details." +#. Tag: para +#: architecture.xml:332 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - current " +"sessions are tracked by thread of execution. Again, see the Javadocs for " +"details." msgstr "" +"<literal>org.hibernate.context.ThreadLocalSessionContext</literal> - スレッド" +"の実行によって、現在のセッションが追跡されます。 詳細はJavadocを参照してくだ" +"さい。" -#: index.docbook:338 -msgid "<literal>org.hibernate.context.ManagedSessionContext</literal> - current sessions are tracked by thread of execution. However, you are responsible to bind and unbind a <literal>Session</literal> instance with static methods on this class, it does never open, flush, or close a <literal>Session</literal>." +#. Tag: para +#: architecture.xml:338 +#, no-c-format +msgid "" +"<literal>org.hibernate.context.ManagedSessionContext</literal> - current " +"sessions are tracked by thread of execution. However, you are responsible to " +"bind and unbind a <literal>Session</literal> instance with static methods on " +"this class, it does never open, flush, or close a <literal>Session</literal>." msgstr "" +"<literal>org.hibernate.context.ManagedSessionContext</literal> - スレッドの実" +"行によって、現在のセッションが追跡されます。 しかし、このクラスのstaticメソッ" +"ドで <literal>Session</literal> インスタンスを バインド/アンバインドする責任" +"はあなたにあります。 これは決して <literal>Session</literal> をオープン、フ" +"ラッシュ、クローズしません。" -#: index.docbook:347 -msgid "The first two implementations provide a \"one session - one database transaction\" programming model, also known and used as <emphasis>session-per-request</emphasis>. The beginning and end of a Hibernate session is defined by the duration of a database transaction. If you use programatic transaction demarcation in plain JSE without JTA, you are adviced to use the Hibernate <literal>Transaction</literal> API to hide the underlying transaction system from your code. If you use JTA, use the JTA interfaces to demarcate transactions. If you execute in an EJB container that supports CMT, transaction boundaries are defined declaratively and you don't need any transaction or session demarcation operations in your code. Refer to <xref linkend=\"transactions\"/> for more information and code examples." +#. Tag: para +#: architecture.xml:347 +#, no-c-format +msgid "" +"The first two implementations provide a \"one session - one database " +"transaction\" programming model, also known and used as <emphasis>session-" +"per-request</emphasis>. The beginning and end of a Hibernate session is " +"defined by the duration of a database transaction. If you use programatic " +"transaction demarcation in plain JSE without JTA, you are adviced to use the " +"Hibernate <literal>Transaction</literal> API to hide the underlying " +"transaction system from your code. If you use JTA, use the JTA interfaces to " +"demarcate transactions. If you execute in an EJB container that supports " +"CMT, transaction boundaries are defined declaratively and you don't need any " +"transaction or session demarcation operations in your code. Refer to <xref " +"linkend=\"transactions\"/> for more information and code examples." msgstr "" +"始めの2つの実装は、\"1セッション - 1データベーストランザクション\" プログラミ" +"ングモデルを提供します。 これは <emphasis>リクエストごとのセッション" +"（session-per-request）</emphasis> としても知られており、使われています。 " +"Hibernate セッションの開始と終了は、データベーストランザクションの期間で決ま" +"ります。 JTAを使わない普通のJSEで、プログラム上のトランザクション境界設定を行" +"うなら、 コードから基礎のトランザクションシステムを隠蔽するために、 " +"Hibernate <literal>Transaction</literal> APIを使うとよいでしょう。 JTAを使う" +"なら、トランザクションの境界設定には、JTAインターフェイスを使ってください。 " +"CMTをサポートするEJBコンテナで実行するつもりなら、トランザクション境界は宣言" +"的に定義できるため、 コード上でトランザクションやセッションの境界を設定する必" +"要はありません。 さらに詳細な情報やコードの例は、 <xref linkend=" +"\"transactions\"/> を参照してください。" -#: index.docbook:359 -msgid "The <literal>hibernate.current_session_context_class</literal> configuration parameter defines which <literal>org.hibernate.context.CurrentSessionContext</literal> implementation should be used. Note that for backwards compatibility, if this config param is not set but a <literal>org.hibernate.transaction.TransactionManagerLookup</literal> is configured, Hibernate will use the <literal>org.hibernate.context.JTASessionContext</literal>. Typically, the value of this parameter would just name the implementation class to use; for the three out-of-the-box implementations, however, there are three corresponding short names, \"jta\", \"thread\", and \"managed\"." +#. Tag: para +#: architecture.xml:359 +#, no-c-format +msgid "" +"The <literal>hibernate.current_session_context_class</literal> configuration " +"parameter defines which <literal>org.hibernate.context." +"CurrentSessionContext</literal> implementation should be used. Note that for " +"backwards compatibility, if this config param is not set but a <literal>org." +"hibernate.transaction.TransactionManagerLookup</literal> is configured, " +"Hibernate will use the <literal>org.hibernate.context.JTASessionContext</" +"literal>. Typically, the value of this parameter would just name the " +"implementation class to use; for the three out-of-the-box implementations, " +"however, there are three corresponding short names, \"jta\", \"thread\", and " +"\"managed\"." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +"<literal>hibernate.current_session_context_class</literal> 設定パラメータ" +"は、 <literal>org.hibernate.context.CurrentSessionContext</literal> のどの実" +"装を使うかを指定します。 下位互換性のため、このパラメータが設定されず " +"<literal>org.hibernate.transaction.TransactionManagerLookup</literal> が設定" +"されていた場合、 Hibernateは <literal>org.hibernate.context." +"JTASessionContext</literal> を使うことに注意してください。 通常このパラメータ" +"の値には、3つの実装の中から使用する実装クラスの名前を直接指定します。 しか" +"し、\"jta\", \"thread\", \"managed\"というそれぞれの省略名も用意されていま" +"す。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/association_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1269 +1,874 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:6 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: association_mapping.xml:6 +#, no-c-format msgid "Association Mappings" msgstr "関連マッピング" -#: index.docbook:9 +#. Tag: title +#: association_mapping.xml:9 +#, no-c-format msgid "Introduction" msgstr "イントロダクション" -#: index.docbook:11 -msgid "Association mappings are the often most difficult thing to get right. In this section we'll go through the canonical cases one by one, starting with unidirectional mappings, and then considering the bidirectional cases. We'll use <literal>Person</literal> and <literal>Address</literal> in all the examples." -msgstr "関連マッピングはしばしば理解が最も難しいものになります。 この章では、基本的な一つ一つのケースについて述べます。 単方向のマッピングから始め、それから双方向のケースについて考えていきます。 例として、<literal>Person</literal> と <literal>Address</literal> を用います。" +#. Tag: para +#: association_mapping.xml:11 +#, no-c-format +msgid "" +"Association mappings are the often most difficult thing to get right. In " +"this section we'll go through the canonical cases one by one, starting with " +"unidirectional mappings, and then considering the bidirectional cases. We'll " +"use <literal>Person</literal> and <literal>Address</literal> in all the " +"examples." +msgstr "" +"関連マッピングはしばしば理解が最も難しいものになります。 この章では、基本的な" +"一つ一つのケースについて述べます。 単方向のマッピングから始め、それから双方向" +"のケースについて考えていきます。 例として、<literal>Person</literal> と " +"<literal>Address</literal> を用います。" -#: index.docbook:19 -msgid "We'll classify associations by whether or not they map to an intervening join table, and by multiplicity." -msgstr "関連は、結合テーブルを入れるかかどうかと、 多重度によって分類することにします。" +#. Tag: para +#: association_mapping.xml:19 +#, no-c-format +msgid "" +"We'll classify associations by whether or not they map to an intervening " +"join table, and by multiplicity." +msgstr "" +"関連は、結合テーブルを入れるかかどうかと、 多重度によって分類することにしま" +"す。" -#: index.docbook:24 -msgid "Nullable foreign keys are not considered good practice in traditional data modelling, so all our examples use not null foreign keys. This is not a requirement of Hibernate, and the mappings will all work if you drop the nullability constraints." -msgstr "すべての例でnot nullの外部キーを使用します。 これはHibernateの要件ではありません。 not null制約を外したとしても、マッピングは問題なく動作します。" +#. Tag: para +#: association_mapping.xml:24 +#, no-c-format +msgid "" +"Nullable foreign keys are not considered good practice in traditional data " +"modelling, so all our examples use not null foreign keys. This is not a " +"requirement of Hibernate, and the mappings will all work if you drop the " +"nullability constraints." +msgstr "" +"すべての例でnot nullの外部キーを使用します。 これはHibernateの要件ではありま" +"せん。 not null制約を外したとしても、マッピングは問題なく動作します。" -#: index.docbook:34 +#. Tag: title +#: association_mapping.xml:34 +#, no-c-format msgid "Unidirectional associations" msgstr "単方向関連" -#: index.docbook:37, index.docbook:108 +#. Tag: title +#: association_mapping.xml:37 association_mapping.xml:108 +#, no-c-format msgid "many to one" -msgstr "<title>多対一</title>" +msgstr "多対一" -#: index.docbook:39 -msgid "A <emphasis>unidirectional many-to-one association</emphasis> is the most common kind of unidirectional association." -msgstr "<emphasis>単方向多対一関連</emphasis> は単方向関連の中で最も一般的なものです。" +#. Tag: para +#: association_mapping.xml:39 +#, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association</emphasis> is the most " +"common kind of unidirectional association." +msgstr "" +"<emphasis>単方向多対一関連</emphasis> は単方向関連の中で最も一般的なもので" +"す。" -#: index.docbook:44 +#. Tag: programlisting +#: association_mapping.xml:44 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:45, index.docbook:161 +#. Tag: programlisting +#: association_mapping.xml:45 association_mapping.xml:161 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key, addressId bigint " +"not null )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:50, index.docbook:121, index.docbook:185, index.docbook:225 +#. Tag: title +#: association_mapping.xml:50 association_mapping.xml:121 +#: association_mapping.xml:185 association_mapping.xml:225 +#, no-c-format msgid "one to one" -msgstr "<title>一対一</title>" +msgstr "一対一" -#: index.docbook:52 -msgid "A <emphasis>unidirectional one-to-one association on a foreign key</emphasis> is almost identical. The only difference is the column unique constraint." -msgstr "<emphasis>外部キーの単方向一対一関連</emphasis> はほとんど同じものです。 唯一違うのは、カラムのユニークな制約です。" +#. Tag: para +#: association_mapping.xml:52 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a foreign key</" +"emphasis> is almost identical. The only difference is the column unique " +"constraint." +msgstr "" +"<emphasis>外部キーの単方向一対一関連</emphasis> はほとんど同じものです。 唯一" +"違うのは、カラムのユニークな制約です。" -#: index.docbook:57 +#. Tag: programlisting +#: association_mapping.xml:57 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\" \n" +" unique=\"true\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " unique=\"true\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:58, index.docbook:193 +#. Tag: programlisting +#: association_mapping.xml:58 association_mapping.xml:193 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key, addressId bigint " +"not null unique )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key, addressId bigint not null unique ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:60 -msgid "A <emphasis>unidirectional one-to-one association on a primary key</emphasis> usually uses a special id generator. (Notice that we've reversed the direction of the association in this example.)" -msgstr "<emphasis>主キーの単方向一対一関連</emphasis> は通常、特別なIDジェネレータを使います。 （この例では関連の方向が逆になっていることに注意してください）" +#. Tag: para +#: association_mapping.xml:60 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a primary key</" +"emphasis> usually uses a special id generator. (Notice that we've reversed " +"the direction of the association in this example.)" +msgstr "" +"<emphasis>主キーの単方向一対一関連</emphasis> は通常、特別なIDジェネレータを" +"使います。 （この例では関連の方向が逆になっていることに注意してください）" -#: index.docbook:66 +#. Tag: programlisting +#: association_mapping.xml:66 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" constrained=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">person</param>\n" +" </generator>\n" +" </id>\n" +" <one-to-one name=\"person\" constrained=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"foreign\"> -\n" - " <param name=\"property\">person</param> -\n" - " </generator> -\n" - " </id> -\n" - " <one-to-one name=\"person\" constrained=\"true\"/> -\n" - "</class>]]>" -#: index.docbook:67, index.docbook:201 +#. Tag: programlisting +#: association_mapping.xml:67 association_mapping.xml:201 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( personId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table Address ( personId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table Address ( personId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:72, index.docbook:94 +#. Tag: title +#: association_mapping.xml:72 association_mapping.xml:94 +#, no-c-format msgid "one to many" -msgstr "<title>一対多</title>" +msgstr "一対多" -#: index.docbook:74 -msgid "A <emphasis>unidirectional one-to-many association on a foreign key</emphasis> is a very unusual case, and is not really recommended." -msgstr "<emphasis>外部キーの単方向一対多関連</emphasis> はとても特殊なケースで、 あまり推奨されていません。" +#. Tag: para +#: association_mapping.xml:74 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a foreign key</" +"emphasis> is a very unusual case, and is not really recommended." +msgstr "" +"<emphasis>外部キーの単方向一対多関連</emphasis> はとても特殊なケースで、 あま" +"り推奨されていません。" -#: index.docbook:79 +#. Tag: programlisting +#: association_mapping.xml:79 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\">\n" - " <key column=\"personId\" \n" - " not-null=\"true\"/>\n" - " <one-to-many class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\">\n" +" <key column=\"personId\" \n" +" not-null=\"true\"/>\n" +" <one-to-many class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\"> -\n" - " <key column=\"personId\" -\n" - " not-null=\"true\"/> -\n" - " <one-to-many class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:80 +#. Tag: programlisting +#: association_mapping.xml:80 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key, personId bigint not null )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table Address ( addressId bigint not null primary key, personId " +"bigint not null )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table Address ( addressId bigint not null primary key, personId bigint not null ) -\n" - " ]]>" -#: index.docbook:82 +#. Tag: para +#: association_mapping.xml:82 +#, no-c-format msgid "We think it's better to use a join table for this kind of association." msgstr "このような関連のために結合テーブルを使うことをお薦めします。" -#: index.docbook:91 +#. Tag: title +#: association_mapping.xml:91 +#, no-c-format msgid "Unidirectional associations with join tables" msgstr "結合テーブルを使った単方向関連" -#: index.docbook:96 -msgid "A <emphasis>unidirectional one-to-many association on a join table</emphasis> is much preferred. Notice that by specifying <literal>unique=\"true\"</literal>, we have changed the multiplicity from many-to-many to one-to-many." -msgstr "<emphasis>結合テーブルを使った単方向一対多関連</emphasis> はより好ましいです。 <literal>unique=\"true\"</literal> の指定により、多重度が多対多から一対多 に変わったことに注意して下さい。" +#. Tag: para +#: association_mapping.xml:96 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-many association on a join table</" +"emphasis> is much preferred. Notice that by specifying <literal>unique=\"true" +"\"</literal>, we have changed the multiplicity from many-to-many to one-to-" +"many." +msgstr "" +"<emphasis>結合テーブルを使った単方向一対多関連</emphasis> はより好ましいで" +"す。 <literal>unique=\"true\"</literal> の指定により、多重度が多対多から一対" +"多 に変わったことに注意して下さい。" -#: index.docbook:102 +#. Tag: programlisting +#: association_mapping.xml:102 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" unique=\"true\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " unique=\"true\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:103 +#. Tag: programlisting +#: association_mapping.xml:103 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId not null, addressId bigint not null " +"primary key )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId not null, addressId bigint not null primary key ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:110 -msgid "A <emphasis>unidirectional many-to-one association on a join table</emphasis> is quite common when the association is optional." -msgstr "<emphasis>結合テーブルの単方向多対一関連</emphasis> は 関連が任意であるときに非常に一般的なものです。" +#. Tag: para +#: association_mapping.xml:110 +#, no-c-format +msgid "" +"A <emphasis>unidirectional many-to-one association on a join table</" +"emphasis> is quite common when the association is optional." +msgstr "" +"<emphasis>結合テーブルの単方向多対一関連</emphasis> は 関連が任意であるときに" +"非常に一般的なものです。" -#: index.docbook:115 +#. Tag: programlisting +#: association_mapping.xml:115 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\"> -\n" - " <key column=\"personId\" unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\"/> -\n" - " </join> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:116 +#. Tag: programlisting +#: association_mapping.xml:116 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null primary key, addressId " +"bigint not null )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:123 -msgid "A <emphasis>unidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible." -msgstr "<emphasis>結合テーブルの単方向一対一関連</emphasis> は、本当に特殊ですが 不可能ではありません。" +#. Tag: para +#: association_mapping.xml:123 +#, no-c-format +msgid "" +"A <emphasis>unidirectional one-to-one association on a join table</emphasis> " +"is extremely unusual, but possible." +msgstr "" +"<emphasis>結合テーブルの単方向一対一関連</emphasis> は、本当に特殊ですが 不可" +"能ではありません。" -#: index.docbook:128 +#. Tag: programlisting +#: association_mapping.xml:128 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\"> -\n" - " <key column=\"personId\" -\n" - " unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\" -\n" - " unique=\"true\"/> -\n" - " </join> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:129, index.docbook:233 +#. Tag: programlisting +#: association_mapping.xml:129 association_mapping.xml:233 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null primary key, addressId " +"bigint not null unique )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null primary key, addressId bigint not null unique ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:134, index.docbook:238 +#. Tag: title +#: association_mapping.xml:134 association_mapping.xml:238 +#, no-c-format msgid "many to many" -msgstr "<title>多対多</title>" +msgstr "多対多" -#: index.docbook:136 -msgid "Finally, we have a <emphasis>unidirectional many-to-many association</emphasis>." +#. Tag: para +#: association_mapping.xml:136 +#, no-c-format +msgid "" +"Finally, we have a <emphasis>unidirectional many-to-many association</" +"emphasis>." msgstr "最後に、<emphasis>単方向多対多関連</emphasis> を示します。" -#: index.docbook:140 +#. Tag: programlisting +#: association_mapping.xml:140 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - "</class>]]>" -#: index.docbook:141, index.docbook:246 +#. Tag: programlisting +#: association_mapping.xml:141 association_mapping.xml:246 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null, addressId bigint not " +"null, primary key (personId, addressId) )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null, primary key (personId, addressId) ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:148 +#. Tag: title +#: association_mapping.xml:148 +#, no-c-format msgid "Bidirectional associations" msgstr "双方向関連" -#: index.docbook:151, index.docbook:211 +#. Tag: title +#: association_mapping.xml:151 association_mapping.xml:211 +#, no-c-format msgid "one to many / many to one" msgstr "一対多/多対一" -#: index.docbook:153 -msgid "A <emphasis>bidirectional many-to-one association</emphasis> is the most common kind of association. (This is the standard parent/child relationship.)" -msgstr "<emphasis>双方向多対一関連</emphasis> は最も一般的な関連です。 （標準的な親子関係です）" +#. Tag: para +#: association_mapping.xml:153 +#, no-c-format +msgid "" +"A <emphasis>bidirectional many-to-one association</emphasis> is the most " +"common kind of association. (This is the standard parent/child relationship.)" +msgstr "" +"<emphasis>双方向多対一関連</emphasis> は最も一般的な関連です。 （標準的な親子" +"関係です）" -#: index.docbook:159 +#. Tag: programlisting +#: association_mapping.xml:159 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"people\" inverse=\"true\">\n" +" <key column=\"addressId\"/>\n" +" <one-to-many class=\"Person\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"people\" inverse=\"true\"> -\n" - " <key column=\"addressId\"/> -\n" - " <one-to-many class=\"Person\"/> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:163 -msgid "If you use a <literal>List</literal> (or other indexed collection) you need to set the <literal>key</literal> column of the foreign key to <literal>not null</literal>, and let Hibernate manage the association from the collections side to maintain the index of each element (making the other side virtually inverse by setting <literal>update=\"false\"</literal> and <literal>insert=\"false\"</literal>):" -msgstr "<literal>List</literal> （または他のインデックス付きのコレクション）を使うなら、 外部キーの <literal>key</literal> カラムを <literal>not null</literal> に設定し、 コレクション側が各要素のインデックスをメンテナンスするように、 関連を扱う必要があります （<literal>update=\"false\"</literal> かつ <literal>insert=\"false\"</literal> と設定して、反対側を仮想的にinverseにします）：" +#. Tag: para +#: association_mapping.xml:163 +#, no-c-format +msgid "" +"If you use a <literal>List</literal> (or other indexed collection) you need " +"to set the <literal>key</literal> column of the foreign key to <literal>not " +"null</literal>, and let Hibernate manage the association from the " +"collections side to maintain the index of each element (making the other " +"side virtually inverse by setting <literal>update=\"false\"</literal> and " +"<literal>insert=\"false\"</literal>):" +msgstr "" +"<literal>List</literal> （または他のインデックス付きのコレクション）を使うな" +"ら、 外部キーの <literal>key</literal> カラムを <literal>not null</literal> " +"に設定し、 コレクション側が各要素のインデックスをメンテナンスするように、 関" +"連を扱う必要があります （<literal>update=\"false\"</literal> かつ " +"<literal>insert=\"false\"</literal> と設定して、反対側を仮想的にinverseにしま" +"す）：" -#: index.docbook:171 +#. Tag: programlisting +#: association_mapping.xml:171 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\"\n" - " not-null=\"true\"\n" - " insert=\"false\"\n" - " update=\"false\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\"/>\n" - " ...\n" - " <list name=\"people\">\n" - " <key column=\"addressId\" not-null=\"true\"/>\n" - " <list-index column=\"peopleIdx\"/>\n" - " <one-to-many class=\"Person\"/>\n" - " </list>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\"/>\n" +" ...\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\"\n" +" not-null=\"true\"\n" +" insert=\"false\"\n" +" update=\"false\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\"/>\n" +" ...\n" +" <list name=\"people\">\n" +" <key column=\"addressId\" not-null=\"true\"/>\n" +" <list-index column=\"peopleIdx\"/>\n" +" <one-to-many class=\"Person\"/>\n" +" </list>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\"/> -\n" - " ... -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\" -\n" - " insert=\"false\" -\n" - " update=\"false\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\"/> -\n" - " ... -\n" - " <list name=\"people\"> -\n" - " <key column=\"addressId\" not-null=\"true\"/> -\n" - " <list-index column=\"peopleIdx\"/> -\n" - " <one-to-many class=\"Person\"/> -\n" - " </list> -\n" - "</class>]]>" -#: index.docbook:173 -msgid "It is important that you define <literal>not-null=\"true\"</literal> on the <literal>&lt;key&gt;</literal> element of the collection mapping if the underlying foreign key column is <literal>NOT NULL</literal>. Don't only declare <literal>not-null=\"true\"</literal> on a possible nested <literal>&lt;column&gt;</literal> element, but on the <literal>&lt;key&gt;</literal> element." -msgstr "もし外部キーカラムが <literal>NOT NULL</literal> であるならば、 コレクションマッピングの <literal>&lt;key&gt;</literal> 要素を <literal>not-null=\"true\"</literal> にすることは重要です。 入れ子になった <literal>&lt;column&gt;</literal> 要素だけではなく、 <literal>&lt;key&gt;</literal> 要素も <literal>not-null=\"true\"</literal> と定義しないようにしてください。" +#. Tag: para +#: association_mapping.xml:173 +#, no-c-format +msgid "" +"It is important that you define <literal>not-null=\"true\"</literal> on the " +"<literal>&lt;key&gt;</literal> element of the collection mapping if the " +"underlying foreign key column is <literal>NOT NULL</literal>. Don't only " +"declare <literal>not-null=\"true\"</literal> on a possible nested " +"<literal>&lt;column&gt;</literal> element, but on the <literal>&lt;key&gt;</" +"literal> element." +msgstr "" +"もし外部キーカラムが <literal>NOT NULL</literal> であるならば、 コレクション" +"マッピングの <literal>&lt;key&gt;</literal> 要素を <literal>not-null=\"true" +"\"</literal> にすることは重要です。 入れ子になった <literal>&lt;column&gt;</" +"literal> 要素だけではなく、 <literal>&lt;key&gt;</literal> 要素も " +"<literal>not-null=\"true\"</literal> と定義しないようにしてください。" -#: index.docbook:187 -msgid "A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> is quite common." +#. Tag: para +#: association_mapping.xml:187 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a foreign key</emphasis> " +"is quite common." msgstr "<emphasis>外部キーの双方向一対一関連</emphasis> は非常に一般的です。" -#: index.docbook:192 +#. Tag: programlisting +#: association_mapping.xml:192 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <many-to-one name=\"address\" \n" - " column=\"addressId\" \n" - " unique=\"true\"\n" - " not-null=\"true\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " property-ref=\"address\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <many-to-one name=\"address\" \n" +" column=\"addressId\" \n" +" unique=\"true\"\n" +" not-null=\"true\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <one-to-one name=\"person\" \n" +" property-ref=\"address\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " unique=\"true\" -\n" - " not-null=\"true\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <one-to-one name=\"person\" -\n" - " property-ref=\"address\"/> -\n" - "</class>]]>" -#: index.docbook:195 -msgid "A <emphasis>bidirectional one-to-one association on a primary key</emphasis> uses the special id generator." -msgstr "<emphasis>主キーの双方向一対一関連</emphasis> は特殊なIDジェネレータを使います。" +#. Tag: para +#: association_mapping.xml:195 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a primary key</emphasis> " +"uses the special id generator." +msgstr "" +"<emphasis>主キーの双方向一対一関連</emphasis> は特殊なIDジェネレータを使いま" +"す。" -#: index.docbook:200 +#. Tag: programlisting +#: association_mapping.xml:200 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <one-to-one name=\"address\"/>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">person</param>\n" - " </generator>\n" - " </id>\n" - " <one-to-one name=\"person\" \n" - " constrained=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <one-to-one name=\"address\"/>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">person</param>\n" +" </generator>\n" +" </id>\n" +" <one-to-one name=\"person\" \n" +" constrained=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <one-to-one name=\"address\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"foreign\"> -\n" - " <param name=\"property\">person</param> -\n" - " </generator> -\n" - " </id> -\n" - " <one-to-one name=\"person\" -\n" - " constrained=\"true\"/> -\n" - "</class>]]>" -#: index.docbook:208 +#. Tag: title +#: association_mapping.xml:208 +#, no-c-format msgid "Bidirectional associations with join tables" msgstr "結合テーブルを使った双方向関連" -#: index.docbook:213 -msgid "A <emphasis>bidirectional one-to-many association on a join table</emphasis>. Note that the <literal>inverse=\"true\"</literal> can go on either end of the association, on the collection, or on the join." -msgstr "<emphasis>結合テーブルの双方向一対多関連</emphasis> です。 <literal>inverse=\"true\"</literal> が関連端、コレクション、結合のいずれかに 設定できることに注意してください。" +#. Tag: para +#: association_mapping.xml:213 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-many association on a join table</" +"emphasis>. Note that the <literal>inverse=\"true\"</literal> can go on " +"either end of the association, on the collection, or on the join." +msgstr "" +"<emphasis>結合テーブルの双方向一対多関連</emphasis> です。 <literal>inverse=" +"\"true\"</literal> が関連端、コレクション、結合のいずれかに 設定できることに" +"注意してください。" -#: index.docbook:219 +#. Tag: programlisting +#: association_mapping.xml:219 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" \n" - " table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " unique=\"true\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " inverse=\"true\" \n" - " optional=\"true\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\"\n" - " not-null=\"true\"/>\n" - " </join>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" \n" +" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" unique=\"true\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" inverse=\"true\" \n" +" optional=\"true\">\n" +" <key column=\"addressId\"/>\n" +" <many-to-one name=\"person\"\n" +" column=\"personId\"\n" +" not-null=\"true\"/>\n" +" </join>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" -\n" - " table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " unique=\"true\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " inverse=\"true\" -\n" - " optional=\"true\"> -\n" - " <key column=\"addressId\"/> -\n" - " <many-to-one name=\"person\" -\n" - " column=\"personId\" -\n" - " not-null=\"true\"/> -\n" - " </join> -\n" - "</class>]]>" -#: index.docbook:220 +#. Tag: programlisting +#: association_mapping.xml:220 +#, no-c-format msgid "" - "<![CDATA[\n" - "create table Person ( personId bigint not null primary key )\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null primary key )\n" - "create table Address ( addressId bigint not null primary key )\n" - " ]]>" +"<![CDATA[\n" +"create table Person ( personId bigint not null primary key )\n" +"create table PersonAddress ( personId bigint not null, addressId bigint not " +"null primary key )\n" +"create table Address ( addressId bigint not null primary key )\n" +" ]]>" msgstr "" - "<![CDATA[ -\n" - "create table Person ( personId bigint not null primary key ) -\n" - "create table PersonAddress ( personId bigint not null, addressId bigint not null primary key ) -\n" - "create table Address ( addressId bigint not null primary key ) -\n" - " ]]>" -#: index.docbook:227 -msgid "A <emphasis>bidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible." -msgstr "<emphasis>結合テーブルの双方向一対一関連</emphasis> は非常に特殊ですが、可能です。" +#. Tag: para +#: association_mapping.xml:227 +#, no-c-format +msgid "" +"A <emphasis>bidirectional one-to-one association on a join table</emphasis> " +"is extremely unusual, but possible." +msgstr "" +"<emphasis>結合テーブルの双方向一対一関連</emphasis> は非常に特殊ですが、可能" +"です。" -#: index.docbook:232 +#. Tag: programlisting +#: association_mapping.xml:232 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\">\n" - " <key column=\"personId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"address\"\n" - " column=\"addressId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <join table=\"PersonAddress\" \n" - " optional=\"true\"\n" - " inverse=\"true\">\n" - " <key column=\"addressId\" \n" - " unique=\"true\"/>\n" - " <many-to-one name=\"person\"\n" - " column=\"personId\" \n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - " </join>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\">\n" +" <key column=\"personId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"address\"\n" +" column=\"addressId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <join table=\"PersonAddress\" \n" +" optional=\"true\"\n" +" inverse=\"true\">\n" +" <key column=\"addressId\" \n" +" unique=\"true\"/>\n" +" <many-to-one name=\"person\"\n" +" column=\"personId\" \n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +" </join>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\"> -\n" - " <key column=\"personId\" -\n" - " unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"addressId\" -\n" - " not-null=\"true\" -\n" - " unique=\"true\"/> -\n" - " </join> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <join table=\"PersonAddress\" -\n" - " optional=\"true\" -\n" - " inverse=\"true\"> -\n" - " <key column=\"addressId\" -\n" - " unique=\"true\"/> -\n" - " <many-to-one name=\"address\" -\n" - " column=\"personId\" -\n" - " not-null=\"true\" -\n" - " unique=\"true\"/> -\n" - " </join> -\n" - "</class>]]>" -#: index.docbook:240 -msgid "Finally, we have a <emphasis>bidirectional many-to-many association</emphasis>." +#. Tag: para +#: association_mapping.xml:240 +#, no-c-format +msgid "" +"Finally, we have a <emphasis>bidirectional many-to-many association</" +"emphasis>." msgstr "最後に、<emphasis>双方向多対多関連</emphasis> を示します。" -#: index.docbook:244 +#. Tag: programlisting +#: association_mapping.xml:244 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\" column=\"personId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"addresses\" table=\"PersonAddress\">\n" - " <key column=\"personId\"/>\n" - " <many-to-many column=\"addressId\"\n" - " class=\"Address\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - " <id name=\"id\" column=\"addressId\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" - " <key column=\"addressId\"/>\n" - " <many-to-many column=\"personId\"\n" - " class=\"Person\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\" column=\"personId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"addresses\" table=\"PersonAddress\">\n" +" <key column=\"personId\"/>\n" +" <many-to-many column=\"addressId\"\n" +" class=\"Address\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +" <id name=\"id\" column=\"addressId\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <set name=\"people\" inverse=\"true\" table=\"PersonAddress\">\n" +" <key column=\"addressId\"/>\n" +" <many-to-many column=\"personId\"\n" +" class=\"Person\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"id\" column=\"personId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"addresses\" table=\"PersonAddress\"> -\n" - " <key column=\"personId\"/> -\n" - " <many-to-many column=\"addressId\" -\n" - " class=\"Address\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " <id name=\"id\" column=\"addressId\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <set name=\"people\" inverse=\"true\" table=\"PersonAddress\"> -\n" - " <key column=\"addressId\"/> -\n" - " <many-to-many column=\"personId\" -\n" - " class=\"Person\"/> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:253 +#. Tag: title +#: association_mapping.xml:253 +#, no-c-format msgid "More complex association mappings" msgstr "より複雑な関連マッピング" -#: index.docbook:255 -msgid "More complex association joins are <emphasis>extremely</emphasis> rare. Hibernate makes it possible to handle more complex situations using SQL fragments embedded in the mapping document. For example, if a table with historical account information data defines <literal>accountNumber</literal>, <literal>effectiveEndDate</literal> and <literal>effectiveStartDate</literal>columns, mapped as follows:" -msgstr "より複雑な関連結合は <emphasis>極めて</emphasis> 稀です。 マッピングドキュメントにSQL文を埋め込むことで、 さらに複雑な状況を扱うことができます。 例えば、<literal>accountNumber</literal>, <literal>effectiveEndDate</literal>, <literal>effectiveStartDate</literal> カラムを持つaccount（口座）情報の履歴を扱うテーブルは、 以下のようにマッピングします。" +#. Tag: para +#: association_mapping.xml:255 +#, no-c-format +msgid "" +"More complex association joins are <emphasis>extremely</emphasis> rare. " +"Hibernate makes it possible to handle more complex situations using SQL " +"fragments embedded in the mapping document. For example, if a table with " +"historical account information data defines <literal>accountNumber</" +"literal>, <literal>effectiveEndDate</literal> and " +"<literal>effectiveStartDate</literal>columns, mapped as follows:" +msgstr "" +"より複雑な関連結合は <emphasis>極めて</emphasis> 稀です。 マッピングドキュメ" +"ントにSQL文を埋め込むことで、 さらに複雑な状況を扱うことができます。 例えば、" +"<literal>accountNumber</literal>, <literal>effectiveEndDate</literal>, " +"<literal>effectiveStartDate</literal> カラムを持つaccount（口座）情報の履歴を" +"扱うテーブルは、 以下のようにマッピングします。" -#: index.docbook:264 +#. Tag: programlisting +#: association_mapping.xml:264 +#, no-c-format msgid "" - "<![CDATA[<properties name=\"currentAccountKey\">\n" - " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" - " <property name=\"currentAccount\" type=\"boolean\">\n" - " <formula>case when effectiveEndDate is null then 1 else 0 end</formula>\n" - " </property>\n" - "</properties>\n" - "<property name=\"effectiveEndDate\" type=\"date\"/>\n" - "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" +"<![CDATA[<properties name=\"currentAccountKey\">\n" +" <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/>\n" +" <property name=\"currentAccount\" type=\"boolean\">\n" +" <formula>case when effectiveEndDate is null then 1 else 0 end</" +"formula>\n" +" </property>\n" +"</properties>\n" +"<property name=\"effectiveEndDate\" type=\"date\"/>\n" +"<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" msgstr "" - "<![CDATA[<properties name=\"currentAccountKey\"> -\n" - " <property name=\"accountNumber\" type=\"string\" not-null=\"true\"/> -\n" - " <property name=\"currentAccount\" type=\"boolean\"> -\n" - " <formula>case when effectiveEndDate is null then 1 else 0 end</formula> -\n" - " </property> -\n" - "</properties> -\n" - "<property name=\"effectiveEndDate\" type=\"date\"/> -\n" - "<property name=\"effectiveStateDate\" type=\"date\" not-null=\"true\"/>]]>" -#: index.docbook:266 -msgid "Then we can map an association to the <emphasis>current</emphasis> instance (the one with null <literal>effectiveEndDate</literal>) using:" -msgstr "そして、関連を <emphasis>現時点の</emphasis> インスタンス （<literal>effectiveEndDate</literal> がnullであるもの）にマッピングします。 以下のようになります：" +#. Tag: para +#: association_mapping.xml:266 +#, no-c-format +msgid "" +"Then we can map an association to the <emphasis>current</emphasis> instance " +"(the one with null <literal>effectiveEndDate</literal>) using:" +msgstr "" +"そして、関連を <emphasis>現時点の</emphasis> インスタンス " +"（<literal>effectiveEndDate</literal> がnullであるもの）にマッピングします。 " +"以下のようになります：" -#: index.docbook:271 +#. Tag: programlisting +#: association_mapping.xml:271 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" - " property-ref=\"currentAccountKey\"\n" - " class=\"AccountInfo\">\n" - " <column name=\"accountNumber\"/>\n" - " <formula>'1'</formula>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"currentAccountInfo\" \n" +" property-ref=\"currentAccountKey\"\n" +" class=\"AccountInfo\">\n" +" <column name=\"accountNumber\"/>\n" +" <formula>'1'</formula>\n" +"</many-to-one>]]>" msgstr "" - "<![CDATA[<many-to-one name=\"currentAccountInfo\" -\n" - " property-ref=\"currentAccountKey\" -\n" - " class=\"AccountInfo\"> -\n" - " <column name=\"accountNumber\"/> -\n" - " <formula>'1'</formula> -\n" - "</many-to-one>]]>" -#: index.docbook:273 -msgid "In a more complex example, imagine that the association between <literal>Employee</literal> and <literal>Organization</literal> is maintained in an <literal>Employment</literal> table full of historical employment data. Then an association to the employee's <emphasis>most recent</emphasis> employer (the one with the most recent <literal>startDate</literal>) might be mapped this way:" -msgstr "さらに複雑な例では、<literal>Employee（従業員）</literal> と <literal>Organization（組織）</literal> 間の関連が <literal>Employment（雇用）</literal> テーブルで保持される場合を想像してください。 このテーブルには雇用データの履歴がすべて含まれます。 すると従業員の <emphasis>最も最近の</emphasis> 雇用者を表す関連 （最も最近の <literal>startDate</literal> を持つもの）は、このようにマッピングできます：" +#. Tag: para +#: association_mapping.xml:273 +#, no-c-format +msgid "" +"In a more complex example, imagine that the association between " +"<literal>Employee</literal> and <literal>Organization</literal> is " +"maintained in an <literal>Employment</literal> table full of historical " +"employment data. Then an association to the employee's <emphasis>most " +"recent</emphasis> employer (the one with the most recent <literal>startDate</" +"literal>) might be mapped this way:" +msgstr "" +"さらに複雑な例では、<literal>Employee（従業員）</literal> と " +"<literal>Organization（組織）</literal> 間の関連が <literal>Employment（雇" +"用）</literal> テーブルで保持される場合を想像してください。 このテーブルには" +"雇用データの履歴がすべて含まれます。 すると従業員の <emphasis>最も最近の</" +"emphasis> 雇用者を表す関連 （最も最近の <literal>startDate</literal> を持つも" +"の）は、このようにマッピングできます：" -#: index.docbook:281 +#. Tag: programlisting +#: association_mapping.xml:281 +#, no-c-format msgid "" - "<![CDATA[<join>\n" - " <key column=\"employeeId\"/>\n" - " <subselect>\n" - " select employeeId, orgId \n" - " from Employments \n" - " group by orgId \n" - " having startDate = max(startDate)\n" - " </subselect>\n" - " <many-to-one name=\"mostRecentEmployer\" \n" - " class=\"Organization\" \n" - " column=\"orgId\"/>\n" - "</join>]]>" +"<![CDATA[<join>\n" +" <key column=\"employeeId\"/>\n" +" <subselect>\n" +" select employeeId, orgId \n" +" from Employments \n" +" group by orgId \n" +" having startDate = max(startDate)\n" +" </subselect>\n" +" <many-to-one name=\"mostRecentEmployer\" \n" +" class=\"Organization\" \n" +" column=\"orgId\"/>\n" +"</join>]]>" msgstr "" - "<![CDATA[<join> -\n" - " <key column=\"employeeId\"/> -\n" - " <subselect> -\n" - " select employeeId, orgId -\n" - " from Employments -\n" - " group by orgId -\n" - " having startDate = max(startDate) -\n" - " </subselect> -\n" - " <many-to-one name=\"mostRecentEmployer\" -\n" - " class=\"Organization\" -\n" - " column=\"orgId\"/> -\n" - "</join>]]>" -#: index.docbook:283 -msgid "You can get quite creative with this functionality, but it is usually more practical to handle these kinds of cases using HQL or a criteria query." -msgstr "この機能は非常に強力です。 しかしこのような場合、普通はHQLやcriteriaクエリを使う方がより実践的です。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: association_mapping.xml:283 +#, no-c-format +msgid "" +"You can get quite creative with this functionality, but it is usually more " +"practical to handle these kinds of cases using HQL or a criteria query." +msgstr "" +"この機能は非常に強力です。 しかしこのような場合、普通はHQLやcriteriaクエリを" +"使う方がより実践的です。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/basic_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,3698 +1,5651 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: basic_mapping.xml:5 +#, no-c-format msgid "Basic O/R Mapping" msgstr "基本的なO/Rマッピング" -#: index.docbook:8 +#. Tag: title +#: basic_mapping.xml:8 +#, no-c-format msgid "Mapping declaration" msgstr "マッピング定義" -#: index.docbook:10 -msgid "Object/relational mappings are usually defined in an XML document. The mapping document is designed to be readable and hand-editable. The mapping language is Java-centric, meaning that mappings are constructed around persistent class declarations, not table declarations." -msgstr "オブジェクト/リレーショナルマッピングは通常XMLドキュメントで定義します。 マッピングドキュメントは、読みやすく手作業で編集しやすいようにデザインされています。 マッピング言語はJava中心、つまりテーブル定義ではなく永続クラスの定義に基づいて構築されています。" +#. Tag: para +#: basic_mapping.xml:10 +#, no-c-format +msgid "" +"Object/relational mappings are usually defined in an XML document. The " +"mapping document is designed to be readable and hand-editable. The mapping " +"language is Java-centric, meaning that mappings are constructed around " +"persistent class declarations, not table declarations." +msgstr "" +"オブジェクト/リレーショナルマッピングは通常XMLドキュメントで定義します。 マッ" +"ピングドキュメントは、読みやすく手作業で編集しやすいようにデザインされていま" +"す。 マッピング言語はJava中心、つまりテーブル定義ではなく永続クラスの定義に基" +"づいて構築されています。" -#: index.docbook:17 -msgid "Note that, even though many Hibernate users choose to write the XML by hand, a number of tools exist to generate the mapping document, including XDoclet, Middlegen and AndroMDA." -msgstr "多くのHibernateユーザはXMLマッピングの記述を手作業で行いますが、 XDoclet, Middlegen, AndroMDAというようなマッピングドキュメントを生成するツールが いくつか存在します。" +#. Tag: para +#: basic_mapping.xml:17 +#, no-c-format +msgid "" +"Note that, even though many Hibernate users choose to write the XML by hand, " +"a number of tools exist to generate the mapping document, including XDoclet, " +"Middlegen and AndroMDA." +msgstr "" +"多くのHibernateユーザはXMLマッピングの記述を手作業で行いますが、 XDoclet, " +"Middlegen, AndroMDAというようなマッピングドキュメントを生成するツールが いく" +"つか存在します。" -#: index.docbook:23 +#. Tag: para +#: basic_mapping.xml:23 +#, no-c-format msgid "Lets kick off with an example mapping:" msgstr "サンプルのマッピングから始めましょう：" -#: index.docbook:27 +#. Tag: programlisting +#: basic_mapping.xml:27 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\"\n" - " table=\"cats\"\n" - " discriminator-value=\"C\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - "\n" - " <discriminator column=\"subclass\"\n" - " type=\"character\"/>\n" - "\n" - " <property name=\"weight\"/>\n" - "\n" - " <property name=\"birthdate\"\n" - " type=\"date\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"color\"\n" - " type=\"eg.types.ColorUserType\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"sex\"\n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - "\n" - " <property name=\"litterId\"\n" - " column=\"litterId\"\n" - " update=\"false\"/>\n" - "\n" - " <many-to-one name=\"mother\"\n" - " column=\"mother_id\"\n" - " update=\"false\"/>\n" - "\n" - " <set name=\"kittens\"\n" - " inverse=\"true\"\n" - " order-by=\"litter_id\">\n" - " <key column=\"mother_id\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - "\n" - " <subclass name=\"DomesticCat\"\n" - " discriminator-value=\"D\">\n" - "\n" - " <property name=\"name\"\n" - " type=\"string\"/>\n" - "\n" - " </subclass>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Dog\">\n" - " <!-- mapping for Dog could go here -->\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class name=\"Cat\"\n" +" table=\"cats\"\n" +" discriminator-value=\"C\">\n" +"\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +"\n" +" <discriminator column=\"subclass\"\n" +" type=\"character\"/>\n" +"\n" +" <property name=\"weight\"/>\n" +"\n" +" <property name=\"birthdate\"\n" +" type=\"date\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"color\"\n" +" type=\"eg.types.ColorUserType\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"sex\"\n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +"\n" +" <property name=\"litterId\"\n" +" column=\"litterId\"\n" +" update=\"false\"/>\n" +"\n" +" <many-to-one name=\"mother\"\n" +" column=\"mother_id\"\n" +" update=\"false\"/>\n" +"\n" +" <set name=\"kittens\"\n" +" inverse=\"true\"\n" +" order-by=\"litter_id\">\n" +" <key column=\"mother_id\"/>\n" +" <one-to-many class=\"Cat\"/>\n" +" </set>\n" +"\n" +" <subclass name=\"DomesticCat\"\n" +" discriminator-value=\"D\">\n" +"\n" +" <property name=\"name\"\n" +" type=\"string\"/>\n" +"\n" +" </subclass>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Dog\">\n" +" <!-- mapping for Dog could go here -->\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?> -\n" - "<!DOCTYPE hibernate-mapping PUBLIC -\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\"> -\n" - " -\n" - "<hibernate-mapping package=\"eg\"> -\n" - " -\n" - " <class name=\"Cat\" -\n" - " table=\"cats\" -\n" - " discriminator-value=\"C\"> -\n" - " -\n" - " <id name=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " -\n" - " <discriminator column=\"subclass\" -\n" - " type=\"character\"/> -\n" - " -\n" - " <property name=\"weight\"/> -\n" - " -\n" - " <property name=\"birthdate\" -\n" - " type=\"date\" -\n" - " not-null=\"true\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <property name=\"color\" -\n" - " type=\"eg.types.ColorUserType\" -\n" - " not-null=\"true\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <property name=\"sex\" -\n" - " not-null=\"true\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <property name=\"litterId\" -\n" - " column=\"litterId\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <many-to-one name=\"mother\" -\n" - " column=\"mother_id\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <set name=\"kittens\" -\n" - " inverse=\"true\" -\n" - " order-by=\"litter_id\"> -\n" - " <key column=\"mother_id\"/> -\n" - " <one-to-many class=\"Cat\"/> -\n" - " </set> -\n" - " -\n" - " <subclass name=\"DomesticCat\" -\n" - " discriminator-value=\"D\"> -\n" - " -\n" - " <property name=\"name\" -\n" - " type=\"string\"/> -\n" - " -\n" - " </subclass> -\n" - " -\n" - " </class> -\n" - " -\n" - " <class name=\"Dog\"> -\n" - " <!-- ここにDog用のマッピング書きます --> -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:29 -msgid "We will now discuss the content of the mapping document. We will only describe the document elements and attributes that are used by Hibernate at runtime. The mapping document also contains some extra optional attributes and elements that affect the database schemas exported by the schema export tool. (For example the <literal> not-null</literal> attribute.)" -msgstr "マッピングドキュメントの内容を説明します。。 ただし、ここではHibernateが実行時に使うドキュメント要素と属性についてのみ説明します。 マッピングドキュメントは、いくつかのオプション属性と要素を含んでいます（例えば <literal>not-null</literal> 属性）。 それらはスキーマエクスポートツールが出力するデータベーススキーマに影響を与えるものです。" +#. Tag: para +#: basic_mapping.xml:29 +#, no-c-format +msgid "" +"We will now discuss the content of the mapping document. We will only " +"describe the document elements and attributes that are used by Hibernate at " +"runtime. The mapping document also contains some extra optional attributes " +"and elements that affect the database schemas exported by the schema export " +"tool. (For example the <literal> not-null</literal> attribute.)" +msgstr "" +"マッピングドキュメントの内容を説明します。。 ただし、ここではHibernateが実行" +"時に使うドキュメント要素と属性についてのみ説明します。 マッピングドキュメント" +"は、いくつかのオプション属性と要素を含んでいます（例えば <literal>not-null</" +"literal> 属性）。 それらはスキーマエクスポートツールが出力するデータベースス" +"キーマに影響を与えるものです。" -#: index.docbook:40 +#. Tag: title +#: basic_mapping.xml:40 +#, no-c-format msgid "Doctype" msgstr "Doctype" -#: index.docbook:42 -msgid "All XML mappings should declare the doctype shown. The actual DTD may be found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/hibernate </literal> or in <literal>hibernate3.jar</literal>. Hibernate will always look for the DTD in its classpath first. If you experience lookups of the DTD using an Internet connection, check your DTD declaration against the contents of your claspath." -msgstr "XMLマッピングでは、お見せしたようなドキュメント型を必ず定義すべきです。 実際のDTDは、上記のURLの <literal>hibernate-x.x.x/src/org/hibernate</literal> ディレクトリ、 または <literal>hibernate.jar</literal> 内にあります。 Hibernateは常に、そのクラスパス内でDTDを探し始めます。 インターネットにあるDTDファイルを探そうとしたなら、 クラスパスの内容を見て、DTD宣言を確認してください。" +#. Tag: para +#: basic_mapping.xml:42 +#, no-c-format +msgid "" +"All XML mappings should declare the doctype shown. The actual DTD may be " +"found at the URL above, in the directory <literal>hibernate-x.x.x/src/org/" +"hibernate </literal> or in <literal>hibernate3.jar</literal>. Hibernate will " +"always look for the DTD in its classpath first. If you experience lookups of " +"the DTD using an Internet connection, check your DTD declaration against the " +"contents of your claspath." +msgstr "" +"XMLマッピングでは、お見せしたようなドキュメント型を必ず定義すべきです。 実際" +"のDTDは、上記のURLの <literal>hibernate-x.x.x/src/org/hibernate</literal> " +"ディレクトリ、 または <literal>hibernate.jar</literal> 内にあります。 " +"Hibernateは常に、そのクラスパス内でDTDを探し始めます。 インターネットにある" +"DTDファイルを探そうとしたなら、 クラスパスの内容を見て、DTD宣言を確認してくだ" +"さい。" -#: index.docbook:52 +#. Tag: title +#: basic_mapping.xml:52 +#, no-c-format msgid "EntityResolver" msgstr "エンティティ・リゾルバ" -#: index.docbook:53 -msgid "As mentioned previously, Hibernate will first attempt to resolve DTDs in its classpath. The manner in which it does this is by registering a custom <literal>org.xml.sax.EntityResolver</literal> implementation with the SAXReader it uses to read in the xml files. This custom <literal>EntityResolver</literal> recognizes two different systemId namespaces." -msgstr "前述したように、Hibernateはまずクラスパス内でDTDを解決しようとします。 <literal>org.xml.sax.EntityResolver</literal> のカスタム実装を XMLファイルを読み込むためのSAXReaderに登録することによって、DTDを解決します。 このカスタムの <literal>EntityResolver</literal> は2つの異なるシステムID名前空間を認識します。" +#. Tag: para +#: basic_mapping.xml:53 +#, no-c-format +msgid "" +"As mentioned previously, Hibernate will first attempt to resolve DTDs in its " +"classpath. The manner in which it does this is by registering a custom " +"<literal>org.xml.sax.EntityResolver</literal> implementation with the " +"SAXReader it uses to read in the xml files. This custom " +"<literal>EntityResolver</literal> recognizes two different systemId " +"namespaces." +msgstr "" +"前述したように、Hibernateはまずクラスパス内でDTDを解決しようとします。 " +"<literal>org.xml.sax.EntityResolver</literal> のカスタム実装を XMLファイルを" +"読み込むためのSAXReaderに登録することによって、DTDを解決します。 このカスタム" +"の <literal>EntityResolver</literal> は2つの異なるシステムID名前空間を認識し" +"ます。" -#: index.docbook:61 -msgid "a <literal>hibernate namespace</literal> is recognized whenever the resolver encounteres a systemId starting with <literal>http://hibernate.sourceforge.net/</literal>; the resolver attempts to resolve these entities via the classlaoder which loaded the Hibernate classes." -msgstr "<literal>Hibernate名前空間</literal> は、リゾルバが <literal>http://hibernate.sourceforge.net/</literal> で始まるシステムIDに到達したときに、 認識されます。 そしてリゾルバは、Hibernateのクラスをロードしたクラスローダを用いて、 これらのエンティティを解決しようとします。" +#. Tag: para +#: basic_mapping.xml:61 +#, no-c-format +msgid "" +"a <literal>hibernate namespace</literal> is recognized whenever the resolver " +"encounteres a systemId starting with <literal>http://hibernate.sourceforge." +"net/</literal>; the resolver attempts to resolve these entities via the " +"classlaoder which loaded the Hibernate classes." +msgstr "" +"<literal>Hibernate名前空間</literal> は、リゾルバが <literal>http://" +"hibernate.sourceforge.net/</literal> で始まるシステムIDに到達したときに、 認" +"識されます。 そしてリゾルバは、Hibernateのクラスをロードしたクラスローダを用" +"いて、 これらのエンティティを解決しようとします。" -#: index.docbook:70 -msgid "a <literal>user namespace</literal> is recognized whenever the resolver encounteres a systemId using a <literal>classpath://</literal> URL protocol; the resolver will attempt to resolve these entities via (1) the current thread context classloader and (2) the classloader which loaded the Hibernate classes." -msgstr "<literal>ユーザ名前空間</literal> は、リゾルバが URLプロトコルの <literal>classpath://</literal> を使ったシステムIDに到達したときに、 認識されます。そしてリゾルバは、(1)カレントスレッドのコンテキストクラスローダー、 または(2)Hibernateのクラスをロードしたクラスローダを使って、 これらのエンティティを解決しようとします。" +#. Tag: para +#: basic_mapping.xml:70 +#, no-c-format +msgid "" +"a <literal>user namespace</literal> is recognized whenever the resolver " +"encounteres a systemId using a <literal>classpath://</literal> URL protocol; " +"the resolver will attempt to resolve these entities via (1) the current " +"thread context classloader and (2) the classloader which loaded the " +"Hibernate classes." +msgstr "" +"<literal>ユーザ名前空間</literal> は、リゾルバが URLプロトコルの " +"<literal>classpath://</literal> を使ったシステムIDに到達したときに、 認識され" +"ます。そしてリゾルバは、(1)カレントスレッドのコンテキストクラスローダー、 ま" +"たは(2)Hibernateのクラスをロードしたクラスローダを使って、 これらのエンティ" +"ティを解決しようとします。" -#: index.docbook:79 +#. Tag: para +#: basic_mapping.xml:79 +#, no-c-format msgid "An example of utilizing user namespacing:" msgstr "下記は、ユーザ名前空間を使った例です：" -#: index.docbook:82 +#. Tag: programlisting +#: basic_mapping.xml:82 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" - " <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" - "]>\n" - "\n" - "<hibernate-mapping package=\"your.domain\">\n" - " <class name=\"MyEntity\">\n" - " <id name=\"id\" type=\"my-custom-id-type\">\n" - " ...\n" - " </id>\n" - " <class>\n" - " &types;\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [\n" +" <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\">\n" +"]>\n" +"\n" +"<hibernate-mapping package=\"your.domain\">\n" +" <class name=\"MyEntity\">\n" +" <id name=\"id\" type=\"my-custom-id-type\">\n" +" ...\n" +" </id>\n" +" <class>\n" +" &types;\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?> -\n" - "<!DOCTYPE hibernate-mapping PUBLIC -\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\" [ -\n" - " <!ENTITY types SYSTEM \"classpath://your/domain/types.xml\"> -\n" - "]> -\n" - " -\n" - "<hibernate-mapping package=\"your.domain\"> -\n" - " <class name=\"MyEntity\"> -\n" - " <id name=\"id\" type=\"my-custom-id-type\"> -\n" - " ... -\n" - " </id> -\n" - " <class> -\n" - " &types; -\n" - "</hibernate-mapping>]]>" -#: index.docbook:83 -msgid "Where <literal>types.xml</literal> is a resource in the <literal>your.domain</literal> package and contains a custom <xref linkend=\"mapping-types-custom\"/>typedef." -msgstr "ここで <literal>types.xml</literal> は <literal>your.domain</literal> パッケージ内のリソースであり、 カスタム <xref linkend=\"mapping-types-custom\"/>typedef を含むます。" +#. Tag: para +#: basic_mapping.xml:83 +#, no-c-format +msgid "" +"Where <literal>types.xml</literal> is a resource in the <literal>your." +"domain</literal> package and contains a custom <link linkend=\"mapping-types-" +"custom\">typedef</link>." +msgstr "" +"ここで <literal>types.xml</literal> は <literal>your.domain</literal> パッ" +"ケージ内のリソースであり、 カスタム <xref linkend=\"mapping-types-custom" +"\">typedef</xref> を含むます。" -#: index.docbook:91 +#. Tag: title +#: basic_mapping.xml:91 +#, no-c-format msgid "hibernate-mapping" msgstr "hibernate-mapping" -#: index.docbook:93 -msgid "This element has several optional attributes. The <literal>schema</literal> and <literal>catalog</literal> attributes specify that tables referred to in this mapping belong to the named schema and/or catalog. If specified, tablenames will be qualified by the given schema and catalog names. If missing, tablenames will be unqualified. The <literal>default-cascade</literal> attribute specifies what cascade style should be assumed for properties and collections which do not specify a <literal>cascade</literal> attribute. The <literal>auto-import</literal> attribute lets us use unqualified class names in the query language, by default." -msgstr "この要素にはいくつかオプション属性があります。<literal>schema</literal> 属性と <literal>catalog</literal> 属性は、 このマッピングが参照するテーブルが、この属性によって指定されたスキーマと(または)カタログに属することを指定します。 この属性が指定されると、テーブル名は与えられたスキーマ名とカタログ名で修飾されます。これらの属性が指定されていなければ、 テーブル名は修飾されません。<literal>default-cascade</literal> 属性は、 <literal>cascade</literal> 属性を指定していないプロパティやコレクションに、 どのカスケードスタイルを割り当てるかを指定します。 <literal>auto-import</literal> 属性は、 クエリ言語内で修飾されていないクラス名を、デフォルトで使えるようにします。" +#. Tag: para +#: basic_mapping.xml:93 +#, no-c-format +msgid "" +"This element has several optional attributes. The <literal>schema</literal> " +"and <literal>catalog</literal> attributes specify that tables referred to in " +"this mapping belong to the named schema and/or catalog. If specified, " +"tablenames will be qualified by the given schema and catalog names. If " +"missing, tablenames will be unqualified. The <literal>default-cascade</" +"literal> attribute specifies what cascade style should be assumed for " +"properties and collections which do not specify a <literal>cascade</literal> " +"attribute. The <literal>auto-import</literal> attribute lets us use " +"unqualified class names in the query language, by default." +msgstr "" +"この要素にはいくつかオプション属性があります。<literal>schema</literal> 属性" +"と <literal>catalog</literal> 属性は、 このマッピングが参照するテーブルが、こ" +"の属性によって指定されたスキーマと(または)カタログに属することを指定します。 " +"この属性が指定されると、テーブル名は与えられたスキーマ名とカタログ名で修飾さ" +"れます。これらの属性が指定されていなければ、 テーブル名は修飾されません。" +"<literal>default-cascade</literal> 属性は、 <literal>cascade</literal> 属性を" +"指定していないプロパティやコレクションに、 どのカスケードスタイルを割り当てる" +"かを指定します。 <literal>auto-import</literal> 属性は、 クエリ言語内で修飾さ" +"れていないクラス名を、デフォルトで使えるようにします。" -#: index.docbook:114 +#. Tag: programlisting +#: basic_mapping.xml:114 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping\n" - " schema=\"schemaName\"\n" - " catalog=\"catalogName\"\n" - " default-cascade=\"cascade_style\"\n" - " default-access=\"field|property|ClassName\"\n" - " default-lazy=\"true|false\"\n" - " auto-import=\"true|false\"\n" - " package=\"package.name\"\n" - " />]]>" +"<![CDATA[<hibernate-mapping\n" +" schema=\"schemaName\"\n" +" catalog=\"catalogName\"\n" +" default-cascade=\"cascade_style\"\n" +" default-access=\"field|property|ClassName\"\n" +" default-lazy=\"true|false\"\n" +" auto-import=\"true|false\"\n" +" package=\"package.name\"\n" +" />]]>" msgstr "" - "<![CDATA[<hibernate-mapping -\n" - " schema=\"schemaName\" -\n" - " catalog=\"catalogName\" -\n" - " default-cascade=\"cascade_style\" -\n" - " default-access=\"field|property|ClassName\" -\n" - " default-lazy=\"true|false\" -\n" - " auto-import=\"true|false\" -\n" - " package=\"package.name\" -\n" - " />]]>" -#: index.docbook:117 +#. Tag: para +#: basic_mapping.xml:117 +#, no-c-format msgid "<literal>schema</literal> (optional): The name of a database schema." msgstr "<literal>schema</literal>（オプション）：データベーススキーマの名前。" -#: index.docbook:122 +#. Tag: para +#: basic_mapping.xml:122 +#, no-c-format msgid "<literal>catalog</literal> (optional): The name of a database catalog." -msgstr "<literal>catalog</literal> （オプション）：データベースカタログの名前。" +msgstr "" +"<literal>catalog</literal> （オプション）：データベースカタログの名前。" -#: index.docbook:127 -msgid "<literal>default-cascade</literal> (optional - defaults to <literal>none</literal>): A default cascade style." -msgstr "<literal>default-cascade</literal> （オプション - デフォルトは <literal>none</literal>）： デフォルトのカスケードスタイル。" +#. Tag: para +#: basic_mapping.xml:127 +#, no-c-format +msgid "" +"<literal>default-cascade</literal> (optional - defaults to <literal>none</" +"literal>): A default cascade style." +msgstr "" +"<literal>default-cascade</literal> （オプション - デフォルトは " +"<literal>none</literal>）： デフォルトのカスケードスタイル。" -#: index.docbook:133 -msgid "<literal>default-access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing all properties. Can be a custom implementation of <literal>PropertyAccessor</literal>." -msgstr "<literal>default-access</literal> (オプション - デフォルトは <literal>property</literal> ）： Hibernateがプロパティにアクセスする際に採るべき戦略。 <literal>PropertyAccessor</literal> を実装することでカスタマイズ可能。" +#. Tag: para +#: basic_mapping.xml:133 +#, no-c-format +msgid "" +"<literal>default-access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing all properties. " +"Can be a custom implementation of <literal>PropertyAccessor</literal>." +msgstr "" +"<literal>default-access</literal> (オプション - デフォルトは " +"<literal>property</literal> ）： Hibernateがプロパティにアクセスする際に採る" +"べき戦略。 <literal>PropertyAccessor</literal> を実装することでカスタマイズ可" +"能。" -#: index.docbook:140 -msgid "<literal>default-lazy</literal> (optional - defaults to <literal>true</literal>): The default value for unspecifed <literal>lazy</literal> attributes of class and collection mappings." -msgstr "<literal>default-lazy</literal> (オプション - デフォルトは <literal>true</literal> )： <literal>lazy</literal> 属性が指定されていないクラスやコレクションマッピングに対するデフォルト値。" +#. Tag: para +#: basic_mapping.xml:140 +#, no-c-format +msgid "" +"<literal>default-lazy</literal> (optional - defaults to <literal>true</" +"literal>): The default value for unspecifed <literal>lazy</literal> " +"attributes of class and collection mappings." +msgstr "" +"<literal>default-lazy</literal> (オプション - デフォルトは <literal>true</" +"literal> )： <literal>lazy</literal> 属性が指定されていないクラスやコレクショ" +"ンマッピングに対するデフォルト値。" -#: index.docbook:147 -msgid "<literal>auto-import</literal> (optional - defaults to <literal>true</literal>): Specifies whether we can use unqualified class names (of classes in this mapping) in the query language." -msgstr "<literal>auto-import</literal> （オプション - デフォルトは <literal>true</literal>）： クエリ言語内で、（このマッピング内のクラスの）修飾されていないクラス名を使えるかどうかを指定します。" +#. Tag: para +#: basic_mapping.xml:147 +#, no-c-format +msgid "" +"<literal>auto-import</literal> (optional - defaults to <literal>true</" +"literal>): Specifies whether we can use unqualified class names (of classes " +"in this mapping) in the query language." +msgstr "" +"<literal>auto-import</literal> （オプション - デフォルトは <literal>true</" +"literal>）： クエリ言語内で、（このマッピング内のクラスの）修飾されていないク" +"ラス名を使えるかどうかを指定します。" -#: index.docbook:154 -msgid "<literal>package</literal> (optional): Specifies a package prefix to assume for unqualified class names in the mapping document." -msgstr "<literal>package</literal> (オプション): マッピングドキュメント内で修飾されていないクラス名に対して割り当てる、 パッケージの接頭辞(prefix)を指定します。" +#. Tag: para +#: basic_mapping.xml:154 +#, no-c-format +msgid "" +"<literal>package</literal> (optional): Specifies a package prefix to assume " +"for unqualified class names in the mapping document." +msgstr "" +"<literal>package</literal> (オプション): マッピングドキュメント内で修飾されて" +"いないクラス名に対して割り当てる、 パッケージの接頭辞(prefix)を指定します。" -#: index.docbook:162 -msgid "If you have two persistent classes with the same (unqualified) name, you should set <literal>auto-import=\"false\"</literal>. Hibernate will throw an exception if you attempt to assign two classes to the same \"imported\" name." -msgstr "（修飾されていない）同じ名前の永続クラスが2つあるなら、 <literal>auto-import=\"false\"</literal> を設定すべきです。 2つのクラスに”インポートされた”同じ名前を割り当てようとすると、Hibernateは例外を投げます。" +#. Tag: para +#: basic_mapping.xml:162 +#, no-c-format +msgid "" +"If you have two persistent classes with the same (unqualified) name, you " +"should set <literal>auto-import=\"false\"</literal>. Hibernate will throw an " +"exception if you attempt to assign two classes to the same \"imported\" name." +msgstr "" +"（修飾されていない）同じ名前の永続クラスが2つあるなら、 <literal>auto-import=" +"\"false\"</literal> を設定すべきです。 2つのクラスに”インポートされた”同じ名" +"前を割り当てようとすると、Hibernateは例外を投げます。" -#: index.docbook:168 -msgid "Note that the <literal>hibernate-mapping</literal> element allows you to nest several persistent <literal>&lt;class&gt;</literal> mappings, as shown above. It is however good practice (and expected by some tools) to map only a single persistent class (or a single class hierarchy) in one mapping file and name it after the persistent superclass, e.g. <literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, <literal>Animal.hbm.xml</literal>." -msgstr "<literal>hibernate-mapping</literal> 要素は、最初の例で示したようにいくつかの永続 <literal>&lt;class&gt;</literal> マッピングをネストできます。 しかし、１つのマッピングファイルではただひとつの永続クラス(またはひとつのクラス階層)にマッピングするようにし、 さらに永続スーパークラスの後で指定するべきでしょう(いくつかのツールはこのようなマッピングファイルを想定しています)。 例えば次のようになります。： <literal>Cat.hbm.xml</literal> , <literal>Dog.hbm.xml</literal> , または継承を使うなら <literal>Animal.hbm.xml</literal> 。" +#. Tag: para +#: basic_mapping.xml:168 +#, no-c-format +msgid "" +"Note that the <literal>hibernate-mapping</literal> element allows you to " +"nest several persistent <literal>&lt;class&gt;</literal> mappings, as shown " +"above. It is however good practice (and expected by some tools) to map only " +"a single persistent class (or a single class hierarchy) in one mapping file " +"and name it after the persistent superclass, e.g. <literal>Cat.hbm.xml</" +"literal>, <literal>Dog.hbm.xml</literal>, or if using inheritance, " +"<literal>Animal.hbm.xml</literal>." +msgstr "" +"<literal>hibernate-mapping</literal> 要素は、最初の例で示したようにいくつかの" +"永続 <literal>&lt;class&gt;</literal> マッピングをネストできます。 しかし、１" +"つのマッピングファイルではただひとつの永続クラス(またはひとつのクラス階層)に" +"マッピングするようにし、 さらに永続スーパークラスの後で指定するべきでしょう" +"(いくつかのツールはこのようなマッピングファイルを想定しています)。 例えば次の" +"ようになります。： <literal>Cat.hbm.xml</literal> , <literal>Dog.hbm.xml</" +"literal> , または継承を使うなら <literal>Animal.hbm.xml</literal> 。" -#: index.docbook:181 +#. Tag: title +#: basic_mapping.xml:181 +#, no-c-format msgid "<title>class</title>" -msgstr "<title>class</title>" +msgstr "" -#: index.docbook:183 -msgid "You may declare a persistent class using the <literal>class</literal> element:" +#. Tag: para +#: basic_mapping.xml:183 +#, no-c-format +msgid "" +"You may declare a persistent class using the <literal>class</literal> " +"element:" msgstr "<literal>class</literal> 要素を使って、永続クラスを宣言できます。" -#: index.docbook:211 +#. Tag: programlisting +#: basic_mapping.xml:211 +#, no-c-format msgid "" - "<![CDATA[<class\n" - " name=\"ClassName\"\n" - " table=\"tableName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " mutable=\"true|false\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " proxy=\"ProxyInterface\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " select-before-update=\"true|false\"\n" - " polymorphism=\"implicit|explicit\"\n" - " where=\"arbitrary sql where condition\"\n" - " persister=\"PersisterClass\"\n" - " batch-size=\"N\"\n" - " optimistic-lock=\"none|version|dirty|all\"\n" - " lazy=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " check=\"arbitrary sql check condition\"\n" - " rowid=\"rowid\"\n" - " subselect=\"SQL expression\"\n" - " abstract=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]>" +"<![CDATA[<class\n" +" name=\"ClassName\"\n" +" table=\"tableName\"\n" +" discriminator-value=\"discriminator_value\"\n" +" mutable=\"true|false\"\n" +" schema=\"owner\"\n" +" catalog=\"catalog\"\n" +" proxy=\"ProxyInterface\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" select-before-update=\"true|false\"\n" +" polymorphism=\"implicit|explicit\"\n" +" where=\"arbitrary sql where condition\"\n" +" persister=\"PersisterClass\"\n" +" batch-size=\"N\"\n" +" optimistic-lock=\"none|version|dirty|all\"\n" +" lazy=\"true|false\"\n" +" entity-name=\"EntityName\"\n" +" check=\"arbitrary sql check condition\"\n" +" rowid=\"rowid\"\n" +" subselect=\"SQL expression\"\n" +" abstract=\"true|false\"\n" +" node=\"element-name\"\n" +"/>]]>" msgstr "" - "<![CDATA[<class -\n" - " name=\"ClassName\" -\n" - " table=\"tableName\" -\n" - " discriminator-value=\"discriminator_value\" -\n" - " mutable=\"true|false\" -\n" - " schema=\"owner\" -\n" - " catalog=\"catalog\" -\n" - " proxy=\"ProxyInterface\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " select-before-update=\"true|false\" -\n" - " polymorphism=\"implicit|explicit\" -\n" - " where=\"arbitrary sql where condition\" -\n" - " persister=\"PersisterClass\" -\n" - " batch-size=\"N\" -\n" - " optimistic-lock=\"none|version|dirty|all\" -\n" - " lazy=\"true|false\" -\n" - " entity-name=\"EntityName\" -\n" - " check=\"arbitrary sql check condition\" -\n" - " rowid=\"rowid\" -\n" - " subselect=\"SQL expression\" -\n" - " abstract=\"true|false\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\" -\n" - "/>]]>" -#: index.docbook:214 -msgid "<literal>name</literal> (optional): The fully qualified Java class name of the persistent class (or interface). If this attribute is missing, it is assumed that the mapping is for a non-POJO entity." -msgstr "<literal>name</literal> (オプション)：永続クラス（またはインターフェイス）の完全修飾Javaクラス名。 もしこの属性を指定しなければ、POJOではないエンティティに対するマッピングとして扱われます。" +#. Tag: para +#: basic_mapping.xml:214 +#, no-c-format +msgid "" +"<literal>name</literal> (optional): The fully qualified Java class name of " +"the persistent class (or interface). If this attribute is missing, it is " +"assumed that the mapping is for a non-POJO entity." +msgstr "" +"<literal>name</literal> (オプション)：永続クラス（またはインターフェイス）の" +"完全修飾Javaクラス名。 もしこの属性を指定しなければ、POJOではないエンティティ" +"に対するマッピングとして扱われます。" -#: index.docbook:221 -msgid "<literal>table</literal> (optional - defaults to the unqualified class name): The name of its database table." -msgstr "<literal>table</literal> (オプション - デフォルトは修飾されていないクラス名)：データベーステーブルの名前" +#. Tag: para +#: basic_mapping.xml:221 +#, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to the unqualified class " +"name): The name of its database table." +msgstr "" +"<literal>table</literal> (オプション - デフォルトは修飾されていないクラス" +"名)：データベーステーブルの名前" -#: index.docbook:227 -msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): A value that distiguishes individual subclasses, used for polymorphic behaviour. Acceptable values include <literal>null</literal> and <literal>not null</literal>." -msgstr "<literal>discriminator-value</literal> (オプション - デフォルトはクラス名)： ポリモーフィックな振る舞いに使われる個々のサブクラスを識別するための値。 値は <literal>null</literal> か <literal>not null</literal> のいずれかを取ります。" +#. Tag: para +#: basic_mapping.xml:227 +#, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): A value that distiguishes individual subclasses, used for polymorphic " +"behaviour. Acceptable values include <literal>null</literal> and " +"<literal>not null</literal>." +msgstr "" +"<literal>discriminator-value</literal> (オプション - デフォルトはクラス名)： " +"ポリモーフィックな振る舞いに使われる個々のサブクラスを識別するための値。 値" +"は <literal>null</literal> か <literal>not null</literal> のいずれかを取りま" +"す。" -#: index.docbook:234 -msgid "<literal>mutable</literal> (optional, defaults to <literal>true</literal>): Specifies that instances of the class are (not) mutable." -msgstr "<literal>mutable</literal> (オプション、 デフォルトは <literal>true</literal> )： そのクラスのインスタンスが更新可能（または不可能）であることを指定します。" +#. Tag: para +#: basic_mapping.xml:234 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional, defaults to <literal>true</literal>): " +"Specifies that instances of the class are (not) mutable." +msgstr "" +"<literal>mutable</literal> (オプション、 デフォルトは <literal>true</" +"literal> )： そのクラスのインスタンスが更新可能（または不可能）であることを指" +"定します。" -#: index.docbook:240, index.docbook:2204 -msgid "<literal>schema</literal> (optional): Override the schema name specified by the root <literal>&lt;hibernate-mapping&gt;</literal> element." -msgstr "<literal>schema</literal> （オプション）： ルートの <literal>&lt;hibernate-mapping&gt;</literal> 要素で指定されたスキーマ名をオーバーライドします。" +#. Tag: para +#: basic_mapping.xml:240 basic_mapping.xml:2204 +#, fuzzy, no-c-format +msgid "" +"<literal>schema</literal> (optional): Override the schema name specified by " +"the root <literal>&lt;hibernate-mapping&gt;</literal> element." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>schema</literal> （オプション）： ルートの <literal>&lt;hibernate-" +"mapping&gt;</literal> 要素で指定されたスキーマ名をオーバーライドします。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>schema</literal> (オプション): ルートの <literal>&lt;hibernate-" +"mapping&gt;</literal> 要素で指定したスキーマ名を オーバーライドします。" -#: index.docbook:246, index.docbook:2210 -msgid "<literal>catalog</literal> (optional): Override the catalog name specified by the root <literal>&lt;hibernate-mapping&gt;</literal> element." -msgstr "<literal>catalog</literal> （オプション）：ルートの <literal>&lt;hibernate-mapping&gt;</literal> 要素で指定されたカタログ名をオーバーライドします。" +#. Tag: para +#: basic_mapping.xml:246 basic_mapping.xml:2210 +#, fuzzy, no-c-format +msgid "" +"<literal>catalog</literal> (optional): Override the catalog name specified " +"by the root <literal>&lt;hibernate-mapping&gt;</literal> element." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>catalog</literal> （オプション）：ルートの <literal>&lt;hibernate-" +"mapping&gt;</literal> 要素で指定されたカタログ名をオーバーライドします。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>catalog</literal> (オプション): ルートの <literal>&lt;hibernate-" +"mapping&gt;</literal> 要素で指定したカタログ名を オーバーライドします。" -#: index.docbook:252 -msgid "<literal>proxy</literal> (optional): Specifies an interface to use for lazy initializing proxies. You may specify the name of the class itself." -msgstr "<literal>proxy</literal> （オプション）：遅延初期化プロキシに使うインターフェイスを指定します。 永続化するクラス名そのものを指定することも可能です。" +#. Tag: para +#: basic_mapping.xml:252 +#, no-c-format +msgid "" +"<literal>proxy</literal> (optional): Specifies an interface to use for lazy " +"initializing proxies. You may specify the name of the class itself." +msgstr "" +"<literal>proxy</literal> （オプション）：遅延初期化プロキシに使うインターフェ" +"イスを指定します。 永続化するクラス名そのものを指定することも可能です。" -#: index.docbook:258 -msgid "<literal>dynamic-update</literal> (optional, defaults to <literal>false</literal>): Specifies that <literal>UPDATE</literal> SQL should be generated at runtime and contain only those columns whose values have changed." -msgstr "<literal>dynamic-update</literal> （オプション、 デフォルトは <literal>false</literal> ）： 値が変更されたカラムだけを含むSQLの <literal>UPDATE</literal> 文を、実行時に生成することを指定します。" +#. Tag: para +#: basic_mapping.xml:258 +#, no-c-format +msgid "" +"<literal>dynamic-update</literal> (optional, defaults to <literal>false</" +"literal>): Specifies that <literal>UPDATE</literal> SQL should be generated " +"at runtime and contain only those columns whose values have changed." +msgstr "" +"<literal>dynamic-update</literal> （オプション、 デフォルトは " +"<literal>false</literal> ）： 値が変更されたカラムだけを含むSQLの " +"<literal>UPDATE</literal> 文を、実行時に生成することを指定します。" -#: index.docbook:265 -msgid "<literal>dynamic-insert</literal> (optional, defaults to <literal>false</literal>): Specifies that <literal>INSERT</literal> SQL should be generated at runtime and contain only the columns whose values are not null." -msgstr "<literal>dynamic-insert</literal> （オプション, デフォルトは <literal>false</literal> ）： 値がnullではないカラムだけを含むSQLの <literal>INSERT</literal> 文を、実行時に生成することを指定します。" +#. Tag: para +#: basic_mapping.xml:265 +#, no-c-format +msgid "" +"<literal>dynamic-insert</literal> (optional, defaults to <literal>false</" +"literal>): Specifies that <literal>INSERT</literal> SQL should be generated " +"at runtime and contain only the columns whose values are not null." +msgstr "" +"<literal>dynamic-insert</literal> （オプション, デフォルトは <literal>false</" +"literal> ）： 値がnullではないカラムだけを含むSQLの <literal>INSERT</" +"literal> 文を、実行時に生成することを指定します。" -#: index.docbook:272 -msgid "<literal>select-before-update</literal> (optional, defaults to <literal>false</literal>): Specifies that Hibernate should <emphasis>never</emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that an object is actually modified. In certain cases (actually, only when a transient object has been associated with a new session using <literal>update()</literal>), this means that Hibernate will perform an extra SQL <literal>SELECT</literal> to determine if an <literal>UPDATE</literal> is actually required." -msgstr "<literal>select-before-update</literal> (オプション, デフォルトは <literal>false</literal>): オブジェクトが変更されたのが確実でないならば、HibernateがSQLの <literal>UPDATE</literal> を <emphasis>決して実行しない</emphasis> ことを指定します。 ある特定の場合(実際的には、一時オブジェクトが <literal>update()</literal> を使い、 新しいセッションと関連付けられた時だけ)、<literal>UPDATE</literal> が実際に必要かどうかを決定するために、 Hibernateが余分なSQLの <literal>SELECT</literal> 文を実行することを意味します。" +#. Tag: para +#: basic_mapping.xml:272 +#, no-c-format +msgid "" +"<literal>select-before-update</literal> (optional, defaults to " +"<literal>false</literal>): Specifies that Hibernate should <emphasis>never</" +"emphasis> perform an SQL <literal>UPDATE</literal> unless it is certain that " +"an object is actually modified. In certain cases (actually, only when a " +"transient object has been associated with a new session using <literal>update" +"()</literal>), this means that Hibernate will perform an extra SQL " +"<literal>SELECT</literal> to determine if an <literal>UPDATE</literal> is " +"actually required." +msgstr "" +"<literal>select-before-update</literal> (オプション, デフォルトは " +"<literal>false</literal>): オブジェクトが変更されたのが確実でないならば、" +"HibernateがSQLの <literal>UPDATE</literal> を <emphasis>決して実行しない</" +"emphasis> ことを指定します。 ある特定の場合(実際的には、一時オブジェクトが " +"<literal>update()</literal> を使い、 新しいセッションと関連付けられた時だ" +"け)、<literal>UPDATE</literal> が実際に必要かどうかを決定するために、 " +"Hibernateが余分なSQLの <literal>SELECT</literal> 文を実行することを意味しま" +"す。" -#: index.docbook:282 -msgid "<literal>polymorphism</literal> (optional, defaults to <literal>implicit</literal>): Determines whether implicit or explicit query polymorphism is used." -msgstr "(optional, デフォルトでは <literal>implicit</literal> ): implicit（暗黙）かexplicit（明示）の、 どちらのクエリポリモーフィズムを使うか決定します。" +#. Tag: para +#: basic_mapping.xml:282 +#, no-c-format +msgid "" +"<literal>polymorphism</literal> (optional, defaults to <literal>implicit</" +"literal>): Determines whether implicit or explicit query polymorphism is " +"used." +msgstr "" +"(optional, デフォルトでは <literal>implicit</literal> ): implicit（暗黙）か" +"explicit（明示）の、 どちらのクエリポリモーフィズムを使うか決定します。" -#: index.docbook:288 -msgid "<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</literal> condition to be used when retrieving objects of this class" -msgstr "<literal>where</literal> （オプション）： このクラスのオブジェクトを検索するときに使用する、任意のSQLの <literal>WHERE</literal> 条件を指定します。" +#. Tag: para +#: basic_mapping.xml:288 +#, no-c-format +msgid "" +"<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</" +"literal> condition to be used when retrieving objects of this class" +msgstr "" +"<literal>where</literal> （オプション）： このクラスのオブジェクトを検索する" +"ときに使用する、任意のSQLの <literal>WHERE</literal> 条件を指定します。" -#: index.docbook:294 -msgid "<literal>persister</literal> (optional): Specifies a custom <literal>ClassPersister</literal>." -msgstr "<literal>persister</literal> （オプション）：カスタム <literal>ClassPersister</literal> を指定します。" +#. Tag: para +#: basic_mapping.xml:294 +#, no-c-format +msgid "" +"<literal>persister</literal> (optional): Specifies a custom " +"<literal>ClassPersister</literal>." +msgstr "" +"<literal>persister</literal> （オプション）：カスタム " +"<literal>ClassPersister</literal> を指定します。" -#: index.docbook:299 -msgid "<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) specify a \"batch size\" for fetching instances of this class by identifier." -msgstr "<literal>batch-size</literal> （オプション, デフォルトは <literal>1</literal> ）： 識別子でこのクラスのインスタンスを復元するときの「バッチサイズ」を指定します。" +#. Tag: para +#: basic_mapping.xml:299 +#, no-c-format +msgid "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) " +"specify a \"batch size\" for fetching instances of this class by identifier." +msgstr "" +"<literal>batch-size</literal> （オプション, デフォルトは <literal>1</" +"literal> ）： 識別子でこのクラスのインスタンスを復元するときの「バッチサイ" +"ズ」を指定します。" -#: index.docbook:305 -msgid "<literal>optimistic-lock</literal> (optional, defaults to <literal>version</literal>): Determines the optimistic locking strategy." -msgstr "<literal>optimistic-lock</literal> （オプション,デフォルトは <literal>version</literal> ）： 楽観ロック戦略を決定します。" +#. Tag: para +#: basic_mapping.xml:305 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional, defaults to <literal>version</" +"literal>): Determines the optimistic locking strategy." +msgstr "" +"<literal>optimistic-lock</literal> （オプション,デフォルトは " +"<literal>version</literal> ）： 楽観ロック戦略を決定します。" -#: index.docbook:311 -msgid "<literal>lazy</literal> (optional): Lazy fetching may be completely disabled by setting <literal>lazy=\"false\"</literal>." -msgstr "<literal>lazy</literal> （オプション）： <literal>lazy=\"false\"</literal> と設定することで、 遅延フェッチができなくなります。" +#. Tag: para +#: basic_mapping.xml:311 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional): Lazy fetching may be completely disabled " +"by setting <literal>lazy=\"false\"</literal>." +msgstr "" +"<literal>lazy</literal> （オプション）： <literal>lazy=\"false\"</literal> と" +"設定することで、 遅延フェッチができなくなります。" -#: index.docbook:317 -msgid "<literal>entity-name</literal> (optional, defaults to the class name): Hibernate3 allows a class to be mapped multiple times (to different tables, potentially), and allows entity mappings that are represented by Maps or XML at the Java level. In these cases, you should provide an explicit arbitrary name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\"/> and <xref linkend=\"xml\"/> for more information." -msgstr "<literal>entity-name</literal> （オプション、デフォルトはクラス名）： Hibernate3ではクラスが複数回マッピングでき（場合によっては違うテーブルに対しても）、 JavaレベルでMapやXMLで表現されるエンティティマッピングが可能です。 これらの場合、エンティティに対して任意の名前を、明示的に付けなくてはなりません。 詳しくは <xref linkend=\"persistent-classes-dynamicmodels\"/> と <xref linkend=\"xml\"/> を参照してください。" +#. Tag: para +#: basic_mapping.xml:317 +#, no-c-format +msgid "" +"<literal>entity-name</literal> (optional, defaults to the class name): " +"Hibernate3 allows a class to be mapped multiple times (to different tables, " +"potentially), and allows entity mappings that are represented by Maps or XML " +"at the Java level. In these cases, you should provide an explicit arbitrary " +"name for the entity. See <xref linkend=\"persistent-classes-dynamicmodels\"/" +"> and <xref linkend=\"xml\"/> for more information." +msgstr "" +"<literal>entity-name</literal> （オプション、デフォルトはクラス名）： " +"Hibernate3ではクラスが複数回マッピングでき（場合によっては違うテーブルに対し" +"ても）、 JavaレベルでMapやXMLで表現されるエンティティマッピングが可能です。 " +"これらの場合、エンティティに対して任意の名前を、明示的に付けなくてはなりませ" +"ん。 詳しくは <xref linkend=\"persistent-classes-dynamicmodels\"/> と <xref " +"linkend=\"xml\"/> を参照してください。" -#: index.docbook:327 -msgid "<literal>check</literal> (optional): A SQL expression used to generate a multi-row <emphasis>check</emphasis> constraint for automatic schema generation." -msgstr "<literal>check</literal> （オプション）：自動的にスキーマを生成するために、 複数行の <emphasis>check</emphasis> 制約を生成するSQL式。" +#. Tag: para +#: basic_mapping.xml:327 +#, no-c-format +msgid "" +"<literal>check</literal> (optional): A SQL expression used to generate a " +"multi-row <emphasis>check</emphasis> constraint for automatic schema " +"generation." +msgstr "" +"<literal>check</literal> （オプション）：自動的にスキーマを生成するために、 " +"複数行の <emphasis>check</emphasis> 制約を生成するSQL式。" -#: index.docbook:333 -msgid "<literal>rowid</literal> (optional): Hibernate can use so called ROWIDs on databases which support. E.g. on Oracle, Hibernate can use the <literal>rowid</literal> extra column for fast updates if you set this option to <literal>rowid</literal>. A ROWID is an implementation detail and represents the physical location of a stored tuple." -msgstr "<literal>rowid</literal> （オプション）：Hibernateは、それをサポートしているデータベースでROWIDと 呼ばれるものを使うことができます。 例えばOracleを使っているとき、このオプションに <literal>rowid</literal> を設定すれば、 Hiberanteはupdateを高速化するために <literal>rowid</literal> という特別なカラムを使うことができます。 ROWIDは詳細な実装であり、保存されたタプルの物理的な位置を表しています。" +#. Tag: para +#: basic_mapping.xml:333 +#, no-c-format +msgid "" +"<literal>rowid</literal> (optional): Hibernate can use so called ROWIDs on " +"databases which support. E.g. on Oracle, Hibernate can use the " +"<literal>rowid</literal> extra column for fast updates if you set this " +"option to <literal>rowid</literal>. A ROWID is an implementation detail and " +"represents the physical location of a stored tuple." +msgstr "" +"<literal>rowid</literal> （オプション）：Hibernateは、それをサポートしている" +"データベースでROWIDと 呼ばれるものを使うことができます。 例えばOracleを使って" +"いるとき、このオプションに <literal>rowid</literal> を設定すれば、 Hiberante" +"はupdateを高速化するために <literal>rowid</literal> という特別なカラムを使う" +"ことができます。 ROWIDは詳細な実装であり、保存されたタプルの物理的な位置を表" +"しています。" -#: index.docbook:341 -msgid "<literal>subselect</literal> (optional): Maps an immutable and read-only entity to a database subselect. Useful if you want to have a view instead of a base table, but don't. See below for more information." -msgstr "<literal>subselect</literal> （オプション）：不変かつ読み取り専用であるエンティティを データベースの副問合せ（subselect）にマッピングします。 もし元のテーブルの代わりにビューを持ちたければ有用ですが、 そうでないのなら有用ではありません。より詳しい情報は下記を参照してください。" +#. Tag: para +#: basic_mapping.xml:341 +#, no-c-format +msgid "" +"<literal>subselect</literal> (optional): Maps an immutable and read-only " +"entity to a database subselect. Useful if you want to have a view instead of " +"a base table, but don't. See below for more information." +msgstr "" +"<literal>subselect</literal> （オプション）：不変かつ読み取り専用であるエン" +"ティティを データベースの副問合せ（subselect）にマッピングします。 もし元の" +"テーブルの代わりにビューを持ちたければ有用ですが、 そうでないのなら有用ではあ" +"りません。より詳しい情報は下記を参照してください。" -#: index.docbook:348 -msgid "<literal>abstract</literal> (optional): Used to mark abstract superclasses in <literal>&lt;union-subclass&gt;</literal> hierarchies." -msgstr "<literal>abstract</literal> （オプション）： <literal>&lt;union-subclass&gt;</literal> 階層内の抽象スーパークラスにマークするために使います。" +#. Tag: para +#: basic_mapping.xml:348 +#, no-c-format +msgid "" +"<literal>abstract</literal> (optional): Used to mark abstract superclasses " +"in <literal>&lt;union-subclass&gt;</literal> hierarchies." +msgstr "" +"<literal>abstract</literal> （オプション）： <literal>&lt;union-subclass&gt;" +"</literal> 階層内の抽象スーパークラスにマークするために使います。" -#: index.docbook:356 -msgid "It is perfectly acceptable for the named persistent class to be an interface. You would then declare implementing classes of that interface using the <literal>&lt;subclass&gt;</literal> element. You may persist any <emphasis>static</emphasis> inner class. You should specify the class name using the standard form ie. <literal>eg.Foo$Bar</literal>." -msgstr "永続クラスの名前にインターフェイスを指定してもまったく問題ありません。 そのときは <literal>&lt;subclass&gt;</literal> 要素を使って、 そのインターフェイスを実装するクラスを定義してください。 <emphasis>static</emphasis> な内部クラスでも永続化できます。 そのときは標準形式、例えば <literal>eg.Foo$Bar</literal> を使ってクラス名を指定してください。" +#. Tag: para +#: basic_mapping.xml:356 +#, no-c-format +msgid "" +"It is perfectly acceptable for the named persistent class to be an " +"interface. You would then declare implementing classes of that interface " +"using the <literal>&lt;subclass&gt;</literal> element. You may persist any " +"<emphasis>static</emphasis> inner class. You should specify the class name " +"using the standard form ie. <literal>eg.Foo$Bar</literal>." +msgstr "" +"永続クラスの名前にインターフェイスを指定してもまったく問題ありません。 そのと" +"きは <literal>&lt;subclass&gt;</literal> 要素を使って、 そのインターフェイス" +"を実装するクラスを定義してください。 <emphasis>static</emphasis> な内部クラス" +"でも永続化できます。 そのときは標準形式、例えば <literal>eg.Foo$Bar</" +"literal> を使ってクラス名を指定してください。" -#: index.docbook:363 -msgid "Immutable classes, <literal>mutable=\"false\"</literal>, may not be updated or deleted by the application. This allows Hibernate to make some minor performance optimizations." -msgstr "<literal>mutable=\"false\"</literal> 指定をした不変クラスは、 アプリケーションによる更新や削除が出来ないことがあります。 これにより、Hibernateがパフォーマンスを少し改善します。" +#. Tag: para +#: basic_mapping.xml:363 +#, no-c-format +msgid "" +"Immutable classes, <literal>mutable=\"false\"</literal>, may not be updated " +"or deleted by the application. This allows Hibernate to make some minor " +"performance optimizations." +msgstr "" +"<literal>mutable=\"false\"</literal> 指定をした不変クラスは、 アプリケーショ" +"ンによる更新や削除が出来ないことがあります。 これにより、Hibernateがパフォー" +"マンスを少し改善します。" -#: index.docbook:368 -msgid "The optional <literal>proxy</literal> attribute enables lazy initialization of persistent instances of the class. Hibernate will initially return CGLIB proxies which implement the named interface. The actual persistent object will be loaded when a method of the proxy is invoked. See \"Initializing collections and proxies\" below." -msgstr "オプションの <literal>proxy</literal> 属性により、クラスの永続インスタンスの遅延初期化が可能になります。 Hibernateは最初に、指定したインターフェイスを実装したCGLIBプロキシを返します。 実際の永続オブジェクトはプロキシのメソッドを呼び出すときにロードします。 以下の「遅延初期化のためのプロキシ」を参照してください。" +#. Tag: para +#: basic_mapping.xml:368 +#, no-c-format +msgid "" +"The optional <literal>proxy</literal> attribute enables lazy initialization " +"of persistent instances of the class. Hibernate will initially return CGLIB " +"proxies which implement the named interface. The actual persistent object " +"will be loaded when a method of the proxy is invoked. See \"Initializing " +"collections and proxies\" below." +msgstr "" +"オプションの <literal>proxy</literal> 属性により、クラスの永続インスタンスの" +"遅延初期化が可能になります。 Hibernateは最初に、指定したインターフェイスを実" +"装したCGLIBプロキシを返します。 実際の永続オブジェクトはプロキシのメソッドを" +"呼び出すときにロードします。 以下の「遅延初期化のためのプロキシ」を参照してく" +"ださい。" -#: index.docbook:375 -msgid "<emphasis>Implicit</emphasis> polymorphism means that instances of the class will be returned by a query that names any superclass or implemented interface or the class and that instances of any subclass of the class will be returned by a query that names the class itself. <emphasis>Explicit</emphasis> polymorphism means that class instances will be returned only by queries that explicitly name that class and that queries that name the class will return only instances of subclasses mapped inside this <literal>&lt;class&gt;</literal> declaration as a <literal>&lt;subclass&gt;</literal> or <literal>&lt;joined-subclass&gt;</literal>. For most purposes the default, <literal>polymorphism=\"implicit\"</literal>, is appropriate. Explicit polymorphism is useful when two different classes are mapped to the same table (this allows a \"lightweight\" class that contains a subset of the table columns)." -msgstr "<emphasis>暗黙的</emphasis> ポリモーフィズムとは、次の二つを意味しています。 一つはクラスのインスタンスが、スーパークラスや実装したインターフェイス、またそのクラスを指定するクエリによって返されることで、 もう一つはそのクラスのサブクラスのインスタンスが、そのクラス自身を指定したクエリによって返されることです。 また、<emphasis>明示的</emphasis> ポリモーフィズムとは、次の二つを意味しています。 一つはクラスのインスタンスが、そのクラスを明示的に指定したクエリによってのみ返されることで、 もう一つはクラスを指定したクエリが、<literal>&lt;class&gt;</literal> 要素の中で <literal>&lt;subclass&gt;</literal> や <literal>&lt;joined-subclass&gt;</literal> とマッピングされているサブクラスのインスタンスだけを返すこ�! ��です。 ほとんどの用途ではデフォルトの <literal>polymorphism=\"implicit\"</literal> が適切です。 明示的なポリモーフィズムは、2つの違ったクラスが同じテーブルにマッピングされているときに有用です （これによってテーブルカラムのサブセットを含む、「軽量な」クラスが可能になります）。" +#. Tag: para +#: basic_mapping.xml:375 +#, no-c-format +msgid "" +"<emphasis>Implicit</emphasis> polymorphism means that instances of the class " +"will be returned by a query that names any superclass or implemented " +"interface or the class and that instances of any subclass of the class will " +"be returned by a query that names the class itself. <emphasis>Explicit</" +"emphasis> polymorphism means that class instances will be returned only by " +"queries that explicitly name that class and that queries that name the class " +"will return only instances of subclasses mapped inside this <literal>&lt;" +"class&gt;</literal> declaration as a <literal>&lt;subclass&gt;</literal> or " +"<literal>&lt;joined-subclass&gt;</literal>. For most purposes the default, " +"<literal>polymorphism=\"implicit\"</literal>, is appropriate. Explicit " +"polymorphism is useful when two different classes are mapped to the same " +"table (this allows a \"lightweight\" class that contains a subset of the " +"table columns)." +msgstr "" +"<emphasis>暗黙的</emphasis> ポリモーフィズムとは、次の二つを意味しています。 " +"一つはクラスのインスタンスが、スーパークラスや実装したインターフェイス、また" +"そのクラスを指定するクエリによって返されることで、 もう一つはそのクラスのサブ" +"クラスのインスタンスが、そのクラス自身を指定したクエリによって返されることで" +"す。 また、<emphasis>明示的</emphasis> ポリモーフィズムとは、次の二つを意味し" +"ています。 一つはクラスのインスタンスが、そのクラスを明示的に指定したクエリに" +"よってのみ返されることで、 もう一つはクラスを指定したクエリが、<literal>&lt;" +"class&gt;</literal> 要素の中で <literal>&lt;subclass&gt;</literal> や " +"<literal>&lt;joined-subclass&gt;</literal> とマッピングされているサブクラスの" +"インスタンスだけを返すことです。 ほとんどの用途ではデフォルトの " +"<literal>polymorphism=\"implicit\"</literal> が適切です。 明示的なポリモー" +"フィズムは、2つの違ったクラスが同じテーブルにマッピングされているときに有用で" +"す （これによってテーブルカラムのサブセットを含む、「軽量な」クラスが可能にな" +"ります）。" -#: index.docbook:387 -msgid "The <literal>persister</literal> attribute lets you customize the persistence strategy used for the class. You may, for example, specify your own subclass of <literal>org.hibernate.persister.EntityPersister</literal> or you might even provide a completely new implementation of the interface <literal>org.hibernate.persister.ClassPersister</literal> that implements persistence via, for example, stored procedure calls, serialization to flat files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for a simple example (of \"persistence\" to a <literal>Hashtable</literal>)." -msgstr "<literal>persister</literal> 属性を指定することで、クラスの永続化戦略をカスタマイズできます。 例えば <literal>org.hibernate.persister.EntityPersister</literal> 自身のサブクラスを指定したり、 また例えばストアドプロシージャコール、フラットファイルへシリアライズ、 LDAPなどを通した永続性を実装する <literal>org.hibernate.persister.ClassPersister</literal> インターフェイスの完全に新しい実装を提供できます。簡単な例として <literal>org.hibernate.test.CustomPersister</literal> を見てください（これは <literal>Hashtable</literal> の「永続化」です）。" +#. Tag: para +#: basic_mapping.xml:387 +#, no-c-format +msgid "" +"The <literal>persister</literal> attribute lets you customize the " +"persistence strategy used for the class. You may, for example, specify your " +"own subclass of <literal>org.hibernate.persister.EntityPersister</literal> " +"or you might even provide a completely new implementation of the interface " +"<literal>org.hibernate.persister.ClassPersister</literal> that implements " +"persistence via, for example, stored procedure calls, serialization to flat " +"files or LDAP. See <literal>org.hibernate.test.CustomPersister</literal> for " +"a simple example (of \"persistence\" to a <literal>Hashtable</literal>)." +msgstr "" +"<literal>persister</literal> 属性を指定することで、クラスの永続化戦略をカスタ" +"マイズできます。 例えば <literal>org.hibernate.persister.EntityPersister</" +"literal> 自身のサブクラスを指定したり、 また例えばストアドプロシージャコー" +"ル、フラットファイルへシリアライズ、 LDAPなどを通した永続性を実装する " +"<literal>org.hibernate.persister.ClassPersister</literal> インターフェイスの" +"完全に新しい実装を提供できます。簡単な例として <literal>org.hibernate.test." +"CustomPersister</literal> を見てください（これは <literal>Hashtable</" +"literal> の「永続化」です）。" -#: index.docbook:398 -msgid "Note that the <literal>dynamic-update</literal> and <literal>dynamic-insert</literal> settings are not inherited by subclasses and so may also be specified on the <literal>&lt;subclass&gt;</literal> or <literal>&lt;joined-subclass&gt;</literal> elements. These settings may increase performance in some cases, but might actually decrease performance in others. Use judiciously." -msgstr "<literal>dynamic-update</literal> と <literal>dynamic-insert</literal> の設定はサブクラスに継承されません。 そのため <literal>&lt;subclass&gt;</literal> や <literal>&lt;joined-subclass&gt;</literal> 要素を指定することも出来ます。 これらの設定はパフォーマンスを向上させる事もありますが、落とすこともありますので、慎重に使用してください。" +#. Tag: para +#: basic_mapping.xml:398 +#, no-c-format +msgid "" +"Note that the <literal>dynamic-update</literal> and <literal>dynamic-insert</" +"literal> settings are not inherited by subclasses and so may also be " +"specified on the <literal>&lt;subclass&gt;</literal> or <literal>&lt;joined-" +"subclass&gt;</literal> elements. These settings may increase performance in " +"some cases, but might actually decrease performance in others. Use " +"judiciously." +msgstr "" +"<literal>dynamic-update</literal> と <literal>dynamic-insert</literal> の設定" +"はサブクラスに継承されません。 そのため <literal>&lt;subclass&gt;</literal> " +"や <literal>&lt;joined-subclass&gt;</literal> 要素を指定することも出来ます。 " +"これらの設定はパフォーマンスを向上させる事もありますが、落とすこともあります" +"ので、慎重に使用してください。" -#: index.docbook:406 -msgid "Use of <literal>select-before-update</literal> will usually decrease performance. It is very useful to prevent a database update trigger being called unnecessarily if you reattach a graph of detached instances to a <literal>Session</literal>." -msgstr "<literal>select-before-update</literal> の使用は通常パフォーマンスを落とします。 もし <literal>Session</literal> へ分離インスタンスのグラフを再追加するなら、 データベース更新のトリガを不必要に呼び出すのを避けるという点で、非常に有用です。" +#. Tag: para +#: basic_mapping.xml:406 +#, no-c-format +msgid "" +"Use of <literal>select-before-update</literal> will usually decrease " +"performance. It is very useful to prevent a database update trigger being " +"called unnecessarily if you reattach a graph of detached instances to a " +"<literal>Session</literal>." +msgstr "" +"<literal>select-before-update</literal> の使用は通常パフォーマンスを落としま" +"す。 もし <literal>Session</literal> へ分離インスタンスのグラフを再追加するな" +"ら、 データベース更新のトリガを不必要に呼び出すのを避けるという点で、非常に有" +"用です。" -#: index.docbook:412 -msgid "If you enable <literal>dynamic-update</literal>, you will have a choice of optimistic locking strategies:" -msgstr "<literal>dynamic-update</literal> を有効にすれば、楽観ロック戦略を選ぶことになります。" +#. Tag: para +#: basic_mapping.xml:412 +#, no-c-format +msgid "" +"If you enable <literal>dynamic-update</literal>, you will have a choice of " +"optimistic locking strategies:" +msgstr "" +"<literal>dynamic-update</literal> を有効にすれば、楽観ロック戦略を選ぶことに" +"なります。" -#: index.docbook:418 +#. Tag: para +#: basic_mapping.xml:418 +#, no-c-format msgid "<literal>version</literal> check the version/timestamp columns" -msgstr "<literal>version</literal> バージョン/タイムスタンプカラムをチェックします" +msgstr "" +"<literal>version</literal> バージョン/タイムスタンプカラムをチェックします" -#: index.docbook:423 +#. Tag: para +#: basic_mapping.xml:423 +#, no-c-format msgid "<literal>all</literal> check all columns" msgstr "<literal>all</literal> すべてのカラムをチェックします。" -#: index.docbook:428 -msgid "<literal>dirty</literal> check the changed columns, allowing some concurrent updates" -msgstr "<literal>dirty</literal> 変更したカラムをチェックし、同時更新できるようにします。" +#. Tag: para +#: basic_mapping.xml:428 +#, no-c-format +msgid "" +"<literal>dirty</literal> check the changed columns, allowing some concurrent " +"updates" +msgstr "" +"<literal>dirty</literal> 変更したカラムをチェックし、同時更新できるようにしま" +"す。" -#: index.docbook:433 +#. Tag: para +#: basic_mapping.xml:433 +#, no-c-format msgid "<literal>none</literal> do not use optimistic locking" msgstr "<literal>none</literal> 楽観ロックを使用しません" -#: index.docbook:438 -msgid "We <emphasis>very</emphasis> strongly recommend that you use version/timestamp columns for optimistic locking with Hibernate. This is the optimal strategy with respect to performance and is the only strategy that correctly handles modifications made to detached instances (ie. when <literal>Session.merge()</literal> is used)." -msgstr "Hibernateで楽観的ロック戦略を使うなら、バージョン/タイムスタンプカラムを使うことを <emphasis> 非常に</emphasis> 強くお勧めします。 楽観的ロックはパフォーマンスの観点からも最適であり、さらに分離インスタンスへの修正 （つまり <literal>Session.marge()</literal> が使われるとき） を正確に扱うことのできる唯一の戦略でもあります。" +#. Tag: para +#: basic_mapping.xml:438 +#, no-c-format +msgid "" +"We <emphasis>very</emphasis> strongly recommend that you use version/" +"timestamp columns for optimistic locking with Hibernate. This is the optimal " +"strategy with respect to performance and is the only strategy that correctly " +"handles modifications made to detached instances (ie. when <literal>Session." +"merge()</literal> is used)." +msgstr "" +"Hibernateで楽観的ロック戦略を使うなら、バージョン/タイムスタンプカラムを使う" +"ことを <emphasis> 非常に</emphasis> 強くお勧めします。 楽観的ロックはパフォー" +"マンスの観点からも最適であり、さらに分離インスタンスへの修正 （つまり " +"<literal>Session.marge()</literal> が使われるとき） を正確に扱うことのできる" +"唯一の戦略でもあります。" -#: index.docbook:445 -msgid "There is no difference between a view and a base table for a Hibernate mapping, as expected this is transparent at the database level (note that some DBMS don't support views properly, especially with updates). Sometimes you want to use a view, but can't create one in the database (ie. with a legacy schema). In this case, you can map an immutable and read-only entity to a given SQL subselect expression:" -msgstr "Hibernateのマッピングにとってビューと普通のテーブルの間に違いはなく、 データベースレベルでは透過的です （ただしビューを完全にはサポートしていないDBMSもあります。 特に、更新のあるビューに対してはそうです）。 ビューを使いたくても、データベースで作成できないことがあります （例えば、レガシースキーマの場合）。 この場合には、不変かつ読み取り専用のエンティティに与えられたSQLの副問合せ文をマップできます。" +#. Tag: para +#: basic_mapping.xml:445 +#, no-c-format +msgid "" +"There is no difference between a view and a base table for a Hibernate " +"mapping, as expected this is transparent at the database level (note that " +"some DBMS don't support views properly, especially with updates). Sometimes " +"you want to use a view, but can't create one in the database (ie. with a " +"legacy schema). In this case, you can map an immutable and read-only entity " +"to a given SQL subselect expression:" +msgstr "" +"Hibernateのマッピングにとってビューと普通のテーブルの間に違いはなく、 データ" +"ベースレベルでは透過的です （ただしビューを完全にはサポートしていないDBMSもあ" +"ります。 特に、更新のあるビューに対してはそうです）。 ビューを使いたくても、" +"データベースで作成できないことがあります （例えば、レガシースキーマの場" +"合）。 この場合には、不変かつ読み取り専用のエンティティに与えられたSQLの副問" +"合せ文をマップできます。" -#: index.docbook:453 +#. Tag: programlisting +#: basic_mapping.xml:453 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Summary\">\n" - " <subselect>\n" - " select item.name, max(bid.amount), count(*)\n" - " from item\n" - " join bid on bid.item_id = item.id\n" - " group by item.name\n" - " </subselect>\n" - " <synchronize table=\"item\"/>\n" - " <synchronize table=\"bid\"/>\n" - " <id name=\"name\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"Summary\">\n" +" <subselect>\n" +" select item.name, max(bid.amount), count(*)\n" +" from item\n" +" join bid on bid.item_id = item.id\n" +" group by item.name\n" +" </subselect>\n" +" <synchronize table=\"item\"/>\n" +" <synchronize table=\"bid\"/>\n" +" <id name=\"name\"/>\n" +" ...\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Summary\"> -\n" - " <subselect> -\n" - " select item.name, max(bid.amount), count(*) -\n" - " from item -\n" - " join bid on bid.item_id = item.id -\n" - " group by item.name -\n" - " </subselect> -\n" - " <synchronize table=\"item\"/> -\n" - " <synchronize table=\"bid\"/> -\n" - " <id name=\"name\"/> -\n" - " ... -\n" - "</class>]]>" -#: index.docbook:455 -msgid "Declare the tables to synchronize this entity with, ensuring that auto-flush happens correctly, and that queries against the derived entity do not return stale data. The <literal>&lt;subselect&gt;</literal> is available as both as an attribute and a nested mapping element." -msgstr "テーブルをこのエンティティと同期するように定義してください。 オートフラッシュが確実に起こるように、また導出エンティティに対するクエリが古いデータを 返さないようにするためです。 <literal>&lt;subselect&gt;</literal> は属性とネストしたマッピング属性のどちらでも利用できます。" +#. Tag: para +#: basic_mapping.xml:455 +#, no-c-format +msgid "" +"Declare the tables to synchronize this entity with, ensuring that auto-flush " +"happens correctly, and that queries against the derived entity do not return " +"stale data. The <literal>&lt;subselect&gt;</literal> is available as both as " +"an attribute and a nested mapping element." +msgstr "" +"テーブルをこのエンティティと同期するように定義してください。 オートフラッシュ" +"が確実に起こるように、また導出エンティティに対するクエリが古いデータを 返さな" +"いようにするためです。 <literal>&lt;subselect&gt;</literal> は属性とネストし" +"たマッピング属性のどちらでも利用できます。" -#: index.docbook:465 +#. Tag: title +#: basic_mapping.xml:465 +#, no-c-format msgid "<title>id</title>" -msgstr "<title>id</title>" +msgstr "" -#: index.docbook:467 -msgid "Mapped classes <emphasis>must</emphasis> declare the primary key column of the database table. Most classes will also have a JavaBeans-style property holding the unique identifier of an instance. The <literal>&lt;id&gt;</literal> element defines the mapping from that property to the primary key column." -msgstr "マップされたクラスはデータベーステーブルの主キーカラムを定義 <emphasis>しなければなりません</emphasis> 。 ほとんどのクラスにはインスタンスのユニークな識別子を保持するJavaBeansスタイルのプロパティもあります。 <literal>&lt;id&gt;</literal> 要素は、そのプロパティから主キーカラムへのマッピングを定義します。" +#. Tag: para +#: basic_mapping.xml:467 +#, no-c-format +msgid "" +"Mapped classes <emphasis>must</emphasis> declare the primary key column of " +"the database table. Most classes will also have a JavaBeans-style property " +"holding the unique identifier of an instance. The <literal>&lt;id&gt;</" +"literal> element defines the mapping from that property to the primary key " +"column." +msgstr "" +"マップされたクラスはデータベーステーブルの主キーカラムを定義 <emphasis>しなけ" +"ればなりません</emphasis> 。 ほとんどのクラスにはインスタンスのユニークな識別" +"子を保持するJavaBeansスタイルのプロパティもあります。 <literal>&lt;id&gt;</" +"literal> 要素は、そのプロパティから主キーカラムへのマッピングを定義します。" -#: index.docbook:482 +#. Tag: programlisting +#: basic_mapping.xml:482 +#, no-c-format msgid "" - "<![CDATA[<id\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " column=\"column_name\"\n" - " unsaved-value=\"null|any|none|undefined|id_value\"\n" - " access=\"field|property|ClassName\">\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; - "\n" - " <generator class=\"generatorClass\"/>\n" - "</id>]]>" +"<![CDATA[<id\n" +" name=\"propertyName\"\n" +" type=\"typename\"\n" +" column=\"column_name\"\n" +" unsaved-value=\"null|any|none|undefined|id_value\"\n" +" access=\"field|property|ClassName\">\n" +" node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; +"\n" +" <generator class=\"generatorClass\"/>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id -\n" - " name=\"propertyName\" -\n" - " type=\"typename\" -\n" - " column=\"column_name\" -\n" - " unsaved-value=\"null|any|none|undefined|id_value\" -\n" - " access=\"field|property|ClassName\"> -\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot; -\n" - " -\n" - " <generator class=\"generatorClass\"/> -\n" - "</id>]]>" -#: index.docbook:485 -msgid "<literal>name</literal> (optional): The name of the identifier property." +#. Tag: para +#: basic_mapping.xml:485 +#, no-c-format +msgid "" +"<literal>name</literal> (optional): The name of the identifier property." msgstr "<literal>name</literal>（オプション）：識別子プロパティの名前。" -#: index.docbook:490 -msgid "<literal>type</literal> (optional): A name that indicates the Hibernate type." +#. Tag: para +#: basic_mapping.xml:490 +#, no-c-format +msgid "" +"<literal>type</literal> (optional): A name that indicates the Hibernate type." msgstr "<literal>type</literal>（オプション）：Hibernateの型を示す名前。" -#: index.docbook:495 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of the primary key column." -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）： 主キーカラムの名前。" +#. Tag: para +#: basic_mapping.xml:495 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of the primary key column." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）： 主キーカ" +"ラムの名前。" -#: index.docbook:501 -msgid "<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" value): An identifier property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session." -msgstr "<literal>unsaved-value</literal>（オプション - デフォルトの値はsensible）： インスタンスが新しくインスタンス化された （セーブされていない）ことを示す、識別子プロパティの値。 以前のSessionでセーブまたはロードされた一時的インスタンスと区別するために 使います。" +#. Tag: para +#: basic_mapping.xml:501 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to a \"sensible\" " +"value): An identifier property value that indicates that an instance is " +"newly instantiated (unsaved), distinguishing it from detached instances that " +"were saved or loaded in a previous session." +msgstr "" +"<literal>unsaved-value</literal>（オプション - デフォルトの値はsensible）： " +"インスタンスが新しくインスタンス化された （セーブされていない）ことを示す、識" +"別子プロパティの値。 以前のSessionでセーブまたはロードされた一時的インスタン" +"スと区別するために 使います。" -#: index.docbook:509, index.docbook:1017, index.docbook:1156, index.docbook:1238, index.docbook:1345, index.docbook:1534, index.docbook:1708, index.docbook:1878, index.docbook:2457 -msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing the property value." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）： プロパティの値へアクセスするためにHibernateが使う戦略です。" +#. Tag: para +#: basic_mapping.xml:509 basic_mapping.xml:1017 basic_mapping.xml:1156 +#: basic_mapping.xml:1238 basic_mapping.xml:1345 basic_mapping.xml:1534 +#: basic_mapping.xml:1708 basic_mapping.xml:1878 basic_mapping.xml:2457 +#, fuzzy, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing the property " +"value." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へアクセスするためにHibernateが使う戦略です。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> (オプション - デフォルトは <literal>property</" +"literal> ): Hibernateがプロパティの値にアクセスするために使用すべき戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>access</literal>（オプション - デフォルトは <literal>property</" +"literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" -#: index.docbook:517 -msgid "If the <literal>name</literal> attribute is missing, it is assumed that the class has no identifier property." -msgstr "<literal>name</literal> 属性がなければ、クラスには識別子プロパティがないものとみなされます。" +#. Tag: para +#: basic_mapping.xml:517 +#, no-c-format +msgid "" +"If the <literal>name</literal> attribute is missing, it is assumed that the " +"class has no identifier property." +msgstr "" +"<literal>name</literal> 属性がなければ、クラスには識別子プロパティがないもの" +"とみなされます。" -#: index.docbook:522 -msgid "The <literal>unsaved-value</literal> attribute is almost never needed in Hibernate3." -msgstr "<literal>unsaved-value</literal> 属性はHibernate3ではほとんどの場合、必要ではありません。" +#. Tag: para +#: basic_mapping.xml:522 +#, no-c-format +msgid "" +"The <literal>unsaved-value</literal> attribute is almost never needed in " +"Hibernate3." +msgstr "" +"<literal>unsaved-value</literal> 属性はHibernate3ではほとんどの場合、必要では" +"ありません。" -#: index.docbook:526 -msgid "There is an alternative <literal>&lt;composite-id&gt;</literal> declaration to allow access to legacy data with composite keys. We strongly discourage its use for anything else." -msgstr "複合キーを持つレガシーデータにアクセスできるように、 <literal>&lt;composite-id&gt;</literal> という代替のマッピング定義があります。 しかし他の用途への使用は全くおすすめできません。" +#. Tag: para +#: basic_mapping.xml:526 +#, no-c-format +msgid "" +"There is an alternative <literal>&lt;composite-id&gt;</literal> declaration " +"to allow access to legacy data with composite keys. We strongly discourage " +"its use for anything else." +msgstr "" +"複合キーを持つレガシーデータにアクセスできるように、 <literal>&lt;composite-" +"id&gt;</literal> という代替のマッピング定義があります。 しかし他の用途への使" +"用は全くおすすめできません。" -#: index.docbook:532 +#. Tag: title +#: basic_mapping.xml:532 +#, no-c-format msgid "Generator" msgstr "ジェネレータ" -#: index.docbook:534 -msgid "The optional <literal>&lt;generator&gt;</literal> child element names a Java class used to generate unique identifiers for instances of the persistent class. If any parameters are required to configure or initialize the generator instance, they are passed using the <literal>&lt;param&gt;</literal> element." -msgstr "オプションの <literal>&lt;generator&gt;</literal> 子要素は、 永続クラスのインスタンスのユニークな識別子を生成するために使う、Javaクラスを指定します。 ジェネレータインスタンスの設定、もしくは初期化にパラメータが必要であれば、<literal>&lt;param&gt;</literal> 要素を使って渡すことができます。" +#. Tag: para +#: basic_mapping.xml:534 +#, no-c-format +msgid "" +"The optional <literal>&lt;generator&gt;</literal> child element names a Java " +"class used to generate unique identifiers for instances of the persistent " +"class. If any parameters are required to configure or initialize the " +"generator instance, they are passed using the <literal>&lt;param&gt;</" +"literal> element." +msgstr "" +"オプションの <literal>&lt;generator&gt;</literal> 子要素は、 永続クラスのイン" +"スタンスのユニークな識別子を生成するために使う、Javaクラスを指定します。 ジェ" +"ネレータインスタンスの設定、もしくは初期化にパラメータが必要であれば、" +"<literal>&lt;param&gt;</literal> 要素を使って渡すことができます。" -#: index.docbook:541 +#. Tag: programlisting +#: basic_mapping.xml:541 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" - " <param name=\"table\">uid_table</param>\n" - " <param name=\"column\">next_hi_value_column</param>\n" - " </generator>\n" - "</id>]]>" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"org.hibernate.id.TableHiLoGenerator\">\n" +" <param name=\"table\">uid_table</param>\n" +" <param name=\"column\">next_hi_value_column</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\"> -\n" - " <generator class=\"org.hibernate.id.TableHiLoGenerator\"> -\n" - " <param name=\"table\">uid_table</param> -\n" - " <param name=\"column\">next_hi_value_column</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:543 -msgid "All generators implement the interface <literal>org.hibernate.id.IdentifierGenerator</literal>. This is a very simple interface; some applications may choose to provide their own specialized implementations. However, Hibernate provides a range of built-in implementations. There are shortcut names for the built-in generators:" -msgstr "すべてのジェネレータは、インターフェイス <literal>org.hibernate.id.IdentifierGenerator</literal> を実装します。 これはとても単純なインターフェイスなので、特別な実装を独自に用意するアプリケーションもあるかもしれません。 しかしHibernateは組み込みの実装をいくつも用意しています。 組み込みのジェネレータには以下のショートカット名があります：" +#. Tag: para +#: basic_mapping.xml:543 +#, fuzzy, no-c-format +msgid "" +"All generators implement the interface <literal>org.hibernate.id." +"IdentifierGenerator</literal>. This is a very simple interface; some " +"applications may choose to provide their own specialized implementations. " +"However, Hibernate provides a range of built-in implementations. There are " +"shortcut names for the built-in generators:" +msgstr "" +"すべてのジェネレータは、インターフェイス <literal>org.hibernate.id." +"IdentifierGenerator</literal> を実装します。 これはとても単純なインターフェイ" +"スなので、特別な実装を独自に用意するアプリケーションもあるかもしれません。 し" +"かしHibernateは組み込みの実装をいくつも用意しています。 組み込みのジェネレー" +"タには以下のショートカット名があります： <placeholder-1/>" -#: index.docbook:551 +#. Tag: literal +#: basic_mapping.xml:551 +#, no-c-format msgid "increment" msgstr "increment" -#: index.docbook:553 -msgid "generates identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal> that are unique only when no other process is inserting data into the same table. <emphasis>Do not use in a cluster.</emphasis>" -msgstr "<literal>long</literal> , <literal>short</literal> , <literal>int</literal> 型の識別子を生成します。 これらは他のプロセスが同じテーブルにデータを挿入しないときだけユニークです。 <emphasis>クラスタ内では使わないでください</emphasis> 。" +#. Tag: para +#: basic_mapping.xml:553 +#, no-c-format +msgid "" +"generates identifiers of type <literal>long</literal>, <literal>short</" +"literal> or <literal>int</literal> that are unique only when no other " +"process is inserting data into the same table. <emphasis>Do not use in a " +"cluster.</emphasis>" +msgstr "" +"<literal>long</literal> , <literal>short</literal> , <literal>int</literal> " +"型の識別子を生成します。 これらは他のプロセスが同じテーブルにデータを挿入しな" +"いときだけユニークです。 <emphasis>クラスタ内では使わないでください</" +"emphasis> 。" -#: index.docbook:562 +#. Tag: literal +#: basic_mapping.xml:562 +#, no-c-format msgid "identity" msgstr "identity" -#: index.docbook:564 -msgid "supports identity columns in DB2, MySQL, MS SQL Server, Sybase and HypersonicSQL. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>." -msgstr "DB2, MySQL, MS SQL Server, Sybase, HypersonicSQLの識別子カラムを サポートします。 返される識別子の型は <literal>long</literal> , <literal>short</literal> , <literal>int</literal> のいずれかです。" +#. Tag: para +#: basic_mapping.xml:564 +#, no-c-format +msgid "" +"supports identity columns in DB2, MySQL, MS SQL Server, Sybase and " +"HypersonicSQL. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>." +msgstr "" +"DB2, MySQL, MS SQL Server, Sybase, HypersonicSQLの識別子カラムを サポートしま" +"す。 返される識別子の型は <literal>long</literal> , <literal>short</" +"literal> , <literal>int</literal> のいずれかです。" -#: index.docbook:572 +#. Tag: literal +#: basic_mapping.xml:572 +#, no-c-format msgid "sequence" msgstr "sequence" -#: index.docbook:574 -msgid "uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in Interbase. The returned identifier is of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>" -msgstr "DB2, PostgreSQL, Oracle, SAP DB, McKoiのシーケンスや、Interbaseのジェネレータを使用します。 返される識別子の型は <literal>long</literal> , <literal>short</literal> , <literal>int</literal> のいずれかです。" +#. Tag: para +#: basic_mapping.xml:574 +#, no-c-format +msgid "" +"uses a sequence in DB2, PostgreSQL, Oracle, SAP DB, McKoi or a generator in " +"Interbase. The returned identifier is of type <literal>long</literal>, " +"<literal>short</literal> or <literal>int</literal>" +msgstr "" +"DB2, PostgreSQL, Oracle, SAP DB, McKoiのシーケンスや、Interbaseのジェネレータ" +"を使用します。 返される識別子の型は <literal>long</literal> , " +"<literal>short</literal> , <literal>int</literal> のいずれかです。" -#: index.docbook:582 +#. Tag: literal +#: basic_mapping.xml:582 +#, no-c-format msgid "hilo" msgstr "hilo" -#: index.docbook:584 -msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a table and column (by default <literal>hibernate_unique_key</literal> and <literal>next_hi</literal> respectively) as a source of hi values. The hi/lo algorithm generates identifiers that are unique only for a particular database." -msgstr "<literal>long</literal> , <literal>short</literal> , <literal>int</literal> 型の識別子を効率的に生成するhi/loアルゴリズムを使います。 hi値のソースとして、テーブルとカラムを与えます(デフォルトではそれぞれ <literal>hibernate_unique_key</literal> と <literal>next_hi</literal> )。 hi/loアルゴリズムは特定のデータベースに対してのみユニークな識別子を生成します。" +#. Tag: para +#: basic_mapping.xml:584 +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a table and column (by default <literal>hibernate_unique_key</literal> " +"and <literal>next_hi</literal> respectively) as a source of hi values. The " +"hi/lo algorithm generates identifiers that are unique only for a particular " +"database." +msgstr "" +"<literal>long</literal> , <literal>short</literal> , <literal>int</literal> " +"型の識別子を効率的に生成するhi/loアルゴリズムを使います。 hi値のソースとし" +"て、テーブルとカラムを与えます(デフォルトではそれぞれ " +"<literal>hibernate_unique_key</literal> と <literal>next_hi</literal> )。 hi/" +"loアルゴリズムは特定のデータベースに対してのみユニークな識別子を生成します。" -#: index.docbook:594 +#. Tag: literal +#: basic_mapping.xml:594 +#, no-c-format msgid "seqhilo" msgstr "seqhilo" -#: index.docbook:596 -msgid "uses a hi/lo algorithm to efficiently generate identifiers of type <literal>long</literal>, <literal>short</literal> or <literal>int</literal>, given a named database sequence." -msgstr "<literal>long</literal> , <literal>short</literal> , <literal>int</literal> 型の識別子を効率的に生成するhi/loアルゴリズムを使います。 指定されたデータベースシーケンスを与えます。" +#. Tag: para +#: basic_mapping.xml:596 +#, no-c-format +msgid "" +"uses a hi/lo algorithm to efficiently generate identifiers of type " +"<literal>long</literal>, <literal>short</literal> or <literal>int</literal>, " +"given a named database sequence." +msgstr "" +"<literal>long</literal> , <literal>short</literal> , <literal>int</literal> " +"型の識別子を効率的に生成するhi/loアルゴリズムを使います。 指定されたデータ" +"ベースシーケンスを与えます。" -#: index.docbook:604 +#. Tag: literal +#: basic_mapping.xml:604 +#, no-c-format msgid "uuid" msgstr "uuid" -#: index.docbook:606 -msgid "uses a 128-bit UUID algorithm to generate identifiers of type string, unique within a network (the IP address is used). The UUID is encoded as a string of hexadecimal digits of length 32." -msgstr "(IPアドレスが使用される)ネットワーク内でユニークな文字列型の識別子を生成するために、 128ビットのUUIDアルゴリズムを使用します。UUIDは長さ32の16進数字の文字列としてエンコードされます。" +#. Tag: para +#: basic_mapping.xml:606 +#, no-c-format +msgid "" +"uses a 128-bit UUID algorithm to generate identifiers of type string, unique " +"within a network (the IP address is used). The UUID is encoded as a string " +"of hexadecimal digits of length 32." +msgstr "" +"(IPアドレスが使用される)ネットワーク内でユニークな文字列型の識別子を生成する" +"ために、 128ビットのUUIDアルゴリズムを使用します。UUIDは長さ32の16進数字の文" +"字列としてエンコードされます。" -#: index.docbook:614 +#. Tag: literal +#: basic_mapping.xml:614 +#, no-c-format msgid "guid" msgstr "guid" -#: index.docbook:616 +#. Tag: para +#: basic_mapping.xml:616 +#, no-c-format msgid "uses a database-generated GUID string on MS SQL Server and MySQL." msgstr "MS SQLサーバとMySQLでデータベースが生成するGUID文字列を使用します。" -#: index.docbook:622 +#. Tag: literal +#: basic_mapping.xml:622 +#, no-c-format msgid "native" msgstr "native" -#: index.docbook:624 -msgid "picks <literal>identity</literal>, <literal>sequence</literal> or <literal>hilo</literal> depending upon the capabilities of the underlying database." -msgstr "使用するデータベースの性能により <literal>identity</literal> , <literal>sequence</literal> , <literal>hilo</literal> のいずれかが選ばれます。" +#. Tag: para +#: basic_mapping.xml:624 +#, no-c-format +msgid "" +"picks <literal>identity</literal>, <literal>sequence</literal> or " +"<literal>hilo</literal> depending upon the capabilities of the underlying " +"database." +msgstr "" +"使用するデータベースの性能により <literal>identity</literal> , " +"<literal>sequence</literal> , <literal>hilo</literal> のいずれかが選ばれま" +"す。" -#: index.docbook:632 +#. Tag: literal +#: basic_mapping.xml:632 +#, no-c-format msgid "assigned" msgstr "assigned" -#: index.docbook:634 -msgid "lets the application to assign an identifier to the object before <literal>save()</literal> is called. This is the default strategy if no <literal>&lt;generator&gt;</literal> element is specified." -msgstr "<literal>save()</literal> が呼ばれる前に、 アプリケーションがオブジェクトに識別子を代入できるようにします。 <literal>&lt;generator&gt;</literal> が指定されていなければ、これがデフォルトの戦略になります。" +#. Tag: para +#: basic_mapping.xml:634 +#, no-c-format +msgid "" +"lets the application to assign an identifier to the object before " +"<literal>save()</literal> is called. This is the default strategy if no " +"<literal>&lt;generator&gt;</literal> element is specified." +msgstr "" +"<literal>save()</literal> が呼ばれる前に、 アプリケーションがオブジェクトに識" +"別子を代入できるようにします。 <literal>&lt;generator&gt;</literal> が指定さ" +"れていなければ、これがデフォルトの戦略になります。" -#: index.docbook:642 +#. Tag: literal +#: basic_mapping.xml:642 +#, no-c-format msgid "select" msgstr "select" -#: index.docbook:644 -msgid "retrieves a primary key assigned by a database trigger by selecting the row by some unique key and retrieving the primary key value." -msgstr "あるユニークキーによる行の選択と主キーの値の復元により、 データベーストリガが割り当てた主キーを取得します。" +#. Tag: para +#: basic_mapping.xml:644 +#, no-c-format +msgid "" +"retrieves a primary key assigned by a database trigger by selecting the row " +"by some unique key and retrieving the primary key value." +msgstr "" +"あるユニークキーによる行の選択と主キーの値の復元により、 データベーストリガが" +"割り当てた主キーを取得します。" -#: index.docbook:651 +#. Tag: literal +#: basic_mapping.xml:651 +#, no-c-format msgid "foreign" msgstr "foreign" -#: index.docbook:653 -msgid "uses the identifier of another associated object. Usually used in conjunction with a <literal>&lt;one-to-one&gt;</literal> primary key association." -msgstr "他の関連オブジェクトの識別子を使います。 普通は、<literal>&lt;one-to-one&gt;</literal> 主キー関連と組み合わせて使います。" +#. Tag: para +#: basic_mapping.xml:653 +#, no-c-format +msgid "" +"uses the identifier of another associated object. Usually used in " +"conjunction with a <literal>&lt;one-to-one&gt;</literal> primary key " +"association." +msgstr "" +"他の関連オブジェクトの識別子を使います。 普通は、<literal>&lt;one-to-one&gt;" +"</literal> 主キー関連と組み合わせて使います。" -#: index.docbook:660 +#. Tag: literal +#: basic_mapping.xml:660 +#, no-c-format msgid "sequence-identity" -msgstr "Hi/lo アルゴリズム" +msgstr "sequence-identity" -#: index.docbook:662 -msgid "a specialized sequence generation strategy which utilizes a database sequence for the actual value generation, but combines this with JDBC3 getGeneratedKeys to actually return the generated identifier value as part of the insert statement execution. This strategy is only known to be supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on these insert statements are disabled due to a bug in the Oracle drivers." -msgstr "<literal>hilo</literal> と <literal>seqhilo</literal> ジェネレータは、 識別子生成の代表的なアプローチであるhi/loアルゴリズムの2つの代替実装を提供します。 1番目の実装は、次回に利用される\"hi\"値を保持する「特別な」データベーステーブルを 必要とします。 2番目の実装は、Oracleスタイルのシーケンスを使います（サポートされている場合）。" +#. Tag: para +#: basic_mapping.xml:662 +#, no-c-format +msgid "" +"a specialized sequence generation strategy which utilizes a database " +"sequence for the actual value generation, but combines this with JDBC3 " +"getGeneratedKeys to actually return the generated identifier value as part " +"of the insert statement execution. This strategy is only known to be " +"supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on " +"these insert statements are disabled due to a bug in the Oracle drivers." +msgstr "" +"a specialized sequence generation strategy which utilizes a database " +"sequence for the actual value generation, but combines this with JDBC3 " +"getGeneratedKeys to actually return the generated identifier value as part " +"of the insert statement execution. This strategy is only known to be " +"supported on Oracle 10g drivers targetted for JDK 1.4. Note comments on " +"these insert statements are disabled due to a bug in the Oracle drivers." -#: index.docbook:679 +#. Tag: title +#: basic_mapping.xml:679 +#, no-c-format msgid "Hi/lo algorithm" +msgstr "Hi/lo アルゴリズム" + +#. Tag: para +#: basic_mapping.xml:680 +#, no-c-format +msgid "" +"The <literal>hilo</literal> and <literal>seqhilo</literal> generators " +"provide two alternate implementations of the hi/lo algorithm, a favorite " +"approach to identifier generation. The first implementation requires a " +"\"special\" database table to hold the next available \"hi\" value. The " +"second uses an Oracle-style sequence (where supported)." msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\"> -\n" - " <generator class=\"hilo\"> -\n" - " <param name=\"table\">hi_value</param> -\n" - " <param name=\"column\">next_value</param> -\n" - " <param name=\"max_lo\">100</param> -\n" - " </generator> -\n" - "</id>]]>" +"<literal>hilo</literal> と <literal>seqhilo</literal> ジェネレータは、 識別子" +"生成の代表的なアプローチであるhi/loアルゴリズムの2つの代替実装を提供します。 " +"1番目の実装は、次回に利用される\"hi\"値を保持する「特別な」データベーステーブ" +"ルを 必要とします。 2番目の実装は、Oracleスタイルのシーケンスを使います（サ" +"ポートされている場合）。" -#: index.docbook:680 -msgid "The <literal>hilo</literal> and <literal>seqhilo</literal> generators provide two alternate implementations of the hi/lo algorithm, a favorite approach to identifier generation. The first implementation requires a \"special\" database table to hold the next available \"hi\" value. The second uses an Oracle-style sequence (where supported)." +#. Tag: programlisting +#: basic_mapping.xml:687 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"hilo\">\n" +" <param name=\"table\">hi_value</param>\n" +" <param name=\"column\">next_value</param>\n" +" <param name=\"max_lo\">100</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\"> -\n" - " <generator class=\"seqhilo\"> -\n" - " <param name=\"sequence\">hi_value</param> -\n" - " <param name=\"max_lo\">100</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:687 +#. Tag: programlisting +#: basic_mapping.xml:689 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"hilo\">\n" - " <param name=\"table\">hi_value</param>\n" - " <param name=\"column\">next_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "残念ながらHibernateへの独自の <literal>Connection</literal> を提供するときには、<literal>hilo</literal> を使えません。 HibernateがJTAでリストされている接続を取得するためにアプリケーションサーバーのデータソースを使用しているときには、 <literal>hibernate.transaction.manager_lookup_class</literal> を適切に設定しなければなりません。" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" +" <generator class=\"seqhilo\">\n" +" <param name=\"sequence\">hi_value</param>\n" +" <param name=\"max_lo\">100</param>\n" +" </generator>\n" +"</id>]]>" +msgstr "" -#: index.docbook:689 +#. Tag: para +#: basic_mapping.xml:691 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"cat_id\">\n" - " <generator class=\"seqhilo\">\n" - " <param name=\"sequence\">hi_value</param>\n" - " <param name=\"max_lo\">100</param>\n" - " </generator>\n" - "</id>]]>" +"Unfortunately, you can't use <literal>hilo</literal> when supplying your own " +"<literal>Connection</literal> to Hibernate. When Hibernate is using an " +"application server datasource to obtain connections enlisted with JTA, you " +"must properly configure the <literal>hibernate.transaction." +"manager_lookup_class</literal>." +msgstr "" +"残念ながらHibernateへの独自の <literal>Connection</literal> を提供するときに" +"は、<literal>hilo</literal> を使えません。 HibernateがJTAでリストされている接" +"続を取得するためにアプリケーションサーバーのデータソースを使用しているときに" +"は、 <literal>hibernate.transaction.manager_lookup_class</literal> を適切に設" +"定しなければなりません。" + +#. Tag: title +#: basic_mapping.xml:700 +#, no-c-format +msgid "UUID algorithm" msgstr "UUID アルゴリズム" -#: index.docbook:691 -msgid "Unfortunately, you can't use <literal>hilo</literal> when supplying your own <literal>Connection</literal> to Hibernate. When Hibernate is using an application server datasource to obtain connections enlisted with JTA, you must properly configure the <literal>hibernate.transaction.manager_lookup_class</literal>." -msgstr "UUIDには以下のものが含まれます： IPアドレス、JVMのスタートアップタイム（4分の1秒の正確さ）、 システム時間、（JVMに対してユニークな）カウンタ値。 JavaコードからMACアドレスやメモリアドレスを取得することはできないので、 JNIが使えないときの最良の方法です。" +#. Tag: para +#: basic_mapping.xml:701 +#, no-c-format +msgid "" +"The UUID contains: IP address, startup time of the JVM (accurate to a " +"quarter second), system time and a counter value (unique within the JVM). " +"It's not possible to obtain a MAC address or memory address from Java code, " +"so this is the best we can do without using JNI." +msgstr "" +"UUIDには以下のものが含まれます： IPアドレス、JVMのスタートアップタイム（4分の" +"1秒の正確さ）、 システム時間、（JVMに対してユニークな）カウンタ値。 Javaコー" +"ドからMACアドレスやメモリアドレスを取得することはできないので、 JNIが使えない" +"ときの最良の方法です。" -#: index.docbook:700 -msgid "UUID algorithm" +#. Tag: title +#: basic_mapping.xml:710 +#, no-c-format +msgid "Identity columns and sequences" msgstr "識別子カラムとシーケンス" -#: index.docbook:701 -msgid "The UUID contains: IP address, startup time of the JVM (accurate to a quarter second), system time and a counter value (unique within the JVM). It's not possible to obtain a MAC address or memory address from Java code, so this is the best we can do without using JNI." -msgstr "識別子カラムをサポートしているデータベース（DB2, MySQL, Sybase, MS SQL）では、 <literal>identity</literal> キー生成を使えます。 シーケンスをサポートするデータベース（DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB）では、 <literal>sequence</literal> スタイルのキー生成を使えます。 どちらの戦略も、新しいオブジェクトを挿入するために、SQLクエリを2つ必要とします。" +#. Tag: para +#: basic_mapping.xml:711 +#, no-c-format +msgid "" +"For databases which support identity columns (DB2, MySQL, Sybase, MS SQL), " +"you may use <literal>identity</literal> key generation. For databases that " +"support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you " +"may use <literal>sequence</literal> style key generation. Both these " +"strategies require two SQL queries to insert a new object." +msgstr "" +"識別子カラムをサポートしているデータベース（DB2, MySQL, Sybase, MS SQL）で" +"は、 <literal>identity</literal> キー生成を使えます。 シーケンスをサポートす" +"るデータベース（DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB）では、 " +"<literal>sequence</literal> スタイルのキー生成を使えます。 どちらの戦略も、新" +"しいオブジェクトを挿入するために、SQLクエリを2つ必要とします。" -#: index.docbook:710 -msgid "Identity columns and sequences" +#. Tag: programlisting +#: basic_mapping.xml:719 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">person_id_sequence</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\"> -\n" - " <generator class=\"sequence\"> -\n" - " <param name=\"sequence\">person_id_sequence</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:711 -msgid "For databases which support identity columns (DB2, MySQL, Sybase, MS SQL), you may use <literal>identity</literal> key generation. For databases that support sequences (DB2, Oracle, PostgreSQL, Interbase, McKoi, SAP DB) you may use <literal>sequence</literal> style key generation. Both these strategies require two SQL queries to insert a new object." +#. Tag: programlisting +#: basic_mapping.xml:721 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0" +"\">\n" +" <generator class=\"identity\"/>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0\"> -\n" - " <generator class=\"identity\"/> -\n" - "</id>]]>" -#: index.docbook:719 +#. Tag: para +#: basic_mapping.xml:723 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">person_id_sequence</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "クロスプラットフォームの開発では、<literal>native</literal> 戦略は <literal>identity</literal> , <literal>sequence</literal> , <literal>hilo</literal> 戦略の中から1つを選択しますが、 これは使用しているデータベースの能力に依存します。" +"For cross-platform development, the <literal>native</literal> strategy will " +"choose from the <literal>identity</literal>, <literal>sequence</literal> and " +"<literal>hilo</literal> strategies, dependant upon the capabilities of the " +"underlying database." +msgstr "" +"クロスプラットフォームの開発では、<literal>native</literal> 戦略は " +"<literal>identity</literal> , <literal>sequence</literal> , <literal>hilo</" +"literal> 戦略の中から1つを選択しますが、 これは使用しているデータベースの能力" +"に依存します。" -#: index.docbook:721 -msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0\">\n" - " <generator class=\"identity\"/>\n" - "</id>]]>" +#. Tag: title +#: basic_mapping.xml:732 +#, no-c-format +msgid "Assigned identifiers" msgstr "識別子の割り当て" -#: index.docbook:723 -msgid "For cross-platform development, the <literal>native</literal> strategy will choose from the <literal>identity</literal>, <literal>sequence</literal> and <literal>hilo</literal> strategies, dependant upon the capabilities of the underlying database." -msgstr "アプリケーションに識別子を割り当てさせたいのであれば(Hibernateが生成するものではなく）、 <literal>assigned</literal> ジェネレータを使うことができます。 この特別なジェネレータは、すでにオブジェクトの識別子プロパティに代入された値を 識別子に使います。このジェネレータは主キーが代理キーの代わりに自然キーである場合に使用します。 <literal>&lt;generator&gt;</literal> 要素を指定しない場合のデフォルトの動作になります。" +#. Tag: para +#: basic_mapping.xml:733 +#, no-c-format +msgid "" +"If you want the application to assign identifiers (as opposed to having " +"Hibernate generate them), you may use the <literal>assigned</literal> " +"generator. This special generator will use the identifier value already " +"assigned to the object's identifier property. This generator is used when " +"the primary key is a natural key instead of a surrogate key. This is the " +"default behavior if you do no specify a <literal>&lt;generator&gt;</literal> " +"element." +msgstr "" +"アプリケーションに識別子を割り当てさせたいのであれば(Hibernateが生成するもの" +"ではなく）、 <literal>assigned</literal> ジェネレータを使うことができます。 " +"この特別なジェネレータは、すでにオブジェクトの識別子プロパティに代入された値" +"を 識別子に使います。このジェネレータは主キーが代理キーの代わりに自然キーであ" +"る場合に使用します。 <literal>&lt;generator&gt;</literal> 要素を指定しない場" +"合のデフォルトの動作になります。" -#: index.docbook:732 -msgid "Assigned identifiers" -msgstr "<literal>assigned</literal> ジェネレータを選択すると、 Hibernateは <literal>unsaved-value=\"undefined\"</literal> を使用します。 そして、バージョンやタイムスタンプのプロパティがない場合や <literal>Interceptor.isUnsaved()</literal> を定義しなかった場合には、インスタンスが一時的(transient)なものであるのか、 またはセッションから分離(detached)したものかどうかを決めるために、データベースを調べます。" +#. Tag: para +#: basic_mapping.xml:742 +#, no-c-format +msgid "" +"Choosing the <literal>assigned</literal> generator makes Hibernate use " +"<literal>unsaved-value=\"undefined\"</literal>, forcing Hibernate to go to " +"the database to determine if an instance is transient or detached, unless " +"there is a version or timestamp property, or you define <literal>Interceptor." +"isUnsaved()</literal>." +msgstr "" +"<literal>assigned</literal> ジェネレータを選択すると、 Hibernateは " +"<literal>unsaved-value=\"undefined\"</literal> を使用します。 そして、バー" +"ジョンやタイムスタンプのプロパティがない場合や <literal>Interceptor.isUnsaved" +"()</literal> を定義しなかった場合には、インスタンスが一時的(transient)なもの" +"であるのか、 またはセッションから分離(detached)したものかどうかを決めるため" +"に、データベースを調べます。" -#: index.docbook:733 -msgid "If you want the application to assign identifiers (as opposed to having Hibernate generate them), you may use the <literal>assigned</literal> generator. This special generator will use the identifier value already assigned to the object's identifier property. This generator is used when the primary key is a natural key instead of a surrogate key. This is the default behavior if you do no specify a <literal>&lt;generator&gt;</literal> element." +#. Tag: title +#: basic_mapping.xml:752 +#, no-c-format +msgid "Primary keys assigned by triggers" msgstr "トリガにより割り当てられた主キー" -#: index.docbook:742 -msgid "Choosing the <literal>assigned</literal> generator makes Hibernate use <literal>unsaved-value=\"undefined\"</literal>, forcing Hibernate to go to the database to determine if an instance is transient or detached, unless there is a version or timestamp property, or you define <literal>Interceptor.isUnsaved()</literal>." -msgstr "レガシースキーマのためにのみ指定します(Hibernateはトリガを使ってDDLを生成しません)。" +#. Tag: para +#: basic_mapping.xml:753 +#, no-c-format +msgid "" +"For legacy schemas only (Hibernate does not generate DDL with triggers)." +msgstr "" +"レガシースキーマのためにのみ指定します(Hibernateはトリガを使ってDDLを生成しま" +"せん)。" -#: index.docbook:752 -msgid "Primary keys assigned by triggers" +#. Tag: programlisting +#: basic_mapping.xml:757 +#, no-c-format +msgid "" +"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" +" <generator class=\"select\">\n" +" <param name=\"key\">socialSecurityNumber</param>\n" +" </generator>\n" +"</id>]]>" msgstr "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\"> -\n" - " <generator class=\"select\"> -\n" - " <param name=\"key\">socialSecurityNumber</param> -\n" - " </generator> -\n" - "</id>]]>" -#: index.docbook:753 -msgid "For legacy schemas only (Hibernate does not generate DDL with triggers)." -msgstr "上の例の中で、クラスで自然キーとして定義された <literal>socialSecurityNumber</literal> という名前のユニークな値のプロパティと、 値がトリガにより生成される <literal>person_id</literal> という名前の代理キーがあります。" - -#: index.docbook:757 +#. Tag: para +#: basic_mapping.xml:759 +#, no-c-format msgid "" - "<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n" - " <generator class=\"select\">\n" - " <param name=\"key\">socialSecurityNumber</param>\n" - " </generator>\n" - "</id>]]>" -msgstr "composite-id" - -#: index.docbook:759 -msgid "In the above example, there is a unique valued property named <literal>socialSecurityNumber</literal> defined by the class, as a natural key, and a surrogate key named <literal>person_id</literal> whose value is generated by a trigger." +"In the above example, there is a unique valued property named " +"<literal>socialSecurityNumber</literal> defined by the class, as a natural " +"key, and a surrogate key named <literal>person_id</literal> whose value is " +"generated by a trigger." msgstr "" - "<![CDATA[<composite-id -\n" - " name=\"propertyName\" -\n" - " class=\"ClassName\" -\n" - " mapped=\"true|false\" -\n" - " access=\"field|property|ClassName\"> -\n" - " node=\"element-name|.\" -\n" - " -\n" - " <key-property name=\"propertyName\" type=\"typename\" column=\"column_name\"/> -\n" - " <key-many-to-one name=\"propertyName class=\"ClassName\" column=\"column_name\"/> -\n" - " ...... -\n" - "</composite-id>]]>" +"上の例の中で、クラスで自然キーとして定義された " +"<literal>socialSecurityNumber</literal> という名前のユニークな値のプロパティ" +"と、 値がトリガにより生成される <literal>person_id</literal> という名前の代理" +"キーがあります。" -#: index.docbook:771 +#. Tag: title +#: basic_mapping.xml:771 +#, no-c-format msgid "Enhanced identifier generators" -msgstr "複合キーのあるテーブルに対し、 識別子プロパティとしてクラスの複数のプロパティをマッピングすることができます。 <literal>&lt;composite-id&gt;</literal> 要素は、子要素として <literal>&lt;key-property&gt;</literal> プロパティマッピングと <literal>&lt;key-many-to-one&gt;</literal> マッピングを受け入れます。" +msgstr "Enhanced identifier generators" -#: index.docbook:773 -msgid "Starting with release 3.2.3, there are 2 new generators which represent a re-thinking of 2 different aspects of identifier generation. The first aspect is database portability; the second is optimization (not having to query the database for every request for a new identifier value). These two new generators are intended to take the place of some of the named generators described above (starting in 3.3.x); however, they are included in the current releases and can be referenced by FQN." +#. Tag: para +#: basic_mapping.xml:773 +#, no-c-format +msgid "" +"Starting with release 3.2.3, there are 2 new generators which represent a re-" +"thinking of 2 different aspects of identifier generation. The first aspect " +"is database portability; the second is optimization (not having to query the " +"database for every request for a new identifier value). These two new " +"generators are intended to take the place of some of the named generators " +"described above (starting in 3.3.x); however, they are included in the " +"current releases and can be referenced by FQN." msgstr "" - "<![CDATA[<composite-id> -\n" - " <key-property name=\"medicareNumber\"/> -\n" - " <key-property name=\"dependent\"/> -\n" - "</composite-id>]]>" +"Starting with release 3.2.3, there are 2 new generators which represent a re-" +"thinking of 2 different aspects of identifier generation. The first aspect " +"is database portability; the second is optimization (not having to query the " +"database for every request for a new identifier value). These two new " +"generators are intended to take the place of some of the named generators " +"described above (starting in 3.3.x); however, they are included in the " +"current releases and can be referenced by FQN." -#: index.docbook:781 -msgid "The first of these new generators is <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> which is intended firstly as a replacement for the <literal>sequence</literal> generator and secondly as a better portability generator than <literal>native</literal> (because <literal>native</literal> (generally) chooses between <literal>identity</literal> and <literal>sequence</literal> which have largely different semantics which can cause subtle isssues in applications eyeing portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</literal> however achieves portability in a different manner. It chooses between using a table or a sequence in the database to store its incrementing values depending on the capabilities of the dialect being used. The difference between this and <literal>native</literal> is that table-based and sequence-based storage have the same exact semantic (in fact sequences are exactly what Hibernate tries to emmulate with its! table-based generators). This generator has a number of configuration parameters:" -msgstr "複合識別子の等価性を実装するためには、永続クラスが <literal>equals()</literal> と <literal>hashCode()</literal> をオーバーライド <emphasis>しなければなりません</emphasis> 。 また <literal>Serializable</literal> も実装しなければいけません。" +#. Tag: para +#: basic_mapping.xml:781 +#, fuzzy, no-c-format +msgid "" +"The first of these new generators is <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal> which is intended firstly as a replacement " +"for the <literal>sequence</literal> generator and secondly as a better " +"portability generator than <literal>native</literal> (because " +"<literal>native</literal> (generally) chooses between <literal>identity</" +"literal> and <literal>sequence</literal> which have largely different " +"semantics which can cause subtle isssues in applications eyeing " +"portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</" +"literal> however achieves portability in a different manner. It chooses " +"between using a table or a sequence in the database to store its " +"incrementing values depending on the capabilities of the dialect being used. " +"The difference between this and <literal>native</literal> is that table-" +"based and sequence-based storage have the same exact semantic (in fact " +"sequences are exactly what Hibernate tries to emmulate with its table-based " +"generators). This generator has a number of configuration parameters:" +msgstr "" +"The first of these new generators is <literal>org.hibernate.id.enhanced." +"SequenceStyleGenerator</literal> which is intended firstly as a replacement " +"for the <literal>sequence</literal> generator and secondly as a better " +"portability generator than <literal>native</literal> (because " +"<literal>native</literal> (generally) chooses between <literal>identity</" +"literal> and <literal>sequence</literal> which have largely different " +"semantics which can cause subtle isssues in applications eyeing " +"portability). <literal>org.hibernate.id.enhanced.SequenceStyleGenerator</" +"literal> however achieves portability in a different manner. It chooses " +"between using a table or a sequence in the database to store its " +"incrementing values depending on the capabilities of the dialect being used. " +"The difference between this and <literal>native</literal> is that table-" +"based and sequence-based storage have the same exact semantic (in fact " +"sequences are exactly what Hibernate tries to emmulate with its table-based " +"generators). This generator has a number of configuration parameters: " +"<placeholder-1/>" -#: index.docbook:795 -msgid "<literal>sequence_name</literal> (optional, defaults to <literal>hibernate_sequence</literal>): The name of the sequence (or table) to be used." -msgstr "残念ながら複合識別子のためのこの方法は、 永続オブジェクトが自身の識別子であることを意味しています。 オブジェクト自身を識別子とする以上の便利な「扱い方」はありません。 複合キーに関連した永続状態を <literal>load()</literal> 出来るようになる前に、 永続クラス自身をインスタンス化し、識別子プロパティを設定しなければなりません。 <emphasis> 組み込みの</emphasis> 複合識別子と呼ばれるこのアプローチは、 本格的なアプリケーションには向いていません。" +#. Tag: para +#: basic_mapping.xml:795 +#, no-c-format +msgid "" +"<literal>sequence_name</literal> (optional, defaults to " +"<literal>hibernate_sequence</literal>): The name of the sequence (or table) " +"to be used." +msgstr "" +"<literal>sequence_name</literal> (optional, defaults to " +"<literal>hibernate_sequence</literal>): The name of the sequence (or table) " +"to be used." -#: index.docbook:801 -msgid "<literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial value to be retrieved from the sequence/table. In sequence creation terms, this is analogous to the clause typical named \"STARTS WITH\"." -msgstr "2つ目の方法は <emphasis> マップされた</emphasis> 複合識別子と呼ばれるもので、 <literal>&lt;composite-id&gt;</literal>エレメント内で指定した識別プロパティが 永続クラスと分離した識別子クラスの両方に重複して存在します。" +#. Tag: para +#: basic_mapping.xml:801 +#, no-c-format +msgid "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the sequence/table. In " +"sequence creation terms, this is analogous to the clause typical named " +"\"STARTS WITH\"." +msgstr "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the sequence/table. In " +"sequence creation terms, this is analogous to the clause typical named " +"\"STARTS WITH\"." -#: index.docbook:808 -msgid "<literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by which subsequent calls to the sequence/table should differ. In sequence creation terms, this is analogous to the clause typical named \"INCREMENT BY\"." +#. Tag: para +#: basic_mapping.xml:808 +#, no-c-format +msgid "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the sequence/table should " +"differ. In sequence creation terms, this is analogous to the clause typical " +"named \"INCREMENT BY\"." msgstr "" - "<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\"> -\n" - " <key-property name=\"medicareNumber\"/> -\n" - " <key-property name=\"dependent\"/> -\n" - "</composite-id>]]>" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the sequence/table should " +"differ. In sequence creation terms, this is analogous to the clause typical " +"named \"INCREMENT BY\"." -#: index.docbook:815 -msgid "<literal>force_table_use</literal> (optional, defaults to <literal>false</literal>): Should we force the use of a table as the backing structure even though the dialect might support sequence?" -msgstr "この例では、複合識別子クラス（ <literal>MedicareId</literal> ）とエンティティクラス自身の両方が、 <literal>medicareNumber</literal> と <literal>dependent</literal> という名前のプロパティを持ちます。 識別子クラスは、<literal>equals()</literal> と <literal>hashCode()</literal> をオーバライドし、 <literal>Serializable</literal> を実装しなくてはなりません。 この方法には、明らかにコードが重複するという不都合があります。" +#. Tag: para +#: basic_mapping.xml:815 +#, no-c-format +msgid "" +"<literal>force_table_use</literal> (optional, defaults to <literal>false</" +"literal>): Should we force the use of a table as the backing structure even " +"though the dialect might support sequence?" +msgstr "" +"<literal>force_table_use</literal> (optional, defaults to <literal>false</" +"literal>): Should we force the use of a table as the backing structure even " +"though the dialect might support sequence?" -#: index.docbook:822 -msgid "<literal>value_column</literal> (optional, defaults to <literal>next_val</literal>): Only relevant for table structures! The name of the column on the table which is used to hold the value." -msgstr "次の属性はマッピングした複合識別子を指定するために使用します。" +#. Tag: para +#: basic_mapping.xml:822 +#, no-c-format +msgid "" +"<literal>value_column</literal> (optional, defaults to <literal>next_val</" +"literal>): Only relevant for table structures! The name of the column on the " +"table which is used to hold the value." +msgstr "" +"<literal>value_column</literal> (optional, defaults to <literal>next_val</" +"literal>): Only relevant for table structures! The name of the column on the " +"table which is used to hold the value." -#: index.docbook:829 -msgid "<literal>optimizer</literal> (optional, defaults to <literal>none</literal>): See" -msgstr "<literal>mapped</literal> (オプション、デフォルトは <literal>false</literal> ): マッピングした複合識別子が使用されることと、包含されたプロパティのマッピングが、 エンティティクラスと複合識別子クラスの両方を参照することを示します。" +#. Tag: para +#: basic_mapping.xml:829 +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional, defaults to <literal>none</" +"literal>): See" +msgstr "" +"<literal>cascade</literal>（オプション - デフォルトは <literal>none</" +"literal> ）： カスケードのスタイル。" -#: index.docbook:836 -msgid "The second of these new generators is <literal>org.hibernate.id.enhanced.TableGenerator</literal> which is intended firstly as a replacement for the <literal>table</literal> generator (although it actually functions much more like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and secondly as a re-implementation of <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable optimiziers. Essentially this generator defines a table capable of holding a number of different increment values simultaneously by using multiple distinctly keyed rows. This generator has a number of configuration parameters:" -msgstr "<literal>class</literal> (オプション,ただしマッピングした複合識別子には必須): 複合識別子として使用するクラス。" +#. Tag: para +#: basic_mapping.xml:836 +#, fuzzy, no-c-format +msgid "" +"The second of these new generators is <literal>org.hibernate.id.enhanced." +"TableGenerator</literal> which is intended firstly as a replacement for the " +"<literal>table</literal> generator (although it actually functions much more " +"like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and " +"secondly as a re-implementation of <literal>org.hibernate.id." +"MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable " +"optimiziers. Essentially this generator defines a table capable of holding a " +"number of different increment values simultaneously by using multiple " +"distinctly keyed rows. This generator has a number of configuration " +"parameters:" +msgstr "" +"The second of these new generators is <literal>org.hibernate.id.enhanced." +"TableGenerator</literal> which is intended firstly as a replacement for the " +"<literal>table</literal> generator (although it actually functions much more " +"like <literal>org.hibernate.id.MultipleHiLoPerTableGenerator</literal>) and " +"secondly as a re-implementation of <literal>org.hibernate.id." +"MultipleHiLoPerTableGenerator</literal> utilizing the notion of pluggable " +"optimiziers. Essentially this generator defines a table capable of holding a " +"number of different increment values simultaneously by using multiple " +"distinctly keyed rows. This generator has a number of configuration " +"parameters: <placeholder-1/>" -#: index.docbook:846 -msgid "<literal>table_name</literal> (optional, defaults to <literal>hibernate_sequences</literal>): The name of the table to be used." -msgstr "3つ目のさらに便利な方法は、複合識別子を<xref linkend=\"components-compositeid\"/>内の コンポーネントクラスとして実装することです。 下で記述している属性は、この代替方法にのみ適用されます。" +#. Tag: para +#: basic_mapping.xml:846 +#, no-c-format +msgid "" +"<literal>table_name</literal> (optional, defaults to " +"<literal>hibernate_sequences</literal>): The name of the table to be used." +msgstr "" +"<literal>table_name</literal> (optional, defaults to " +"<literal>hibernate_sequences</literal>): The name of the table to be used." -#: index.docbook:852 -msgid "<literal>value_column_name</literal> (optional, defaults to <literal>next_val</literal>): The name of the column on the table which is used to hold the value." -msgstr "<literal>name</literal> (オプション, このアプローチでは必須): 複合識別子を保持するコンポーネントタイプのプロパティ(9章を参照してください)." +#. Tag: para +#: basic_mapping.xml:852 +#, no-c-format +msgid "" +"<literal>value_column_name</literal> (optional, defaults to " +"<literal>next_val</literal>): The name of the column on the table which is " +"used to hold the value." +msgstr "" +"<literal>value_column_name</literal> (optional, defaults to " +"<literal>next_val</literal>): The name of the column on the table which is " +"used to hold the value." -#: index.docbook:858 -msgid "<literal>segment_column_name</literal> (optional, defaults to <literal>sequence_name</literal>): The name of the column on the table which is used to hold the \"segement key\". This is the value which distinctly identifies which increment value to use." -msgstr "<literal>access</literal> (オプション - デフォルトは <literal>property</literal> ): Hibernateがプロパティの値にアクセスするために使用すべき戦略。" +#. Tag: para +#: basic_mapping.xml:858 +#, no-c-format +msgid "" +"<literal>segment_column_name</literal> (optional, defaults to " +"<literal>sequence_name</literal>): The name of the column on the table which " +"is used to hold the \"segement key\". This is the value which distinctly " +"identifies which increment value to use." +msgstr "" +"<literal>segment_column_name</literal> (optional, defaults to " +"<literal>sequence_name</literal>): The name of the column on the table which " +"is used to hold the \"segement key\". This is the value which distinctly " +"identifies which increment value to use." -#: index.docbook:865 -msgid "<literal>segment_value</literal> (optional, defaults to <literal>default</literal>): The \"segment key\" value for the segment from which we want to pull increment values for this generator." -msgstr "<literal>class</literal> （オプション - デフォルトはリフレクションにより決定されるプロパティの型）： 複合識別子として使われるコンポーネントのクラス（次の節を見てください）。" +#. Tag: para +#: basic_mapping.xml:865 +#, no-c-format +msgid "" +"<literal>segment_value</literal> (optional, defaults to <literal>default</" +"literal>): The \"segment key\" value for the segment from which we want to " +"pull increment values for this generator." +msgstr "" +"<literal>segment_value</literal> (optional, defaults to <literal>default</" +"literal>): The \"segment key\" value for the segment from which we want to " +"pull increment values for this generator." -#: index.docbook:872 -msgid "<literal>segment_value_length</literal> (optional, defaults to <literal>255</literal>): Used for schema generation; the column size to create this segment key column." -msgstr "この3つ目の方法は <emphasis> 識別子コンポーネント</emphasis> と呼び、 ほとんどすべてのアプリケーションに対して推奨する方法です。" +#. Tag: para +#: basic_mapping.xml:872 +#, no-c-format +msgid "" +"<literal>segment_value_length</literal> (optional, defaults to <literal>255</" +"literal>): Used for schema generation; the column size to create this " +"segment key column." +msgstr "" +"<literal>segment_value_length</literal> (optional, defaults to <literal>255</" +"literal>): Used for schema generation; the column size to create this " +"segment key column." -#: index.docbook:878 -msgid "<literal>initial_value</literal> (optional, defaults to <literal>1</literal>): The initial value to be retrieved from the table." -msgstr "discriminator" +#. Tag: para +#: basic_mapping.xml:878 +#, no-c-format +msgid "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the table." +msgstr "" +"<literal>initial_value</literal> (optional, defaults to <literal>1</" +"literal>): The initial value to be retrieved from the table." -#: index.docbook:884 -msgid "<literal>increment_size</literal> (optional, defaults to <literal>1</literal>): The value by which subsequent calls to the table should differ." -msgstr "<literal>&lt;discriminator&gt;</literal> 要素は、 table-per-class-hierarchyマッピング戦略を使うポリモーフィックな永続化に必要であり、 テーブルの識別カラムを定義します。 識別カラムは、ある行に対して永続層がどのサブクラスをインスタンス化するかを 伝えるマーカー値を含んでいます。 以下のような型に制限されます： <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>." +#. Tag: para +#: basic_mapping.xml:884 +#, no-c-format +msgid "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the table should differ." +msgstr "" +"<literal>increment_size</literal> (optional, defaults to <literal>1</" +"literal>): The value by which subsequent calls to the table should differ." -#: index.docbook:890 -msgid "<literal>optimizer</literal> (optional, defaults to <literal></literal>): See" +#. Tag: para +#: basic_mapping.xml:890 +#, fuzzy, no-c-format +msgid "" +"<literal>optimizer</literal> (optional, defaults to <literal></literal>): See" msgstr "" - "<![CDATA[<discriminator -\n" - " column=\"discriminator_column\" -\n" - " type=\"discriminator_type\" -\n" - " force=\"true|false\" -\n" - " insert=\"true|false\" -\n" - " formula=\"arbitrary sql expression\" -\n" - "/>]]>" +"<literal>cascade</literal>（オプション - デフォルトは <literal>none</" +"literal> ）： カスケードのスタイル。" -#: index.docbook:900 +#. Tag: title +#: basic_mapping.xml:900 +#, no-c-format msgid "Identifier generator optimization" -msgstr "<literal>column</literal>（オプション - デフォルトは <literal>class</literal> ）： 識別カラムの名前。" +msgstr "Identifier generator optimization" -#: index.docbook:901 -msgid "For identifier generators which store values in the database, it is inefficient for them to hit the database on each and every call to generate a new identifier value. Instead, you'd ideally want to group a bunch of them in memory and only hit the database when you have exhausted your in-memory value group. This is the role of the pluggable optimizers. Currently only the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced\"/> support this notion." -msgstr "<literal>type</literal> （オプション - デフォルトは <literal>string</literal> ）：Hibernateの型を示す名前。" +#. Tag: para +#: basic_mapping.xml:901 +#, fuzzy, no-c-format +msgid "" +"For identifier generators which store values in the database, it is " +"inefficient for them to hit the database on each and every call to generate " +"a new identifier value. Instead, you'd ideally want to group a bunch of them " +"in memory and only hit the database when you have exhausted your in-memory " +"value group. This is the role of the pluggable optimizers. Currently only " +"the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced" +"\"/> support this notion." +msgstr "" +"For identifier generators which store values in the database, it is " +"inefficient for them to hit the database on each and every call to generate " +"a new identifier value. Instead, you'd ideally want to group a bunch of them " +"in memory and only hit the database when you have exhausted your in-memory " +"value group. This is the role of the pluggable optimizers. Currently only " +"the two enhanced generators (<xref linkend=\"mapping-declaration-id-enhanced" +"\"/> support this notion. <placeholder-1/>" -#: index.docbook:909 -msgid "<literal>none</literal> (generally this is the default if no optimizer was specified): This says to not perform any optimizations, and hit the database each and every request." -msgstr "<literal>force</literal> （オプション - デフォルトは <literal>false</literal> ）： ルートクラスのすべてのインスタンスを検索する場合であっても、 Hibernateが使用できる識別カラムの指定を「強制」します。" +#. Tag: para +#: basic_mapping.xml:909 +#, no-c-format +msgid "" +"<literal>none</literal> (generally this is the default if no optimizer was " +"specified): This says to not perform any optimizations, and hit the database " +"each and every request." +msgstr "" +"<literal>none</literal> (generally this is the default if no optimizer was " +"specified): This says to not perform any optimizations, and hit the database " +"each and every request." -#: index.docbook:915 -msgid "<literal>hilo</literal>: applies a hi/lo algorithm around the database retrieved values. The values from the database for this optimizer are expected to be sequential. The values retrieved from the database structure for this optimizer indicates the \"group number\"; the <literal>increment_size</literal> is multiplied by that value in memory to define a group \"hi value\"." -msgstr "<literal>insert</literal> （オプション - デフォルトは <literal>true</literal> ）： もし識別カラムがマッピングする複合識別子の一部ならば、<literal>false</literal> と設定してください。 (HibernateにSQLの <literal>INSERT</literal> には含まれないことを知らせる)" +#. Tag: para +#: basic_mapping.xml:915 +#, no-c-format +msgid "" +"<literal>hilo</literal>: applies a hi/lo algorithm around the database " +"retrieved values. The values from the database for this optimizer are " +"expected to be sequential. The values retrieved from the database structure " +"for this optimizer indicates the \"group number\"; the " +"<literal>increment_size</literal> is multiplied by that value in memory to " +"define a group \"hi value\"." +msgstr "" +"<literal>hilo</literal>: applies a hi/lo algorithm around the database " +"retrieved values. The values from the database for this optimizer are " +"expected to be sequential. The values retrieved from the database structure " +"for this optimizer indicates the \"group number\"; the " +"<literal>increment_size</literal> is multiplied by that value in memory to " +"define a group \"hi value\"." -#: index.docbook:924 -msgid "<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, this optimizers attempts to minimize the number of hits to the database. Here, however, we simply store the starting value for the \"next group\" into the database structure rather than a sequential value in combination with an in-memory grouping algorithm. <literal>increment_size</literal> here refers to the values coming from the database." -msgstr "<literal>formula</literal> (オプション)型が評価されるときに実行される任意のSQL式。 コンテンツベースの識別を可能にします。" +#. Tag: para +#: basic_mapping.xml:924 +#, no-c-format +msgid "" +"<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, " +"this optimizers attempts to minimize the number of hits to the database. " +"Here, however, we simply store the starting value for the \"next group\" " +"into the database structure rather than a sequential value in combination " +"with an in-memory grouping algorithm. <literal>increment_size</literal> here " +"refers to the values coming from the database." +msgstr "" +"<literal>pooled</literal>: like was discussed for <literal>hilo</literal>, " +"this optimizers attempts to minimize the number of hits to the database. " +"Here, however, we simply store the starting value for the \"next group\" " +"into the database structure rather than a sequential value in combination " +"with an in-memory grouping algorithm. <literal>increment_size</literal> here " +"refers to the values coming from the database." -#: index.docbook:937 +#. Tag: title +#: basic_mapping.xml:937 +#, no-c-format msgid "composite-id" -msgstr "識別カラムの実際の値は、 <literal>&lt;class&gt;</literal> と <literal>&lt;subclass&gt;</literal> 要素の <literal>discriminator-value</literal> 属性で指定されます。" +msgstr "composite-id" -#: index.docbook:939 +#. Tag: programlisting +#: basic_mapping.xml:939 +#, no-c-format msgid "" - "<![CDATA[<composite-id\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " mapped=\"true|false\"\n" - " access=\"field|property|ClassName\">\n" - " node=\"element-name|.\"\n" - "\n" - " <key-property name=\"propertyName\" type=\"typename\" column=\"column_name\"/>\n" - " <key-many-to-one name=\"propertyName class=\"ClassName\" column=\"column_name\"/>\n" - " ......\n" - "</composite-id>]]>" -msgstr "永続クラスへマッピングされない｢余分な」識別値を持つ行が テーブルにあれば、（そのときに限り）<literal>force</literal> 属性は有効です。 ただし、普通はそういうことはありません。" +"<![CDATA[<composite-id\n" +" name=\"propertyName\"\n" +" class=\"ClassName\"\n" +" mapped=\"true|false\"\n" +" access=\"field|property|ClassName\">\n" +" node=\"element-name|.\"\n" +"\n" +" <key-property name=\"propertyName\" type=\"typename\" column=" +"\"column_name\"/>\n" +" <key-many-to-one name=\"propertyName class=\"ClassName\" column=" +"\"column_name\"/>\n" +" ......\n" +"</composite-id>]]>" +msgstr "" -#: index.docbook:941 -msgid "For a table with a composite key, you may map multiple properties of the class as identifier properties. The <literal>&lt;composite-id&gt;</literal> element accepts <literal>&lt;key-property&gt;</literal> property mappings and <literal>&lt;key-many-to-one&gt;</literal> mappings as child elements." -msgstr "<literal>formula</literal> 属性を使うと、行の型を評価するために任意のSQL式を宣言できます。" +#. Tag: para +#: basic_mapping.xml:941 +#, no-c-format +msgid "" +"For a table with a composite key, you may map multiple properties of the " +"class as identifier properties. The <literal>&lt;composite-id&gt;</literal> " +"element accepts <literal>&lt;key-property&gt;</literal> property mappings " +"and <literal>&lt;key-many-to-one&gt;</literal> mappings as child elements." +msgstr "" +"複合キーのあるテーブルに対し、 識別子プロパティとしてクラスの複数のプロパティ" +"をマッピングすることができます。 <literal>&lt;composite-id&gt;</literal> 要素" +"は、子要素として <literal>&lt;key-property&gt;</literal> プロパティマッピング" +"と <literal>&lt;key-many-to-one&gt;</literal> マッピングを受け入れます。" -#: index.docbook:948 +#. Tag: programlisting +#: basic_mapping.xml:948 +#, no-c-format msgid "" - "<![CDATA[<composite-id>\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" +"<![CDATA[<composite-id>\n" +" <key-property name=\"medicareNumber\"/>\n" +" <key-property name=\"dependent\"/>\n" +"</composite-id>]]>" msgstr "" - "<![CDATA[<discriminator -\n" - " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\" -\n" - " type=\"integer\"/>]]>" -#: index.docbook:950 -msgid "Your persistent class <emphasis>must</emphasis> override <literal>equals()</literal> and <literal>hashCode()</literal> to implement composite identifier equality. It must also implements <literal>Serializable</literal>." -msgstr "version（オプション）" +#. Tag: para +#: basic_mapping.xml:950 +#, no-c-format +msgid "" +"Your persistent class <emphasis>must</emphasis> override <literal>equals()</" +"literal> and <literal>hashCode()</literal> to implement composite identifier " +"equality. It must also implements <literal>Serializable</literal>." +msgstr "" +"複合識別子の等価性を実装するためには、永続クラスが <literal>equals()</" +"literal> と <literal>hashCode()</literal> をオーバーライド <emphasis>しなけれ" +"ばなりません</emphasis> 。 また <literal>Serializable</literal> も実装しなけ" +"ればいけません。" -#: index.docbook:956 -msgid "Unfortunately, this approach to composite identifiers means that a persistent object is its own identifier. There is no convenient \"handle\" other than the object itself. You must instantiate an instance of the persistent class itself and populate its identifier properties before you can <literal>load()</literal> the persistent state associated with a composite key. We call this approach an <emphasis>embedded</emphasis> composite identifier, and discourage it for serious applications." -msgstr "<literal>&lt;version&gt;</literal> 要素はオプションであり、 テーブルがバージョンデータを含むことを示します。 これは <emphasis>ロングトランザクション</emphasis> を使うつもりなら、特に役立ちます（以下を見てください）。" +#. Tag: para +#: basic_mapping.xml:956 +#, no-c-format +msgid "" +"Unfortunately, this approach to composite identifiers means that a " +"persistent object is its own identifier. There is no convenient \"handle\" " +"other than the object itself. You must instantiate an instance of the " +"persistent class itself and populate its identifier properties before you " +"can <literal>load()</literal> the persistent state associated with a " +"composite key. We call this approach an <emphasis>embedded</emphasis> " +"composite identifier, and discourage it for serious applications." +msgstr "" +"残念ながら複合識別子のためのこの方法は、 永続オブジェクトが自身の識別子である" +"ことを意味しています。 オブジェクト自身を識別子とする以上の便利な「扱い方」は" +"ありません。 複合キーに関連した永続状態を <literal>load()</literal> 出来るよ" +"うになる前に、 永続クラス自身をインスタンス化し、識別子プロパティを設定しなけ" +"ればなりません。 <emphasis> 組み込みの</emphasis> 複合識別子と呼ばれるこのア" +"プローチは、 本格的なアプリケーションには向いていません。" -#: index.docbook:965 -msgid "A second approach is what we call a <emphasis>mapped</emphasis> composite identifier, where the identifier properties named inside the <literal>&lt;composite-id&gt;</literal> element are duplicated on both the persistent class and a separate identifier class." +#. Tag: para +#: basic_mapping.xml:965 +#, no-c-format +msgid "" +"A second approach is what we call a <emphasis>mapped</emphasis> composite " +"identifier, where the identifier properties named inside the <literal>&lt;" +"composite-id&gt;</literal> element are duplicated on both the persistent " +"class and a separate identifier class." msgstr "" - "<![CDATA[<version -\n" - " column=\"version_column\" -\n" - " name=\"propertyName\" -\n" - " type=\"typename\" -\n" - " access=\"field|property|ClassName\" -\n" - " unsaved-value=\"null|negative|undefined\" -\n" - " generated=\"never|always\" -\n" - " insert=\"true|false\" -\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot; -\n" - "/>]]>" +"2つ目の方法は <emphasis> マップされた</emphasis> 複合識別子と呼ばれるもの" +"で、 <literal>&lt;composite-id&gt;</literal>エレメント内で指定した識別プロパ" +"ティが 永続クラスと分離した識別子クラスの両方に重複して存在します。" -#: index.docbook:971 +#. Tag: programlisting +#: basic_mapping.xml:971 +#, no-c-format msgid "" - "<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" - " <key-property name=\"medicareNumber\"/>\n" - " <key-property name=\"dependent\"/>\n" - "</composite-id>]]>" -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）: バージョン番号を保持するカラムの名前。" +"<![CDATA[<composite-id class=\"MedicareId\" mapped=\"true\">\n" +" <key-property name=\"medicareNumber\"/>\n" +" <key-property name=\"dependent\"/>\n" +"</composite-id>]]>" +msgstr "" -#: index.docbook:973 -msgid "In this example, both the composite identifier class, <literal>MedicareId</literal>, and the entity class itself have properties named <literal>medicareNumber</literal> and <literal>dependent</literal>. The identifier class must override <literal>equals()</literal> and <literal>hashCode()</literal> and implement. <literal>Serializable</literal>. The disadvantage of this approach is quite obvious&mdash;code duplication." -msgstr "<literal>name</literal> ：永続クラスのプロパティの名前。" +#. Tag: para +#: basic_mapping.xml:973 +#, no-c-format +msgid "" +"In this example, both the composite identifier class, <literal>MedicareId</" +"literal>, and the entity class itself have properties named " +"<literal>medicareNumber</literal> and <literal>dependent</literal>. The " +"identifier class must override <literal>equals()</literal> and " +"<literal>hashCode()</literal> and implement. <literal>Serializable</" +"literal>. The disadvantage of this approach is quite obvious&mdash;code " +"duplication." +msgstr "" +"この例では、複合識別子クラス（ <literal>MedicareId</literal> ）とエンティティ" +"クラス自身の両方が、 <literal>medicareNumber</literal> と " +"<literal>dependent</literal> という名前のプロパティを持ちます。 識別子クラス" +"は、<literal>equals()</literal> と <literal>hashCode()</literal> をオーバライ" +"ドし、 <literal>Serializable</literal> を実装しなくてはなりません。 この方法" +"には、明らかにコードが重複するという不都合があります。" -#: index.docbook:982 -msgid "The following attributes are used to specify a mapped composite identifier:" -msgstr "<literal>type</literal> （オプション - デフォルトは <literal>integer</literal> ）：バージョン番号の型。" +#. Tag: para +#: basic_mapping.xml:982 +#, no-c-format +msgid "" +"The following attributes are used to specify a mapped composite identifier:" +msgstr "次の属性はマッピングした複合識別子を指定するために使用します。" -#: index.docbook:988 -msgid "<literal>mapped</literal> (optional, defaults to <literal>false</literal>): indicates that a mapped composite identifier is used, and that the contained property mappings refer to both the entity class and the composite identifier class." -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:988 +#, no-c-format +msgid "" +"<literal>mapped</literal> (optional, defaults to <literal>false</literal>): " +"indicates that a mapped composite identifier is used, and that the contained " +"property mappings refer to both the entity class and the composite " +"identifier class." +msgstr "" +"<literal>mapped</literal> (オプション、デフォルトは <literal>false</" +"literal> ): マッピングした複合識別子が使用されることと、包含されたプロパティ" +"のマッピングが、 エンティティクラスと複合識別子クラスの両方を参照することを示" +"します。" -#: index.docbook:996 -msgid "<literal>class</literal> (optional, but required for a mapped composite identifier): The class used as a composite identifier." -msgstr "<literal>unsaved-value</literal> （オプション - デフォルトは <literal>undefined</literal> ）： インスタンスが新しくインスタンス化されたことを示す （セーブされていないことを示す）バージョンプロパティの値。 以前のSessionでセーブまたはロードされた一時的なインスタンスと区別するために 使います。 （ <literal>undefined</literal> は識別子プロパティの値が使われることを指定します。）" +#. Tag: para +#: basic_mapping.xml:996 +#, no-c-format +msgid "" +"<literal>class</literal> (optional, but required for a mapped composite " +"identifier): The class used as a composite identifier." +msgstr "" +"<literal>class</literal> (オプション,ただしマッピングした複合識別子には必" +"須): 複合識別子として使用するクラス。" -#: index.docbook:1003 -msgid "We will describe a third, even more convenient approach where the composite identifier is implemented as a component class in <xref linkend=\"components-compositeid\"/>. The attributes described below apply only to this alternative approach:" -msgstr "<literal>generated</literal> (オプション - デフォルトは <literal>never</literal> ): このバージョンのプロパティの値が、データベースによって生成されたことを指定します。 <xref linkend=\"mapping-generated\"/>生成プロパティ の議論を見てください。" +#. Tag: para +#: basic_mapping.xml:1003 +#, no-c-format +msgid "" +"We will describe a third, even more convenient approach where the composite " +"identifier is implemented as a component class in <xref linkend=\"components-" +"compositeid\"/>. The attributes described below apply only to this " +"alternative approach:" +msgstr "" +"3つ目のさらに便利な方法は、複合識別子を<xref linkend=\"components-compositeid" +"\"/>内の コンポーネントクラスとして実装することです。 下で記述している属性" +"は、この代替方法にのみ適用されます。" -#: index.docbook:1011 -msgid "<literal>name</literal> (optional, required for this approach): A property of component type that holds the composite identifier (see chapter 9)." -msgstr "<literal>insert</literal> (オプション - デフォルトは <literal>true</literal> ): SQLのinsert文にバージョン・カラムを含めるべきかどうかを指定します。 もしデータベース・カラムのデフォルト値が <literal>0</literal> と定義されるときには、 <literal>false</literal> に設定すると良いでしょう。" +#. Tag: para +#: basic_mapping.xml:1011 +#, no-c-format +msgid "" +"<literal>name</literal> (optional, required for this approach): A property " +"of component type that holds the composite identifier (see chapter 9)." +msgstr "" +"<literal>name</literal> (オプション, このアプローチでは必須): 複合識別子を保" +"持するコンポーネントタイプのプロパティ(9章を参照してください)." -#: index.docbook:1023 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The component class used as a composite identifier (see next section)." -msgstr "バージョンやタイムスタンプのプロパティは、分離されたインスタンスに対してnullであってはなりません。 そのためどのような <literal>unsaved-value</literal> 戦略が指定されても、 Hibernateはnullのバージョンやタイムスタンプを持ったすべてのインスタンスを、 一時的なものであると判断します。 <emphasis> nullを許容するバージョンやタイムスタンプのプロパティを定義することは、 過渡的に一時オブジェクトとすることを防ぐ簡単な方法です。 特に識別子の割り当てや複合キーを使用しているときには特に有用です。</emphasis>" +#. Tag: para +#: basic_mapping.xml:1023 +#, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The component class used as a composite " +"identifier (see next section)." +msgstr "" +"<literal>class</literal> （オプション - デフォルトはリフレクションにより決定" +"されるプロパティの型）： 複合識別子として使われるコンポーネントのクラス（次の" +"節を見てください）。" -#: index.docbook:1030 -msgid "This third approach, an <emphasis>identifier component</emphasis> is the one we recommend for almost all applications." -msgstr "timestamp（オプション）" +#. Tag: para +#: basic_mapping.xml:1030 +#, no-c-format +msgid "" +"This third approach, an <emphasis>identifier component</emphasis> is the one " +"we recommend for almost all applications." +msgstr "" +"この3つ目の方法は <emphasis> 識別子コンポーネント</emphasis> と呼び、 ほとん" +"どすべてのアプリケーションに対して推奨する方法です。" -#: index.docbook:1038 +#. Tag: title +#: basic_mapping.xml:1038 +#, no-c-format msgid "discriminator" -msgstr "オプションの <literal>&lt;timestamp&gt;</literal> 要素は、 テーブルがタイムスタンプデータを含むことを示します。 これはバージョン付けの代わりの方法として用意されています。 タイムスタンプはもともと楽観的ロックにおける安全性の低い実装です。 しかしアプリケーションは異なる用途で使うこともあるかもしれません。" +msgstr "discriminator" -#: index.docbook:1040 -msgid "The <literal>&lt;discriminator&gt;</literal> element is required for polymorphic persistence using the table-per-class-hierarchy mapping strategy and declares a discriminator column of the table. The discriminator column contains marker values that tell the persistence layer what subclass to instantiate for a particular row. A restricted set of types may be used: <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>." +#. Tag: para +#: basic_mapping.xml:1040 +#, no-c-format +msgid "" +"The <literal>&lt;discriminator&gt;</literal> element is required for " +"polymorphic persistence using the table-per-class-hierarchy mapping strategy " +"and declares a discriminator column of the table. The discriminator column " +"contains marker values that tell the persistence layer what subclass to " +"instantiate for a particular row. A restricted set of types may be used: " +"<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>." msgstr "" - "<![CDATA[<timestamp -\n" - " column=\"timestamp_column\" -\n" - " name=\"propertyName\" -\n" - " access=\"field|property|ClassName\" -\n" - " unsaved-value=\"null|undefined\" -\n" - " source=\"vm|db\" -\n" - " generated=\"never|always\" -\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot; -\n" - "/>]]>" +"<literal>&lt;discriminator&gt;</literal> 要素は、 table-per-class-hierarchy" +"マッピング戦略を使うポリモーフィックな永続化に必要であり、 テーブルの識別カラ" +"ムを定義します。 識別カラムは、ある行に対して永続層がどのサブクラスをインスタ" +"ンス化するかを 伝えるマーカー値を含んでいます。 以下のような型に制限されま" +"す： <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>." -#: index.docbook:1058 +#. Tag: programlisting +#: basic_mapping.xml:1058 +#, no-c-format msgid "" - "<![CDATA[<discriminator\n" - " column=\"discriminator_column\"\n" - " type=\"discriminator_type\"\n" - " force=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary sql expression\"\n" - "/>]]>" -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）： タイムスタンプを保持するカラムの名前。" +"<![CDATA[<discriminator\n" +" column=\"discriminator_column\"\n" +" type=\"discriminator_type\"\n" +" force=\"true|false\"\n" +" insert=\"true|false\"\n" +" formula=\"arbitrary sql expression\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1061 -msgid "<literal>column</literal> (optional - defaults to <literal>class</literal>) the name of the discriminator column." -msgstr "<literal>name</literal> ： 永続クラスであるJava の <literal>Date</literal>型 または <literal>Timestamp</literal> 型 の、JavaBeansスタイルプロパティの名前。" +#. Tag: para +#: basic_mapping.xml:1061 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to <literal>class</literal>) " +"the name of the discriminator column." +msgstr "" +"<literal>column</literal>（オプション - デフォルトは <literal>class</" +"literal> ）： 識別カラムの名前。" -#: index.docbook:1067 -msgid "<literal>type</literal> (optional - defaults to <literal>string</literal>) a name that indicates the Hibernate type" -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1067 +#, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>string</literal>) a " +"name that indicates the Hibernate type" +msgstr "" +"<literal>type</literal> （オプション - デフォルトは <literal>string</" +"literal> ）：Hibernateの型を示す名前。" -#: index.docbook:1073 -msgid "<literal>force</literal> (optional - defaults to <literal>false</literal>) \"force\" Hibernate to specify allowed discriminator values even when retrieving all instances of the root class." -msgstr "<literal>unsaved-value</literal> （オプション - デフォルトは <literal>null</literal> ）： インスタンスが新しくインスタンス化された （セーブされていない）ことを示すバージョンプロパティの値。 以前のSessionでセーブまたはロードされた一時的なインスタンスと 区別するために使われます。 （ <literal>undefined</literal> と指定すると、 識別子プロパティの値が使われます。）" +#. Tag: para +#: basic_mapping.xml:1073 +#, no-c-format +msgid "" +"<literal>force</literal> (optional - defaults to <literal>false</literal>) " +"\"force\" Hibernate to specify allowed discriminator values even when " +"retrieving all instances of the root class." +msgstr "" +"<literal>force</literal> （オプション - デフォルトは <literal>false</" +"literal> ）： ルートクラスのすべてのインスタンスを検索する場合であっても、 " +"Hibernateが使用できる識別カラムの指定を「強制」します。" -#: index.docbook:1080 -msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>) set this to <literal>false</literal> if your discriminator column is also part of a mapped composite identifier. (Tells Hibernate to not include the column in SQL <literal>INSERT</literal>s.)" -msgstr "<literal>source</literal> (オプション - デフォルトは <literal>vm</literal> ): Hibernateはどこからタイムスタンプの値を取得するべきでしょうか？ データベースからでしょうか、現在のJVMからでしょうか？ データベースによるタイムスタンプは、Hibernateが\"次の値\"を決定するために データベースをヒットしなければならないため、オーバヘッドを招きます。 しかしクラスタ環境ではJVMから取得するより安全です。 データベースの現在のタイムスタンプの取得をサポートする すべての <literal>データベース方言</literal> が知られているわけではないことに 注意してください。また一方で、精密さを欠くために、 ロックで使用するには安全でないものもあります(例えばOracle 8)。" +#. Tag: para +#: basic_mapping.xml:1080 +#, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>) " +"set this to <literal>false</literal> if your discriminator column is also " +"part of a mapped composite identifier. (Tells Hibernate to not include the " +"column in SQL <literal>INSERT</literal>s.)" +msgstr "" +"<literal>insert</literal> （オプション - デフォルトは <literal>true</" +"literal> ）： もし識別カラムがマッピングする複合識別子の一部ならば、" +"<literal>false</literal> と設定してください。 (HibernateにSQLの " +"<literal>INSERT</literal> には含まれないことを知らせる)" -#: index.docbook:1088 -msgid "<literal>formula</literal> (optional) an arbitrary SQL expression that is executed when a type has to be evaluated. Allows content-based discrimination." -msgstr "<literal>generated</literal> (オプション - デフォルトは <literal>never</literal> ): このタイムスタンプ・プロパティの値が、データベースによって生成されることを指定します。 <xref linkend=\"mapping-generated\"/>生成プロパティ を参照してください。" +#. Tag: para +#: basic_mapping.xml:1088 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional) an arbitrary SQL expression that is " +"executed when a type has to be evaluated. Allows content-based " +"discrimination." +msgstr "" +"<literal>formula</literal> (オプション)型が評価されるときに実行される任意の" +"SQL式。 コンテンツベースの識別を可能にします。" -#: index.docbook:1096 -msgid "Actual values of the discriminator column are specified by the <literal>discriminator-value</literal> attribute of the <literal>&lt;class&gt;</literal> and <literal>&lt;subclass&gt;</literal> elements." -msgstr "<literal>&lt;timestamp&gt;</literal> は <literal>&lt;version type=\"timestamp\"&gt;</literal> と等価であることに注意してください。 <literal>&lt;timestamp source=\"db\"&gt;</literal> は <literal>&lt;version type=\"dbtimestamp\"&gt;</literal> と等価であることに注意してください。" +#. Tag: para +#: basic_mapping.xml:1096 +#, no-c-format +msgid "" +"Actual values of the discriminator column are specified by the " +"<literal>discriminator-value</literal> attribute of the <literal>&lt;" +"class&gt;</literal> and <literal>&lt;subclass&gt;</literal> elements." +msgstr "" +"識別カラムの実際の値は、 <literal>&lt;class&gt;</literal> と <literal>&lt;" +"subclass&gt;</literal> 要素の <literal>discriminator-value</literal> 属性で指" +"定されます。" -#: index.docbook:1102 -msgid "The <literal>force</literal> attribute is (only) useful if the table contains rows with \"extra\" discriminator values that are not mapped to a persistent class. This will not usually be the case." -msgstr "property" +#. Tag: para +#: basic_mapping.xml:1102 +#, no-c-format +msgid "" +"The <literal>force</literal> attribute is (only) useful if the table " +"contains rows with \"extra\" discriminator values that are not mapped to a " +"persistent class. This will not usually be the case." +msgstr "" +"永続クラスへマッピングされない｢余分な」識別値を持つ行が テーブルにあれば、" +"（そのときに限り）<literal>force</literal> 属性は有効です。 ただし、普通はそ" +"ういうことはありません。" -#: index.docbook:1108 -msgid "Using the <literal>formula</literal> attribute you can declare an arbitrary SQL expression that will be used to evaluate the type of a row:" -msgstr "<literal>&lt;property&gt;</literal> 要素は、クラスの永続的なJavaBeanスタイルのプロパティを定義します。" +#. Tag: para +#: basic_mapping.xml:1108 +#, no-c-format +msgid "" +"Using the <literal>formula</literal> attribute you can declare an arbitrary " +"SQL expression that will be used to evaluate the type of a row:" +msgstr "" +"<literal>formula</literal> 属性を使うと、行の型を評価するために任意のSQL式を" +"宣言できます。" -#: index.docbook:1113 +#. Tag: programlisting +#: basic_mapping.xml:1113 +#, no-c-format msgid "" - "<![CDATA[<discriminator\n" - " formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\"\n" - " type=\"integer\"/>]]>" +"<![CDATA[<discriminator\n" +" formula=\"case when CLASS_TYPE in ('a', 'b', 'c') then 0 else 1 end\"\n" +" type=\"integer\"/>]]>" msgstr "" - "<![CDATA[<property -\n" - " name=\"propertyName\" -\n" - " column=\"column_name\" -\n" - " type=\"typename\" -\n" - " update=\"true|false\" -\n" - " insert=\"true|false\" -\n" - " formula=\"arbitrary SQL expression\" -\n" - " access=\"field|property|ClassName\" -\n" - " lazy=\"true|false\" -\n" - " unique=\"true|false\" -\n" - " not-null=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " generated=\"never|insert|always\" -\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot; -\n" - " index=\"index_name\" -\n" - " unique_key=\"unique_key_id\" -\n" - " length=\"L\" -\n" - " precision=\"P\" -\n" - " scale=\"S\" -\n" - "/>]]>" -#: index.docbook:1118 +#. Tag: title +#: basic_mapping.xml:1118 +#, no-c-format msgid "version (optional)" -msgstr "<literal>name</literal>：小文字で始まるプロパティ名。" +msgstr "version（オプション）" -#: index.docbook:1120 -msgid "The <literal>&lt;version&gt;</literal> element is optional and indicates that the table contains versioned data. This is particularly useful if you plan to use <emphasis>long transactions</emphasis> (see below)." -msgstr "<literal>column</literal>（オプション - デフォルトはプロパティ名）： マッピングされたデータベーステーブルのカラムの名前。 ネストした <literal>&lt;column&gt;</literal> 要素でも指定できます。" +#. Tag: para +#: basic_mapping.xml:1120 +#, no-c-format +msgid "" +"The <literal>&lt;version&gt;</literal> element is optional and indicates " +"that the table contains versioned data. This is particularly useful if you " +"plan to use <emphasis>long transactions</emphasis> (see below)." +msgstr "" +"<literal>&lt;version&gt;</literal> 要素はオプションであり、 テーブルがバー" +"ジョンデータを含むことを示します。 これは <emphasis>ロングトランザクション</" +"emphasis> を使うつもりなら、特に役立ちます（以下を見てください）。" -#: index.docbook:1136 +#. Tag: programlisting +#: basic_mapping.xml:1136 +#, no-c-format msgid "" - "<![CDATA[<version\n" - " column=\"version_column\"\n" - " name=\"propertyName\"\n" - " type=\"typename\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|negative|undefined\"\n" - " generated=\"never|always\"\n" - " insert=\"true|false\"\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; - "/>]]>" -msgstr "<literal>type</literal>（オプション）：Hibernateの型を示す名前。" +"<![CDATA[<version\n" +" column=\"version_column\"\n" +" name=\"propertyName\"\n" +" type=\"typename\"\n" +" access=\"field|property|ClassName\"\n" +" unsaved-value=\"null|negative|undefined\"\n" +" generated=\"never|always\"\n" +" insert=\"true|false\"\n" +" node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; +"/>]]>" +msgstr "" -#: index.docbook:1139 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of the column holding the version number." -msgstr "<literal>update, insert</literal> （オプション - デフォルトは <literal>true</literal> ）： マッピングされたカラムがSQLの <literal>UPDATE</literal> や <literal>INSERT</literal> に含まれることを指定します。 両方とも <literal>false</literal> に設定すると、 同じカラムにマッピングされた他のプロパティやトリガや 他のアプリケーションによって初期化された純粋な「導出」プロパティが可能になります。" +#. Tag: para +#: basic_mapping.xml:1139 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of the column holding the version number." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）: バージョ" +"ン番号を保持するカラムの名前。" -#: index.docbook:1145 -msgid "<literal>name</literal>: The name of a property of the persistent class." -msgstr "<literal>formula</literal>（オプション）： <emphasis>計算</emphasis> プロパティのための値を定義するSQL式。 計算されたプロパティは自身のカラムへのマッピングがありません。" +#. Tag: para +#: basic_mapping.xml:1145 +#, no-c-format +msgid "" +"<literal>name</literal>: The name of a property of the persistent class." +msgstr "<literal>name</literal> ：永続クラスのプロパティの名前。" -#: index.docbook:1150 -msgid "<literal>type</literal> (optional - defaults to <literal>integer</literal>): The type of the version number." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1150 +#, no-c-format +msgid "" +"<literal>type</literal> (optional - defaults to <literal>integer</literal>): " +"The type of the version number." +msgstr "" +"<literal>type</literal> （オプション - デフォルトは <literal>integer</" +"literal> ）：バージョン番号の型。" -#: index.docbook:1162 -msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</literal>): A version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. (<literal>undefined</literal> specifies that the identifier property value should be used.)" -msgstr "<literal>unique</literal> (オプション):カラムにユニーク制約をつけるDDLの生成を可能にします。 また、<literal>property-ref</literal> のターゲットとすることもできます。" +#. Tag: para +#: basic_mapping.xml:1162 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>undefined</" +"literal>): A version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. (<literal>undefined</literal> " +"specifies that the identifier property value should be used.)" +msgstr "" +"<literal>unsaved-value</literal> （オプション - デフォルトは " +"<literal>undefined</literal> ）： インスタンスが新しくインスタンス化されたこ" +"とを示す （セーブされていないことを示す）バージョンプロパティの値。 以前の" +"Sessionでセーブまたはロードされた一時的なインスタンスと区別するために 使いま" +"す。 （ <literal>undefined</literal> は識別子プロパティの値が使われることを指" +"定します。）" -#: index.docbook:1171 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this version property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." -msgstr "<literal>not-null</literal> (オプション):カラムにnull値を許可するDDLの生成を可能にします。" +#. Tag: para +#: basic_mapping.xml:1171 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this version property value is actually generated " +"by the database. See the discussion of <link linkend=\"mapping-generated" +"\">generated properties</link>." +msgstr "" +"<literal>generated</literal> (オプション - デフォルトは <literal>never</" +"literal> ): このバージョンのプロパティの値が、データベースによって生成された" +"ことを指定します。 <xref linkend=\"mapping-generated\">生成プロパティ</xref> " +"の議論を見てください。" -#: index.docbook:1178 -msgid "<literal>insert</literal> (optional - defaults to <literal>true</literal>): Specifies whether the version column should be included in SQL insert statements. May be set to <literal>false</literal> if and only if the database column is defined with a default value of <literal>0</literal>." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定します。 言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +#. Tag: para +#: basic_mapping.xml:1178 +#, no-c-format +msgid "" +"<literal>insert</literal> (optional - defaults to <literal>true</literal>): " +"Specifies whether the version column should be included in SQL insert " +"statements. May be set to <literal>false</literal> if and only if the " +"database column is defined with a default value of <literal>0</literal>." +msgstr "" +"<literal>insert</literal> (オプション - デフォルトは <literal>true</" +"literal> ): SQLのinsert文にバージョン・カラムを含めるべきかどうかを指定しま" +"す。 もしデータベース・カラムのデフォルト値が <literal>0</literal> と定義され" +"るときには、 <literal>false</literal> に設定すると良いでしょう。" -#: index.docbook:1188 -msgid "Version numbers may be of Hibernate type <literal>long</literal>, <literal>integer</literal>, <literal>short</literal>, <literal>timestamp</literal> or <literal>calendar</literal>." -msgstr "<literal>generated</literal> (オプション - デフォルトは <literal>never</literal> ): プロパティの値が、データベースによって生成されたことを指定します。 <xref linkend=\"mapping-generated\"/>生成プロパティ を参照してください。" +#. Tag: para +#: basic_mapping.xml:1188 +#, no-c-format +msgid "" +"Version numbers may be of Hibernate type <literal>long</literal>, " +"<literal>integer</literal>, <literal>short</literal>, <literal>timestamp</" +"literal> or <literal>calendar</literal>." +msgstr "" +"バージョン番号は Hibernateの <literal>long</literal> , <literal>integer</" +"literal> , <literal>short</literal> , <literal>timestamp</literal> , " +"<literal>calendar</literal> 型のいずれかです。" -#: index.docbook:1193 -msgid "A version or timestamp property should never be null for a detached instance, so Hibernate will detect any instance with a null version or timestamp as transient, no matter what other <literal>unsaved-value</literal> strategies are specified. <emphasis>Declaring a nullable version or timestamp property is an easy way to avoid any problems with transitive reattachment in Hibernate, especially useful for people using assigned identifiers or composite keys!</emphasis>" -msgstr "<emphasis>typename</emphasis> には以下の値が可能です：" +#. Tag: para +#: basic_mapping.xml:1193 +#, no-c-format +msgid "" +"A version or timestamp property should never be null for a detached " +"instance, so Hibernate will detect any instance with a null version or " +"timestamp as transient, no matter what other <literal>unsaved-value</" +"literal> strategies are specified. <emphasis>Declaring a nullable version or " +"timestamp property is an easy way to avoid any problems with transitive " +"reattachment in Hibernate, especially useful for people using assigned " +"identifiers or composite keys!</emphasis>" +msgstr "" +"バージョンやタイムスタンプのプロパティは、分離されたインスタンスに対してnull" +"であってはなりません。 そのためどのような <literal>unsaved-value</literal> 戦" +"略が指定されても、 Hibernateはnullのバージョンやタイムスタンプを持ったすべて" +"のインスタンスを、 一時的なものであると判断します。 <emphasis> nullを許容する" +"バージョンやタイムスタンプのプロパティを定義することは、 過渡的に一時オブジェ" +"クトとすることを防ぐ簡単な方法です。 特に識別子の割り当てや複合キーを使用して" +"いるときには特に有用です。</emphasis>" -#: index.docbook:1204 +#. Tag: title +#: basic_mapping.xml:1204 +#, no-c-format msgid "timestamp (optional)" -msgstr "Hibernateの基本型の名前（例 <literal>integer, string, character, date, timestamp, float, binary, serializable, object, blob</literal> ）。" +msgstr "timestamp（オプション）" -#: index.docbook:1206 -msgid "The optional <literal>&lt;timestamp&gt;</literal> element indicates that the table contains timestamped data. This is intended as an alternative to versioning. Timestamps are by nature a less safe implementation of optimistic locking. However, sometimes the application might use the timestamps in other ways." -msgstr "デフォルトの基本型のJavaクラス名 （例 <literal>int, float, char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal> ）。" +#. Tag: para +#: basic_mapping.xml:1206 +#, no-c-format +msgid "" +"The optional <literal>&lt;timestamp&gt;</literal> element indicates that the " +"table contains timestamped data. This is intended as an alternative to " +"versioning. Timestamps are by nature a less safe implementation of " +"optimistic locking. However, sometimes the application might use the " +"timestamps in other ways." +msgstr "" +"オプションの <literal>&lt;timestamp&gt;</literal> 要素は、 テーブルがタイムス" +"タンプデータを含むことを示します。 これはバージョン付けの代わりの方法として用" +"意されています。 タイムスタンプはもともと楽観的ロックにおける安全性の低い実装" +"です。 しかしアプリケーションは異なる用途で使うこともあるかもしれません。" -#: index.docbook:1222 +#. Tag: programlisting +#: basic_mapping.xml:1222 +#, no-c-format msgid "" - "<![CDATA[<timestamp\n" - " column=\"timestamp_column\"\n" - " name=\"propertyName\"\n" - " access=\"field|property|ClassName\"\n" - " unsaved-value=\"null|undefined\"\n" - " source=\"vm|db\"\n" - " generated=\"never|always\"\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; - "/>]]>" -msgstr "シリアライズ可能なJavaクラスの名前。" +"<![CDATA[<timestamp\n" +" column=\"timestamp_column\"\n" +" name=\"propertyName\"\n" +" access=\"field|property|ClassName\"\n" +" unsaved-value=\"null|undefined\"\n" +" source=\"vm|db\"\n" +" generated=\"never|always\"\n" +" node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; +"/>]]>" +msgstr "" -#: index.docbook:1225 -msgid "<literal>column</literal> (optional - defaults to the property name): The name of a column holding the timestamp." -msgstr "カスタム型のクラス名（例 <literal>com.illflow.type.MyCustomType</literal> ）。" +#. Tag: para +#: basic_mapping.xml:1225 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): The " +"name of a column holding the timestamp." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）： タイムス" +"タンプを保持するカラムの名前。" -#: index.docbook:1231 -msgid "<literal>name</literal>: The name of a JavaBeans style property of Java type <literal>Date</literal> or <literal>Timestamp</literal> of the persistent class." -msgstr "型を指定しなければ、Hibernateは正しいHibernateの型を推測するために、 指定されたプロパティに対してリフレクションを使います。 Hibernateはルール2, 3, 4をその順序に使い、 getterプロパティの返り値のクラスの名前を解釈しようとします。 しかしこれで常に十分であるとは限りません。 場合によっては、<literal>type</literal> 属性が必要な場合があります。 （例えば <literal>Hibernate.DATE</literal> と <literal>Hibernate.TIMESTAMP</literal> を区別するため、 またはカスタム型を指定するためなどです。）" +#. Tag: para +#: basic_mapping.xml:1231 +#, no-c-format +msgid "" +"<literal>name</literal>: The name of a JavaBeans style property of Java type " +"<literal>Date</literal> or <literal>Timestamp</literal> of the persistent " +"class." +msgstr "" +"<literal>name</literal> ： 永続クラスであるJava の <literal>Date</literal>型 " +"または <literal>Timestamp</literal> 型 の、JavaBeansスタイルプロパティの名" +"前。" -#: index.docbook:1244 -msgid "<literal>unsaved-value</literal> (optional - defaults to <literal>null</literal>): A version property value that indicates that an instance is newly instantiated (unsaved), distinguishing it from detached instances that were saved or loaded in a previous session. (<literal>undefined</literal> specifies that the identifier property value should be used.)" -msgstr "特に強力な特徴は生成プロパティです。 これらのプロパティは当然読み取り専用であり、プロパティの値はロード時に計算されます。 計算をSQL式として宣言すると、このプロパティは インスタンスをロードするSQLクエリの <literal>SELECT</literal> 句のサブクエリに変換されます。" +#. Tag: para +#: basic_mapping.xml:1244 +#, no-c-format +msgid "" +"<literal>unsaved-value</literal> (optional - defaults to <literal>null</" +"literal>): A version property value that indicates that an instance is newly " +"instantiated (unsaved), distinguishing it from detached instances that were " +"saved or loaded in a previous session. (<literal>undefined</literal> " +"specifies that the identifier property value should be used.)" +msgstr "" +"<literal>unsaved-value</literal> （オプション - デフォルトは <literal>null</" +"literal> ）： インスタンスが新しくインスタンス化された （セーブされていない）" +"ことを示すバージョンプロパティの値。 以前のSessionでセーブまたはロードされた" +"一時的なインスタンスと 区別するために使われます。 （ <literal>undefined</" +"literal> と指定すると、 識別子プロパティの値が使われます。）" -#: index.docbook:1253 -msgid "<literal>source</literal> (optional - defaults to <literal>vm</literal>): From where should Hibernate retrieve the timestamp value? From the database, or from the current JVM? Database-based timestamps incur an overhead because Hibernate must hit the database in order to determine the \"next value\", but will be safer for use in clustered environments. Note also, that not all <literal>Dialect</literal>s are known to support retrieving of the database's current timestamp, while others might be unsafe for usage in locking due to lack of precision (Oracle 8 for example)." +#. Tag: para +#: basic_mapping.xml:1253 +#, no-c-format +msgid "" +"<literal>source</literal> (optional - defaults to <literal>vm</literal>): " +"From where should Hibernate retrieve the timestamp value? From the database, " +"or from the current JVM? Database-based timestamps incur an overhead because " +"Hibernate must hit the database in order to determine the \"next value\", " +"but will be safer for use in clustered environments. Note also, that not all " +"<literal>Dialect</literal>s are known to support retrieving of the " +"database's current timestamp, while others might be unsafe for usage in " +"locking due to lack of precision (Oracle 8 for example)." msgstr "" - "<![CDATA[ -\n" - "<property name=\"totalPrice\" -\n" - " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p -\n" - " WHERE li.productId = p.productId -\n" - " AND li.customerId = customerId -\n" - " AND li.orderNumber = orderNumber )\"/>]]>" +"<literal>source</literal> (オプション - デフォルトは <literal>vm</" +"literal> ): Hibernateはどこからタイムスタンプの値を取得するべきでしょうか？ " +"データベースからでしょうか、現在のJVMからでしょうか？ データベースによるタイ" +"ムスタンプは、Hibernateが\"次の値\"を決定するために データベースをヒットしな" +"ければならないため、オーバヘッドを招きます。 しかしクラスタ環境ではJVMから取" +"得するより安全です。 データベースの現在のタイムスタンプの取得をサポートする " +"すべての <literal>データベース方言</literal> が知られているわけではないこと" +"に 注意してください。また一方で、精密さを欠くために、 ロックで使用するには安" +"全でないものもあります(例えばOracle 8)。" -#: index.docbook:1265 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this timestamp property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." -msgstr "特定のカラム(例では <literal>customerId</literal> がそれにあたります)のエイリアスを宣言することなく、 エンティティ自身のテーブルを参照できることに注意してください。 もし属性を使用したくなければ、 ネストした <literal>&lt;formula&gt;</literal> マッピング要素を使えることにも注意してください。" +#. Tag: para +#: basic_mapping.xml:1265 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this timestamp property value is actually " +"generated by the database. See the discussion of <link linkend=\"mapping-" +"generated\">generated properties</link>." +msgstr "" +"<literal>generated</literal> (オプション - デフォルトは <literal>never</" +"literal> ): このタイムスタンプ・プロパティの値が、データベースによって生成さ" +"れることを指定します。 <xref linkend=\"mapping-generated\">生成プロパティ</" +"xref> を参照してください。" -#: index.docbook:1274 -msgid "Note that <literal>&lt;timestamp&gt;</literal> is equivalent to <literal>&lt;version type=\"timestamp\"&gt;</literal>. And <literal>&lt;timestamp source=\"db\"&gt;</literal> is equivalent to <literal>&lt;version type=\"dbtimestamp\"&gt;</literal>" -msgstr "many-to-one" +#. Tag: para +#: basic_mapping.xml:1274 +#, no-c-format +msgid "" +"Note that <literal>&lt;timestamp&gt;</literal> is equivalent to <literal>&lt;" +"version type=\"timestamp\"&gt;</literal>. And <literal>&lt;timestamp source=" +"\"db\"&gt;</literal> is equivalent to <literal>&lt;version type=\"dbtimestamp" +"\"&gt;</literal>" +msgstr "" +"<literal>&lt;timestamp&gt;</literal> は <literal>&lt;version type=\"timestamp" +"\"&gt;</literal> と等価であることに注意してください。 <literal>&lt;timestamp " +"source=\"db\"&gt;</literal> は <literal>&lt;version type=\"dbtimestamp\"&gt;" +"</literal> と等価であることに注意してください。" -#: index.docbook:1284 +#. Tag: title +#: basic_mapping.xml:1284 +#, no-c-format msgid "property" -msgstr "他の永続クラスへの通常の関連は <literal>many-to-one</literal> 要素を使って定義します。 リレーショナルモデルは多対一関連です。 つまりあるテーブルの外部キーは、ターゲットとなるテーブルの主キーカラムを参照しています。" +msgstr "property" -#: index.docbook:1286 -msgid "The <literal>&lt;property&gt;</literal> element declares a persistent, JavaBean style property of the class." +#. Tag: para +#: basic_mapping.xml:1286 +#, no-c-format +msgid "" +"The <literal>&lt;property&gt;</literal> element declares a persistent, " +"JavaBean style property of the class." msgstr "" - "<![CDATA[<many-to-one -\n" - " name=\"propertyName\" -\n" - " column=\"column_name\" -\n" - " class=\"ClassName\" -\n" - " cascade=\"cascade_style\" -\n" - " fetch=\"join|select\" -\n" - " update=\"true|false\" -\n" - " insert=\"true|false\" -\n" - " property-ref=\"propertyNameFromAssociatedClass\" -\n" - " access=\"field|property|ClassName\" -\n" - " unique=\"true|false\" -\n" - " not-null=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " lazy=\"proxy|no-proxy|false\" -\n" - " not-found=\"ignore|exception\" -\n" - " entity-name=\"EntityName\" -\n" - " formula=\"arbitrary SQL expression\" -\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot; -\n" - " embed-xml=\"true|false\" -\n" - " index=\"index_name\" -\n" - " unique_key=\"unique_key_id\" -\n" - " foreign-key=\"foreign_key_name\" -\n" - "/>]]>" +"<literal>&lt;property&gt;</literal> 要素は、クラスの永続的なJavaBeanスタイル" +"のプロパティを定義します。" -#: index.docbook:1308 +#. Tag: programlisting +#: basic_mapping.xml:1308 +#, no-c-format msgid "" - "<![CDATA[<property\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " type=\"typename\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " formula=\"arbitrary SQL expression\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " generated=\"never|insert|always\"\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - "/>]]>" -msgstr "<literal>name</literal>：プロパティ名。" +"<![CDATA[<property\n" +" name=\"propertyName\"\n" +" column=\"column_name\"\n" +" type=\"typename\"\n" +" update=\"true|false\"\n" +" insert=\"true|false\"\n" +" formula=\"arbitrary SQL expression\"\n" +" access=\"field|property|ClassName\"\n" +" lazy=\"true|false\"\n" +" unique=\"true|false\"\n" +" not-null=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" generated=\"never|insert|always\"\n" +" node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; +" index=\"index_name\"\n" +" unique_key=\"unique_key_id\"\n" +" length=\"L\"\n" +" precision=\"P\"\n" +" scale=\"S\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1311 -msgid "<literal>name</literal>: the name of the property, with an initial lowercase letter." -msgstr "<literal>column</literal> (オプション):外部キーカラムの名前。 ネストした <literal>&lt;column&gt;</literal> 要素でも指定できます。" +#. Tag: para +#: basic_mapping.xml:1311 +#, no-c-format +msgid "" +"<literal>name</literal>: the name of the property, with an initial lowercase " +"letter." +msgstr "<literal>name</literal>：小文字で始まるプロパティ名。" -#: index.docbook:1317 -msgid "<literal>column</literal> (optional - defaults to the property name): the name of the mapped database table column. This may also be specified by nested <literal>&lt;column&gt;</literal> element(s)." -msgstr "<literal>class</literal>（オプション - デフォルトは、 リフレクションにより決定されるプロパティの型）：関連クラスの名前。" +#. Tag: para +#: basic_mapping.xml:1317 +#, no-c-format +msgid "" +"<literal>column</literal> (optional - defaults to the property name): the " +"name of the mapped database table column. This may also be specified by " +"nested <literal>&lt;column&gt;</literal> element(s)." +msgstr "" +"<literal>column</literal>（オプション - デフォルトはプロパティ名）： マッピン" +"グされたデータベーステーブルのカラムの名前。 ネストした <literal>&lt;" +"column&gt;</literal> 要素でも指定できます。" -#: index.docbook:1324 -msgid "<literal>type</literal> (optional): a name that indicates the Hibernate type." -msgstr "<literal>cascade</literal>（オプション）： どの操作を、親オブジェクトから関連オブジェクトへとカスケードさせるかを指定します。" +#. Tag: para +#: basic_mapping.xml:1324 +#, no-c-format +msgid "" +"<literal>type</literal> (optional): a name that indicates the Hibernate type." +msgstr "<literal>type</literal>（オプション）：Hibernateの型を示す名前。" -#: index.docbook:1329 -msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>) : specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" property whose value is initialized from some other property that maps to the same colum(s) or by a trigger or other application." -msgstr "<literal>fetch</literal> (オプション - デフォルトは <literal>select</literal> ): 外部結合フェッチか順次選択フェッチ（sequential select fetch）を選択します。" +#. Tag: para +#: basic_mapping.xml:1329 +#, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>) : specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" property " +"whose value is initialized from some other property that maps to the same " +"colum(s) or by a trigger or other application." +msgstr "" +"<literal>update, insert</literal> （オプション - デフォルトは <literal>true</" +"literal> ）： マッピングされたカラムがSQLの <literal>UPDATE</literal> や " +"<literal>INSERT</literal> に含まれることを指定します。 両方とも " +"<literal>false</literal> に設定すると、 同じカラムにマッピングされた他のプロ" +"パティやトリガや 他のアプリケーションによって初期化された純粋な「導出」プロパ" +"ティが可能になります。" -#: index.docbook:1338 -msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> property. Computed properties do not have a column mapping of their own." -msgstr "<literal>update, insert</literal>（オプション - デフォルトは <literal>true</literal> ）： マッピングされたカラムがSQLの <literal>UPDATE</literal> または <literal>INSERT</literal> 文に含まれることを指定します。 両方とも <literal>false</literal> に設定すると、 その値が同じカラムにマッピングされた他のプロパティやトリガや 他のアプリケーションによって初期化された純粋な「導出」プロパティが可能になります。" +#. Tag: para +#: basic_mapping.xml:1338 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> property. Computed properties do " +"not have a column mapping of their own." +msgstr "" +"<literal>formula</literal>（オプション）： <emphasis>計算</emphasis> プロパ" +"ティのための値を定義するSQL式。 計算されたプロパティは自身のカラムへのマッピ" +"ングがありません。" -#: index.docbook:1351 -msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): Specifies that this property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation)." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1351 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that this property should be fetched lazily when the instance " +"variable is first accessed (requires build-time bytecode instrumentation)." +msgstr "" +"<literal>lazy</literal> (optional - デフォルトは <literal>false</literal> ): " +"インスタンス変数に最初にアクセスしたときに、プロパティを遅延して取得するよう" +"指定します。 (バイトコード実装を作成する時間が必要になります)。" -#: index.docbook:1358 -msgid "<literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the columns. Also, allow this to be the target of a <literal>property-ref</literal>." -msgstr "<literal>unique</literal>（オプション）： 外部キーカラムに対してユニーク制約をつけたDDLの生成を可能にします。 また、<literal>property-ref</literal> のターゲットにすることもできます。 これにより関連の多重度を効果的に一対一にします。" +#. Tag: para +#: basic_mapping.xml:1358 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Enable the DDL generation of a unique " +"constraint for the columns. Also, allow this to be the target of a " +"<literal>property-ref</literal>." +msgstr "" +"<literal>unique</literal> (オプション):カラムにユニーク制約をつけるDDLの生成" +"を可能にします。 また、<literal>property-ref</literal> のターゲットとすること" +"もできます。" -#: index.docbook:1365 -msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the columns." -msgstr "<literal>not-null</literal> (オプション):外部キーカラムに対して、 null値を許可するDDLの生成を可能にします" +#. Tag: para +#: basic_mapping.xml:1365 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Enable the DDL generation of a " +"nullability constraint for the columns." +msgstr "" +"<literal>not-null</literal> (オプション):カラムにnull値を許可するDDLの生成を" +"可能にします。" -#: index.docbook:1371 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when this property is dirty." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に楽観的ロックの取得を要求するかどうかを指定します。 言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +#. Tag: para +#: basic_mapping.xml:1371 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定し" +"ます。 言い換えれば、このプロパティがダーティであるときにバージョンを増やすべ" +"きかを決定します。" -#: index.docbook:1379 -msgid "<literal>generated</literal> (optional - defaults to <literal>never</literal>): Specifies that this property value is actually generated by the database. See the discussion of <xref linkend=\"mapping-generated\"/>generated properties." -msgstr "<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 <literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスしたときに、 プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時にフェッチするよう指定します。" +#. Tag: para +#: basic_mapping.xml:1379 +#, no-c-format +msgid "" +"<literal>generated</literal> (optional - defaults to <literal>never</" +"literal>): Specifies that this property value is actually generated by the " +"database. See the discussion of <link linkend=\"mapping-generated" +"\">generated properties</link>." +msgstr "" +"<literal>generated</literal> (オプション - デフォルトは <literal>never</" +"literal> ): プロパティの値が、データベースによって生成されたことを指定しま" +"す。 <xref linkend=\"mapping-generated\">生成プロパティ</xref> を参照してくだ" +"さい。" -#: index.docbook:1388 +#. Tag: para +#: basic_mapping.xml:1388 +#, no-c-format msgid "<emphasis>typename</emphasis> could be:" -msgstr "<literal>not-found</literal> (オプション - デフォルトは <literal>exception</literal> ): 欠落した行を参照する外部キーをどのように扱うかを指定します。 <literal>ignore</literal> は欠落した行をnull関連として扱います。" +msgstr "<emphasis>typename</emphasis> には以下の値が可能です：" -#: index.docbook:1394 -msgid "The name of a Hibernate basic type (eg. <literal>integer, string, character, date, timestamp, float, binary, serializable, object, blob</literal>)." -msgstr "<literal>entity-name</literal> (オプション):関連したクラスのエンティティ名。" +#. Tag: para +#: basic_mapping.xml:1394 +#, no-c-format +msgid "" +"The name of a Hibernate basic type (eg. <literal>integer, string, character, " +"date, timestamp, float, binary, serializable, object, blob</literal>)." +msgstr "" +"Hibernateの基本型の名前（例 <literal>integer, string, character, date, " +"timestamp, float, binary, serializable, object, blob</literal> ）。" -#: index.docbook:1400 -msgid "The name of a Java class with a default basic type (eg. <literal>int, float, char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</literal>)." -msgstr "<literal>formula</literal> (オプション): <emphasis> 計算された</emphasis> 外部キーに対して値を定義するSQL式" +#. Tag: para +#: basic_mapping.xml:1400 +#, no-c-format +msgid "" +"The name of a Java class with a default basic type (eg. <literal>int, float, " +"char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob</" +"literal>)." +msgstr "" +"デフォルトの基本型のJavaクラス名 （例 <literal>int, float, char, java.lang." +"String, java.util.Date, java.lang.Integer, java.sql.Clob</literal> ）。" -#: index.docbook:1406 +#. Tag: para +#: basic_mapping.xml:1406 +#, no-c-format msgid "The name of a serializable Java class." -msgstr "<literal>cascade</literal> 属性に <literal>none</literal> 以外の意味のある値をを設定すると、 関連オブジェクトへある操作が伝播することになります。 意味のある値とはHibernateの基本操作の名前のことで、 <literal>delete-orphan</literal> と <literal>all</literal> 、操作名をカンマで区切った組み合わせ （例えば <literal>cascade=\"persist,merge,evict\"</literal> や <literal>cascade=\"all,delete-orphan\"</literal>）、 またそれだけでなく <literal>persist, merge, delete, save-update, evict, replicate, lock, refresh</literal> のことを指します。 詳しい説明は <xref linkend=\"objectstate-transitive\"/> を見てください。 値が一つの関連(many-to-oneとone-to-one関連)は、 単独での削除（orphan delete)をサポートしていないことに注意してください。" +msgstr "シリアライズ可能なJavaクラスの名前。" -#: index.docbook:1411 -msgid "The class name of a custom type (eg. <literal>com.illflow.type.MyCustomType</literal>)." -msgstr "典型的な <literal>many-to-one</literal> 宣言は次のようにシンプルです。：" +#. Tag: para +#: basic_mapping.xml:1411 +#, no-c-format +msgid "" +"The class name of a custom type (eg. <literal>com.illflow.type.MyCustomType</" +"literal>)." +msgstr "" +"カスタム型のクラス名（例 <literal>com.illflow.type.MyCustomType</" +"literal> ）。" -#: index.docbook:1417 -msgid "If you do not specify a type, Hibernate will use reflection upon the named property to take a guess at the correct Hibernate type. Hibernate will try to interpret the name of the return class of the property getter using rules 2, 3, 4 in that order. However, this is not always enough. In certain cases you will still need the <literal>type</literal> attribute. (For example, to distinguish between <literal>Hibernate.DATE</literal> and <literal>Hibernate.TIMESTAMP</literal>, or to specify a custom type.)" -msgstr "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1417 +#, no-c-format +msgid "" +"If you do not specify a type, Hibernate will use reflection upon the named " +"property to take a guess at the correct Hibernate type. Hibernate will try " +"to interpret the name of the return class of the property getter using rules " +"2, 3, 4 in that order. However, this is not always enough. In certain cases " +"you will still need the <literal>type</literal> attribute. (For example, to " +"distinguish between <literal>Hibernate.DATE</literal> and <literal>Hibernate." +"TIMESTAMP</literal>, or to specify a custom type.)" +msgstr "" +"型を指定しなければ、Hibernateは正しいHibernateの型を推測するために、 指定され" +"たプロパティに対してリフレクションを使います。 Hibernateはルール2, 3, 4をその" +"順序に使い、 getterプロパティの返り値のクラスの名前を解釈しようとします。 し" +"かしこれで常に十分であるとは限りません。 場合によっては、<literal>type</" +"literal> 属性が必要な場合があります。 （例えば <literal>Hibernate.DATE</" +"literal> と <literal>Hibernate.TIMESTAMP</literal> を区別するため、 またはカ" +"スタム型を指定するためなどです。）" -#: index.docbook:1427 -msgid "The <literal>access</literal> attribute lets you control how Hibernate will access the property at runtime. By default, Hibernate will call the property get/set pair. If you specify <literal>access=\"field\"</literal>, Hibernate will bypass the get/set pair and access the field directly, using reflection. You may specify your own strategy for property access by naming a class that implements the interface <literal>org.hibernate.property.PropertyAccessor</literal>." -msgstr "<literal>property-ref</literal> 属性は、外部キーが関連付けられたテーブルの、主キーでない ユニークキーを参照しているレガシーデータをマップするためにだけ使うべきです。 これは醜いリレーショナルモデルです。 例えば <literal>Product</literal> クラスが、 主キーでないユニークなシリアルナンバーを持っていると仮定してみてください。 （ <literal>unique</literal> 属性はSchemaExportツールを使ったHibernateのDDL生成を制御します。）" +#. Tag: para +#: basic_mapping.xml:1427 +#, no-c-format +msgid "" +"The <literal>access</literal> attribute lets you control how Hibernate will " +"access the property at runtime. By default, Hibernate will call the property " +"get/set pair. If you specify <literal>access=\"field\"</literal>, Hibernate " +"will bypass the get/set pair and access the field directly, using " +"reflection. You may specify your own strategy for property access by naming " +"a class that implements the interface <literal>org.hibernate.property." +"PropertyAccessor</literal>." +msgstr "" +"<literal>access</literal> 属性で、 実行時にHibernateがどのようにプロパティに" +"アクセスするかを制御できます。 デフォルトではHibernateはプロパティのget/setの" +"ペアをコールします。 <literal>access=\"field\"</literal> と指定すれば、 " +"Hibernateはリフレクションを使いget/setのペアを介さずに、直接フィールドにアク" +"セスします。 インターフェイス <literal>org.hibernate.property." +"PropertyAccessor</literal> を 実装するクラスを指定することで、プロパティへの" +"アクセスに独自の戦略を指定することができます。" -#: index.docbook:1436 -msgid "An especially powerful feature are derived properties. These properties are by definition read-only, the property value is computed at load time. You declare the computation as a SQL expression, this translates to a <literal>SELECT</literal> clause subquery in the SQL query that loads an instance:" -msgstr "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=\"SERIAL_NUMBER\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1436 +#, no-c-format +msgid "" +"An especially powerful feature are derived properties. These properties are " +"by definition read-only, the property value is computed at load time. You " +"declare the computation as a SQL expression, this translates to a " +"<literal>SELECT</literal> clause subquery in the SQL query that loads an " +"instance:" +msgstr "" +"特に強力な特徴は生成プロパティです。 これらのプロパティは当然読み取り専用であ" +"り、プロパティの値はロード時に計算されます。 計算をSQL式として宣言すると、こ" +"のプロパティは インスタンスをロードするSQLクエリの <literal>SELECT</literal> " +"句のサブクエリに変換されます。" -#: index.docbook:1443 +#. Tag: programlisting +#: basic_mapping.xml:1443 +#, no-c-format msgid "" - "<![CDATA[\n" - "<property name=\"totalPrice\"\n" - " formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product p\n" - " WHERE li.productId = p.productId\n" - " AND li.customerId = customerId\n" - " AND li.orderNumber = orderNumber )\"/>]]>" -msgstr "以下のように <literal>OrderItem</literal> に対してマッピングを使えます：" +"<![CDATA[\n" +"<property name=\"totalPrice\"\n" +" formula=\"( SELECT SUM (li.quantity*p.price) FROM LineItem li, Product " +"p\n" +" WHERE li.productId = p.productId\n" +" AND li.customerId = customerId\n" +" AND li.orderNumber = orderNumber )\"/>]]>" +msgstr "" -#: index.docbook:1445 -msgid "Note that you can reference the entities own table by not declaring an alias on a particular column (<literal>customerId</literal> in the given example). Also note that you can use the nested <literal>&lt;formula&gt;</literal> mapping element if you don't like to use the attribute." -msgstr "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=\"PRODUCT_SERIAL_NUMBER\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1445 +#, no-c-format +msgid "" +"Note that you can reference the entities own table by not declaring an alias " +"on a particular column (<literal>customerId</literal> in the given example). " +"Also note that you can use the nested <literal>&lt;formula&gt;</literal> " +"mapping element if you don't like to use the attribute." +msgstr "" +"特定のカラム(例では <literal>customerId</literal> がそれにあたります)のエイリ" +"アスを宣言することなく、 エンティティ自身のテーブルを参照できることに注意して" +"ください。 もし属性を使用したくなければ、 ネストした <literal>&lt;formula&gt;" +"</literal> マッピング要素を使えることにも注意してください。" -#: index.docbook:1455 +#. Tag: title +#: basic_mapping.xml:1455 +#, no-c-format msgid "many-to-one" -msgstr "しかし、これは決して推奨できません。" +msgstr "many-to-one" -#: index.docbook:1457 -msgid "An ordinary association to another persistent class is declared using a <literal>many-to-one</literal> element. The relational model is a many-to-one association: a foreign key in one table is referencing the primary key column(s) of the target table." -msgstr "参照したユニークキーが、関連するエンティティの多数のプロパティから構成される場合、 指定した <literal>&lt;properties&gt;</literal> 要素内で、参照するプロパティをマッピングするべきです。" +#. Tag: para +#: basic_mapping.xml:1457 +#, no-c-format +msgid "" +"An ordinary association to another persistent class is declared using a " +"<literal>many-to-one</literal> element. The relational model is a many-to-" +"one association: a foreign key in one table is referencing the primary key " +"column(s) of the target table." +msgstr "" +"他の永続クラスへの通常の関連は <literal>many-to-one</literal> 要素を使って定" +"義します。 リレーショナルモデルは多対一関連です。 つまりあるテーブルの外部" +"キーは、ターゲットとなるテーブルの主キーカラムを参照しています。" -#: index.docbook:1485 +#. Tag: programlisting +#: basic_mapping.xml:1485 +#, no-c-format msgid "" - "<![CDATA[<many-to-one\n" - " name=\"propertyName\"\n" - " column=\"column_name\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " fetch=\"join|select\"\n" - " update=\"true|false\"\n" - " insert=\"true|false\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " unique=\"true|false\"\n" - " not-null=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " formula=\"arbitrary SQL expression\"\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; - " embed-xml=\"true|false\"\n" - " index=\"index_name\"\n" - " unique_key=\"unique_key_id\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" -msgstr "もし参照したユニークキーがコンポーネントのプロパティである場合は、プロパティのパスを指定できます。" +"<![CDATA[<many-to-one\n" +" name=\"propertyName\"\n" +" column=\"column_name\"\n" +" class=\"ClassName\"\n" +" cascade=\"cascade_style\"\n" +" fetch=\"join|select\"\n" +" update=\"true|false\"\n" +" insert=\"true|false\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" access=\"field|property|ClassName\"\n" +" unique=\"true|false\"\n" +" not-null=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" lazy=\"proxy|no-proxy|false\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" formula=\"arbitrary SQL expression\"\n" +" node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; +" embed-xml=\"true|false\"\n" +" index=\"index_name\"\n" +" unique_key=\"unique_key_id\"\n" +" foreign-key=\"foreign_key_name\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1488, index.docbook:1669, index.docbook:1855 +#. Tag: para +#: basic_mapping.xml:1488 basic_mapping.xml:1669 basic_mapping.xml:1855 +#, no-c-format msgid "<literal>name</literal>: The name of the property." -msgstr "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=\"OWNER_SSN\"/>]]>" +msgstr "<literal>name</literal>：プロパティ名。" -#: index.docbook:1493, index.docbook:2284 -msgid "<literal>column</literal> (optional): The name of the foreign key column. This may also be specified by nested <literal>&lt;column&gt;</literal> element(s)." -msgstr "one-to-one" +#. Tag: para +#: basic_mapping.xml:1493 basic_mapping.xml:2284 +#, fuzzy, no-c-format +msgid "" +"<literal>column</literal> (optional): The name of the foreign key column. " +"This may also be specified by nested <literal>&lt;column&gt;</literal> " +"element(s)." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>column</literal> (オプション):外部キーカラムの名前。 ネストした " +"<literal>&lt;column&gt;</literal> 要素でも指定できます。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>column</literal> (オプション):外部キーカラムの名前。 ネストした " +"<literal>&lt;column&gt;</literal> カラムによっても指定されます。" -#: index.docbook:1500, index.docbook:1674 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The name of the associated class." -msgstr "他の永続クラスへの一対一関連は、<literal>one-to-one</literal> 要素で定義します。" +#. Tag: para +#: basic_mapping.xml:1500 basic_mapping.xml:1674 +#, fuzzy, no-c-format +msgid "" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The name of the associated class." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>class</literal>（オプション - デフォルトは、 リフレクションにより決" +"定されるプロパティの型）：関連クラスの名前。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>class</literal>（オプション - デフォルトはリフレクションにより決定さ" +"れるプロパティの型）： 関連クラスの名前。" -#: index.docbook:1506 -msgid "<literal>cascade</literal> (optional): Specifies which operations should be cascaded from the parent object to the associated object." +#. Tag: para +#: basic_mapping.xml:1506 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional): Specifies which operations should be " +"cascaded from the parent object to the associated object." msgstr "" - "<![CDATA[<one-to-one -\n" - " name=\"propertyName\" -\n" - " class=\"ClassName\" -\n" - " cascade=\"cascade_style\" -\n" - " constrained=\"true|false\" -\n" - " fetch=\"join|select\" -\n" - " property-ref=\"propertyNameFromAssociatedClass\" -\n" - " access=\"field|property|ClassName\" -\n" - " formula=\"any SQL expression\" -\n" - " lazy=\"proxy|no-proxy|false\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot; -\n" - " embed-xml=\"true|false\" -\n" - " foreign-key=\"foreign_key_name\" -\n" - "/>]]>" +"<literal>cascade</literal>（オプション）： どの操作を、親オブジェクトから関連" +"オブジェクトへとカスケードさせるかを指定します。" -#: index.docbook:1512, index.docbook:1695 -msgid "<literal>fetch</literal> (optional - defaults to <literal>select</literal>): Chooses between outer-join fetching or sequential select fetching." -msgstr "<literal>name</literal>：プロパティ名。" +#. Tag: para +#: basic_mapping.xml:1512 basic_mapping.xml:1695 +#, fuzzy, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>select</literal>): " +"Chooses between outer-join fetching or sequential select fetching." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>fetch</literal> (オプション - デフォルトは <literal>select</" +"literal> ): 外部結合フェッチか順次選択フェッチ（sequential select fetch）を選" +"択します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>fetch</literal>（オプション - デフォルトは <literal>select</" +"literal> ）： 外部結合フェッチと順次選択フェッチ（sequential select fetch）の" +"どちらかを選択します。" -#: index.docbook:1518 -msgid "<literal>update, insert</literal> (optional - defaults to <literal>true</literal>) specifies that the mapped columns should be included in SQL <literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. Setting both to <literal>false</literal> allows a pure \"derived\" association whose value is initialized from some other property that maps to the same colum(s) or by a trigger or other application." -msgstr "<literal>class</literal>（オプション - デフォルトはリフレクションにより決定されるプロパティの型）： 関連クラスの名前。" +#. Tag: para +#: basic_mapping.xml:1518 +#, no-c-format +msgid "" +"<literal>update, insert</literal> (optional - defaults to <literal>true</" +"literal>) specifies that the mapped columns should be included in SQL " +"<literal>UPDATE</literal> and/or <literal>INSERT</literal> statements. " +"Setting both to <literal>false</literal> allows a pure \"derived\" " +"association whose value is initialized from some other property that maps to " +"the same colum(s) or by a trigger or other application." +msgstr "" +"<literal>update, insert</literal>（オプション - デフォルトは <literal>true</" +"literal> ）： マッピングされたカラムがSQLの <literal>UPDATE</literal> または " +"<literal>INSERT</literal> 文に含まれることを指定します。 両方とも " +"<literal>false</literal> に設定すると、 その値が同じカラムにマッピングされた" +"他のプロパティやトリガや 他のアプリケーションによって初期化された純粋な「導" +"出」プロパティが可能になります。" -#: index.docbook:1527 -msgid "<literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to this foreign key. If not specified, the primary key of the associated class is used." -msgstr "<literal>cascade</literal>（オプション）： 親オブジェクトから関連オブジェクトへ、どの操作をカスケードするかを指定します。" +#. Tag: para +#: basic_mapping.xml:1527 +#, no-c-format +msgid "" +"<literal>property-ref</literal>: (optional) The name of a property of the " +"associated class that is joined to this foreign key. If not specified, the " +"primary key of the associated class is used." +msgstr "" +"<literal>property-ref</literal>（オプション）： この外部キーに結合された関連" +"クラスのプロパティ名。 何も指定しなければ、関連クラスの主キーが使われます。" -#: index.docbook:1540 -msgid "<literal>unique</literal> (optional): Enable the DDL generation of a unique constraint for the foreign-key column. Also, allow this to be the target of a <literal>property-ref</literal>. This makes the association multiplicity effectively one to one." -msgstr "<literal>fetch</literal>（オプション - デフォルトは <literal>select</literal> ）： 外部結合フェッチと順次選択フェッチ（sequential select fetch）のどちらかを選択します。" +#. Tag: para +#: basic_mapping.xml:1540 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Enable the DDL generation of a unique " +"constraint for the foreign-key column. Also, allow this to be the target of " +"a <literal>property-ref</literal>. This makes the association multiplicity " +"effectively one to one." +msgstr "" +"<literal>unique</literal>（オプション）： 外部キーカラムに対してユニーク制約" +"をつけたDDLの生成を可能にします。 また、<literal>property-ref</literal> の" +"ターゲットにすることもできます。 これにより関連の多重度を効果的に一対一にしま" +"す。" -#: index.docbook:1548 -msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the foreign key columns." -msgstr "<literal>property-ref</literal>（オプション）： このクラスの主キーに結合された関連クラスのプロパティ名。 指定されなければ、関連クラスの主キーが使われます。" +#. Tag: para +#: basic_mapping.xml:1548 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Enable the DDL generation of a " +"nullability constraint for the foreign key columns." +msgstr "" +"<literal>not-null</literal> (オプション):外部キーカラムに対して、 null値を許" +"可するDDLの生成を可能にします" -#: index.docbook:1554 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, dertermines if a version increment should occur when this property is dirty." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:1554 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, dertermines if a version " +"increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に楽観的ロックの取得を要求するかどうかを指定" +"します。 言い換えれば、このプロパティがダーティであるときにバージョンを増やす" +"べきかを決定します。" -#: index.docbook:1562 -msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): By default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation). <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched." -msgstr "<literal>formula</literal> (オプション): ほとんどすべての一対一関連はオーナーのエンティティの主キーへとマッピングされます。 これ以外の稀な場合は、 他のカラムや、複数のカラム、SQL構文を使った結合するための式を指定できます。 （例は <literal>org.hibernate.test.onetooneformula</literal> を参照してください。）" +#. Tag: para +#: basic_mapping.xml:1562 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"By default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed (requires build-time bytecode " +"instrumentation). <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched." +msgstr "" +"<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</" +"literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 " +"<literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスした" +"ときに、 プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実" +"装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時に" +"フェッチするよう指定します。" -#: index.docbook:1572 -msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how foreign keys that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association." -msgstr "<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 <literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスしたときに、 プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時にフェッチするよう指定します。 <emphasis>もし <literal>constrained=\"false\"</literal> ならば、 プロキシは使用不可能となり、関連を即時にフェッチすることに注意してください！</emphasis>" +#. Tag: para +#: basic_mapping.xml:1572 +#, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): Specifies how foreign keys that reference missing rows will be " +"handled: <literal>ignore</literal> will treat a missing row as a null " +"association." +msgstr "" +"<literal>not-found</literal> (オプション - デフォルトは <literal>exception</" +"literal> ): 欠落した行を参照する外部キーをどのように扱うかを指定します。 " +"<literal>ignore</literal> は欠落した行をnull関連として扱います。" -#: index.docbook:1579, index.docbook:1733 -msgid "<literal>entity-name</literal> (optional): The entity name of the associated class." -msgstr "<literal>entity-name</literal> (オプション):関連クラスのエンティティ名" +#. Tag: para +#: basic_mapping.xml:1579 basic_mapping.xml:1733 +#, fuzzy, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): The entity name of the associated " +"class." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>entity-name</literal> (オプション):関連したクラスのエンティティ" +"名。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>entity-name</literal> (オプション):関連クラスのエンティティ名" -#: index.docbook:1585 -msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> foreign key." -msgstr "一対一関連には2種類あります：" +#. Tag: para +#: basic_mapping.xml:1585 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): an SQL expression that defines the " +"value for a <emphasis>computed</emphasis> foreign key." +msgstr "" +"<literal>formula</literal> (オプション): <emphasis> 計算された</emphasis> 外" +"部キーに対して値を定義するSQL式" -#: index.docbook:1592 -msgid "Setting a value of the <literal>cascade</literal> attribute to any meaningful value other than <literal>none</literal> will propagate certain operations to the associated object. The meaningful values are the names of Hibernate's basic operations, <literal>persist, merge, delete, save-update, evict, replicate, lock, refresh</literal>, as well as the special values <literal>delete-orphan</literal> and <literal>all</literal> and comma-separated combinations of operation names, for example, <literal>cascade=\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</literal>. See <xref linkend=\"objectstate-transitive\"/> for a full explanation. Note that single valued associations (many-to-one and one-to-one associations) do not support orphan delete." -msgstr "主キー関連" +#. Tag: para +#: basic_mapping.xml:1592 +#, no-c-format +msgid "" +"Setting a value of the <literal>cascade</literal> attribute to any " +"meaningful value other than <literal>none</literal> will propagate certain " +"operations to the associated object. The meaningful values are the names of " +"Hibernate's basic operations, <literal>persist, merge, delete, save-update, " +"evict, replicate, lock, refresh</literal>, as well as the special values " +"<literal>delete-orphan</literal> and <literal>all</literal> and comma-" +"separated combinations of operation names, for example, <literal>cascade=" +"\"persist,merge,evict\"</literal> or <literal>cascade=\"all,delete-orphan\"</" +"literal>. See <xref linkend=\"objectstate-transitive\"/> for a full " +"explanation. Note that single valued associations (many-to-one and one-to-" +"one associations) do not support orphan delete." +msgstr "" +"<literal>cascade</literal> 属性に <literal>none</literal> 以外の意味のある値" +"をを設定すると、 関連オブジェクトへある操作が伝播することになります。 意味の" +"ある値とはHibernateの基本操作の名前のことで、 <literal>delete-orphan</" +"literal> と <literal>all</literal> 、操作名をカンマで区切った組み合わせ （例" +"えば <literal>cascade=\"persist,merge,evict\"</literal> や <literal>cascade=" +"\"all,delete-orphan\"</literal>）、 またそれだけでなく <literal>persist, " +"merge, delete, save-update, evict, replicate, lock, refresh</literal> のこと" +"を指します。 詳しい説明は <xref linkend=\"objectstate-transitive\"/> を見てく" +"ださい。 値が一つの関連(many-to-oneとone-to-one関連)は、 単独での削除" +"（orphan delete)をサポートしていないことに注意してください。" -#: index.docbook:1605 -msgid "A typical <literal>many-to-one</literal> declaration looks as simple as this:" -msgstr "ユニーク外部キー関連" +#. Tag: para +#: basic_mapping.xml:1605 +#, no-c-format +msgid "" +"A typical <literal>many-to-one</literal> declaration looks as simple as this:" +msgstr "" +"典型的な <literal>many-to-one</literal> 宣言は次のようにシンプルです。：" -#: index.docbook:1609 -msgid "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/>]]>" -msgstr "主キー関連には、特別なテーブルカラムは必要ありません。 もし2つの行が関連により関係していれば、2つのテーブルは同じ主キーの値を共有します。 そのため2つのオブジェクトを主キー関連によって関連付けたいのであれば、 確実に同じ識別子の値を代入しなければなりません。" +#. Tag: programlisting +#: basic_mapping.xml:1609 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID" +"\"/>]]>" +msgstr "" -#: index.docbook:1611 -msgid "The <literal>property-ref</literal> attribute should only be used for mapping legacy data where a foreign key refers to a unique key of the associated table other than the primary key. This is an ugly relational model. For example, suppose the <literal>Product</literal> class had a unique serial number, that is not the primary key. (The <literal>unique</literal> attribute controls Hibernate's DDL generation with the SchemaExport tool.)" -msgstr "主キー関連を行うためには、以下のマッピングを <literal>Employee</literal> と <literal>Person</literal> のそれぞれに追加してください。" +#. Tag: para +#: basic_mapping.xml:1611 +#, no-c-format +msgid "" +"The <literal>property-ref</literal> attribute should only be used for " +"mapping legacy data where a foreign key refers to a unique key of the " +"associated table other than the primary key. This is an ugly relational " +"model. For example, suppose the <literal>Product</literal> class had a " +"unique serial number, that is not the primary key. (The <literal>unique</" +"literal> attribute controls Hibernate's DDL generation with the SchemaExport " +"tool.)" +msgstr "" +"<literal>property-ref</literal> 属性は、外部キーが関連付けられたテーブルの、" +"主キーでない ユニークキーを参照しているレガシーデータをマップするためにだけ使" +"うべきです。 これは醜いリレーショナルモデルです。 例えば <literal>Product</" +"literal> クラスが、 主キーでないユニークなシリアルナンバーを持っていると仮定" +"してみてください。 （ <literal>unique</literal> 属性はSchemaExportツールを" +"使ったHibernateのDDL生成を制御します。）" -#: index.docbook:1620 -msgid "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=\"SERIAL_NUMBER\"/>]]>" -msgstr "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1620 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" " +"column=\"SERIAL_NUMBER\"/>]]>" +msgstr "" -#: index.docbook:1622 +#. Tag: para +#: basic_mapping.xml:1622 +#, no-c-format msgid "Then the mapping for <literal>OrderItem</literal> might use:" -msgstr "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/>]]>" +msgstr "" +"以下のように <literal>OrderItem</literal> に対してマッピングを使えます：" -#: index.docbook:1626 -msgid "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=\"PRODUCT_SERIAL_NUMBER\"/>]]>" -msgstr "ここで、PERSONとEMPLOYEEテーブルの関係する行の主キーが同じであることを確実にしなければいけません。 ここでは、<literal>foreign</literal> という特殊なHibernate識別子生成戦略を使います：" +#. Tag: programlisting +#: basic_mapping.xml:1626 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=" +"\"PRODUCT_SERIAL_NUMBER\"/>]]>" +msgstr "" -#: index.docbook:1628 +#. Tag: para +#: basic_mapping.xml:1628 +#, no-c-format msgid "This is certainly not encouraged, however." +msgstr "しかし、これは決して推奨できません。" + +#. Tag: para +#: basic_mapping.xml:1632 +#, no-c-format +msgid "" +"If the referenced unique key comprises multiple properties of the associated " +"entity, you should map the referenced properties inside a named <literal>&lt;" +"properties&gt;</literal> element." msgstr "" - "<![CDATA[<class name=\"person\" table=\"PERSON\"> -\n" - " <id name=\"id\" column=\"PERSON_ID\"> -\n" - " <generator class=\"foreign\"> -\n" - " <param name=\"property\">employee</param> -\n" - " </generator> -\n" - " </id> -\n" - " ... -\n" - " <one-to-one name=\"employee\" -\n" - " class=\"Employee\" -\n" - " constrained=\"true\"/> -\n" - "</class>]]>" +"参照したユニークキーが、関連するエンティティの多数のプロパティから構成される" +"場合、 指定した <literal>&lt;properties&gt;</literal> 要素内で、参照するプロ" +"パティをマッピングするべきです。" -#: index.docbook:1632 -msgid "If the referenced unique key comprises multiple properties of the associated entity, you should map the referenced properties inside a named <literal>&lt;properties&gt;</literal> element." -msgstr "<literal>Employee</literal> インスタンスが、<literal>Person</literal> の <literal>employee</literal> プロパティで参照されるように、 新しくセーブされた <literal>Person</literal> のインスタンスには同じ主キーの値が代入されます。 新しくセーブする <literal>Person</literal> インスタンスは、 その <literal>Person</literal> の <literal>employee</literal> プロパティが参照する <literal>Employee</literal> インスタンスとして同じ主キーが割り当てられます。" +#. Tag: para +#: basic_mapping.xml:1637 +#, no-c-format +msgid "" +"If the referenced unique key is the property of a component, you may specify " +"a property path:" +msgstr "" +"もし参照したユニークキーがコンポーネントのプロパティである場合は、プロパティ" +"のパスを指定できます。" -#: index.docbook:1637 -msgid "If the referenced unique key is the property of a component, you may specify a property path:" -msgstr "もう1つの方法として、<literal>Employee</literal> から <literal>Person</literal> への ユニーク制約を使った外部キー関連は以下のように表現されます：" +#. Tag: programlisting +#: basic_mapping.xml:1641 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=" +"\"OWNER_SSN\"/>]]>" +msgstr "" -#: index.docbook:1641 -msgid "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=\"OWNER_SSN\"/>]]>" -msgstr "<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" unique=\"true\"/>]]>" - -#: index.docbook:1646 +#. Tag: title +#: basic_mapping.xml:1646 +#, no-c-format msgid "one-to-one" -msgstr "そしてこの関連は、 以下の記述を <literal>Person</literal> のマッピングに追加することで双方向にすることができます：" +msgstr "one-to-one" -#: index.docbook:1648 -msgid "A one-to-one association to another persistent class is declared using a <literal>one-to-one</literal> element." -msgstr "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=\"person\"/>]]>" +#. Tag: para +#: basic_mapping.xml:1648 +#, no-c-format +msgid "" +"A one-to-one association to another persistent class is declared using a " +"<literal>one-to-one</literal> element." +msgstr "" +"他の永続クラスへの一対一関連は、<literal>one-to-one</literal> 要素で定義しま" +"す。" -#: index.docbook:1666 +#. Tag: programlisting +#: basic_mapping.xml:1666 +#, no-c-format msgid "" - "<![CDATA[<one-to-one\n" - " name=\"propertyName\"\n" - " class=\"ClassName\"\n" - " cascade=\"cascade_style\"\n" - " constrained=\"true|false\"\n" - " fetch=\"join|select\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " access=\"field|property|ClassName\"\n" - " formula=\"any SQL expression\"\n" - " lazy=\"proxy|no-proxy|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; - " embed-xml=\"true|false\"\n" - " foreign-key=\"foreign_key_name\"\n" - "/>]]>" -msgstr "natural-id" +"<![CDATA[<one-to-one\n" +" name=\"propertyName\"\n" +" class=\"ClassName\"\n" +" cascade=\"cascade_style\"\n" +" constrained=\"true|false\"\n" +" fetch=\"join|select\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" access=\"field|property|ClassName\"\n" +" formula=\"any SQL expression\"\n" +" lazy=\"proxy|no-proxy|false\"\n" +" entity-name=\"EntityName\"\n" +" node=\&quot;element-name|@attribute-name|element/(a)attribute|.\&quot;\n&quot; +" embed-xml=\"true|false\"\n" +" foreign-key=\"foreign_key_name\"\n" +"/>]]>" +msgstr "" -#: index.docbook:1680 -msgid "<literal>cascade</literal> (optional) specifies which operations should be cascaded from the parent object to the associated object." -msgstr "エンティティの自然キープロパティの比較には、 <literal>equals()</literal> と <literal>hashCode()</literal> の実装を強くお勧めします。" +#. Tag: para +#: basic_mapping.xml:1680 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional) specifies which operations should be " +"cascaded from the parent object to the associated object." +msgstr "" +"<literal>cascade</literal>（オプション）： 親オブジェクトから関連オブジェクト" +"へ、どの操作をカスケードするかを指定します。" -#: index.docbook:1686 -msgid "<literal>constrained</literal> (optional) specifies that a foreign key constraint on the primary key of the mapped table references the table of the associated class. This option affects the order in which <literal>save()</literal> and <literal>delete()</literal> are cascaded, and determines whether the association may be proxied (it is also used by the schema export tool)." -msgstr "このマッピングは自然主キーを使ったエンティティでの使用を意図していません。" +#. Tag: para +#: basic_mapping.xml:1686 +#, no-c-format +msgid "" +"<literal>constrained</literal> (optional) specifies that a foreign key " +"constraint on the primary key of the mapped table references the table of " +"the associated class. This option affects the order in which <literal>save()" +"</literal> and <literal>delete()</literal> are cascaded, and determines " +"whether the association may be proxied (it is also used by the schema export " +"tool)." +msgstr "" +"<literal>constrained</literal>（オプション）： マッピングされたテーブルの主" +"キーに対する外部キー制約が、 関連クラスのテーブルを参照することを指定しま" +"す。 このオプションは <literal>save()</literal> と <literal>delete()</" +"literal> がカスケードされる順序に影響し、 そして関連がプロキシされるかどうか" +"にも影響します （そしてスキーマエクスポートツールにも使われます）。" -#: index.docbook:1701 -msgid "<literal>property-ref</literal>: (optional) The name of a property of the associated class that is joined to the primary key of this class. If not specified, the primary key of the associated class is used." -msgstr "component, dynamic-component" +#. Tag: para +#: basic_mapping.xml:1701 +#, no-c-format +msgid "" +"<literal>property-ref</literal>: (optional) The name of a property of the " +"associated class that is joined to the primary key of this class. If not " +"specified, the primary key of the associated class is used." +msgstr "" +"<literal>property-ref</literal>（オプション）： このクラスの主キーに結合され" +"た関連クラスのプロパティ名。 指定されなければ、関連クラスの主キーが使われま" +"す。" -#: index.docbook:1714 -msgid "<literal>formula</literal> (optional): Almost all one to one associations map to the primary key of the owning entity. In the rare case that this is not the case, you may specify a some other column, columns or expression to join on using an SQL formula. (See <literal>org.hibernate.test.onetooneformula</literal> for an example.)" +#. Tag: para +#: basic_mapping.xml:1714 +#, no-c-format +msgid "" +"<literal>formula</literal> (optional): Almost all one to one associations " +"map to the primary key of the owning entity. In the rare case that this is " +"not the case, you may specify a some other column, columns or expression to " +"join on using an SQL formula. (See <literal>org.hibernate.test." +"onetooneformula</literal> for an example.)" msgstr "" - "<![CDATA[<component -\n" - " name=\"propertyName\" -\n" - " class=\"className\" -\n" - " insert=\"true|false\" -\n" - " update=\"true|false\" -\n" - " access=\"field|property|ClassName\" -\n" - " lazy=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " unique=\"true|false\" -\n" - " node=\"element-name|.\" -\n" - "> -\n" - " -\n" - " <property ...../> -\n" - " <many-to-one .... /> -\n" - " ........ -\n" - "</component>]]>" +"<literal>formula</literal> (オプション): ほとんどすべての一対一関連はオーナー" +"のエンティティの主キーへとマッピングされます。 これ以外の稀な場合は、 他のカ" +"ラムや、複数のカラム、SQL構文を使った結合するための式を指定できます。 （例は " +"<literal>org.hibernate.test.onetooneformula</literal> を参照してください。）" -#: index.docbook:1722 -msgid "<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): By default, single point associations are proxied. <literal>lazy=\"no-proxy\"</literal> specifies that the property should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation). <literal>lazy=\"false\"</literal> specifies that the association will always be eagerly fetched. <emphasis>Note that if <literal>constrained=\"false\"</literal>, proxying is impossible and Hibernate will eager fetch the association!</emphasis>" -msgstr "<literal>name</literal>：プロパティ名。" +#. Tag: para +#: basic_mapping.xml:1722 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>proxy</literal>): " +"By default, single point associations are proxied. <literal>lazy=\"no-proxy" +"\"</literal> specifies that the property should be fetched lazily when the " +"instance variable is first accessed (requires build-time bytecode " +"instrumentation). <literal>lazy=\"false\"</literal> specifies that the " +"association will always be eagerly fetched. <emphasis>Note that if " +"<literal>constrained=\"false\"</literal>, proxying is impossible and " +"Hibernate will eager fetch the association!</emphasis>" +msgstr "" +"<literal>lazy</literal> (オプション - デフォルトは <literal>proxy</" +"literal> ): デフォルトでは、多重度１の関連がプロキシとなります。 " +"<literal>lazy=\"no-proxy\"</literal> は、インスタンス変数に最初にアクセスした" +"ときに、 プロパティを遅延フェッチするよう指定します (ビルド時にバイトコード実" +"装が必要になります)。 <literal>lazy=\"false\"</literal> は関連を常に即時に" +"フェッチするよう指定します。 <emphasis>もし <literal>constrained=\"false\"</" +"literal> ならば、 プロキシは使用不可能となり、関連を即時にフェッチすることに" +"注意してください！</emphasis>" -#: index.docbook:1740 +#. Tag: para +#: basic_mapping.xml:1740 +#, no-c-format msgid "There are two varieties of one-to-one association:" -msgstr "<literal>insert</literal> ：マッピングされたカラムがSQLの <literal>INSERT</literal> に現れるようにするどうかを指定します。" +msgstr "一対一関連には2種類あります：" -#: index.docbook:1744 +#. Tag: para +#: basic_mapping.xml:1744 +#, no-c-format msgid "primary key associations" -msgstr "<literal>update</literal> : マッピングされたカラムがSQL の <literal>UPDATE</literal> に現れるようにするかどうかを指定します。" +msgstr "主キー関連" -#: index.docbook:1747 +#. Tag: para +#: basic_mapping.xml:1747 +#, no-c-format msgid "unique foreign key associations" -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" +msgstr "ユニーク外部キー関連" -#: index.docbook:1752 -msgid "Primary key associations don't need an extra table column; if two rows are related by the association then the two table rows share the same primary key value. So if you want two objects to be related by a primary key association, you must make sure that they are assigned the same identifier value!" -msgstr "<literal>lazy</literal> (optional - デフォルトは <literal>false</literal> ): インスタンス変数に最初にアクセスしたときに、 コンポーネントを遅延してフェッチするよう指定します。 (バイトコード実装を作成する時間が必要になります)" +#. Tag: para +#: basic_mapping.xml:1752 +#, no-c-format +msgid "" +"Primary key associations don't need an extra table column; if two rows are " +"related by the association then the two table rows share the same primary " +"key value. So if you want two objects to be related by a primary key " +"association, you must make sure that they are assigned the same identifier " +"value!" +msgstr "" +"主キー関連には、特別なテーブルカラムは必要ありません。 もし2つの行が関連によ" +"り関係していれば、2つのテーブルは同じ主キーの値を共有します。 そのため2つのオ" +"ブジェクトを主キー関連によって関連付けたいのであれば、 確実に同じ識別子の値を" +"代入しなければなりません。" -#: index.docbook:1759 -msgid "For a primary key association, add the following mappings to <literal>Employee</literal> and <literal>Person</literal>, respectively." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に、楽観ロックの取得を要求するかどうかを指定します。 言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +#. Tag: para +#: basic_mapping.xml:1759 +#, no-c-format +msgid "" +"For a primary key association, add the following mappings to " +"<literal>Employee</literal> and <literal>Person</literal>, respectively." +msgstr "" +"主キー関連を行うためには、以下のマッピングを <literal>Employee</literal> と " +"<literal>Person</literal> のそれぞれに追加してください。" -#: index.docbook:1764 +#. Tag: programlisting +#: basic_mapping.xml:1764 +#, no-c-format msgid "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>" -msgstr "<literal>unique</literal> (オプション - デフォルトは <literal>false</literal> ): コンポーネントのすべてのマッピングするカラムに、ユニーク制約が存在するかを指定します。" +msgstr "" -#: index.docbook:1765 -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/>]]>" -msgstr "子の <literal>&lt;property&gt;</literal> タグで、 子のクラスのプロパティをテーブルカラムにマッピングします。" +#. Tag: programlisting +#: basic_mapping.xml:1765 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true" +"\"/>]]>" +msgstr "" -#: index.docbook:1767 -msgid "Now we must ensure that the primary keys of related rows in the PERSON and EMPLOYEE tables are equal. We use a special Hibernate identifier generation strategy called <literal>foreign</literal>:" -msgstr "<literal>&lt;component&gt;</literal> 要素は、親エンティティへ戻る参照として、 コンポーネントのクラスのプロパティをマッピングする <literal>&lt;parent&gt;</literal> サブ要素を許可します。" +#. Tag: para +#: basic_mapping.xml:1767 +#, no-c-format +msgid "" +"Now we must ensure that the primary keys of related rows in the PERSON and " +"EMPLOYEE tables are equal. We use a special Hibernate identifier generation " +"strategy called <literal>foreign</literal>:" +msgstr "" +"ここで、PERSONとEMPLOYEEテーブルの関係する行の主キーが同じであることを確実に" +"しなければいけません。 ここでは、<literal>foreign</literal> という特殊な" +"Hibernate識別子生成戦略を使います：" -#: index.docbook:1773 +#. Tag: programlisting +#: basic_mapping.xml:1773 +#, no-c-format msgid "" - "<![CDATA[<class name=\"person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"foreign\">\n" - " <param name=\"property\">employee</param>\n" - " </generator>\n" - " </id>\n" - " ...\n" - " <one-to-one name=\"employee\"\n" - " class=\"Employee\"\n" - " constrained=\"true\"/>\n" - "</class>]]>" -msgstr "<literal>&lt;dynamic-component&gt;</literal> 要素は、 <literal>Map</literal> がコンポーネントとしてマッピングされることを可能にします。 プロパティ名はmapのキーを参照します。<xref linkend=\"components-dynamic\"/> を参照してください。" +"<![CDATA[<class name=\"person\" table=\"PERSON\">\n" +" <id name=\"id\" column=\"PERSON_ID\">\n" +" <generator class=\"foreign\">\n" +" <param name=\"property\">employee</param>\n" +" </generator>\n" +" </id>\n" +" ...\n" +" <one-to-one name=\"employee\"\n" +" class=\"Employee\"\n" +" constrained=\"true\"/>\n" +"</class>]]>" +msgstr "" -#: index.docbook:1775 -msgid "A newly saved instance of <literal>Person</literal> is then assigned the same primary key value as the <literal>Employee</literal> instance refered with the <literal>employee</literal> property of that <literal>Person</literal>." -msgstr "properties" +#. Tag: para +#: basic_mapping.xml:1775 +#, no-c-format +msgid "" +"A newly saved instance of <literal>Person</literal> is then assigned the " +"same primary key value as the <literal>Employee</literal> instance refered " +"with the <literal>employee</literal> property of that <literal>Person</" +"literal>." +msgstr "" +"<literal>Employee</literal> インスタンスが、<literal>Person</literal> の " +"<literal>employee</literal> プロパティで参照されるように、 新しくセーブされ" +"た <literal>Person</literal> のインスタンスには同じ主キーの値が代入されま" +"す。 新しくセーブする <literal>Person</literal> インスタンスは、 その " +"<literal>Person</literal> の <literal>employee</literal> プロパティが参照す" +"る <literal>Employee</literal> インスタンスとして同じ主キーが割り当てられま" +"す。" -#: index.docbook:1781 -msgid "Alternatively, a foreign key with a unique constraint, from <literal>Employee</literal> to <literal>Person</literal>, may be expressed as:" -msgstr "<literal>&lt;properties&gt;</literal> 要素はクラスのプロパティの指定された、 論理的なグルーピングを可能にします。 この構造の最も重要な使用方法は、 <literal>property-ref</literal> のターゲットになるプロパティの結合を許可することです。 それはまた、複数カラムのユニーク制約を定義する簡単な方法でもあります。" +#. Tag: para +#: basic_mapping.xml:1781 +#, no-c-format +msgid "" +"Alternatively, a foreign key with a unique constraint, from " +"<literal>Employee</literal> to <literal>Person</literal>, may be expressed " +"as:" +msgstr "" +"もう1つの方法として、<literal>Employee</literal> から <literal>Person</" +"literal> への ユニーク制約を使った外部キー関連は以下のように表現されます：" -#: index.docbook:1786 -msgid "<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" unique=\"true\"/>]]>" +#. Tag: programlisting +#: basic_mapping.xml:1786 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"person\" class=\"Person\" column=\"PERSON_ID\" " +"unique=\"true\"/>]]>" msgstr "" - "<![CDATA[<properties -\n" - " name=\"logicalName\" -\n" - " insert=\"true|false\" -\n" - " update=\"true|false\" -\n" - " optimistic-lock=\"true|false\" -\n" - " unique=\"true|false\" -\n" - "> -\n" - " -\n" - " <property ...../> -\n" - " <many-to-one .... /> -\n" - " ........ -\n" - "</properties>]]>" -#: index.docbook:1788 -msgid "And this association may be made bidirectional by adding the following to the <literal>Person</literal> mapping:" -msgstr "<literal>name</literal> : グルーピングの論理名。 実際のプロパティ名では <emphasis>ありません</emphasis> 。" +#. Tag: para +#: basic_mapping.xml:1788 +#, no-c-format +msgid "" +"And this association may be made bidirectional by adding the following to " +"the <literal>Person</literal> mapping:" +msgstr "" +"そしてこの関連は、 以下の記述を <literal>Person</literal> のマッピングに追加" +"することで双方向にすることができます：" -#: index.docbook:1793 -msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=\"person\"/>]]>" -msgstr "<literal>insert</literal>：マッピングされたカラムがSQLの <literal>INSERT</literal> に現れるようにするかどうかを指定します。" +#. Tag: programlisting +#: basic_mapping.xml:1793 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=" +"\"person\"/>]]>" +msgstr "" -#: index.docbook:1798 +#. Tag: title +#: basic_mapping.xml:1798 +#, no-c-format msgid "natural-id" -msgstr "<literal>update</literal>：マッピングされたカラムがSQLの <literal>UPDATE</literal> に現れるようにするかどうかを指定します。" +msgstr "natural-id" -#: index.docbook:1800 +#. Tag: programlisting +#: basic_mapping.xml:1800 +#, no-c-format msgid "" - "<![CDATA[<natural-id mutable=\"true|false\"/>\n" - " <property ... />\n" - " <many-to-one ... />\n" - " ......\n" - "</natural-id>]]>" -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): これらのプロパティの更新に楽観的ロックの取得を要求するかどうかを指定します。 言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを決定します。" +"<![CDATA[<natural-id mutable=\"true|false\"/>\n" +" <property ... />\n" +" <many-to-one ... />\n" +" ......\n" +"</natural-id>]]>" +msgstr "" -#: index.docbook:1802 -msgid "Even though we recommend the use of surrogate keys as primary keys, you should still try to identify natural keys for all entities. A natural key is a property or combination of properties that is unique and non-null. If it is also immutable, even better. Map the properties of the natural key inside the <literal>&lt;natural-id&gt;</literal> element. Hibernate will generate the necessary unique key and nullability constraints, and your mapping will be more self-documenting." -msgstr "<literal>unique</literal> (オプション - デフォルトは <literal>false</literal> ): コンポーネントのすべてのマッピングするカラムに、ユニーク制約が存在するかを指定します。" +#. Tag: para +#: basic_mapping.xml:1802 +#, no-c-format +msgid "" +"Even though we recommend the use of surrogate keys as primary keys, you " +"should still try to identify natural keys for all entities. A natural key is " +"a property or combination of properties that is unique and non-null. If it " +"is also immutable, even better. Map the properties of the natural key inside " +"the <literal>&lt;natural-id&gt;</literal> element. Hibernate will generate " +"the necessary unique key and nullability constraints, and your mapping will " +"be more self-documenting." +msgstr "" +"主キーとして代理キーの使用を推奨しますが、 すべてのエンティティに対して自然" +"キーを識別するようにすべきです。 自然キーはユニークかつ非nullな一つのプロパ" +"ティ、またはプロパティの連結です。 不変であればさらに良いです。 <literal>&lt;" +"natural-id&gt;</literal> 要素内で自然キーのプロパティをマッピングします。 " +"Hibernateは必然的にユニークかつnull値を許可する制約を生成し、 こうしてマッピ" +"ングはより自己記述的になります。" -#: index.docbook:1811 -msgid "We strongly recommend that you implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the natural key properties of the entity." -msgstr "例えば、もし以下のような <literal>&lt;properties&gt;</literal> マッピングがあった場合：" +#. Tag: para +#: basic_mapping.xml:1811 +#, no-c-format +msgid "" +"We strongly recommend that you implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the natural key properties of the " +"entity." +msgstr "" +"エンティティの自然キープロパティの比較には、 <literal>equals()</literal> と " +"<literal>hashCode()</literal> の実装を強くお勧めします。" -#: index.docbook:1816 -msgid "This mapping is not intended for use with entities with natural primary keys." +#. Tag: para +#: basic_mapping.xml:1816 +#, no-c-format +msgid "" +"This mapping is not intended for use with entities with natural primary keys." msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"personNumber\"/> -\n" - " ... -\n" - " <properties name=\"name\" -\n" - " unique=\"true\" update=\"false\"> -\n" - " <property name=\"firstName\"/> -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"lastName\"/> -\n" - " </properties> -\n" - "</class>]]>" +"このマッピングは自然主キーを使ったエンティティでの使用を意図していません。" -#: index.docbook:1822 -msgid "<literal>mutable</literal> (optional, defaults to <literal>false</literal>): By default, natural identifier properties as assumed to be immutable (constant)." -msgstr "主キーの代わりに <literal>Person</literal> テーブルのユニークキーへの参照を持つ、 レガシーデータの関連を持つかもしれません。：" +#. Tag: para +#: basic_mapping.xml:1822 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional, defaults to <literal>false</literal>): " +"By default, natural identifier properties as assumed to be immutable " +"(constant)." +msgstr "" +"<literal>mutable</literal> (オプション, デフォルトは <literal>false</" +"literal> ): デフォルトでは、自然識別子プロパティは不変(定数)と想定されていま" +"す。" -#: index.docbook:1832 +#. Tag: title +#: basic_mapping.xml:1832 +#, no-c-format msgid "component, dynamic-component" +msgstr "component, dynamic-component" + +#. Tag: para +#: basic_mapping.xml:1834 +#, no-c-format +msgid "" +"The <literal>&lt;component&gt;</literal> element maps properties of a child " +"object to columns of the table of a parent class. Components may, in turn, " +"declare their own properties, components or collections. See \"Components\" " +"below." msgstr "" - "<![CDATA[<many-to-one name=\"person\" -\n" - " class=\"Person\" property-ref=\"name\"> -\n" - " <column name=\"firstName\"/> -\n" - " <column name=\"initial\"/> -\n" - " <column name=\"lastName\"/> -\n" - "</many-to-one>]]>" +"<literal>&lt;component&gt;</literal> 要素は、 子オブジェクトのプロパティを親" +"クラスのテーブルのカラムへマッピングします。 コンポーネントは自分のプロパ" +"ティ、コンポーネント、コレクションの順に定義できます。 以下の「コンポーネン" +"ト」を見てください。" -#: index.docbook:1834 -msgid "The <literal>&lt;component&gt;</literal> element maps properties of a child object to columns of the table of a parent class. Components may, in turn, declare their own properties, components or collections. See \"Components\" below." -msgstr "しかし、このようなレガシーデータマッピングのコンテキスト外への使用は推奨しません。" +#. Tag: programlisting +#: basic_mapping.xml:1852 +#, no-c-format +msgid "" +"<![CDATA[<component\n" +" name=\"propertyName\"\n" +" class=\"className\"\n" +" insert=\"true|false\"\n" +" update=\"true|false\"\n" +" access=\"field|property|ClassName\"\n" +" lazy=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" unique=\"true|false\"\n" +" node=\"element-name|.\"\n" +">\n" +"\n" +" <property ...../>\n" +" <many-to-one .... />\n" +" ........\n" +"</component>]]>" +msgstr "" -#: index.docbook:1852 +#. Tag: para +#: basic_mapping.xml:1860 +#, no-c-format msgid "" - "<![CDATA[<component\n" - " name=\"propertyName\"\n" - " class=\"className\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " access=\"field|property|ClassName\"\n" - " lazy=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name|.\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</component>]]>" -msgstr "subclass" +"<literal>class</literal> (optional - defaults to the property type " +"determined by reflection): The name of the component (child) class." +msgstr "" +"<literal>class</literal> （オプション - デフォルトはリフレクションにより決定" +"されるプロパティの型）： コンポーネント（子）クラスの名前。" -#: index.docbook:1860 -msgid "<literal>class</literal> (optional - defaults to the property type determined by reflection): The name of the component (child) class." +#. Tag: para +#: basic_mapping.xml:1866 basic_mapping.xml:1955 +#, fuzzy, no-c-format +msgid "" +"<literal>insert</literal>: Do the mapped columns appear in SQL " +"<literal>INSERT</literal>s?" msgstr "" - "<![CDATA[<subclass -\n" - " name=\"ClassName\" -\n" - " discriminator-value=\"discriminator_value\" -\n" - " proxy=\"ProxyInterface\" -\n" - " lazy=\"true|false\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\" -\n" - " extends=\"SuperclassName\"> -\n" - " -\n" - " <property .... /> -\n" - " ..... -\n" - "</subclass>]]>" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>insert</literal> ：マッピングされたカラムがSQLの <literal>INSERT</" +"literal> に現れるようにするどうかを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>insert</literal>：マッピングされたカラムがSQLの <literal>INSERT</" +"literal> に現れるようにするかどうかを指定します。" -#: index.docbook:1866, index.docbook:1955 -msgid "<literal>insert</literal>: Do the mapped columns appear in SQL <literal>INSERT</literal>s?" -msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" +#. Tag: para +#: basic_mapping.xml:1872 basic_mapping.xml:1961 +#, fuzzy, no-c-format +msgid "" +"<literal>update</literal>: Do the mapped columns appear in SQL " +"<literal>UPDATE</literal>s?" +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>update</literal> : マッピングされたカラムがSQL の <literal>UPDATE</" +"literal> に現れるようにするかどうかを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>update</literal>：マッピングされたカラムがSQLの <literal>UPDATE</" +"literal> に現れるようにするかどうかを指定します。" -#: index.docbook:1872, index.docbook:1961 -msgid "<literal>update</literal>: Do the mapped columns appear in SQL <literal>UPDATE</literal>s?" -msgstr "<literal>discriminator-value</literal>（オプション - デフォルトはクラス名）： 個々のサブクラスを区別するための値。" +#. Tag: para +#: basic_mapping.xml:1884 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that this component should be fetched lazily when the instance " +"variable is first accessed (requires build-time bytecode instrumentation)." +msgstr "" +"<literal>lazy</literal> (optional - デフォルトは <literal>false</literal> ): " +"インスタンス変数に最初にアクセスしたときに、 コンポーネントを遅延してフェッチ" +"するよう指定します。 (バイトコード実装を作成する時間が必要になります)" -#: index.docbook:1884 -msgid "<literal>lazy</literal> (optional - defaults to <literal>false</literal>): Specifies that this component should be fetched lazily when the instance variable is first accessed (requires build-time bytecode instrumentation)." -msgstr "<literal>lazy</literal>（オプション, デフォルトは <literal>true</literal> ）： <literal>lazy=\"false\"</literal> と設定すると、遅延フェッチが使用できません。" +#. Tag: para +#: basic_mapping.xml:1891 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this component do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に、楽観ロックの取得を要求するかどうかを指定" +"します。 言い換えれば、このプロパティがダーティであるときにバージョンを増やす" +"べきかを決定します。" -#: index.docbook:1891 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this component do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when this property is dirty." -msgstr "各サブクラスでは、永続プロパティとサブクラスを定義します。 <literal>&lt;version&gt;</literal> と <literal>&lt;id&gt;</literal> プロパティは、 ルートクラスから継承されると仮定されます。 階層構造におけるサブクラスは、 ユニークな <literal>discriminator-value</literal> を定義しなければなりません。 noneが指定されると、完全修飾されたJavaクラス名が使われます。" +#. Tag: para +#: basic_mapping.xml:1899 basic_mapping.xml:1975 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional - defaults to <literal>false</literal>): " +"Specifies that a unique constraint exists upon all mapped columns of the " +"component." +msgstr "" +"<literal>unique</literal> (オプション - デフォルトは <literal>false</" +"literal> ): コンポーネントのすべてのマッピングするカラムに、ユニーク制約が存" +"在するかを指定します。" -#: index.docbook:1899, index.docbook:1975 -msgid "<literal>unique</literal> (optional - defaults to <literal>false</literal>): Specifies that a unique constraint exists upon all mapped columns of the component." -msgstr "継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てください。" +#. Tag: para +#: basic_mapping.xml:1908 +#, no-c-format +msgid "" +"The child <literal>&lt;property&gt;</literal> tags map properties of the " +"child class to table columns." +msgstr "" +"子の <literal>&lt;property&gt;</literal> タグで、 子のクラスのプロパティを" +"テーブルカラムにマッピングします。" -#: index.docbook:1908 -msgid "The child <literal>&lt;property&gt;</literal> tags map properties of the child class to table columns." -msgstr "joined-subclass" +#. Tag: para +#: basic_mapping.xml:1913 +#, no-c-format +msgid "" +"The <literal>&lt;component&gt;</literal> element allows a <literal>&lt;" +"parent&gt;</literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." +msgstr "" +"<literal>&lt;component&gt;</literal> 要素は、親エンティティへ戻る参照とし" +"て、 コンポーネントのクラスのプロパティをマッピングする <literal>&lt;" +"parent&gt;</literal> サブ要素を許可します。" -#: index.docbook:1913 -msgid "The <literal>&lt;component&gt;</literal> element allows a <literal>&lt;parent&gt;</literal> subelement that maps a property of the component class as a reference back to the containing entity." -msgstr "もう1つの方法として、各サブクラスを自身のテーブルへマッピングすることができます (table-per-subclass mapping strategy)。 継承した状態はスーパークラスのテーブルを使った結合で検索します。 <literal>&lt;joined-subclass&gt;</literal> 要素を使用します。" - -#: index.docbook:1919 -msgid "The <literal>&lt;dynamic-component&gt;</literal> element allows a <literal>Map</literal> to be mapped as a component, where the property names refer to keys of the map, see <xref linkend=\"components-dynamic\"/>." +#. Tag: para +#: basic_mapping.xml:1919 +#, no-c-format +msgid "" +"The <literal>&lt;dynamic-component&gt;</literal> element allows a " +"<literal>Map</literal> to be mapped as a component, where the property names " +"refer to keys of the map, see <xref linkend=\"components-dynamic\"/>." msgstr "" - "<![CDATA[<joined-subclass -\n" - " name=\"ClassName\" -\n" - " table=\"tablename\" -\n" - " proxy=\"ProxyInterface\" -\n" - " lazy=\"true|false\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " schema=\"schema\" -\n" - " catalog=\"catalog\" -\n" - " extends=\"SuperclassName\" -\n" - " persister=\"ClassName\" -\n" - " subselect=\"SQL expression\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\"> -\n" - " -\n" - " <key .... > -\n" - " -\n" - " <property .... /> -\n" - " ..... -\n" - "</joined-subclass>]]>" +"<literal>&lt;dynamic-component&gt;</literal> 要素は、 <literal>Map</literal> " +"がコンポーネントとしてマッピングされることを可能にします。 プロパティ名はmap" +"のキーを参照します。<xref linkend=\"components-dynamic\"/> を参照してくださ" +"い。" -#: index.docbook:1928 +#. Tag: title +#: basic_mapping.xml:1928 +#, no-c-format msgid "properties" -msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" +msgstr "properties" -#: index.docbook:1930 -msgid "The <literal>&lt;properties&gt;</literal> element allows the definition of a named, logical grouping of properties of a class. The most important use of the construct is that it allows a combination of properties to be the target of a <literal>property-ref</literal>. It is also a convenient way to define a multi-column unique constraint." -msgstr "<literal>table</literal> :サブクラステーブルの名前。" +#. Tag: para +#: basic_mapping.xml:1930 +#, no-c-format +msgid "" +"The <literal>&lt;properties&gt;</literal> element allows the definition of a " +"named, logical grouping of properties of a class. The most important use of " +"the construct is that it allows a combination of properties to be the target " +"of a <literal>property-ref</literal>. It is also a convenient way to define " +"a multi-column unique constraint." +msgstr "" +"<literal>&lt;properties&gt;</literal> 要素はクラスのプロパティの指定された、 " +"論理的なグルーピングを可能にします。 この構造の最も重要な使用方法は、 " +"<literal>property-ref</literal> のターゲットになるプロパティの結合を許可する" +"ことです。 それはまた、複数カラムのユニーク制約を定義する簡単な方法でもありま" +"す。" -#: index.docbook:1946 +#. Tag: programlisting +#: basic_mapping.xml:1946 +#, no-c-format msgid "" - "<![CDATA[<properties\n" - " name=\"logicalName\"\n" - " insert=\"true|false\"\n" - " update=\"true|false\"\n" - " optimistic-lock=\"true|false\"\n" - " unique=\"true|false\"\n" - ">\n" - "\n" - " <property ...../>\n" - " <many-to-one .... />\n" - " ........\n" - "</properties>]]>" -msgstr "<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやインターフェイスを指定します。" +"<![CDATA[<properties\n" +" name=\"logicalName\"\n" +" insert=\"true|false\"\n" +" update=\"true|false\"\n" +" optimistic-lock=\"true|false\"\n" +" unique=\"true|false\"\n" +">\n" +"\n" +" <property ...../>\n" +" <many-to-one .... />\n" +" ........\n" +"</properties>]]>" +msgstr "" -#: index.docbook:1949 -msgid "<literal>name</literal>: The logical name of the grouping - <emphasis>not</emphasis> an actual property name." -msgstr "<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): <literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。" +#. Tag: para +#: basic_mapping.xml:1949 +#, no-c-format +msgid "" +"<literal>name</literal>: The logical name of the grouping - <emphasis>not</" +"emphasis> an actual property name." +msgstr "" +"<literal>name</literal> : グルーピングの論理名。 実際のプロパティ名では " +"<emphasis>ありません</emphasis> 。" -#: index.docbook:1967 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to these properties do or do not require acquisition of the optimistic lock. In other words, determines if a version increment should occur when these properties are dirty." -msgstr "継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てください。" +#. Tag: para +#: basic_mapping.xml:1967 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to these properties do or do not require " +"acquisition of the optimistic lock. In other words, determines if a version " +"increment should occur when these properties are dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): これらのプロパティの更新に楽観的ロックの取得を要求するかどうかを" +"指定します。 言い換えれば、このプロパティがダーティであるときにバージョンを増" +"やすべきかを決定します。" -#: index.docbook:1984 -msgid "For example, if we have the following <literal>&lt;properties&gt;</literal> mapping:" -msgstr "3つ目の選択肢は、継承階層の具象クラスのみをテーブルにマッピングすることです (the table-per-concrete-class戦略)。 それぞれのテーブルは継承の状態を含めすべてのクラスの永続状態を定義します。 Hibernateではその様な継承階層が必ずしも必要ではありません。 単純にそれぞれのクラスを、 別々の <literal>&lt;class&gt;</literal> 宣言を使ってマッピングすることができます。 しかしポリモーフィックな関連(例えば 階層のスーパークラスへの関連)を使いたいなら、 <literal>&lt;union-subclass&gt;</literal> マッピングを使う必要があります。" +#. Tag: para +#: basic_mapping.xml:1984 +#, no-c-format +msgid "" +"For example, if we have the following <literal>&lt;properties&gt;</literal> " +"mapping:" +msgstr "" +"例えば、もし以下のような <literal>&lt;properties&gt;</literal> マッピングが" +"あった場合：" -#: index.docbook:1988 +#. Tag: programlisting +#: basic_mapping.xml:1988 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"personNumber\"/>\n" - " ...\n" - " <properties name=\"name\"\n" - " unique=\"true\" update=\"false\">\n" - " <property name=\"firstName\"/>\n" - " <property name=\"initial\"/>\n" - " <property name=\"lastName\"/>\n" - " </properties>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"personNumber\"/>\n" +" ...\n" +" <properties name=\"name\"\n" +" unique=\"true\" update=\"false\">\n" +" <property name=\"firstName\"/>\n" +" <property name=\"initial\"/>\n" +" <property name=\"lastName\"/>\n" +" </properties>\n" +"</class>]]>" msgstr "" - "<![CDATA[<union-subclass -\n" - " name=\"ClassName\" -\n" - " table=\"tablename\" -\n" - " proxy=\"ProxyInterface\" -\n" - " lazy=\"true|false\" -\n" - " dynamic-update=\"true|false\" -\n" - " dynamic-insert=\"true|false\" -\n" - " schema=\"schema\" -\n" - " catalog=\"catalog\" -\n" - " extends=\"SuperclassName\" -\n" - " abstract=\"true|false\" -\n" - " persister=\"ClassName\" -\n" - " subselect=\"SQL expression\" -\n" - " entity-name=\"EntityName\" -\n" - " node=\"element-name\"> -\n" - " -\n" - " <property .... /> -\n" - " ..... -\n" - "</union-subclass>]]>" -#: index.docbook:1990 -msgid "Then we might have some legacy data association which refers to this unique key of the <literal>Person</literal> table, instead of to the primary key:" -msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" +#. Tag: para +#: basic_mapping.xml:1990 +#, no-c-format +msgid "" +"Then we might have some legacy data association which refers to this unique " +"key of the <literal>Person</literal> table, instead of to the primary key:" +msgstr "" +"主キーの代わりに <literal>Person</literal> テーブルのユニークキーへの参照を持" +"つ、 レガシーデータの関連を持つかもしれません。：" -#: index.docbook:1995 +#. Tag: programlisting +#: basic_mapping.xml:1995 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"person\"\n" - " class=\"Person\" property-ref=\"name\">\n" - " <column name=\"firstName\"/>\n" - " <column name=\"initial\"/>\n" - " <column name=\"lastName\"/>\n" - "</many-to-one>]]>" -msgstr "<literal>table</literal> :サブクラステーブルの名前。" +"<![CDATA[<many-to-one name=\"person\"\n" +" class=\"Person\" property-ref=\"name\">\n" +" <column name=\"firstName\"/>\n" +" <column name=\"initial\"/>\n" +" <column name=\"lastName\"/>\n" +"</many-to-one>]]>" +msgstr "" -#: index.docbook:1997 -msgid "We don't recommend the use of this kind of thing outside the context of mapping legacy data." -msgstr "<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやインターフェイスを指定します。" +#. Tag: para +#: basic_mapping.xml:1997 +#, no-c-format +msgid "" +"We don't recommend the use of this kind of thing outside the context of " +"mapping legacy data." +msgstr "" +"しかし、このようなレガシーデータマッピングのコンテキスト外への使用は推奨しま" +"せん。" -#: index.docbook:2005 +#. Tag: title +#: basic_mapping.xml:2005 +#, no-c-format msgid "subclass" -msgstr "<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): <literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。" +msgstr "subclass" -#: index.docbook:2007 -msgid "Finally, polymorphic persistence requires the declaration of each subclass of the root persistent class. For the table-per-class-hierarchy mapping strategy, the <literal>&lt;subclass&gt;</literal> declaration is used." -msgstr "このマッピング戦略では識別カラムやキーカラムは必要ありません。" +#. Tag: para +#: basic_mapping.xml:2007 +#, no-c-format +msgid "" +"Finally, polymorphic persistence requires the declaration of each subclass " +"of the root persistent class. For the table-per-class-hierarchy mapping " +"strategy, the <literal>&lt;subclass&gt;</literal> declaration is used." +msgstr "" +"最後にポリモーフィックな永続化には、ルートの永続クラスの各サブクラスの定義が" +"必要です。 table-per-class-hierarchyマッピング戦略では、 <literal>&lt;" +"subclass&gt;</literal> 定義が使われます。" -#: index.docbook:2020 +#. Tag: programlisting +#: basic_mapping.xml:2020 +#, no-c-format msgid "" - "<![CDATA[<subclass\n" - " name=\"ClassName\"\n" - " discriminator-value=\"discriminator_value\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " extends=\"SuperclassName\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</subclass>]]>" -msgstr "継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てください。" +"<![CDATA[<subclass\n" +" name=\"ClassName\"\n" +" discriminator-value=\"discriminator_value\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\"\n" +" extends=\"SuperclassName\">\n" +"\n" +" <property .... />\n" +" .....\n" +"</subclass>]]>" +msgstr "" -#: index.docbook:2023, index.docbook:2081, index.docbook:2144 -msgid "<literal>name</literal>: The fully qualified class name of the subclass." -msgstr "join" +#. Tag: para +#: basic_mapping.xml:2023 basic_mapping.xml:2081 basic_mapping.xml:2144 +#, no-c-format +msgid "" +"<literal>name</literal>: The fully qualified class name of the subclass." +msgstr "<literal>name</literal>：サブクラスの完全修飾されたクラス名。" -#: index.docbook:2028 -msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): A value that distiguishes individual subclasses." -msgstr "<literal>&lt;join&gt;</literal> 要素を使うことで、 １つのクラスのプロパティをいくつものテーブルにマッピングすることができます。" +#. Tag: para +#: basic_mapping.xml:2028 +#, no-c-format +msgid "" +"<literal>discriminator-value</literal> (optional - defaults to the class " +"name): A value that distiguishes individual subclasses." +msgstr "" +"<literal>discriminator-value</literal>（オプション - デフォルトはクラス" +"名）： 個々のサブクラスを区別するための値。" -#: index.docbook:2034, index.docbook:2091, index.docbook:2154 -msgid "<literal>proxy</literal> (optional): Specifies a class or interface to use for lazy initializing proxies." +#. Tag: para +#: basic_mapping.xml:2034 basic_mapping.xml:2091 basic_mapping.xml:2154 +#, fuzzy, no-c-format +msgid "" +"<literal>proxy</literal> (optional): Specifies a class or interface to use " +"for lazy initializing proxies." msgstr "" - "<![CDATA[<join -\n" - " table=\"tablename\" -\n" - " schema=\"owner\" -\n" - " catalog=\"catalog\" -\n" - " fetch=\"join|select\" -\n" - " inverse=\"true|false\" -\n" - " optional=\"true|false\"> -\n" - " -\n" - " <key ... /> -\n" - " -\n" - " <property ... /> -\n" - " ... -\n" - "</join>]]>" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal>（オプション）： 遅延初期化プロキシに使うクラスやイン" +"ターフェイスを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやイ" +"ンターフェイスを指定します。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>proxy</literal> (オプション): 遅延初期化プロキシに使用するクラスやイ" +"ンターフェイスを指定します。" -#: index.docbook:2040, index.docbook:2097, index.docbook:2160 -msgid "<literal>lazy</literal> (optional, defaults to <literal>true</literal>): Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." -msgstr "<literal>table</literal> :結合したテーブルの名前" +#. Tag: para +#: basic_mapping.xml:2040 basic_mapping.xml:2097 basic_mapping.xml:2160 +#, fuzzy, no-c-format +msgid "" +"<literal>lazy</literal> (optional, defaults to <literal>true</literal>): " +"Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching." +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal>（オプション, デフォルトは <literal>true</" +"literal> ）： <literal>lazy=\"false\"</literal> と設定すると、遅延フェッチが" +"使用できません。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): " +"<literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"<literal>lazy</literal> (オプション, デフォルトは <literal>true</literal> ): " +"<literal>lazy=\"false\"</literal> とすると、遅延フェッチが使用できません。" -#: index.docbook:2048 -msgid "Each subclass should declare its own persistent properties and subclasses. <literal>&lt;version&gt;</literal> and <literal>&lt;id&gt;</literal> properties are assumed to be inherited from the root class. Each subclass in a heirarchy must define a unique <literal>discriminator-value</literal>. If none is specified, the fully qualified Java class name is used." -msgstr "<literal>schema</literal> (オプション): ルートの <literal>&lt;hibernate-mapping&gt;</literal> 要素で指定したスキーマ名を オーバーライドします。" +#. Tag: para +#: basic_mapping.xml:2048 +#, no-c-format +msgid "" +"Each subclass should declare its own persistent properties and subclasses. " +"<literal>&lt;version&gt;</literal> and <literal>&lt;id&gt;</literal> " +"properties are assumed to be inherited from the root class. Each subclass in " +"a heirarchy must define a unique <literal>discriminator-value</literal>. If " +"none is specified, the fully qualified Java class name is used." +msgstr "" +"各サブクラスでは、永続プロパティとサブクラスを定義します。 <literal>&lt;" +"version&gt;</literal> と <literal>&lt;id&gt;</literal> プロパティは、 ルート" +"クラスから継承されると仮定されます。 階層構造におけるサブクラスは、 ユニーク" +"な <literal>discriminator-value</literal> を定義しなければなりません。 noneが" +"指定されると、完全修飾されたJavaクラス名が使われます。" -#: index.docbook:2056, index.docbook:2114, index.docbook:2172 -msgid "For information about inheritance mappings, see <xref linkend=\"inheritance\"/>." -msgstr "<literal>catalog</literal> (オプション): ルートの <literal>&lt;hibernate-mapping&gt;</literal> 要素で指定したカタログ名を オーバーライドします。" +#. Tag: para +#: basic_mapping.xml:2056 basic_mapping.xml:2114 basic_mapping.xml:2172 +#, no-c-format +msgid "" +"For information about inheritance mappings, see <xref linkend=\"inheritance" +"\"/>." +msgstr "" +"継承のマッピングに関する情報は <xref linkend=\"inheritance\"/> を見てくださ" +"い。" -#: index.docbook:2063 +#. Tag: title +#: basic_mapping.xml:2063 +#, no-c-format msgid "joined-subclass" -msgstr "<literal>fetch</literal> (オプション - デフォルトは <literal>join</literal> ): <literal>join</literal> を設定した場合、 Hibernateはデフォルトで、クラスやスーパークラスで定義された <literal>&lt;join&gt;</literal> を検索するのに内部結合を使い、サブクラスで定義された <literal>&lt;join&gt;</literal> を検索するのに外部結合を使います。 <literal>select</literal> を設定した場合には、 Hibernateはサブクラスで定義された <literal>&lt;join&gt;</literal> の選択に順次選択を使います。この場合、 行がサブクラスのインスタンスを代表することがわかった場合にのみ発行されます。 内部結合はクラスやそのスーパークラスで定義された <literal>&lt;join&gt;</literal> を検索 するために使用します。" +msgstr "joined-subclass" -#: index.docbook:2065 -msgid "Alternatively, each subclass may be mapped to its own table (table-per-subclass mapping strategy). Inherited state is retrieved by joining with the table of the superclass. We use the <literal>&lt;joined-subclass&gt;</literal> element." -msgstr "<literal>inverse</literal> (オプション - デフォルトは <literal>false</literal> ): もし可能であれば、Hibernateはこの結合で定義されているプロパティに対し 挿入や更新を行いません。" +#. Tag: para +#: basic_mapping.xml:2065 +#, no-c-format +msgid "" +"Alternatively, each subclass may be mapped to its own table (table-per-" +"subclass mapping strategy). Inherited state is retrieved by joining with the " +"table of the superclass. We use the <literal>&lt;joined-subclass&gt;</" +"literal> element." +msgstr "" +"もう1つの方法として、各サブクラスを自身のテーブルへマッピングすることができま" +"す (table-per-subclass mapping strategy)。 継承した状態はスーパークラスのテー" +"ブルを使った結合で検索します。 <literal>&lt;joined-subclass&gt;</literal> 要" +"素を使用します。" -#: index.docbook:2078 +#. Tag: programlisting +#: basic_mapping.xml:2078 +#, no-c-format msgid "" - "<![CDATA[<joined-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <key .... >\n" - "\n" - " <property .... />\n" - " .....\n" - "</joined-subclass>]]>" -msgstr "<literal>optional</literal> (オプション - デフォルトは <literal>false</literal> ): もし可能であれば、Hibernateはこの結合で定義されたプロパティがnullでない場合にのみ 行を挿入し、そのプロパティの検索には常に外部結合を使用します。" +"<![CDATA[<joined-subclass\n" +" name=\"ClassName\"\n" +" table=\"tablename\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" schema=\"schema\"\n" +" catalog=\"catalog\"\n" +" extends=\"SuperclassName\"\n" +" persister=\"ClassName\"\n" +" subselect=\"SQL expression\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\">\n" +"\n" +" <key .... >\n" +"\n" +" <property .... />\n" +" .....\n" +"</joined-subclass>]]>" +msgstr "" -#: index.docbook:2086, index.docbook:2149 +#. Tag: para +#: basic_mapping.xml:2086 basic_mapping.xml:2149 +#, no-c-format msgid "<literal>table</literal>: The name of the subclass table." +msgstr "<literal>table</literal> :サブクラステーブルの名前。" + +#. Tag: para +#: basic_mapping.xml:2105 +#, no-c-format +msgid "" +"No discriminator column is required for this mapping strategy. Each subclass " +"must, however, declare a table column holding the object identifier using " +"the <literal>&lt;key&gt;</literal> element. The mapping at the start of the " +"chapter would be re-written as:" msgstr "" - "<![CDATA[<class name=\"Person\" -\n" - " table=\"PERSON\"> -\n" - " -\n" - " <id name=\"id\" column=\"PERSON_ID\">...</id> -\n" - " -\n" - " <join table=\"ADDRESS\"> -\n" - " <key column=\"ADDRESS_ID\"/> -\n" - " <property name=\"address\"/> -\n" - " <property name=\"zip\"/> -\n" - " <property name=\"country\"/> -\n" - " </join> -\n" - " ...]]>" +"このマッピング戦略には、識別カラムは必要ありません。 しかし各サブクラスは " +"<literal>&lt;key&gt;</literal> 要素を使い、 オブジェクト識別子を保持するテー" +"ブルカラムを定義しなければなりません。 この章の初めのマッピングは以下のように" +"書き直せます：" -#: index.docbook:2105 -msgid "No discriminator column is required for this mapping strategy. Each subclass must, however, declare a table column holding the object identifier using the <literal>&lt;key&gt;</literal> element. The mapping at the start of the chapter would be re-written as:" -msgstr "今まで何度か <literal>&lt;key&gt;</literal> 要素が出てきました。 この要素は新しいテーブルへの結合を定義したり、 結合テーブルで外部キーを定義したりする親要素のどこにでも現れ、 オリジナルテーブルの主キーを参照します。" - -#: index.docbook:2112 +#. Tag: programlisting +#: basic_mapping.xml:2112 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class name=\"Cat\" table=\"CATS\">\n" - " <id name=\"id\" column=\"uid\" type=\"long\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - " <property name=\"birthdate\" type=\"date\"/>\n" - " <property name=\"color\" not-null=\"true\"/>\n" - " <property name=\"sex\" not-null=\"true\"/>\n" - " <property name=\"weight\"/>\n" - " <many-to-one name=\"mate\"/>\n" - " <set name=\"kittens\">\n" - " <key column=\"MOTHER\"/>\n" - " <one-to-many class=\"Cat\"/>\n" - " </set>\n" - " <joined-subclass name=\"DomesticCat\" table=\"DOMESTIC_CATS\">\n" - " <key column=\"CAT\"/>\n" - " <property name=\"name\" type=\"string\"/>\n" - " </joined-subclass>\n" - " </class>\n" - "\n" - " <class name=\"eg.Dog\">\n" - " <!-- mapping for Dog could go here -->\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class name=\"Cat\" table=\"CATS\">\n" +" <id name=\"id\" column=\"uid\" type=\"long\">\n" +" <generator class=\"hilo\"/>\n" +" </id>\n" +" <property name=\"birthdate\" type=\"date\"/>\n" +" <property name=\"color\" not-null=\"true\"/>\n" +" <property name=\"sex\" not-null=\"true\"/>\n" +" <property name=\"weight\"/>\n" +" <many-to-one name=\"mate\"/>\n" +" <set name=\"kittens\">\n" +" <key column=\"MOTHER\"/>\n" +" <one-to-many class=\"Cat\"/>\n" +" </set>\n" +" <joined-subclass name=\"DomesticCat\" table=\"DOMESTIC_CATS" +"\">\n" +" <key column=\"CAT\"/>\n" +" <property name=\"name\" type=\"string\"/>\n" +" </joined-subclass>\n" +" </class>\n" +"\n" +" <class name=\"eg.Dog\">\n" +" <!-- mapping for Dog could go here -->\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<key -\n" - " column=\"columnname\" -\n" - " on-delete=\"noaction|cascade\" -\n" - " property-ref=\"propertyName\" -\n" - " not-null=\"true|false\" -\n" - " update=\"true|false\" -\n" - " unique=\"true|false\" -\n" - "/>]]>" -#: index.docbook:2121 +#. Tag: title +#: basic_mapping.xml:2121 +#, no-c-format msgid "union-subclass" -msgstr "<literal>on-delete</literal> (オプション, デフォルトは <literal>noaction</literal>): 外部キー制約がデータベースレベルでカスケード削除が可能かどうかを指定します。" +msgstr "union-subclass" -#: index.docbook:2123 -msgid "A third option is to map only the concrete classes of an inheritance hierarchy to tables, (the table-per-concrete-class strategy) where each table defines all persistent state of the class, including inherited state. In Hibernate, it is not absolutely necessary to explicitly map such inheritance hierarchies. You can simply map each class with a separate <literal>&lt;class&gt;</literal> declaration. However, if you wish use polymorphic associations (e.g. an association to the superclass of your hierarchy), you need to use the <literal>&lt;union-subclass&gt;</literal> mapping." -msgstr "<literal>property-ref</literal> (オプション): オリジナルテーブルの主キーではないカラムを参照する外部キーを指定します (レガシーデータに対して提供されます)。" +#. Tag: para +#: basic_mapping.xml:2123 +#, no-c-format +msgid "" +"A third option is to map only the concrete classes of an inheritance " +"hierarchy to tables, (the table-per-concrete-class strategy) where each " +"table defines all persistent state of the class, including inherited state. " +"In Hibernate, it is not absolutely necessary to explicitly map such " +"inheritance hierarchies. You can simply map each class with a separate " +"<literal>&lt;class&gt;</literal> declaration. However, if you wish use " +"polymorphic associations (e.g. an association to the superclass of your " +"hierarchy), you need to use the <literal>&lt;union-subclass&gt;</literal> " +"mapping." +msgstr "" +"3つ目の選択肢は、継承階層の具象クラスのみをテーブルにマッピングすることです " +"(the table-per-concrete-class戦略)。 それぞれのテーブルは継承の状態を含めすべ" +"てのクラスの永続状態を定義します。 Hibernateではその様な継承階層が必ずしも必" +"要ではありません。 単純にそれぞれのクラスを、 別々の <literal>&lt;class&gt;</" +"literal> 宣言を使ってマッピングすることができます。 しかしポリモーフィックな" +"関連(例えば 階層のスーパークラスへの関連)を使いたいなら、 <literal>&lt;union-" +"subclass&gt;</literal> マッピングを使う必要があります。" -#: index.docbook:2141 +#. Tag: programlisting +#: basic_mapping.xml:2141 +#, no-c-format msgid "" - "<![CDATA[<union-subclass\n" - " name=\"ClassName\"\n" - " table=\"tablename\"\n" - " proxy=\"ProxyInterface\"\n" - " lazy=\"true|false\"\n" - " dynamic-update=\"true|false\"\n" - " dynamic-insert=\"true|false\"\n" - " schema=\"schema\"\n" - " catalog=\"catalog\"\n" - " extends=\"SuperclassName\"\n" - " abstract=\"true|false\"\n" - " persister=\"ClassName\"\n" - " subselect=\"SQL expression\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\">\n" - "\n" - " <property .... />\n" - " .....\n" - "</union-subclass>]]>" -msgstr "<literal>not-null</literal> (オプション): 外部キーカラムがnull値を許容しないことを指定します (このことは外部キーが主キーの一部であることを暗黙的に示します)。" +"<![CDATA[<union-subclass\n" +" name=\"ClassName\"\n" +" table=\"tablename\"\n" +" proxy=\"ProxyInterface\"\n" +" lazy=\"true|false\"\n" +" dynamic-update=\"true|false\"\n" +" dynamic-insert=\"true|false\"\n" +" schema=\"schema\"\n" +" catalog=\"catalog\"\n" +" extends=\"SuperclassName\"\n" +" abstract=\"true|false\"\n" +" persister=\"ClassName\"\n" +" subselect=\"SQL expression\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\">\n" +"\n" +" <property .... />\n" +" .....\n" +"</union-subclass>]]>" +msgstr "" -#: index.docbook:2168 -msgid "No discriminator column or key column is required for this mapping strategy." -msgstr "column と formula 要素" +#. Tag: para +#: basic_mapping.xml:2168 +#, no-c-format +msgid "" +"No discriminator column or key column is required for this mapping strategy." +msgstr "このマッピング戦略では識別カラムやキーカラムは必要ありません。" -#: index.docbook:2179 +#. Tag: title +#: basic_mapping.xml:2179 +#, no-c-format msgid "join" +msgstr "join" + +#. Tag: para +#: basic_mapping.xml:2181 +#, no-c-format +msgid "" +"Using the <literal>&lt;join&gt;</literal> element, it is possible to map " +"properties of one class to several tables, when there's a 1-to-1 " +"relationship between the tables." msgstr "" - "<![CDATA[<column -\n" - " name=\"column_name\" -\n" - " length=\"N\" -\n" - " precision=\"N\" -\n" - " scale=\"N\" -\n" - " not-null=\"true|false\" -\n" - " unique=\"true|false\" -\n" - " unique-key=\"multicolumn_unique_key_name\" -\n" - " index=\"index_name\" -\n" - " sql-type=\"sql_type_name\" -\n" - " check=\"SQL expression\" -\n" - " default=\"SQL expression\"/>]]>" +"<literal>&lt;join&gt;</literal> 要素を使うことで、 １つのクラスのプロパティを" +"いくつものテーブルにマッピングすることができます。" -#: index.docbook:2181 -msgid "Using the <literal>&lt;join&gt;</literal> element, it is possible to map properties of one class to several tables, when there's a 1-to-1 relationship between the tables." -msgstr "<![CDATA[<formula>SQL expression</formula>]]>" - -#: index.docbook:2195 +#. Tag: programlisting +#: basic_mapping.xml:2195 +#, no-c-format msgid "" - "<![CDATA[<join\n" - " table=\"tablename\"\n" - " schema=\"owner\"\n" - " catalog=\"catalog\"\n" - " fetch=\"join|select\"\n" - " inverse=\"true|false\"\n" - " optional=\"true|false\">\n" - "\n" - " <key ... />\n" - "\n" - " <property ... />\n" - " ...\n" - "</join>]]>" -msgstr "同じプロパティや関連のマッピングの中で、 <literal>column</literal> と <literal>formula</literal> 属性を組み合わせることができます。 例えば、特殊な結合条件などです。" +"<![CDATA[<join\n" +" table=\"tablename\"\n" +" schema=\"owner\"\n" +" catalog=\"catalog\"\n" +" fetch=\"join|select\"\n" +" inverse=\"true|false\"\n" +" optional=\"true|false\">\n" +"\n" +" <key ... />\n" +"\n" +" <property ... />\n" +" ...\n" +"</join>]]>" +msgstr "" -#: index.docbook:2199 +#. Tag: para +#: basic_mapping.xml:2199 +#, no-c-format msgid "<literal>table</literal>: The name of the joined table." +msgstr "<literal>table</literal> :結合したテーブルの名前" + +#. Tag: para +#: basic_mapping.xml:2216 +#, no-c-format +msgid "" +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"If set to <literal>join</literal>, the default, Hibernate will use an inner " +"join to retrieve a <literal>&lt;join&gt;</literal> defined by a class or its " +"superclasses and an outer join for a <literal>&lt;join&gt;</literal> defined " +"by a subclass. If set to <literal>select</literal> then Hibernate will use a " +"sequential select for a <literal>&lt;join&gt;</literal> defined on a " +"subclass, which will be issued only if a row turns out to represent an " +"instance of the subclass. Inner joins will still be used to retrieve a " +"<literal>&lt;join&gt;</literal> defined by the class and its superclasses." msgstr "" - "<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\" -\n" - " insert=\"false\" update=\"false\"> -\n" - " <column name=\"person_id\" not-null=\"true\" length=\"10\"/> -\n" - " <formula>'MAILING'</formula> -\n" - "</many-to-one>]]>" +"<literal>fetch</literal> (オプション - デフォルトは <literal>join</" +"literal> ): <literal>join</literal> を設定した場合、 Hibernateはデフォルト" +"で、クラスやスーパークラスで定義された <literal>&lt;join&gt;</literal> を検索" +"するのに内部結合を使い、サブクラスで定義された <literal>&lt;join&gt;</" +"literal> を検索するのに外部結合を使います。 <literal>select</literal> を設定" +"した場合には、 Hibernateはサブクラスで定義された <literal>&lt;join&gt;</" +"literal> の選択に順次選択を使います。この場合、 行がサブクラスのインスタンス" +"を代表することがわかった場合にのみ発行されます。 内部結合はクラスやそのスー" +"パークラスで定義された <literal>&lt;join&gt;</literal> を検索 するために使用" +"します。" -#: index.docbook:2216 -msgid "<literal>fetch</literal> (optional - defaults to <literal>join</literal>): If set to <literal>join</literal>, the default, Hibernate will use an inner join to retrieve a <literal>&lt;join&gt;</literal> defined by a class or its superclasses and an outer join for a <literal>&lt;join&gt;</literal> defined by a subclass. If set to <literal>select</literal> then Hibernate will use a sequential select for a <literal>&lt;join&gt;</literal> defined on a subclass, which will be issued only if a row turns out to represent an instance of the subclass. Inner joins will still be used to retrieve a <literal>&lt;join&gt;</literal> defined by the class and its superclasses." -msgstr "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>" +#. Tag: para +#: basic_mapping.xml:2229 +#, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</" +"literal>): If enabled, Hibernate will not try to insert or update the " +"properties defined by this join." +msgstr "" +"<literal>inverse</literal> (オプション - デフォルトは <literal>false</" +"literal> ): もし可能であれば、Hibernateはこの結合で定義されているプロパティに" +"対し 挿入や更新を行いません。" -#: index.docbook:2229 -msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>): If enabled, Hibernate will not try to insert or update the properties defined by this join." +#. Tag: para +#: basic_mapping.xml:2236 +#, no-c-format +msgid "" +"<literal>optional</literal> (optional - defaults to <literal>false</" +"literal>): If enabled, Hibernate will insert a row only if the properties " +"defined by this join are non-null and will always use an outer join to " +"retrieve the properties." msgstr "" - "<![CDATA[<import -\n" - " class=\"ClassName\" -\n" - " rename=\"ShortName\" -\n" - "/>]]>" +"<literal>optional</literal> (オプション - デフォルトは <literal>false</" +"literal> ): もし可能であれば、Hibernateはこの結合で定義されたプロパティがnull" +"でない場合にのみ 行を挿入し、そのプロパティの検索には常に外部結合を使用しま" +"す。" -#: index.docbook:2236 -msgid "<literal>optional</literal> (optional - defaults to <literal>false</literal>): If enabled, Hibernate will insert a row only if the properties defined by this join are non-null and will always use an outer join to retrieve the properties." -msgstr "<literal>class</literal>：Javaクラスの完全修飾されたクラス名。" +#. Tag: para +#: basic_mapping.xml:2245 +#, no-c-format +msgid "" +"For example, the address information for a person can be mapped to a " +"separate table (while preserving value type semantics for all properties):" +msgstr "" +"例えば人のアドレスの情報を分離したテーブルにマッピングすることが可能です (す" +"べてのプロパティに対して値型のセマンティクスを保持します)。" -#: index.docbook:2245 -msgid "For example, the address information for a person can be mapped to a separate table (while preserving value type semantics for all properties):" -msgstr "<literal>rename</literal>（オプション - デフォルトは修飾されていないクラス名）： クエリ言語で使われる名前。" +#. Tag: programlisting +#: basic_mapping.xml:2250 +#, no-c-format +msgid "" +"<![CDATA[<class name=\"Person\"\n" +" table=\"PERSON\">\n" +"\n" +" <id name=\"id\" column=\"PERSON_ID\">...</id>\n" +"\n" +" <join table=\"ADDRESS\">\n" +" <key column=\"ADDRESS_ID\"/>\n" +" <property name=\"address\"/>\n" +" <property name=\"zip\"/>\n" +" <property name=\"country\"/>\n" +" </join>\n" +" ...]]>" +msgstr "" -#: index.docbook:2250 +#. Tag: para +#: basic_mapping.xml:2252 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\"\n" - " table=\"PERSON\">\n" - "\n" - " <id name=\"id\" column=\"PERSON_ID\">...</id>\n" - "\n" - " <join table=\"ADDRESS\">\n" - " <key column=\"ADDRESS_ID\"/>\n" - " <property name=\"address\"/>\n" - " <property name=\"zip\"/>\n" - " <property name=\"country\"/>\n" - " </join>\n" - " ...]]>" -msgstr "<title>any</title>" +"This feature is often only useful for legacy data models, we recommend fewer " +"tables than classes and a fine-grained domain model. However, it is useful " +"for switching between inheritance mapping strategies in a single hierarchy, " +"as explained later." +msgstr "" +"この特徴はしばしばレガシーデータモデルに対してのみ有用ですが、 クラスよりも少" +"ないテーブルと、きめの細かいドメインモデルを推奨します。 しかし後で説明するよ" +"うに、１つのクラス階層で継承のマッピング戦略を切り替える時には有用です。" -#: index.docbook:2252 -msgid "This feature is often only useful for legacy data models, we recommend fewer tables than classes and a fine-grained domain model. However, it is useful for switching between inheritance mapping strategies in a single hierarchy, as explained later." -msgstr "プロパティマッピングにはさらにもう1つの型があります。 <literal>&lt;any&gt;</literal> マッピング要素は、 複数のテーブルからクラスへのポリモーフィックな関連を定義します。 この型のマッピングには必ず複数のカラムが必要です。1番目のカラムは関連エンティティの型を保持します。 残りのカラムは識別子を保持します。この種類の関連には外部キー制約を指定することはできません。 そのためこれは最も使われることのない（ポリモーフィックな）関連のマッピング方法です。 非常に特別な場合（例えば、検査ログやユーザセッションデータなど)に限って、これを使うべきです。" - -#: index.docbook:2262 +#. Tag: title +#: basic_mapping.xml:2262 +#, no-c-format msgid "<title>key</title>" -msgstr "<literal>meta-type</literal> により、 アプリケーションはカスタム型を指定できます。このカスタム型は データベースカラムの値を、<literal>id-type</literal> で指定した型の 識別子プロパティを持った永続クラスへマッピングします。 meta-typeの値からクラス名へのマッピングを指定しなければなりません。" +msgstr "" -#: index.docbook:2264 -msgid "We've seen the <literal>&lt;key&gt;</literal> element crop up a few times now. It appears anywhere the parent mapping element defines a join to a new table, and defines the foreign key in the joined table, that references the primary key of the original table." +#. Tag: para +#: basic_mapping.xml:2264 +#, no-c-format +msgid "" +"We've seen the <literal>&lt;key&gt;</literal> element crop up a few times " +"now. It appears anywhere the parent mapping element defines a join to a new " +"table, and defines the foreign key in the joined table, that references the " +"primary key of the original table." msgstr "" - "<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\"> -\n" - " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/> -\n" - " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/> -\n" - " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/> -\n" - " <column name=\"table_name\"/> -\n" - " <column name=\"id\"/> -\n" - "</any>]]>" +"今まで何度か <literal>&lt;key&gt;</literal> 要素が出てきました。 この要素は新" +"しいテーブルへの結合を定義したり、 結合テーブルで外部キーを定義したりする親要" +"素のどこにでも現れ、 オリジナルテーブルの主キーを参照します。" -#: index.docbook:2280 +#. Tag: programlisting +#: basic_mapping.xml:2280 +#, no-c-format msgid "" - "<![CDATA[<key\n" - " column=\"columnname\"\n" - " on-delete=\"noaction|cascade\"\n" - " property-ref=\"propertyName\"\n" - " not-null=\"true|false\"\n" - " update=\"true|false\"\n" - " unique=\"true|false\"\n" - "/>]]>" +"<![CDATA[<key\n" +" column=\"columnname\"\n" +" on-delete=\"noaction|cascade\"\n" +" property-ref=\"propertyName\"\n" +" not-null=\"true|false\"\n" +" update=\"true|false\"\n" +" unique=\"true|false\"\n" +"/>]]>" msgstr "" - "<![CDATA[<any -\n" - " name=\"propertyName\" -\n" - " id-type=\"idtypename\" -\n" - " meta-type=\"metatypename\" -\n" - " cascade=\"cascade_style\" -\n" - " access=\"field|property|ClassName\" -\n" - " optimistic-lock=\"true|false\" -\n" - "> -\n" - " <meta-value ... /> -\n" - " <meta-value ... /> -\n" - " ..... -\n" - " <column .... /> -\n" - " <column .... /> -\n" - " ..... -\n" - "</any>]]>" -#: index.docbook:2291 -msgid "<literal>on-delete</literal> (optional, defaults to <literal>noaction</literal>): Specifies whether the foreign key constraint has database-level cascade delete enabled." -msgstr "<literal>id-type</literal>：識別子の型。" +#. Tag: para +#: basic_mapping.xml:2291 +#, no-c-format +msgid "" +"<literal>on-delete</literal> (optional, defaults to <literal>noaction</" +"literal>): Specifies whether the foreign key constraint has database-level " +"cascade delete enabled." +msgstr "" +"<literal>on-delete</literal> (オプション, デフォルトは <literal>noaction</" +"literal>): 外部キー制約がデータベースレベルでカスケード削除が可能かどうかを指" +"定します。" -#: index.docbook:2298 -msgid "<literal>property-ref</literal> (optional): Specifies that the foreign key refers to columns that are not the primary key of the orginal table. (Provided for legacy data.)" -msgstr "<literal>meta-type</literal>（オプション - デフォルトは <literal>string</literal> ）： ディスクリミネータマッピングで許された型" +#. Tag: para +#: basic_mapping.xml:2298 +#, no-c-format +msgid "" +"<literal>property-ref</literal> (optional): Specifies that the foreign key " +"refers to columns that are not the primary key of the orginal table. " +"(Provided for legacy data.)" +msgstr "" +"<literal>property-ref</literal> (オプション): オリジナルテーブルの主キーでは" +"ないカラムを参照する外部キーを指定します (レガシーデータに対して提供されま" +"す)。" -#: index.docbook:2305 -msgid "<literal>not-null</literal> (optional): Specifies that the foreign key columns are not nullable (this is implied whenever the foreign key is also part of the primary key)." -msgstr "<literal>cascade</literal>（オプション - デフォルトは <literal>none</literal> ）： カスケードのスタイル。" +#. Tag: para +#: basic_mapping.xml:2305 +#, no-c-format +msgid "" +"<literal>not-null</literal> (optional): Specifies that the foreign key " +"columns are not nullable (this is implied whenever the foreign key is also " +"part of the primary key)." +msgstr "" +"<literal>not-null</literal> (オプション): 外部キーカラムがnull値を許容しない" +"ことを指定します (このことは外部キーが主キーの一部であることを暗黙的に示しま" +"す)。" -#: index.docbook:2312 -msgid "<literal>update</literal> (optional): Specifies that the foreign key should never be updated (this is implied whenever the foreign key is also part of the primary key)." -msgstr "<literal>access</literal>（オプション - デフォルトは <literal>property</literal> ）： プロパティの値へのアクセスにHibernateが使う戦略。" +#. Tag: para +#: basic_mapping.xml:2312 +#, no-c-format +msgid "" +"<literal>update</literal> (optional): Specifies that the foreign key should " +"never be updated (this is implied whenever the foreign key is also part of " +"the primary key)." +msgstr "" +"<literal>update</literal> (オプション): 外部キーを決して更新してはならないこ" +"とを指定します (このことは外部キーが主キーの一部であることを暗黙的に示しま" +"す)。" -#: index.docbook:2319 -msgid "<literal>unique</literal> (optional): Specifies that the foreign key should have a unique constraint (this is implied whenever the foreign key is also the primary key)." -msgstr "<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定します。 言い換えれば、このプロパティがダーティであるときにバージョンを増やすべきかを定義します。" +#. Tag: para +#: basic_mapping.xml:2319 +#, no-c-format +msgid "" +"<literal>unique</literal> (optional): Specifies that the foreign key should " +"have a unique constraint (this is implied whenever the foreign key is also " +"the primary key)." +msgstr "" +"<literal>unique</literal> (オプション): 外部キーがユニーク制約を持つべきであ" +"ることを指定します (このことは外部キーが主キーの一部であることを暗黙的に示し" +"ます)。" -#: index.docbook:2327 -msgid "We recommend that for systems where delete performance is important, all keys should be defined <literal>on-delete=\"cascade\"</literal>, and Hibernate will use a database-level <literal>ON CASCADE DELETE</literal> constraint, instead of many individual <literal>DELETE</literal> statements. Be aware that this feature bypasses Hibernate's usual optimistic locking strategy for versioned data." -msgstr "Hibernateの型" +#. Tag: para +#: basic_mapping.xml:2327 +#, no-c-format +msgid "" +"We recommend that for systems where delete performance is important, all " +"keys should be defined <literal>on-delete=\"cascade\"</literal>, and " +"Hibernate will use a database-level <literal>ON CASCADE DELETE</literal> " +"constraint, instead of many individual <literal>DELETE</literal> statements. " +"Be aware that this feature bypasses Hibernate's usual optimistic locking " +"strategy for versioned data." +msgstr "" +"削除のパフォーマンスが重要であるシステムには、 すべてのキーを <literal>on-" +"delete=\"cascade\"</literal> と定義することを推奨します。 そうすることで" +"Hibernateは、<literal>DELETE</literal> 文を毎回発行する代わりに、 データベー" +"スレベルの <literal>ON CASCADE DELETE</literal> 制約を使用します。 この特徴は" +"バージョン付けられたデータに対するHibernateの通常の楽観的ロック戦略を 無視す" +"るということに注意してください。" -#: index.docbook:2335 -msgid "The <literal>not-null</literal> and <literal>update</literal> attributes are useful when mapping a unidirectional one to many association. If you map a unidirectional one to many to a non-nullable foreign key, you <emphasis>must</emphasis> declare the key column using <literal>&lt;key not-null=\"true\"&gt;</literal>." -msgstr "エンティティと値" +#. Tag: para +#: basic_mapping.xml:2335 +#, no-c-format +msgid "" +"The <literal>not-null</literal> and <literal>update</literal> attributes are " +"useful when mapping a unidirectional one to many association. If you map a " +"unidirectional one to many to a non-nullable foreign key, you " +"<emphasis>must</emphasis> declare the key column using <literal>&lt;key not-" +"null=\"true\"&gt;</literal>." +msgstr "" +"<literal>not-null</literal> と <literal>update</literal> 属性は、単方向一対多" +"関連の時には有用です。 単方向一対多関連をnullを許容しない外部キーにマッピング" +"するときは、 <literal>&lt;key not-null=\"true\"&gt;</literal> を使ってキーカ" +"ラムを宣言 <emphasis> しなくてはなりません</emphasis> 。" -#: index.docbook:2345 +#. Tag: title +#: basic_mapping.xml:2345 +#, no-c-format msgid "column and formula elements" -msgstr "永続サービスに関わる様々なJava言語レベルのオブジェクトの振る舞いを理解するためには、 オブジェクトを2つのグループに分ける必要があります：" +msgstr "column と formula 要素" -#: index.docbook:2346 -msgid "Any mapping element which accepts a <literal>column</literal> attribute will alternatively accept a <literal>&lt;column&gt;</literal> subelement. Likewise, <literal>&lt;formula&gt;</literal> is an alternative to the <literal>formula</literal> attribute." -msgstr "<emphasis> エンティティ</emphasis> はエンティティへの参照を保持する、 他のすべてのオブジェクトから独立して存在します。 参照されないオブジェクトがガベージコレクトされてしまう性質を持つ通常のJavaモデルと、 これを比べてみてください。 （親エンティティから子へ、セーブと削除が <emphasis>カスケード</emphasis> されうることを除いて） エンティティは明示的にセーブまたは削除されなければなりません。 これは到達可能性によるオブジェクト永続化のODMGモデルとは異なっています。 大規模なシステムでアプリケーションオブジェクトが普通どのように使われるかにより密接に対応します。 エンティティは循環と参照の共有をサポートします。 またそれらはバージョン付けすることもできます。" +#. Tag: para +#: basic_mapping.xml:2346 +#, no-c-format +msgid "" +"Any mapping element which accepts a <literal>column</literal> attribute will " +"alternatively accept a <literal>&lt;column&gt;</literal> subelement. " +"Likewise, <literal>&lt;formula&gt;</literal> is an alternative to the " +"<literal>formula</literal> attribute." +msgstr "" +"<literal>column</literal> 属性を記述できる任意のマッピング要素はまた、 " +"<literal>&lt;column&gt;</literal> サブ要素も記述できます。 同様に " +"<literal>&lt;formula&gt;</literal> も <literal>formula</literal> 属性の代替手" +"段です。" -#: index.docbook:2352 +#. Tag: programlisting +#: basic_mapping.xml:2352 +#, no-c-format msgid "" - "<![CDATA[<column\n" - " name=\"column_name\"\n" - " length=\"N\"\n" - " precision=\"N\"\n" - " scale=\"N\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " unique-key=\"multicolumn_unique_key_name\"\n" - " index=\"index_name\"\n" - " sql-type=\"sql_type_name\"\n" - " check=\"SQL expression\"\n" - " default=\"SQL expression\"/>]]>" -msgstr "エンティティの永続状態は他のエンティティや <emphasis>値</emphasis> 型の インスタンスへの参照から構成されます。 値はプリミティブ、コレクション(コレクションの内部ではなく)、 コンポーネント、不変オブジェクトです。 エンティティとは違い、値は（特にコレクションとコンポーネントにおいて）、 到達可能性による永続化や削除が <emphasis>行われます</emphasis> 。 値オブジェクト（とプリミティブ）は、包含するエンティティと一緒に永続化や削除が行われるので、 それらを独立にバージョン付けすることはできません。 値には独立したアイデンティティがないので、 複数のエンティティやコレクションがこれを共有することはできません。" +"<![CDATA[<column\n" +" name=\"column_name\"\n" +" length=\"N\"\n" +" precision=\"N\"\n" +" scale=\"N\"\n" +" not-null=\"true|false\"\n" +" unique=\"true|false\"\n" +" unique-key=\"multicolumn_unique_key_name\"\n" +" index=\"index_name\"\n" +" sql-type=\"sql_type_name\"\n" +" check=\"SQL expression\"\n" +" default=\"SQL expression\"/>]]>" +msgstr "" -#: index.docbook:2354 +#. Tag: programlisting +#: basic_mapping.xml:2354 +#, no-c-format msgid "<![CDATA[<formula>SQL expression</formula>]]>" -msgstr "これまで「永続クラス」という言葉をエンティティの意味で使ってきました。 これからもそうしていきます。 厳密に言うと、永続状態を持つユーザ定義のクラスのすべてが エンティティというわけではありません。 <emphasis>コンポーネント</emphasis> は値のセマンティクスを持つユーザ定義クラスです。 <literal>java.lang.String</literal> 型のプロパティもまた値のセマンティクスを持ちます。 定義するなら、JDKで提供されているすべてのJavaの型(クラス)が値のセマンティクスを持つといえます。 一方ユーザ定義型は、エンティティや値型のセマンティクスとともにマッピングできます。 この決定はアプリケーション開発者次第です。 そのクラスの１つのインスタンスへの共有参照は、 ドメインモデル内のエンティティクラスに対す! る良いヒントになります。 一方合成集約や集約は、通常値型へ変換されます。" +msgstr "" -#: index.docbook:2356 -msgid "<literal>column</literal> and <literal>formula</literal> attributes may even be combined within the same property or association mapping to express, for example, exotic join conditions." -msgstr "本ドキュメントを通して、何度もこの概念を取り上げます。" +#. Tag: para +#: basic_mapping.xml:2356 +#, no-c-format +msgid "" +"<literal>column</literal> and <literal>formula</literal> attributes may even " +"be combined within the same property or association mapping to express, for " +"example, exotic join conditions." +msgstr "" +"同じプロパティや関連のマッピングの中で、 <literal>column</literal> と " +"<literal>formula</literal> 属性を組み合わせることができます。 例えば、特殊な" +"結合条件などです。" -#: index.docbook:2362 +#. Tag: programlisting +#: basic_mapping.xml:2362 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" - " <formula>'MAILING'</formula>\n" - "</many-to-one>]]>" -msgstr "Java型のシステム(もしくは開発者が定義したエンティティと値型)を SQL/データベース型のシステムにマッピングすることは難しいです。 Hibernateは２つのシステムの架け橋を提供します。 エンティティに対しては <literal>&lt;class&gt;</literal> や <literal>&lt;subclass&gt;</literal> などを使用します。 値型に対しては <literal>&lt;property&gt;</literal> や <literal>&lt;component&gt;</literal> などを、通常 <literal>type</literal> とともに使います。 この属性の値はHibernateの <emphasis>マッピング型</emphasis> の名前です。 Hibernateは(標準JDKの値型に対して)多くの自由なマッピングを提供します。 後で見るように、自身のマッピング型を記述し、同様にカスタムの変換戦略を実装することができます。" +"<![CDATA[<many-to-one name=\"homeAddress\" class=\"Address\"\n" +" insert=\"false\" update=\"false\">\n" +" <column name=\"person_id\" not-null=\"true\" length=\"10\"/>\n" +" <formula>'MAILING'</formula>\n" +"</many-to-one>]]>" +msgstr "" -#: index.docbook:2367 +#. Tag: title +#: basic_mapping.xml:2367 +#, no-c-format msgid "import" -msgstr "コレクションを除く組み込みのHibernateの型はすべて、nullセマンティクスをサポートします。" +msgstr "import" -#: index.docbook:2369 -msgid "Suppose your application has two persistent classes with the same name, and you don't want to specify the fully qualified (package) name in Hibernate queries. Classes may be \"imported\" explicitly, rather than relying upon <literal>auto-import=\"true\"</literal>. You may even import classes and interfaces that are not explicitly mapped." -msgstr "基本的な型" +#. Tag: para +#: basic_mapping.xml:2369 +#, no-c-format +msgid "" +"Suppose your application has two persistent classes with the same name, and " +"you don't want to specify the fully qualified (package) name in Hibernate " +"queries. Classes may be \"imported\" explicitly, rather than relying upon " +"<literal>auto-import=\"true\"</literal>. You may even import classes and " +"interfaces that are not explicitly mapped." +msgstr "" +"アプリケーションに同じ名前の2つの永続クラスがあり、 Hibernateクエリで完全修飾" +"された（パッケージの）名前を指定したくないと仮定します。 そのような場合は " +"<literal>auto-import=\"true\"</literal> に頼らず、 クラスが「インポート」され" +"たものであると明示できます。 明示的にマッピングされていないクラスやインター" +"フェイスでさえもインポートできます。" -#: index.docbook:2376 +#. Tag: programlisting +#: basic_mapping.xml:2376 +#, no-c-format msgid "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>" -msgstr "組み込みの <emphasis>基本的なマッピング型</emphasis> は大まかに以下のように分けられます。" +msgstr "" -#: index.docbook:2383 +#. Tag: programlisting +#: basic_mapping.xml:2383 +#, no-c-format msgid "" - "<![CDATA[<import\n" - " class=\"ClassName\"\n" - " rename=\"ShortName\"\n" - "/>]]>" -msgstr "integer, long, short, float, double, character, byte, boolean, yes_no, true_false" +"<![CDATA[<import\n" +" class=\"ClassName\"\n" +" rename=\"ShortName\"\n" +"/>]]>" +msgstr "" -#: index.docbook:2386 -msgid "<literal>class</literal>: The fully qualified class name of of any Java class." -msgstr "Javaのプリミティブやラッパークラスから適切な（ベンダー固有の） SQLカラム型への型マッピング。 <literal>boolean, yes_no</literal> と <literal>true_false</literal> は、 すべてJavaの <literal>boolean</literal> または <literal>java.lang.Boolean</literal> の代替エンコードです。" +#. Tag: para +#: basic_mapping.xml:2386 +#, no-c-format +msgid "" +"<literal>class</literal>: The fully qualified class name of of any Java " +"class." +msgstr "<literal>class</literal>：Javaクラスの完全修飾されたクラス名。" -#: index.docbook:2391 -msgid "<literal>rename</literal> (optional - defaults to the unqualified class name): A name that may be used in the query language." -msgstr "string" +#. Tag: para +#: basic_mapping.xml:2391 +#, no-c-format +msgid "" +"<literal>rename</literal> (optional - defaults to the unqualified class " +"name): A name that may be used in the query language." +msgstr "" +"<literal>rename</literal>（オプション - デフォルトは修飾されていないクラス" +"名）： クエリ言語で使われる名前。" -#: index.docbook:2402 +#. Tag: title +#: basic_mapping.xml:2402 +#, no-c-format msgid "<title>any</title>" -msgstr "<literal>java.lang.String</literal> から <literal>VARCHAR</literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。" +msgstr "" -#: index.docbook:2404 -msgid "There is one further type of property mapping. The <literal>&lt;any&gt;</literal> mapping element defines a polymorphic association to classes from multiple tables. This type of mapping always requires more than one column. The first column holds the type of the associated entity. The remaining columns hold the identifier. It is impossible to specify a foreign key constraint for this kind of association, so this is most certainly not meant as the usual way of mapping (polymorphic) associations. You should use this only in very special cases (eg. audit logs, user session data, etc)." -msgstr "date, time, timestamp" +#. Tag: para +#: basic_mapping.xml:2404 +#, no-c-format +msgid "" +"There is one further type of property mapping. The <literal>&lt;any&gt;</" +"literal> mapping element defines a polymorphic association to classes from " +"multiple tables. This type of mapping always requires more than one column. " +"The first column holds the type of the associated entity. The remaining " +"columns hold the identifier. It is impossible to specify a foreign key " +"constraint for this kind of association, so this is most certainly not meant " +"as the usual way of mapping (polymorphic) associations. You should use this " +"only in very special cases (eg. audit logs, user session data, etc)." +msgstr "" +"プロパティマッピングにはさらにもう1つの型があります。 <literal>&lt;any&gt;</" +"literal> マッピング要素は、 複数のテーブルからクラスへのポリモーフィックな関" +"連を定義します。 この型のマッピングには必ず複数のカラムが必要です。1番目のカ" +"ラムは関連エンティティの型を保持します。 残りのカラムは識別子を保持します。こ" +"の種類の関連には外部キー制約を指定することはできません。 そのためこれは最も使" +"われることのない（ポリモーフィックな）関連のマッピング方法です。 非常に特別な" +"場合（例えば、検査ログやユーザセッションデータなど)に限って、これを使うべきで" +"す。" -#: index.docbook:2414 -msgid "The <literal>meta-type</literal> attribute lets the application specify a custom type that maps database column values to persistent classes which have identifier properties of the type specified by <literal>id-type</literal>. You must specify the mapping from values of the meta-type to class names." -msgstr "<literal>java.util.Date</literal> とそのサブクラスからSQL型の <literal>DATE</literal>, <literal>TIME</literal> , <literal>TIMESTAMP</literal> （またはそれらと等価なもの） への型マッピング。" +#. Tag: para +#: basic_mapping.xml:2414 +#, no-c-format +msgid "" +"The <literal>meta-type</literal> attribute lets the application specify a " +"custom type that maps database column values to persistent classes which " +"have identifier properties of the type specified by <literal>id-type</" +"literal>. You must specify the mapping from values of the meta-type to class " +"names." +msgstr "" +"<literal>meta-type</literal> により、 アプリケーションはカスタム型を指定でき" +"ます。このカスタム型は データベースカラムの値を、<literal>id-type</literal> " +"で指定した型の 識別子プロパティを持った永続クラスへマッピングします。 meta-" +"typeの値からクラス名へのマッピングを指定しなければなりません。" -#: index.docbook:2421 +#. Tag: programlisting +#: basic_mapping.xml:2421 +#, no-c-format msgid "" - "<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" - " <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" - " <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" - " <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" - " <column name=\"table_name\"/>\n" - " <column name=\"id\"/>\n" - "</any>]]>" -msgstr "calendar, calendar_date" +"<![CDATA[<any name=\"being\" id-type=\"long\" meta-type=\"string\">\n" +" <meta-value value=\"TBL_ANIMAL\" class=\"Animal\"/>\n" +" <meta-value value=\"TBL_HUMAN\" class=\"Human\"/>\n" +" <meta-value value=\"TBL_ALIEN\" class=\"Alien\"/>\n" +" <column name=\"table_name\"/>\n" +" <column name=\"id\"/>\n" +"</any>]]>" +msgstr "" -#: index.docbook:2432 +#. Tag: programlisting +#: basic_mapping.xml:2432 +#, no-c-format msgid "" - "<![CDATA[<any\n" - " name=\"propertyName\"\n" - " id-type=\"idtypename\"\n" - " meta-type=\"metatypename\"\n" - " cascade=\"cascade_style\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - ">\n" - " <meta-value ... />\n" - " <meta-value ... />\n" - " .....\n" - " <column .... />\n" - " <column .... />\n" - " .....\n" - "</any>]]>" -msgstr "<literal>java.util.Calendar</literal> からSQL型 の「 <literal>TIMESTAMP</literal> , <literal>DATE</literal> (またはそれらと等価なもの）への型マッピング。" +"<![CDATA[<any\n" +" name=\"propertyName\"\n" +" id-type=\"idtypename\"\n" +" meta-type=\"metatypename\"\n" +" cascade=\"cascade_style\"\n" +" access=\"field|property|ClassName\"\n" +" optimistic-lock=\"true|false\"\n" +">\n" +" <meta-value ... />\n" +" <meta-value ... />\n" +" .....\n" +" <column .... />\n" +" <column .... />\n" +" .....\n" +"</any>]]>" +msgstr "" -#: index.docbook:2435 +#. Tag: para +#: basic_mapping.xml:2435 +#, no-c-format msgid "<literal>name</literal>: the property name." -msgstr "big_decimal, big_integer" +msgstr "<literal>name</literal>：プロパティ名。" -#: index.docbook:2440 +#. Tag: para +#: basic_mapping.xml:2440 +#, no-c-format msgid "<literal>id-type</literal>: the identifier type." -msgstr "<literal>java.math.BigDecimal</literal> と <literal>java.math.BigInteger</literal> から <literal>NUMERIC</literal>（またはOracleの <literal>NUMBER</literal> ）への型マッピング。" +msgstr "<literal>id-type</literal>：識別子の型。" -#: index.docbook:2445 -msgid "<literal>meta-type</literal> (optional - defaults to <literal>string</literal>): Any type that is allowed for a discriminator mapping." -msgstr "locale, timezone, currency" +#. Tag: para +#: basic_mapping.xml:2445 +#, no-c-format +msgid "" +"<literal>meta-type</literal> (optional - defaults to <literal>string</" +"literal>): Any type that is allowed for a discriminator mapping." +msgstr "" +"<literal>meta-type</literal>（オプション - デフォルトは <literal>string</" +"literal> ）： ディスクリミネータマッピングで許された型" -#: index.docbook:2451 -msgid "<literal>cascade</literal> (optional- defaults to <literal>none</literal>): the cascade style." -msgstr "<literal>java.util.Locale</literal> , <literal>java.util.TimeZone</literal> , <literal>java.util.Currency</literal> から <literal>VARCHAR</literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。 <literal>Locale</literal> と <literal>Currency</literal> のインスタンスは、 それらのISOコードにマッピングされます。 <literal>TimeZone</literal> のインスタンスは、 それらの <literal>ID</literal> にマッピングされます。" +#. Tag: para +#: basic_mapping.xml:2451 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional- defaults to <literal>none</literal>): " +"the cascade style." +msgstr "" +"<literal>cascade</literal>（オプション - デフォルトは <literal>none</" +"literal> ）： カスケードのスタイル。" -#: index.docbook:2463 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Specifies that updates to this property do or do not require acquisition of the optimistic lock. In other words, define if a version increment should occur if this property is dirty." -msgstr "<literal>java.lang.Class</literal> から <literal>VARCHAR</literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。 <literal>Class</literal> はその完全修飾された名前にマッピングされます。" +#. Tag: para +#: basic_mapping.xml:2463 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Specifies that updates to this property do or do not require " +"acquisition of the optimistic lock. In other words, define if a version " +"increment should occur if this property is dirty." +msgstr "" +"<literal>optimistic-lock</literal> (オプション - デフォルトは <literal>true</" +"literal> ): このプロパティの更新に楽観ロックの取得を要求するかどうかを指定し" +"ます。 言い換えれば、このプロパティがダーティであるときにバージョンを増やすべ" +"きかを定義します。" -#: index.docbook:2478 +#. Tag: title +#: basic_mapping.xml:2478 +#, no-c-format msgid "Hibernate Types" -msgstr "binary" +msgstr "Hibernateの型" -#: index.docbook:2481 +#. Tag: title +#: basic_mapping.xml:2481 +#, no-c-format msgid "Entities and values" -msgstr "バイト配列は、適切なSQLのバイナリ型にマッピングされます。" +msgstr "エンティティと値" -#: index.docbook:2483 -msgid "To understand the behaviour of various Java language-level objects with respect to the persistence service, we need to classify them into two groups:" -msgstr "text" +#. Tag: para +#: basic_mapping.xml:2483 +#, no-c-format +msgid "" +"To understand the behaviour of various Java language-level objects with " +"respect to the persistence service, we need to classify them into two groups:" +msgstr "" +"永続サービスに関わる様々なJava言語レベルのオブジェクトの振る舞いを理解するた" +"めには、 オブジェクトを2つのグループに分ける必要があります：" -#: index.docbook:2488 -msgid "An <emphasis>entity</emphasis> exists independently of any other objects holding references to the entity. Contrast this with the usual Java model where an unreferenced object is garbage collected. Entities must be explicitly saved and deleted (except that saves and deletions may be <emphasis>cascaded</emphasis> from a parent entity to its children). This is different from the ODMG model of object persistence by reachablity - and corresponds more closely to how application objects are usually used in large systems. Entities support circular and shared references. They may also be versioned." -msgstr "長いJava文字列は、SQLの <literal>CLOB</literal> または <literal>TEXT</literal> 型にマッピングされます。" +#. Tag: para +#: basic_mapping.xml:2488 +#, no-c-format +msgid "" +"An <emphasis>entity</emphasis> exists independently of any other objects " +"holding references to the entity. Contrast this with the usual Java model " +"where an unreferenced object is garbage collected. Entities must be " +"explicitly saved and deleted (except that saves and deletions may be " +"<emphasis>cascaded</emphasis> from a parent entity to its children). This is " +"different from the ODMG model of object persistence by reachablity - and " +"corresponds more closely to how application objects are usually used in " +"large systems. Entities support circular and shared references. They may " +"also be versioned." +msgstr "" +"<emphasis> エンティティ</emphasis> はエンティティへの参照を保持する、 他のす" +"べてのオブジェクトから独立して存在します。 参照されないオブジェクトがガベージ" +"コレクトされてしまう性質を持つ通常のJavaモデルと、 これを比べてみてくださ" +"い。 （親エンティティから子へ、セーブと削除が <emphasis>カスケード</" +"emphasis> されうることを除いて） エンティティは明示的にセーブまたは削除されな" +"ければなりません。 これは到達可能性によるオブジェクト永続化のODMGモデルとは異" +"なっています。 大規模なシステムでアプリケーションオブジェクトが普通どのように" +"使われるかにより密接に対応します。 エンティティは循環と参照の共有をサポートし" +"ます。 またそれらはバージョン付けすることもできます。" -#: index.docbook:2499 -msgid "An entity's persistent state consists of references to other entities and instances of <emphasis>value</emphasis> types. Values are primitives, collections (not what's inside a collection), components and certain immutable objects. Unlike entities, values (in particular collections and components) <emphasis>are</emphasis> persisted and deleted by reachability. Since value objects (and primitives) are persisted and deleted along with their containing entity they may not be independently versioned. Values have no independent identity, so they cannot be shared by two entities or collections." -msgstr "serializable" +#. Tag: para +#: basic_mapping.xml:2499 +#, no-c-format +msgid "" +"An entity's persistent state consists of references to other entities and " +"instances of <emphasis>value</emphasis> types. Values are primitives, " +"collections (not what's inside a collection), components and certain " +"immutable objects. Unlike entities, values (in particular collections and " +"components) <emphasis>are</emphasis> persisted and deleted by reachability. " +"Since value objects (and primitives) are persisted and deleted along with " +"their containing entity they may not be independently versioned. Values have " +"no independent identity, so they cannot be shared by two entities or " +"collections." +msgstr "" +"エンティティの永続状態は他のエンティティや <emphasis>値</emphasis> 型の イン" +"スタンスへの参照から構成されます。 値はプリミティブ、コレクション(コレクショ" +"ンの内部ではなく)、 コンポーネント、不変オブジェクトです。 エンティティとは違" +"い、値は（特にコレクションとコンポーネントにおいて）、 到達可能性による永続化" +"や削除が <emphasis>行われます</emphasis> 。 値オブジェクト（とプリミティブ）" +"は、包含するエンティティと一緒に永続化や削除が行われるので、 それらを独立に" +"バージョン付けすることはできません。 値には独立したアイデンティティがないの" +"で、 複数のエンティティやコレクションがこれを共有することはできません。" -#: index.docbook:2510 -msgid "Up until now, we've been using the term \"persistent class\" to refer to entities. We will continue to do that. Strictly speaking, however, not all user-defined classes with persistent state are entities. A <emphasis>component</emphasis> is a user defined class with value semantics. A Java property of type <literal>java.lang.String</literal> also has value semantics. 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 be mapped with entity or value type semantics. This decision is up to the application developer. A good hint for an entity class in a domain model are shared references to a single instance of that class, while composition or aggregation usually translates to a value type." -msgstr "シリアライズ可能なJava型は、適切なSQLのバイナリ型にマッピングされます。 デフォルトで基本型ではないシリアライズ可能なJavaクラスや インターフェイスの名前を指定することで、 Hibernateの型を <literal>serializable</literal> とすることもできます。" +#. Tag: para +#: basic_mapping.xml:2510 +#, no-c-format +msgid "" +"Up until now, we've been using the term \"persistent class\" to refer to " +"entities. We will continue to do that. Strictly speaking, however, not all " +"user-defined classes with persistent state are entities. A " +"<emphasis>component</emphasis> is a user defined class with value semantics. " +"A Java property of type <literal>java.lang.String</literal> also has value " +"semantics. 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 be mapped with entity or value type semantics. This decision is up " +"to the application developer. A good hint for an entity class in a domain " +"model are shared references to a single instance of that class, while " +"composition or aggregation usually translates to a value type." +msgstr "" +"これまで「永続クラス」という言葉をエンティティの意味で使ってきました。 これか" +"らもそうしていきます。 厳密に言うと、永続状態を持つユーザ定義のクラスのすべて" +"が エンティティというわけではありません。 <emphasis>コンポーネント</" +"emphasis> は値のセマンティクスを持つユーザ定義クラスです。 <literal>java." +"lang.String</literal> 型のプロパティもまた値のセマンティクスを持ちます。 定義" +"するなら、JDKで提供されているすべてのJavaの型(クラス)が値のセマンティクスを持" +"つといえます。 一方ユーザ定義型は、エンティティや値型のセマンティクスとともに" +"マッピングできます。 この決定はアプリケーション開発者次第です。 そのクラスの" +"１つのインスタンスへの共有参照は、 ドメインモデル内のエンティティクラスに対す" +"る良いヒントになります。 一方合成集約や集約は、通常値型へ変換されます。" -#: index.docbook:2524 +#. Tag: para +#: basic_mapping.xml:2524 +#, no-c-format msgid "We'll revisit both concepts throughout the documentation." -msgstr "clob, blob" +msgstr "本ドキュメントを通して、何度もこの概念を取り上げます。" -#: index.docbook:2528 -msgid "The challenge is to map the Java type system (and the developers' definition of entities and value types) to the SQL/database type system. The bridge between both systems is provided by Hibernate: for entities we use <literal>&lt;class&gt;</literal>, <literal>&lt;subclass&gt;</literal> and so on. For value types we use <literal>&lt;property&gt;</literal>, <literal>&lt;component&gt;</literal>, etc, usually with a <literal>type</literal> attribute. The value of this attribute is the name of a Hibernate <emphasis>mapping type</emphasis>. Hibernate provides many mappings (for standard JDK value types) out of the box. You can write your own mapping types and implement your custom conversion strategies as well, as you'll see later." -msgstr "JDBCクラス <literal>java.sql.Clob</literal> と <literal>java.sql.Blob</literal> に対する型マッピング。 blobやclobオブジェクトはトランザクションの外では再利用できないため、 アプリケーションによっては不便かもしれません。 （さらにはドライバサポートが一貫していません。）" +#. Tag: para +#: basic_mapping.xml:2528 +#, no-c-format +msgid "" +"The challenge is to map the Java type system (and the developers' definition " +"of entities and value types) to the SQL/database type system. The bridge " +"between both systems is provided by Hibernate: for entities we use " +"<literal>&lt;class&gt;</literal>, <literal>&lt;subclass&gt;</literal> and so " +"on. For value types we use <literal>&lt;property&gt;</literal>, <literal>&lt;" +"component&gt;</literal>, etc, usually with a <literal>type</literal> " +"attribute. The value of this attribute is the name of a Hibernate " +"<emphasis>mapping type</emphasis>. Hibernate provides many mappings (for " +"standard JDK value types) out of the box. You can write your own mapping " +"types and implement your custom conversion strategies as well, as you'll see " +"later." +msgstr "" +"Java型のシステム(もしくは開発者が定義したエンティティと値型)を SQL/データベー" +"ス型のシステムにマッピングすることは難しいです。 Hibernateは２つのシステムの" +"架け橋を提供します。 エンティティに対しては <literal>&lt;class&gt;</literal> " +"や <literal>&lt;subclass&gt;</literal> などを使用します。 値型に対しては " +"<literal>&lt;property&gt;</literal> や <literal>&lt;component&gt;</literal> " +"などを、通常 <literal>type</literal> とともに使います。 この属性の値は" +"Hibernateの <emphasis>マッピング型</emphasis> の名前です。 Hibernateは(標準" +"JDKの値型に対して)多くの自由なマッピングを提供します。 後で見るように、自身の" +"マッピング型を記述し、同様にカスタムの変換戦略を実装することができます。" -#: index.docbook:2541 +#. Tag: para +#: basic_mapping.xml:2541 +#, no-c-format msgid "All built-in Hibernate types except collections support null semantics." -msgstr "imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary" +msgstr "" +"コレクションを除く組み込みのHibernateの型はすべて、nullセマンティクスをサポー" +"トします。" -#: index.docbook:2548 +#. Tag: title +#: basic_mapping.xml:2548 +#, no-c-format msgid "Basic value types" -msgstr "ほとんどの場合に可変であるJavaの型に対する型マッピング。 Hibernateは不変なJavaの型に対しては最適化を行い、 アプリケーションはそれを不変オブジェクトとして扱います。 例えば <literal>imm_timestamp</literal> としてマップしたインスタンスに対して、 <literal>Date.setTime()</literal> を呼び出してはなりません。 プロパティの値を変更しその変更を永続化するためには、 アプリケーションはプロパティに対して新しい(同一でない)オブジェクトを割り当てなければなりません。" +msgstr "基本的な型" -#: index.docbook:2550 -msgid "The built-in <emphasis>basic mapping types</emphasis> may be roughly categorized into" -msgstr "エンティティとコレクションのユニークな識別子は、<literal>binary</literal> , <literal>blob</literal> , <literal>clob</literal> を除く、どんな基本型でも構いません。 （複合識別子でも構いません。以下を見てください。）" +#. Tag: para +#: basic_mapping.xml:2550 +#, fuzzy, no-c-format +msgid "" +"The built-in <emphasis>basic mapping types</emphasis> may be roughly " +"categorized into" +msgstr "" +"組み込みの <emphasis>基本的なマッピング型</emphasis> は大まかに以下のように分" +"けられます。 <placeholder-1/>" -#: index.docbook:2555 -msgid "integer, long, short, float, double, character, byte, boolean, yes_no, true_false" -msgstr "基本的な値型には、<literal>org.hibernate.Hibernate</literal> で定義された <literal>Type</literal> 定数がそれぞれあります。 例えば、<literal>Hibernate.STRING</literal> は <literal>string</literal> 型を表現しています。" +#. Tag: literal +#: basic_mapping.xml:2555 +#, no-c-format +msgid "" +"integer, long, short, float, double, character, byte, boolean, yes_no, " +"true_false" +msgstr "" +"integer, long, short, float, double, character, byte, boolean, yes_no, " +"true_false" -#: index.docbook:2558 -msgid "Type mappings from Java primitives or wrapper classes to appropriate (vendor-specific) SQL column types. <literal>boolean, yes_no</literal> and <literal>true_false</literal> are all alternative encodings for a Java <literal>boolean</literal> or <literal>java.lang.Boolean</literal>." -msgstr "カスタム型" +#. Tag: para +#: basic_mapping.xml:2558 +#, no-c-format +msgid "" +"Type mappings from Java primitives or wrapper classes to appropriate (vendor-" +"specific) SQL column types. <literal>boolean, yes_no</literal> and " +"<literal>true_false</literal> are all alternative encodings for a Java " +"<literal>boolean</literal> or <literal>java.lang.Boolean</literal>." +msgstr "" +"Javaのプリミティブやラッパークラスから適切な（ベンダー固有の） SQLカラム型へ" +"の型マッピング。 <literal>boolean, yes_no</literal> と <literal>true_false</" +"literal> は、 すべてJavaの <literal>boolean</literal> または <literal>java." +"lang.Boolean</literal> の代替エンコードです。" -#: index.docbook:2567 +#. Tag: literal +#: basic_mapping.xml:2567 +#, no-c-format msgid "string" -msgstr "開発者が独自の値型を作成することは、比較的簡単です。 例えば、<literal>java.lang.BigInteger</literal> 型のプロパティを <literal>VARCHAR</literal> カラムに永続化したいかもしれません。 Hibernateはこのための組み込み型を用意していません。 しかしカスタム型は、プロパティ（またはコレクションの要素）を1つのテーブルカラムに マッピングするのに制限はありません。 そのため例えば、<literal>java.lang.String</literal> 型の <literal>getName()</literal> / <literal>setName()</literal> Javaプロパティを <literal>FIRST_NAME</literal> , <literal>INITIAL</literal>, <literal>SURNAME</literal> カラムに永続化できます。" +msgstr "string" -#: index.docbook:2569 -msgid "A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>)." -msgstr "カスタム型を実装するには、<literal>org.hibernate.UserType</literal> または <literal>org.hibernate.CompositeUserType</literal> を実装し、 型の完全修飾された名前を使ってプロパティを定義します。 どのような種類のものが可能かを調べるには、 <literal>org.hibernate.test.DoubleStringType</literal> を確認してください。" +#. Tag: para +#: basic_mapping.xml:2569 +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>)." +msgstr "" +"<literal>java.lang.String</literal> から <literal>VARCHAR</literal> （または" +"Oracleの <literal>VARCHAR2</literal> ）への型マッピング。" -#: index.docbook:2576 +#. Tag: literal +#: basic_mapping.xml:2576 +#, no-c-format msgid "date, time, timestamp" +msgstr "date, time, timestamp" + +#. Tag: para +#: basic_mapping.xml:2578 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Date</literal> and its subclasses to " +"SQL types <literal>DATE</literal>, <literal>TIME</literal> and " +"<literal>TIMESTAMP</literal> (or equivalent)." msgstr "" - "<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test.DoubleStringType\"> -\n" - " <column name=\"first_string\"/> -\n" - " <column name=\"second_string\"/> -\n" - "</property>]]>" +"<literal>java.util.Date</literal> とそのサブクラスからSQL型の <literal>DATE</" +"literal>, <literal>TIME</literal> , <literal>TIMESTAMP</literal> （またはそれ" +"らと等価なもの） への型マッピング。" -#: index.docbook:2578 -msgid "Type mappings from <literal>java.util.Date</literal> and its subclasses to SQL types <literal>DATE</literal>, <literal>TIME</literal> and <literal>TIMESTAMP</literal> (or equivalent)." -msgstr "<literal>&lt;column&gt;</literal> タグで、 プロパティを複数のカラムへマッピングできることに注目してください。" - -#: index.docbook:2586 +#. Tag: literal +#: basic_mapping.xml:2586 +#, no-c-format msgid "calendar, calendar_date" -msgstr "<literal>CompositeUserType</literal> , <literal>EnhancedUserType</literal> , <literal>UserCollectionType</literal> , <literal>UserVersionType</literal> インターフェイスは、より特殊な使用法に対してのサポートを提供します。" +msgstr "calendar, calendar_date" -#: index.docbook:2588 -msgid "Type mappings from <literal>java.util.Calendar</literal> to SQL types <literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." -msgstr "マッピングファイル内で <literal>UserType</literal> へパラメータを提供できます。 このためには、<literal>UserType</literal> は <literal>org.hibernate.usertype.ParameterizedType</literal> を実装しなくてはなりません。 カスタム型パラメータを提供するために、 マッピングファイル内で <literal>&lt;type&gt;</literal> 要素を使用できます。" +#. Tag: para +#: basic_mapping.xml:2588 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Calendar</literal> to SQL types " +"<literal>TIMESTAMP</literal> and <literal>DATE</literal> (or equivalent)." +msgstr "" +"<literal>java.util.Calendar</literal> からSQL型 の「 <literal>TIMESTAMP</" +"literal> , <literal>DATE</literal> (またはそれらと等価なもの）への型マッピン" +"グ。" -#: index.docbook:2596 +#. Tag: literal +#: basic_mapping.xml:2596 +#, no-c-format msgid "big_decimal, big_integer" +msgstr "big_decimal, big_integer" + +#. Tag: para +#: basic_mapping.xml:2598 +#, no-c-format +msgid "" +"Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java." +"math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle " +"<literal>NUMBER</literal>)." msgstr "" - "<![CDATA[<property name=\"priority\"> -\n" - " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\"> -\n" - " <param name=\"default\">0</param> -\n" - " </type> -\n" - "</property>]]>" +"<literal>java.math.BigDecimal</literal> と <literal>java.math.BigInteger</" +"literal> から <literal>NUMERIC</literal>（またはOracleの <literal>NUMBER</" +"literal> ）への型マッピング。" -#: index.docbook:2598 -msgid "Type mappings from <literal>java.math.BigDecimal</literal> and <literal>java.math.BigInteger</literal> to <literal>NUMERIC</literal> (or Oracle <literal>NUMBER</literal>)." -msgstr "<literal>UserType</literal> は、 引数として渡された <literal>Properties</literal> オブジェクトから、 <literal>default</literal> で指定したパラメータに対する値を検索することができます。" - -#: index.docbook:2606 +#. Tag: literal +#: basic_mapping.xml:2606 +#, no-c-format msgid "locale, timezone, currency" -msgstr "特定の <literal>UserType</literal> を頻繁に使用するならば、短い名前を定義すると便利になるでしょう。 <literal>&lt;typedef&gt;</literal> 要素を使ってこのようなことが行えます。 Typedefsはカスタム型に名前を割り当てます。 その型がパラメータを持つならば、 パラメータのデフォルト値のリストを含むこともできます。" +msgstr "locale, timezone, currency" -#: index.docbook:2608 -msgid "Type mappings from <literal>java.util.Locale</literal>, <literal>java.util.TimeZone</literal> and <literal>java.util.Currency</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). Instances of <literal>Locale</literal> and <literal>Currency</literal> are mapped to their ISO codes. Instances of <literal>TimeZone</literal> are mapped to their <literal>ID</literal>." +#. Tag: para +#: basic_mapping.xml:2608 +#, no-c-format +msgid "" +"Type mappings from <literal>java.util.Locale</literal>, <literal>java.util." +"TimeZone</literal> and <literal>java.util.Currency</literal> to " +"<literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). " +"Instances of <literal>Locale</literal> and <literal>Currency</literal> are " +"mapped to their ISO codes. Instances of <literal>TimeZone</literal> are " +"mapped to their <literal>ID</literal>." msgstr "" - "<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" name=\"default_zero\"> -\n" - " <param name=\"default\">0</param> -\n" - "</typedef>]]>" +"<literal>java.util.Locale</literal> , <literal>java.util.TimeZone</" +"literal> , <literal>java.util.Currency</literal> から <literal>VARCHAR</" +"literal> （またはOracleの <literal>VARCHAR2</literal> ）への型マッピング。 " +"<literal>Locale</literal> と <literal>Currency</literal> のインスタンスは、 " +"それらのISOコードにマッピングされます。 <literal>TimeZone</literal> のインス" +"タンスは、 それらの <literal>ID</literal> にマッピングされます。" -#: index.docbook:2620 +#. Tag: literal +#: basic_mapping.xml:2620 +#, fuzzy, no-c-format msgid "<literal>class</literal>" -msgstr "<![CDATA[<property name=\"priority\" type=\"default_zero\"/>]]>" +msgstr "<literal>all</literal> すべてのカラムをチェックします。" -#: index.docbook:2622 -msgid "A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> is mapped to its fully qualified name." -msgstr "プロパティのマッピングで型パラメータを使うことで、 typedefで提供されたパラメータをその都度オーバーライドすることが可能です。" +#. Tag: para +#: basic_mapping.xml:2622 +#, no-c-format +msgid "" +"A type mapping from <literal>java.lang.Class</literal> to <literal>VARCHAR</" +"literal> (or Oracle <literal>VARCHAR2</literal>). A <literal>Class</literal> " +"is mapped to its fully qualified name." +msgstr "" +"<literal>java.lang.Class</literal> から <literal>VARCHAR</literal> （または" +"Oracleの <literal>VARCHAR2</literal> ）への型マッピング。 <literal>Class</" +"literal> はその完全修飾された名前にマッピングされます。" -#: index.docbook:2630 +#. Tag: literal +#: basic_mapping.xml:2630 +#, no-c-format msgid "binary" -msgstr "Hibernateの幅広い組み込み型とコンポーネントに対するサポートは、 カスタム型をめったに <emphasis>使わない</emphasis> ということを意味します。 それでもなお、アプリケーションで頻出する(エンティティではない)クラスに対するカスタム型の使用は、 よいやり方であるとみなされます。 例えば <literal>MonetaryAmount</literal> クラスはコンポーネントとして簡単にマッピングできますが、 <literal>CompositeUserType</literal> の良い候補です。 カスタム型を使用する動機の1つは抽象化です。 カスタム型を使うことで、通貨をどのように表現しようとも マッピングドキュメントは起こりうる変化に対応できます。" +msgstr "binary" -#: index.docbook:2632 +#. Tag: para +#: basic_mapping.xml:2632 +#, no-c-format msgid "Maps byte arrays to an appropriate SQL binary type." -msgstr "１つのクラスに１つ以上のマッピング" +msgstr "バイト配列は、適切なSQLのバイナリ型にマッピングされます。" -#: index.docbook:2638 +#. Tag: literal +#: basic_mapping.xml:2638 +#, no-c-format msgid "text" -msgstr "ある永続クラスに、一つ以上のマッピングを提供することが出来ます。 この場合、マッピングする２つのエンティティのインスタンスを明確にするために、 <emphasis>エンティティ名</emphasis> を指定しなければなりません (デフォルトではエンティティ名はクラス名と同じです。)。 永続オブジェクトを扱うとき、クエリを書き込むとき、 指定されたエンティティへの関連をマッピングするときには、 Hibernateではエンティティ名を指定しなければなりません。" +msgstr "text" -#: index.docbook:2640 -msgid "Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</literal> type." +#. Tag: para +#: basic_mapping.xml:2640 +#, no-c-format +msgid "" +"Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</" +"literal> type." msgstr "" - "<![CDATA[<class name=\"Contract\" table=\"Contracts\" -\n" - " entity-name=\"CurrentContract\"> -\n" - " ... -\n" - " <set name=\"history\" inverse=\"true\" -\n" - " order-by=\"effectiveEndDate desc\"> -\n" - " <key column=\"currentContractId\"/> -\n" - " <one-to-many entity-name=\"HistoricalContract\"/> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Contract\" table=\"ContractHistory\" -\n" - " entity-name=\"HistoricalContract\"> -\n" - " ... -\n" - " <many-to-one name=\"currentContract\" -\n" - " column=\"currentContractId\" -\n" - " entity-name=\"CurrentContract\"/> -\n" - "</class>]]>" +"長いJava文字列は、SQLの <literal>CLOB</literal> または <literal>TEXT</" +"literal> 型にマッピングされます。" -#: index.docbook:2647 +#. Tag: literal +#: basic_mapping.xml:2647 +#, no-c-format msgid "serializable" -msgstr "関連が<literal>class</literal> の代わりに <literal>entity-name</literal> を使って、 どのように指定されるのかに注目してください。" +msgstr "serializable" -#: index.docbook:2649 -msgid "Maps serializable Java types to an appropriate SQL binary type. You may also indicate the Hibernate type <literal>serializable</literal> with the name of a serializable Java class or interface that does not default to a basic type." -msgstr "バッククォートで囲んだ SQL 識別子" +#. Tag: para +#: basic_mapping.xml:2649 +#, no-c-format +msgid "" +"Maps serializable Java types to an appropriate SQL binary type. You may also " +"indicate the Hibernate type <literal>serializable</literal> with the name of " +"a serializable Java class or interface that does not default to a basic type." +msgstr "" +"シリアライズ可能なJava型は、適切なSQLのバイナリ型にマッピングされます。 デ" +"フォルトで基本型ではないシリアライズ可能なJavaクラスや インターフェイスの名前" +"を指定することで、 Hibernateの型を <literal>serializable</literal> とすること" +"もできます。" -#: index.docbook:2658 +#. Tag: literal +#: basic_mapping.xml:2658 +#, no-c-format msgid "clob, blob" -msgstr "マッピングドキュメントでテーブルやカラムの名前をバッククォートで囲むことで、 Hibernateで生成されたSQL中の識別子を引用させることができます。 HibernateはSQLの <literal>Dialect</literal> に対応する、正しい引用スタイルを使います （普通はダブルクォートですが、SQL Serverではかぎ括弧、MySQLではバッククォートです）。" +msgstr "clob, blob" -#: index.docbook:2660 -msgid "Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and <literal>java.sql.Blob</literal>. These types may be inconvenient for some applications, since the blob or clob object may not be reused outside of a transaction. (Furthermore, driver support is patchy and inconsistent.)" +#. Tag: para +#: basic_mapping.xml:2660 +#, no-c-format +msgid "" +"Type mappings for the JDBC classes <literal>java.sql.Clob</literal> and " +"<literal>java.sql.Blob</literal>. These types may be inconvenient for some " +"applications, since the blob or clob object may not be reused outside of a " +"transaction. (Furthermore, driver support is patchy and inconsistent.)" msgstr "" - "<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\"> -\n" - " <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></id> -\n" - " <property name=\"itemNumber\" column=\"`Item #`\"/> -\n" - " ... -\n" - "</class>]]>" +"JDBCクラス <literal>java.sql.Clob</literal> と <literal>java.sql.Blob</" +"literal> に対する型マッピング。 blobやclobオブジェクトはトランザクションの外" +"では再利用できないため、 アプリケーションによっては不便かもしれません。 （さ" +"らにはドライバサポートが一貫していません。）" -#: index.docbook:2670 -msgid "imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary" -msgstr "メタデータの代替手段" +#. Tag: literal +#: basic_mapping.xml:2670 +#, no-c-format +msgid "" +"imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary" +msgstr "" +"imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, " +"imm_serializable, imm_binary" -#: index.docbook:2674 -msgid "Type mappings for what are usually considered mutable Java types, where Hibernate makes certain optimizations appropriate only for immutable Java types, and the application treats the object as immutable. For example, you should not call <literal>Date.setTime()</literal> for an instance mapped as <literal>imm_timestamp</literal>. To change the value of the property, and have that change made persistent, the application must assign a new (nonidentical) object to the property." -msgstr "XMLの記述以外に、 HibernateではO/Rマッピングのメタデータを定義する代替方法があります。" +#. Tag: para +#: basic_mapping.xml:2674 +#, no-c-format +msgid "" +"Type mappings for what are usually considered mutable Java types, where " +"Hibernate makes certain optimizations appropriate only for immutable Java " +"types, and the application treats the object as immutable. For example, you " +"should not call <literal>Date.setTime()</literal> for an instance mapped as " +"<literal>imm_timestamp</literal>. To change the value of the property, and " +"have that change made persistent, the application must assign a new " +"(nonidentical) object to the property." +msgstr "" +"ほとんどの場合に可変であるJavaの型に対する型マッピング。 Hibernateは不変な" +"Javaの型に対しては最適化を行い、 アプリケーションはそれを不変オブジェクトとし" +"て扱います。 例えば <literal>imm_timestamp</literal> としてマップしたインスタ" +"ンスに対して、 <literal>Date.setTime()</literal> を呼び出してはなりません。 " +"プロパティの値を変更しその変更を永続化するためには、 アプリケーションはプロパ" +"ティに対して新しい(同一でない)オブジェクトを割り当てなければなりません。" -#: index.docbook:2689 -msgid "Unique identifiers of entities and collections may be of any basic type except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</literal>. (Composite identifiers are also allowed, see below.)" -msgstr "XDoclet マークアップの使用" +#. Tag: para +#: basic_mapping.xml:2689 +#, no-c-format +msgid "" +"Unique identifiers of entities and collections may be of any basic type " +"except <literal>binary</literal>, <literal>blob</literal> and <literal>clob</" +"literal>. (Composite identifiers are also allowed, see below.)" +msgstr "" +"エンティティとコレクションのユニークな識別子は、<literal>binary</literal> , " +"<literal>blob</literal> , <literal>clob</literal> を除く、どんな基本型でも構" +"いません。 （複合識別子でも構いません。以下を見てください。）" -#: index.docbook:2695 -msgid "The basic value types have corresponding <literal>Type</literal> constants defined on <literal>org.hibernate.Hibernate</literal>. For example, <literal>Hibernate.STRING</literal> represents the <literal>string</literal> type." -msgstr "多くのHibernateユーザはXDocletの <literal&gt;(a)hibernate.tags&lt;/literal&gt; を使って、 ソースコード内に直接マッピング情報を埋め込むことを好みます。 これは厳密に言えばXDocletの分野なので、本ドキュメントではこの方法を対象とはしません。 しかしXDocletを使った以下の <literal>Cat</literal> マッピングの例を示します。" +#. Tag: para +#: basic_mapping.xml:2695 +#, no-c-format +msgid "" +"The basic value types have corresponding <literal>Type</literal> constants " +"defined on <literal>org.hibernate.Hibernate</literal>. For example, " +"<literal>Hibernate.STRING</literal> represents the <literal>string</literal> " +"type." +msgstr "" +"基本的な値型には、<literal>org.hibernate.Hibernate</literal> で定義された " +"<literal>Type</literal> 定数がそれぞれあります。 例えば、<literal>Hibernate." +"STRING</literal> は <literal>string</literal> 型を表現しています。" -#: index.docbook:2704 +#. Tag: title +#: basic_mapping.xml:2704 +#, no-c-format msgid "Custom value types" +msgstr "カスタム型" + +#. Tag: para +#: basic_mapping.xml:2706 +#, no-c-format +msgid "" +"It is relatively easy for developers to create their own value types. For " +"example, you might want to persist properties of type <literal>java.lang." +"BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does " +"not provide a built-in type for this. But custom types are not limited to " +"mapping a property (or collection element) to a single table column. So, for " +"example, you might have a Java property <literal>getName()</literal>/" +"<literal>setName()</literal> of type <literal>java.lang.String</literal> " +"that is persisted to the columns <literal>FIRST_NAME</literal>, " +"<literal>INITIAL</literal>, <literal>SURNAME</literal>." msgstr "" - "<![CDATA[package eg; -\n" - "import java.util.Set; -\n" - "import java.util.Date; -\n" - " -\n" - "/** -\n" - " * @hibernate.class -\n" - " * table=\"CATS\" -\n" - " */ -\n" - "public class Cat { -\n" - " private Long id; // identifier -\n" - " private Date birthdate; -\n" - " private Cat mother; -\n" - " private Set kittens -\n" - " private Color color; -\n" - " private char sex; -\n" - " private float weight; -\n" - " -\n" - " /* -\n" - " * @hibernate.id -\n" - " * generator-class=\"native\" -\n" - " * column=\"CAT_ID\" -\n" - " */ -\n" - " public Long getId() { -\n" - " return id; -\n" - " } -\n" - " private void setId(Long id) { -\n" - " this.id=id; -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.many-to-one -\n" - " * column=\"PARENT_ID\" -\n" - " */ -\n" - " public Cat getMother() { -\n" - " return mother; -\n" - " } -\n" - " void setMother(Cat mother) { -\n" - " this.mother = mother; -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"BIRTH_DATE\" -\n" - " */ -\n" - " public Date getBirthdate() { -\n" - " return birthdate; -\n" - " } -\n" - " void setBirthdate(Date date) { -\n" - " birthdate = date; -\n" - " } -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"WEIGHT\" -\n" - " */ -\n" - " public float getWeight() { -\n" - " return weight; -\n" - " } -\n" - " void setWeight(float weight) { -\n" - " this.weight = weight; -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"COLOR\" -\n" - " * not-null=\"true\" -\n" - " */ -\n" - " public Color getColor() { -\n" - " return color; -\n" - " } -\n" - " void setColor(Color color) { -\n" - " this.color = color; -\n" - " } -\n" - " /** -\n" - " * @hibernate.set -\n" - " * inverse=\"true\" -\n" - " * order-by=\"BIRTH_DATE\" -\n" - " * @hibernate.collection-key -\n" - " * column=\"PARENT_ID\" -\n" - " * @hibernate.collection-one-to-many -\n" - " */ -\n" - " public Set getKittens() { -\n" - " return kittens; -\n" - " } -\n" - " void setKittens(Set kittens) { -\n" - " this.kittens = kittens; -\n" - " } -\n" - " // addKitten not needed by Hibernate -\n" - " public void addKitten(Cat kitten) { -\n" - " kittens.add(kitten); -\n" - " } -\n" - " -\n" - " /** -\n" - " * @hibernate.property -\n" - " * column=\"SEX\" -\n" - " * not-null=\"true\" -\n" - " * update=\"false\" -\n" - " */ -\n" - " public char getSex() { -\n" - " return sex; -\n" - " } -\n" - " void setSex(char sex) { -\n" - " this.sex=sex; -\n" - " } -\n" - "}]]>" +"開発者が独自の値型を作成することは、比較的簡単です。 例えば、<literal>java." +"lang.BigInteger</literal> 型のプロパティを <literal>VARCHAR</literal> カラム" +"に永続化したいかもしれません。 Hibernateはこのための組み込み型を用意していま" +"せん。 しかしカスタム型は、プロパティ（またはコレクションの要素）を1つのテー" +"ブルカラムに マッピングするのに制限はありません。 そのため例えば、" +"<literal>java.lang.String</literal> 型の <literal>getName()</literal> / " +"<literal>setName()</literal> Javaプロパティを <literal>FIRST_NAME</" +"literal> , <literal>INITIAL</literal>, <literal>SURNAME</literal> カラムに永" +"続化できます。" -#: index.docbook:2706 -msgid "It is relatively easy for developers to create their own value types. For example, you might want to persist properties of type <literal>java.lang.BigInteger</literal> to <literal>VARCHAR</literal> columns. Hibernate does not provide a built-in type for this. But custom types are not limited to mapping a property (or collection element) to a single table column. So, for example, you might have a Java property <literal>getName()</literal>/<literal>setName()</literal> of type <literal>java.lang.String</literal> that is persisted to the columns <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, <literal>SURNAME</literal>." -msgstr "Hibernateのウェブサイトには、XDocletとHibernateに関するサンプルが多数あります。" +#. Tag: para +#: basic_mapping.xml:2717 +#, no-c-format +msgid "" +"To implement a custom type, implement either <literal>org.hibernate." +"UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and " +"declare properties using the fully qualified classname of the type. Check " +"out <literal>org.hibernate.test.DoubleStringType</literal> to see the kind " +"of things that are possible." +msgstr "" +"カスタム型を実装するには、<literal>org.hibernate.UserType</literal> または " +"<literal>org.hibernate.CompositeUserType</literal> を実装し、 型の完全修飾さ" +"れた名前を使ってプロパティを定義します。 どのような種類のものが可能かを調べる" +"には、 <literal>org.hibernate.test.DoubleStringType</literal> を確認してくだ" +"さい。" -#: index.docbook:2717 -msgid "To implement a custom type, implement either <literal>org.hibernate.UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> and declare properties using the fully qualified classname of the type. Check out <literal>org.hibernate.test.DoubleStringType</literal> to see the kind of things that are possible." -msgstr "JDK 5.0 アノテーションの使用" +#. Tag: programlisting +#: basic_mapping.xml:2725 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test." +"DoubleStringType\">\n" +" <column name=\"first_string\"/>\n" +" <column name=\"second_string\"/>\n" +"</property>]]>" +msgstr "" -#: index.docbook:2725 +#. Tag: para +#: basic_mapping.xml:2727 +#, no-c-format msgid "" - "<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test.DoubleStringType\">\n" - " <column name=\"first_string\"/>\n" - " <column name=\"second_string\"/>\n" - "</property>]]>" -msgstr "JDK5.0ではタイプセーフかつコンパイル時にチェックできる、 言語レベルのXDocletスタイルのアノテーションを導入しました。 このメカニズムはXDocletのアノテーションよりも強力で、ツールやIDEも多くがサポートしています。 例えばIntelliJ IDEAは、JDK5.0にアノテーションの自動補完と構文の強調表示をサポートしています。 EJB仕様 (JSR-220)の新しいバージョンでは、エンティティビーンに対する主要なメタデータメカニズムとして JDK5.0のアノテーションを使用しています。 Hibernate3ではJSR-220 (永続化API)の <literal>EntityManager</literal> を実装し、 メタデータマッピングに対するサポートは、 別ダウンロードの <emphasis>Hibernate Annotations</emphasis> パッケージにより利用可能です。 これはEJB3(JSR-220)とHibernate3のメタデータをどちらもサポート! しています。" +"Notice the use of <literal>&lt;column&gt;</literal> tags to map a property " +"to multiple columns." +msgstr "" +"<literal>&lt;column&gt;</literal> タグで、 プロパティを複数のカラムへマッピン" +"グできることに注目してください。" -#: index.docbook:2727 -msgid "Notice the use of <literal>&lt;column&gt;</literal> tags to map a property to multiple columns." -msgstr "以下はEJBのエンティティビーンとして注釈されたPOJOクラスの例です。" +#. Tag: para +#: basic_mapping.xml:2732 +#, no-c-format +msgid "" +"The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</" +"literal>, <literal>UserCollectionType</literal>, and " +"<literal>UserVersionType</literal> interfaces provide support for more " +"specialized uses." +msgstr "" +"<literal>CompositeUserType</literal> , <literal>EnhancedUserType</literal> , " +"<literal>UserCollectionType</literal> , <literal>UserVersionType</literal> イ" +"ンターフェイスは、より特殊な使用法に対してのサポートを提供します。" -#: index.docbook:2732 -msgid "The <literal>CompositeUserType</literal>, <literal>EnhancedUserType</literal>, <literal>UserCollectionType</literal>, and <literal>UserVersionType</literal> interfaces provide support for more specialized uses." +#. Tag: para +#: basic_mapping.xml:2738 +#, no-c-format +msgid "" +"You may even supply parameters to a <literal>UserType</literal> in the " +"mapping file. To do this, your <literal>UserType</literal> must implement " +"the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. " +"To supply parameters to your custom type, you can use the <literal>&lt;" +"type&gt;</literal> element in your mapping files." msgstr "" - "<![CDATA[@Entity(access = AccessType.FIELD) -\n" - "public class Customer implements Serializable { -\n" - " -\n" - " @Id; -\n" - " Long id; -\n" - " -\n" - " String firstName; -\n" - " String lastName; -\n" - " Date birthday; -\n" - " -\n" - " @Transient -\n" - " Integer age; -\n" - " -\n" - " @Embedded -\n" - " private Address homeAddress; -\n" - " -\n" - " @OneToMany(cascade=CascadeType.ALL) -\n" - " @JoinColumn(name=\"CUSTOMER_ID\") -\n" - " Set<Order> orders; -\n" - " -\n" - " // Getter/setter and business methods -\n" - "}]]>" +"マッピングファイル内で <literal>UserType</literal> へパラメータを提供できま" +"す。 このためには、<literal>UserType</literal> は <literal>org.hibernate." +"usertype.ParameterizedType</literal> を実装しなくてはなりません。 カスタム型" +"パラメータを提供するために、 マッピングファイル内で <literal>&lt;type&gt;</" +"literal> 要素を使用できます。" -#: index.docbook:2738 -msgid "You may even supply parameters to a <literal>UserType</literal> in the mapping file. To do this, your <literal>UserType</literal> must implement the <literal>org.hibernate.usertype.ParameterizedType</literal> interface. To supply parameters to your custom type, you can use the <literal>&lt;type&gt;</literal> element in your mapping files." -msgstr "JDK5.0のアノテーション(とJSR-220)のサポートは進行中の作業であり、完全ではないことに注意してください。 さらに詳しい情報はHibernateのアノテーション・モジュールを参照してください。" +#. Tag: programlisting +#: basic_mapping.xml:2746 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"priority\">\n" +" <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" +" <param name=\"default\">0</param>\n" +" </type>\n" +"</property>]]>" +msgstr "" -#: index.docbook:2746 +#. Tag: para +#: basic_mapping.xml:2748 +#, no-c-format msgid "" - "<![CDATA[<property name=\"priority\">\n" - " <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n" - " <param name=\"default\">0</param>\n" - " </type>\n" - "</property>]]>" -msgstr "生成プロパティ" +"The <literal>UserType</literal> can now retrieve the value for the parameter " +"named <literal>default</literal> from the <literal>Properties</literal> " +"object passed to it." +msgstr "" +"<literal>UserType</literal> は、 引数として渡された <literal>Properties</" +"literal> オブジェクトから、 <literal>default</literal> で指定したパラメータに" +"対する値を検索することができます。" -#: index.docbook:2748 -msgid "The <literal>UserType</literal> can now retrieve the value for the parameter named <literal>default</literal> from the <literal>Properties</literal> object passed to it." -msgstr "生成プロパティとは、データベースによって生成された値を持つプロパティです。 通常、Hibernateアプリケーションは、データベースが値を生成したプロパティを含むオブジェクトを <literal>リフレッシュ</literal> する必要がありました。 しかし、プロパティが生成されたということをマークすることで、 アプリケーションはリフレッシュの責任をHibernateに委譲します。 基本的に、生成プロパティを持つと定義したエンティティに対して HibernateがINSERTやUPDATEのSQLを発行した後すぐに、 生成された値を読み込むための SELECT SQL が発行されます。" +#. Tag: para +#: basic_mapping.xml:2753 +#, no-c-format +msgid "" +"If you use a certain <literal>UserType</literal> very often, it may be " +"useful to define a shorter name for it. You can do this using the " +"<literal>&lt;typedef&gt;</literal> element. Typedefs assign a name to a " +"custom type, and may also contain a list of default parameter values if the " +"type is parameterized." +msgstr "" +"特定の <literal>UserType</literal> を頻繁に使用するならば、短い名前を定義する" +"と便利になるでしょう。 <literal>&lt;typedef&gt;</literal> 要素を使ってこのよ" +"うなことが行えます。 Typedefsはカスタム型に名前を割り当てます。 その型がパラ" +"メータを持つならば、 パラメータのデフォルト値のリストを含むこともできます。" -#: index.docbook:2753 -msgid "If you use a certain <literal>UserType</literal> very often, it may be useful to define a shorter name for it. You can do this using the <literal>&lt;typedef&gt;</literal> element. Typedefs assign a name to a custom type, and may also contain a list of default parameter values if the type is parameterized." -msgstr "生成プロパティは、挿入不可能かつ更新不可能でなければなりません。 <xref linkend=\"mapping-declaration-version\"/>versions 、 <xref linkend=\"mapping-declaration-timestamp\"/>timestamps 、 <xref linkend=\"mapping-declaration-property\"/>simple properties だけが生成されたとマークできます。" - -#: index.docbook:2760 +#. Tag: programlisting +#: basic_mapping.xml:2760 +#, no-c-format msgid "" - "<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" name=\"default_zero\">\n" - " <param name=\"default\">0</param>\n" - "</typedef>]]>" -msgstr "<literal>never</literal> (デフォルト) - 与えられたプロパティの値は、 データベースから生成されないことを意味します。" +"<![CDATA[<typedef class=\"com.mycompany.usertypes.DefaultValueIntegerType\" " +"name=\"default_zero\">\n" +" <param name=\"default\">0</param>\n" +"</typedef>]]>" +msgstr "" -#: index.docbook:2762 +#. Tag: programlisting +#: basic_mapping.xml:2762 +#, no-c-format msgid "<![CDATA[<property name=\"priority\" type=\"default_zero\"/>]]>" -msgstr "<literal>insert</literal> - 与えられたプロパティの値は挿入時に生成されるが、 続いて起こる更新時には生成されないこと示します。 作成された日付などは、このカテゴリに分類されます。 <xref linkend=\"mapping-declaration-version\"/>version や <xref linkend=\"mapping-declaration-timestamp\"/>timestamp の プロパティは生成されたとマークできますが、このオプションは利用できないことに注意してください。" +msgstr "" -#: index.docbook:2764 -msgid "It is also possible to override the parameters supplied in a typedef on a case-by-case basis by using type parameters on the property mapping." -msgstr "<literal>always</literal> - 挿入時も更新時もプロパティの値が生成されることを示します。" +#. Tag: para +#: basic_mapping.xml:2764 +#, no-c-format +msgid "" +"It is also possible to override the parameters supplied in a typedef on a " +"case-by-case basis by using type parameters on the property mapping." +msgstr "" +"プロパティのマッピングで型パラメータを使うことで、 typedefで提供されたパラ" +"メータをその都度オーバーライドすることが可能です。" -#: index.docbook:2769 -msgid "Even though Hibernate's rich range of built-in types and support for components means you will very rarely <emphasis>need</emphasis> to use a custom type, it is nevertheless considered good form to use custom types for (non-entity) classes that occur frequently in your application. For example, a <literal>MonetaryAmount</literal> class is a good candidate for a <literal>CompositeUserType</literal>, even though it could easily be mapped as a component. One motivation for this is abstraction. With a custom type, your mapping documents would be future-proofed against possible changes in your way of representing monetary values." -msgstr "補助的なデータベース・オブジェクト" +#. Tag: para +#: basic_mapping.xml:2769 +#, no-c-format +msgid "" +"Even though Hibernate's rich range of built-in types and support for " +"components means you will very rarely <emphasis>need</emphasis> to use a " +"custom type, it is nevertheless considered good form to use custom types for " +"(non-entity) classes that occur frequently in your application. For example, " +"a <literal>MonetaryAmount</literal> class is a good candidate for a " +"<literal>CompositeUserType</literal>, even though it could easily be mapped " +"as a component. One motivation for this is abstraction. With a custom type, " +"your mapping documents would be future-proofed against possible changes in " +"your way of representing monetary values." +msgstr "" +"Hibernateの幅広い組み込み型とコンポーネントに対するサポートは、 カスタム型を" +"めったに <emphasis>使わない</emphasis> ということを意味します。 それでもな" +"お、アプリケーションで頻出する(エンティティではない)クラスに対するカスタム型" +"の使用は、 よいやり方であるとみなされます。 例えば <literal>MonetaryAmount</" +"literal> クラスはコンポーネントとして簡単にマッピングできますが、 " +"<literal>CompositeUserType</literal> の良い候補です。 カスタム型を使用する動" +"機の1つは抽象化です。 カスタム型を使うことで、通貨をどのように表現しようとも " +"マッピングドキュメントは起こりうる変化に対応できます。" -#: index.docbook:2785 +#. Tag: title +#: basic_mapping.xml:2785 +#, no-c-format msgid "Mapping a class more than once" -msgstr "Hibernateのスキーマ・エボリューションツールと連動することで、 任意のデータベース・オブジェクト（トリガーやストアドプロシージャなど）のCREATEとDROPにより、 Hibernateのマッピングファイル内のユーザ・スキーマをすべて定義することが出来ます。 主にトリガやストアドプロシージャのようなデータベース・オブジェクトを生成や削除することを意図していますが、 実際には <literal>java.sql.Statement.execute()</literal> メソッドによって実行できる 任意のSQLコマンド（ALTER、INSERTなど）が実行できます。 補助的なデータベース・オブジェクトを定義するための、2つの基本的な方法があります。" +msgstr "１つのクラスに１つ以上のマッピング" -#: index.docbook:2786 -msgid "It is possible to provide more than one mapping for a particular persistent class. In this case you must specify an <emphasis>entity name</emphasis> do disambiguate between instances of the two mapped entities. (By default, the entity name is the same as the class name.) Hibernate lets you specify the entity name when working with persistent objects, when writing queries, or when mapping associations to the named entity." -msgstr "1つ目の方法は、CREATEとDROPコマンドをマッピングファイルの外に、明示的に記載することです。" +#. Tag: para +#: basic_mapping.xml:2786 +#, no-c-format +msgid "" +"It is possible to provide more than one mapping for a particular persistent " +"class. In this case you must specify an <emphasis>entity name</emphasis> do " +"disambiguate between instances of the two mapped entities. (By default, the " +"entity name is the same as the class name.) Hibernate lets you specify the " +"entity name when working with persistent objects, when writing queries, or " +"when mapping associations to the named entity." +msgstr "" +"ある永続クラスに、一つ以上のマッピングを提供することが出来ます。 この場合、" +"マッピングする２つのエンティティのインスタンスを明確にするために、 <emphasis>" +"エンティティ名</emphasis> を指定しなければなりません (デフォルトではエンティ" +"ティ名はクラス名と同じです。)。 永続オブジェクトを扱うとき、クエリを書き込む" +"とき、 指定されたエンティティへの関連をマッピングするときには、 Hibernateでは" +"エンティティ名を指定しなければなりません。" -#: index.docbook:2794 +#. Tag: programlisting +#: basic_mapping.xml:2794 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" - " entity-name=\"CurrentContract\">\n" - " ...\n" - " <set name=\"history\" inverse=\"true\"\n" - " order-by=\"effectiveEndDate desc\">\n" - " <key column=\"currentContractId\"/>\n" - " <one-to-many entity-name=\"HistoricalContract\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Contract\" table=\"ContractHistory\"\n" - " entity-name=\"HistoricalContract\">\n" - " ...\n" - " <many-to-one name=\"currentContract\"\n" - " column=\"currentContractId\"\n" - " entity-name=\"CurrentContract\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Contract\" table=\"Contracts\"\n" +" entity-name=\"CurrentContract\">\n" +" ...\n" +" <set name=\"history\" inverse=\"true\"\n" +" order-by=\"effectiveEndDate desc\">\n" +" <key column=\"currentContractId\"/>\n" +" <one-to-many entity-name=\"HistoricalContract\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Contract\" table=\"ContractHistory\"\n" +" entity-name=\"HistoricalContract\">\n" +" ...\n" +" <many-to-one name=\"currentContract\"\n" +" column=\"currentContractId\"\n" +" entity-name=\"CurrentContract\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " ... -\n" - " <database-object> -\n" - " <create>CREATE TRIGGER my_trigger ...</create> -\n" - " <drop>DROP TRIGGER my_trigger</drop> -\n" - " </database-object> -\n" - "</hibernate-mapping>]]>" -#: index.docbook:2796 -msgid "Notice how associations are now specified using <literal>entity-name</literal> instead of <literal>class</literal>." -msgstr "2つ目の方法は、CREATEとDROPコマンドの組み立て方を知っているカスタムクラスを提供することです。 このカスタムクラスは <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> インタフェースを 実装しなければなりません。" +#. Tag: para +#: basic_mapping.xml:2796 +#, no-c-format +msgid "" +"Notice how associations are now specified using <literal>entity-name</" +"literal> instead of <literal>class</literal>." +msgstr "" +"関連が<literal>class</literal> の代わりに <literal>entity-name</literal> を" +"使って、 どのように指定されるのかに注目してください。" -#: index.docbook:2804 +#. Tag: title +#: basic_mapping.xml:2804 +#, no-c-format msgid "SQL quoted identifiers" +msgstr "バッククォートで囲んだ SQL 識別子" + +#. Tag: para +#: basic_mapping.xml:2805 +#, no-c-format +msgid "" +"You may force Hibernate to quote an identifier in the generated SQL by " +"enclosing the table or column name in backticks in the mapping document. " +"Hibernate will use the correct quotation style for the SQL <literal>Dialect</" +"literal> (usually double quotes, but brackets for SQL Server and backticks " +"for MySQL)." msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " ... -\n" - " <database-object> -\n" - " <definition class=\"MyTriggerDefinition\"/> -\n" - " </database-object> -\n" - "</hibernate-mapping>]]>" +"マッピングドキュメントでテーブルやカラムの名前をバッククォートで囲むことで、 " +"Hibernateで生成されたSQL中の識別子を引用させることができます。 HibernateはSQL" +"の <literal>Dialect</literal> に対応する、正しい引用スタイルを使います （普通" +"はダブルクォートですが、SQL Serverではかぎ括弧、MySQLではバッククォートで" +"す）。" -#: index.docbook:2805 -msgid "You may force Hibernate to quote an identifier in the generated SQL by enclosing the table or column name in backticks in the mapping document. Hibernate will use the correct quotation style for the SQL <literal>Dialect</literal> (usually double quotes, but brackets for SQL Server and backticks for MySQL)." -msgstr "さらに、あるデータベース方言が使用される時にだけ適用するといったように、 データベース・オブジェクトが使われるケースを限定できます。" - -#: index.docbook:2812 +#. Tag: programlisting +#: basic_mapping.xml:2812 +#, no-c-format msgid "" - "<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" - " <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></id>\n" - " <property name=\"itemNumber\" column=\"`Item #`\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"LineItem\" table=\"`Line Item`\">\n" +" <id name=\"id\" column=\"`Item Id`\"/><generator class=\"assigned\"/></" +"id>\n" +" <property name=\"itemNumber\" column=\"`Item #`\"/>\n" +" ...\n" +"</class>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " ... -\n" - " <database-object> -\n" - " <definition class=\"MyTriggerDefinition\"/> -\n" - " <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/> -\n" - " <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/> -\n" - " </database-object> -\n" - "</hibernate-mapping>]]>" -#: index.docbook:2818 +#. Tag: title +#: basic_mapping.xml:2818 +#, no-c-format msgid "Metadata alternatives" -msgstr "" +msgstr "メタデータの代替手段" -#: index.docbook:2820 -msgid "XML isn't for everyone, and so there are some alternative ways to define O/R mapping metadata in Hibernate." +#. Tag: para +#: basic_mapping.xml:2820 +#, no-c-format +msgid "" +"XML isn't for everyone, and so there are some alternative ways to define O/R " +"mapping metadata in Hibernate." msgstr "" +"XMLの記述以外に、 HibernateではO/Rマッピングのメタデータを定義する代替方法が" +"あります。" -#: index.docbook:2825 +#. Tag: title +#: basic_mapping.xml:2825 +#, no-c-format msgid "Using XDoclet markup" -msgstr "" +msgstr "XDoclet マークアップの使用" -#: index.docbook:2827 -msgid "Many Hibernate users prefer to embed mapping information directly in sourcecode using XDoclet <literal&gt;(a)hibernate.tags&lt;/literal&gt;. We will not cover this approach in this document, since strictly it is considered part of XDoclet. However, we include the following example of the <literal>Cat</literal> class with XDoclet mappings." +#. Tag: para +#: basic_mapping.xml:2827 +#, no-c-format +msgid "" +"Many Hibernate users prefer to embed mapping information directly in " +"sourcecode using XDoclet <literal&gt;(a)hibernate.tags&lt;/literal&gt;. We will not " +"cover this approach in this document, since strictly it is considered part " +"of XDoclet. However, we include the following example of the <literal>Cat</" +"literal> class with XDoclet mappings." msgstr "" +"多くのHibernateユーザはXDocletの <literal&gt;(a)hibernate.tags&lt;/literal&gt; を使っ" +"て、 ソースコード内に直接マッピング情報を埋め込むことを好みます。 これは厳密" +"に言えばXDocletの分野なので、本ドキュメントではこの方法を対象とはしません。 " +"しかしXDocletを使った以下の <literal>Cat</literal> マッピングの例を示します。" -#: index.docbook:2834 +#. Tag: programlisting +#: basic_mapping.xml:2834 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "import java.util.Date;\n" - "\n" - "/**\n" - " * @hibernate.class\n" - " * table=\"CATS\"\n" - " */\n" - "public class Cat {\n" - " private Long id; // identifier\n" - " private Date birthdate;\n" - " private Cat mother;\n" - " private Set kittens\n" - " private Color color;\n" - " private char sex;\n" - " private float weight;\n" - "\n" - " /*\n" - " * @hibernate.id\n" - " * generator-class=\"native\"\n" - " * column=\"CAT_ID\"\n" - " */\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - " private void setId(Long id) {\n" - " this.id=id;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.many-to-one\n" - " * column=\"PARENT_ID\"\n" - " */\n" - " public Cat getMother() {\n" - " return mother;\n" - " }\n" - " void setMother(Cat mother) {\n" - " this.mother = mother;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"BIRTH_DATE\"\n" - " */\n" - " public Date getBirthdate() {\n" - " return birthdate;\n" - " }\n" - " void setBirthdate(Date date) {\n" - " birthdate = date;\n" - " }\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"WEIGHT\"\n" - " */\n" - " public float getWeight() {\n" - " return weight;\n" - " }\n" - " void setWeight(float weight) {\n" - " this.weight = weight;\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"COLOR\"\n" - " * not-null=\"true\"\n" - " */\n" - " public Color getColor() {\n" - " return color;\n" - " }\n" - " void setColor(Color color) {\n" - " this.color = color;\n" - " }\n" - " /**\n" - " * @hibernate.set\n" - " * inverse=\"true\"\n" - " * order-by=\"BIRTH_DATE\"\n" - " * @hibernate.collection-key\n" - " * column=\"PARENT_ID\"\n" - " * @hibernate.collection-one-to-many\n" - " */\n" - " public Set getKittens() {\n" - " return kittens;\n" - " }\n" - " void setKittens(Set kittens) {\n" - " this.kittens = kittens;\n" - " }\n" - " // addKitten not needed by Hibernate\n" - " public void addKitten(Cat kitten) {\n" - " kittens.add(kitten);\n" - " }\n" - "\n" - " /**\n" - " * @hibernate.property\n" - " * column=\"SEX\"\n" - " * not-null=\"true\"\n" - " * update=\"false\"\n" - " */\n" - " public char getSex() {\n" - " return sex;\n" - " }\n" - " void setSex(char sex) {\n" - " this.sex=sex;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"import java.util.Date;\n" +"\n" +"/**\n" +" * @hibernate.class\n" +" * table=\"CATS\"\n" +" */\n" +"public class Cat {\n" +" private Long id; // identifier\n" +" private Date birthdate;\n" +" private Cat mother;\n" +" private Set kittens\n" +" private Color color;\n" +" private char sex;\n" +" private float weight;\n" +"\n" +" /*\n" +" * @hibernate.id\n" +" * generator-class=\"native\"\n" +" * column=\"CAT_ID\"\n" +" */\n" +" public Long getId() {\n" +" return id;\n" +" }\n" +" private void setId(Long id) {\n" +" this.id=id;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.many-to-one\n" +" * column=\"PARENT_ID\"\n" +" */\n" +" public Cat getMother() {\n" +" return mother;\n" +" }\n" +" void setMother(Cat mother) {\n" +" this.mother = mother;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"BIRTH_DATE\"\n" +" */\n" +" public Date getBirthdate() {\n" +" return birthdate;\n" +" }\n" +" void setBirthdate(Date date) {\n" +" birthdate = date;\n" +" }\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"WEIGHT\"\n" +" */\n" +" public float getWeight() {\n" +" return weight;\n" +" }\n" +" void setWeight(float weight) {\n" +" this.weight = weight;\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"COLOR\"\n" +" * not-null=\"true\"\n" +" */\n" +" public Color getColor() {\n" +" return color;\n" +" }\n" +" void setColor(Color color) {\n" +" this.color = color;\n" +" }\n" +" /**\n" +" * @hibernate.set\n" +" * inverse=\"true\"\n" +" * order-by=\"BIRTH_DATE\"\n" +" * @hibernate.collection-key\n" +" * column=\"PARENT_ID\"\n" +" * @hibernate.collection-one-to-many\n" +" */\n" +" public Set getKittens() {\n" +" return kittens;\n" +" }\n" +" void setKittens(Set kittens) {\n" +" this.kittens = kittens;\n" +" }\n" +" // addKitten not needed by Hibernate\n" +" public void addKitten(Cat kitten) {\n" +" kittens.add(kitten);\n" +" }\n" +"\n" +" /**\n" +" * @hibernate.property\n" +" * column=\"SEX\"\n" +" * not-null=\"true\"\n" +" * update=\"false\"\n" +" */\n" +" public char getSex() {\n" +" return sex;\n" +" }\n" +" void setSex(char sex) {\n" +" this.sex=sex;\n" +" }\n" +"}]]>" msgstr "" -#: index.docbook:2836 +#. Tag: para +#: basic_mapping.xml:2836 +#, no-c-format msgid "See the Hibernate web site for more examples of XDoclet and Hibernate." msgstr "" +"Hibernateのウェブサイトには、XDocletとHibernateに関するサンプルが多数ありま" +"す。" -#: index.docbook:2843 +#. Tag: title +#: basic_mapping.xml:2843 +#, no-c-format msgid "Using JDK 5.0 Annotations" -msgstr "" +msgstr "JDK 5.0 アノテーションの使用" -#: index.docbook:2845 -msgid "JDK 5.0 introduced XDoclet-style annotations at the language level, type-safe and checked at compile time. This mechnism is more powerful than XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, for example, supports auto-completion and syntax highlighting of JDK 5.0 annotations. The new revision of the EJB specification (JSR-220) uses JDK 5.0 annotations as the primary metadata mechanism for entity beans. Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the persistence API), support for mapping metadata is available via the <emphasis>Hibernate Annotations</emphasis> package, as a separate download. Both EJB3 (JSR-220) and Hibernate3 metadata is supported." +#. Tag: para +#: basic_mapping.xml:2845 +#, no-c-format +msgid "" +"JDK 5.0 introduced XDoclet-style annotations at the language level, type-" +"safe and checked at compile time. This mechnism is more powerful than " +"XDoclet annotations and better supported by tools and IDEs. IntelliJ IDEA, " +"for example, supports auto-completion and syntax highlighting of JDK 5.0 " +"annotations. The new revision of the EJB specification (JSR-220) uses JDK " +"5.0 annotations as the primary metadata mechanism for entity beans. " +"Hibernate3 implements the <literal>EntityManager</literal> of JSR-220 (the " +"persistence API), support for mapping metadata is available via the " +"<emphasis>Hibernate Annotations</emphasis> package, as a separate download. " +"Both EJB3 (JSR-220) and Hibernate3 metadata is supported." msgstr "" +"JDK5.0ではタイプセーフかつコンパイル時にチェックできる、 言語レベルのXDoclet" +"スタイルのアノテーションを導入しました。 このメカニズムはXDocletのアノテー" +"ションよりも強力で、ツールやIDEも多くがサポートしています。 例えばIntelliJ " +"IDEAは、JDK5.0にアノテーションの自動補完と構文の強調表示をサポートしていま" +"す。 EJB仕様 (JSR-220)の新しいバージョンでは、エンティティビーンに対する主要" +"なメタデータメカニズムとして JDK5.0のアノテーションを使用しています。 " +"Hibernate3ではJSR-220 (永続化API)の <literal>EntityManager</literal> を実装" +"し、 メタデータマッピングに対するサポートは、 別ダウンロードの " +"<emphasis>Hibernate Annotations</emphasis> パッケージにより利用可能です。 こ" +"れはEJB3(JSR-220)とHibernate3のメタデータをどちらもサポートしています。" -#: index.docbook:2856 +#. Tag: para +#: basic_mapping.xml:2856 +#, no-c-format msgid "This is an example of a POJO class annotated as an EJB entity bean:" -msgstr "" +msgstr "以下はEJBのエンティティビーンとして注釈されたPOJOクラスの例です。" -#: index.docbook:2860 +#. Tag: programlisting +#: basic_mapping.xml:2860 +#, no-c-format msgid "" - "<![CDATA[@Entity(access = AccessType.FIELD)\n" - "public class Customer implements Serializable {\n" - "\n" - " @Id;\n" - " Long id;\n" - "\n" - " String firstName;\n" - " String lastName;\n" - " Date birthday;\n" - "\n" - " @Transient\n" - " Integer age;\n" - "\n" - " @Embedded\n" - " private Address homeAddress;\n" - "\n" - " @OneToMany(cascade=CascadeType.ALL)\n" - " @JoinColumn(name=\"CUSTOMER_ID\")\n" - " Set<Order> orders;\n" - "\n" - " // Getter/setter and business methods\n" - "}]]>" +"<![CDATA[@Entity(access = AccessType.FIELD)\n" +"public class Customer implements Serializable {\n" +"\n" +" @Id;\n" +" Long id;\n" +"\n" +" String firstName;\n" +" String lastName;\n" +" Date birthday;\n" +"\n" +" @Transient\n" +" Integer age;\n" +"\n" +" @Embedded\n" +" private Address homeAddress;\n" +"\n" +" @OneToMany(cascade=CascadeType.ALL)\n" +" @JoinColumn(name=\"CUSTOMER_ID\")\n" +" Set<Order> orders;\n" +"\n" +" // Getter/setter and business methods\n" +"}]]>" msgstr "" -#: index.docbook:2862 -msgid "Note that support for JDK 5.0 Annotations (and JSR-220) is still work in progress and not completed. Please refer to the Hibernate Annotations module for more details." +#. Tag: para +#: basic_mapping.xml:2862 +#, no-c-format +msgid "" +"Note that support for JDK 5.0 Annotations (and JSR-220) is still work in " +"progress and not completed. Please refer to the Hibernate Annotations module " +"for more details." msgstr "" +"JDK5.0のアノテーション(とJSR-220)のサポートは進行中の作業であり、完全ではない" +"ことに注意してください。 さらに詳しい情報はHibernateのアノテーション・モ" +"ジュールを参照してください。" -#: index.docbook:2871 +#. Tag: title +#: basic_mapping.xml:2871 +#, no-c-format msgid "Generated Properties" -msgstr "" +msgstr "生成プロパティ" -#: index.docbook:2872 -msgid "Generated properties are properties which have their values generated by the database. Typically, Hibernate applications needed to <literal>refresh</literal> objects which contain any properties for which the database was generating values. Marking properties as generated, however, lets the application delegate this responsibility to Hibernate. Essentially, whenever Hibernate issues an SQL INSERT or UPDATE for an entity which has defined generated properties, it immediately issues a select afterwards to retrieve the generated values." +#. Tag: para +#: basic_mapping.xml:2872 +#, no-c-format +msgid "" +"Generated properties are properties which have their values generated by the " +"database. Typically, Hibernate applications needed to <literal>refresh</" +"literal> objects which contain any properties for which the database was " +"generating values. Marking properties as generated, however, lets the " +"application delegate this responsibility to Hibernate. Essentially, whenever " +"Hibernate issues an SQL INSERT or UPDATE for an entity which has defined " +"generated properties, it immediately issues a select afterwards to retrieve " +"the generated values." msgstr "" +"生成プロパティとは、データベースによって生成された値を持つプロパティです。 通" +"常、Hibernateアプリケーションは、データベースが値を生成したプロパティを含むオ" +"ブジェクトを <literal>リフレッシュ</literal> する必要がありました。 しかし、" +"プロパティが生成されたということをマークすることで、 アプリケーションはリフ" +"レッシュの責任をHibernateに委譲します。 基本的に、生成プロパティを持つと定義" +"したエンティティに対して HibernateがINSERTやUPDATEのSQLを発行した後すぐに、 " +"生成された値を読み込むための SELECT SQL が発行されます。" -#: index.docbook:2881 -msgid "Properties marked as generated must additionally be non-insertable and non-updateable. Only <xref linkend=\"mapping-declaration-version\"/>versions, <xref linkend=\"mapping-declaration-timestamp\"/>timestamps, and <xref linkend=\"mapping-declaration-property\"/>simple properties can be marked as generated." +#. Tag: para +#: basic_mapping.xml:2881 +#, no-c-format +msgid "" +"Properties marked as generated must additionally be non-insertable and non-" +"updateable. Only <link linkend=\"mapping-declaration-version\">versions</" +"link>, <link linkend=\"mapping-declaration-timestamp\">timestamps</link>, " +"and <link linkend=\"mapping-declaration-property\">simple properties</link> " +"can be marked as generated." msgstr "" +"生成プロパティは、挿入不可能かつ更新不可能でなければなりません。 <xref " +"linkend=\"mapping-declaration-version\">versions</xref> 、 <xref linkend=" +"\"mapping-declaration-timestamp\">timestamps</xref> 、 <xref linkend=" +"\"mapping-declaration-property\">simple properties</xref> だけが生成されたと" +"マークできます。" -#: index.docbook:2888 -msgid "<literal>never</literal> (the default) - means that the given property value is not generated within the database." +#. Tag: para +#: basic_mapping.xml:2888 +#, no-c-format +msgid "" +"<literal>never</literal> (the default) - means that the given property value " +"is not generated within the database." msgstr "" +"<literal>never</literal> (デフォルト) - 与えられたプロパティの値は、 データ" +"ベースから生成されないことを意味します。" -#: index.docbook:2892 -msgid "<literal>insert</literal> - states that the given property value is generated on insert, but is not regenerated on subsequent updates. Things like created-date would fall into this category. Note that even thought <xref linkend=\"mapping-declaration-version\"/>version and <xref linkend=\"mapping-declaration-timestamp\"/>timestamp properties can be marked as generated, this option is not available there..." +#. Tag: para +#: basic_mapping.xml:2892 +#, no-c-format +msgid "" +"<literal>insert</literal> - states that the given property value is " +"generated on insert, but is not regenerated on subsequent updates. Things " +"like created-date would fall into this category. Note that even thought " +"<link linkend=\"mapping-declaration-version\">version</link> and <link " +"linkend=\"mapping-declaration-timestamp\">timestamp</link> properties can be " +"marked as generated, this option is not available there..." msgstr "" +"<literal>insert</literal> - 与えられたプロパティの値は挿入時に生成されるが、 " +"続いて起こる更新時には生成されないこと示します。 作成された日付などは、このカ" +"テゴリに分類されます。 <xref linkend=\"mapping-declaration-version" +"\">version</xref> や <xref linkend=\"mapping-declaration-timestamp" +"\">timestamp</xref> の プロパティは生成されたとマークできますが、このオプショ" +"ンは利用できないことに注意してください。" -#: index.docbook:2900 -msgid "<literal>always</literal> - states that the property value is generated both on insert and on update." +#. Tag: para +#: basic_mapping.xml:2900 +#, no-c-format +msgid "" +"<literal>always</literal> - states that the property value is generated both " +"on insert and on update." msgstr "" +"<literal>always</literal> - 挿入時も更新時もプロパティの値が生成されることを" +"示します。" -#: index.docbook:2907 +#. Tag: title +#: basic_mapping.xml:2907 +#, no-c-format msgid "Auxiliary Database Objects" -msgstr "" +msgstr "補助的なデータベース・オブジェクト" -#: index.docbook:2908 -msgid "Allows CREATE and DROP of arbitrary database objects, in conjunction with Hibernate's schema evolution tools, to provide the ability to fully define a user schema within the Hibernate mapping files. Although designed specifically for creating and dropping things like triggers or stored procedures, really any SQL command that can be run via a <literal>java.sql.Statement.execute()</literal> method is valid here (ALTERs, INSERTS, etc). There are essentially two modes for defining auxiliary database objects..." +#. Tag: para +#: basic_mapping.xml:2908 +#, no-c-format +msgid "" +"Allows CREATE and DROP of arbitrary database objects, in conjunction with " +"Hibernate's schema evolution tools, to provide the ability to fully define a " +"user schema within the Hibernate mapping files. Although designed " +"specifically for creating and dropping things like triggers or stored " +"procedures, really any SQL command that can be run via a <literal>java.sql." +"Statement.execute()</literal> method is valid here (ALTERs, INSERTS, etc). " +"There are essentially two modes for defining auxiliary database objects..." msgstr "" +"Hibernateのスキーマ・エボリューションツールと連動することで、 任意のデータ" +"ベース・オブジェクト（トリガーやストアドプロシージャなど）のCREATEとDROPによ" +"り、 Hibernateのマッピングファイル内のユーザ・スキーマをすべて定義することが" +"出来ます。 主にトリガやストアドプロシージャのようなデータベース・オブジェクト" +"を生成や削除することを意図していますが、 実際には <literal>java.sql." +"Statement.execute()</literal> メソッドによって実行できる 任意のSQLコマンド" +"（ALTER、INSERTなど）が実行できます。 補助的なデータベース・オブジェクトを定" +"義するための、2つの基本的な方法があります。" -#: index.docbook:2917 -msgid "The first mode is to explicitly list the CREATE and DROP commands out in the mapping file:" +#. Tag: para +#: basic_mapping.xml:2917 +#, no-c-format +msgid "" +"The first mode is to explicitly list the CREATE and DROP commands out in the " +"mapping file:" msgstr "" +"1つ目の方法は、CREATEとDROPコマンドをマッピングファイルの外に、明示的に記載す" +"ることです。" -#: index.docbook:2921 +#. Tag: programlisting +#: basic_mapping.xml:2921 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <create>CREATE TRIGGER my_trigger ...</create>\n" - " <drop>DROP TRIGGER my_trigger</drop>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <create>CREATE TRIGGER my_trigger ...</create>\n" +" <drop>DROP TRIGGER my_trigger</drop>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:2922 -msgid "The second mode is to supply a custom class which knows how to construct the CREATE and DROP commands. This custom class must implement the <literal>org.hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." +#. Tag: para +#: basic_mapping.xml:2922 +#, no-c-format +msgid "" +"The second mode is to supply a custom class which knows how to construct the " +"CREATE and DROP commands. This custom class must implement the <literal>org." +"hibernate.mapping.AuxiliaryDatabaseObject</literal> interface." msgstr "" +"2つ目の方法は、CREATEとDROPコマンドの組み立て方を知っているカスタムクラスを提" +"供することです。 このカスタムクラスは <literal>org.hibernate.mapping." +"AuxiliaryDatabaseObject</literal> インタフェースを 実装しなければなりません。" -#: index.docbook:2927 +#. Tag: programlisting +#: basic_mapping.xml:2927 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <definition class=\"MyTriggerDefinition\"/>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -#: index.docbook:2928 -msgid "Additionally, these database objects can be optionally scoped such that they only apply when certain dialects are used." +#. Tag: para +#: basic_mapping.xml:2928 +#, no-c-format +msgid "" +"Additionally, these database objects can be optionally scoped such that they " +"only apply when certain dialects are used." msgstr "" +"さらに、あるデータベース方言が使用される時にだけ適用するといったように、 デー" +"タベース・オブジェクトが使われるケースを限定できます。" -#: index.docbook:2932 +#. Tag: programlisting +#: basic_mapping.xml:2932 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " ...\n" - " <database-object>\n" - " <definition class=\"MyTriggerDefinition\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/>\n" - " <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/>\n" - " </database-object>\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" ...\n" +" <database-object>\n" +" <definition class=\"MyTriggerDefinition\"/>\n" +" <dialect-scope name=\"org.hibernate.dialect.Oracle9Dialect\"/>\n" +" <dialect-scope name=\"org.hibernate.dialect.OracleDialect\"/>\n" +" </database-object>\n" +"</hibernate-mapping>]]>" msgstr "" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" +#~ msgid "class" +#~ msgstr "class" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" +#~ msgid "id" +#~ msgstr "id" +#~ msgid "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal>none</" +#~ "literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers" +#~ "\"/>" +#~ msgstr "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal>none</" +#~ "literal>): See <xref linkend=\"mapping-declaration-id-enhanced-optimizers" +#~ "\"/>" + +#~ msgid "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal/>): See " +#~ "<xref linkend=\"mapping-declaration-id-enhanced-optimizers\"/>" +#~ msgstr "" +#~ "<literal>optimizer</literal> (optional, defaults to <literal/>): See " +#~ "<xref linkend=\"mapping-declaration-id-enhanced-optimizers\"/>" + +#~ msgid "key" +#~ msgstr "key" + +#~ msgid "any" +#~ msgstr "any" Modified: core/trunk/documentation/manual/translations/ja-JP/content/batch.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/batch.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/batch.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,459 +1,630 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: batch.xml:5 +#, no-c-format msgid "Batch processing" msgstr "バッチ処理" -#: index.docbook:7 -msgid "A naive approach to inserting 100 000 rows in the database using Hibernate might look like this:" -msgstr "Hibernateを使ってデータベースに100,000行を挿入する愚直な方法は、このようなものです：" +#. Tag: para +#: batch.xml:7 +#, no-c-format +msgid "" +"A naive approach to inserting 100 000 rows in the database using Hibernate " +"might look like this:" +msgstr "" +"Hibernateを使ってデータベースに100,000行を挿入する愚直な方法は、このようなも" +"のです：" -#: index.docbook:12 +#. Tag: programlisting +#: batch.xml:12 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - "}\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"for ( int i=0; i<100000; i++ ) {\n" +" Customer customer = new Customer(.....);\n" +" session.save(customer);\n" +"}\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - "for ( int i=0; i<100000; i++ ) { -\n" - " Customer customer = new Customer(.....); -\n" - " session.save(customer); -\n" - "} -\n" - "tx.commit(); -\n" - "session.close();]]>" -#: index.docbook:14 -msgid "This would fall over with an <literal>OutOfMemoryException</literal> somewhere around the 50 000th row. That's because Hibernate caches all the newly inserted <literal>Customer</literal> instances in the session-level cache." -msgstr "これは50,000番目の行のあたりで <literal>OutOfMemoryException</literal> で失敗するでしょう。 Hibernateがセッションレベルキャッシュで、 新しく挿入されたすべての <literal>Customer</literal> インスタンスをキャッシュするからです。" +#. Tag: para +#: batch.xml:14 +#, no-c-format +msgid "" +"This would fall over with an <literal>OutOfMemoryException</literal> " +"somewhere around the 50 000th row. That's because Hibernate caches all the " +"newly inserted <literal>Customer</literal> instances in the session-level " +"cache." +msgstr "" +"これは50,000番目の行のあたりで <literal>OutOfMemoryException</literal> で失敗" +"するでしょう。 Hibernateがセッションレベルキャッシュで、 新しく挿入されたすべ" +"ての <literal>Customer</literal> インスタンスをキャッシュするからです。" -#: index.docbook:20 -msgid "In this chapter we'll show you how to avoid this problem. First, however, if you are doing batch processing, it is absolutely critical that you enable the use of JDBC batching, if you intend to achieve reasonable performance. Set the JDBC batch size to a reasonable number (say, 10-50):" -msgstr "この章では、この問題を回避する方法を紹介します。 しかしバッチ処理をするなら、JDBCバッチが使用可能であることが非常に重要です。 そうでなければ手頃なパフォーマンスが得られません。 JDBCバッチサイズを手頃な数値（例えば、10から50）に設定してください：" +#. Tag: para +#: batch.xml:20 +#, no-c-format +msgid "" +"In this chapter we'll show you how to avoid this problem. First, however, if " +"you are doing batch processing, it is absolutely critical that you enable " +"the use of JDBC batching, if you intend to achieve reasonable performance. " +"Set the JDBC batch size to a reasonable number (say, 10-50):" +msgstr "" +"この章では、この問題を回避する方法を紹介します。 しかしバッチ処理をするなら、" +"JDBCバッチが使用可能であることが非常に重要です。 そうでなければ手頃なパフォー" +"マンスが得られません。 JDBCバッチサイズを手頃な数値（例えば、10から50）に設定" +"してください：" -#: index.docbook:27 +#. Tag: programlisting +#: batch.xml:27 +#, no-c-format msgid "<![CDATA[hibernate.jdbc.batch_size 20]]>" -msgstr "<![CDATA[hibernate.jdbc.batch_size 20]]>" +msgstr "" -#: index.docbook:29 -msgid "Note that Hibernate disables insert batching at the JDBC level transparently if you use an <literal>identiy</literal> identifier generator." -msgstr "また二次キャッシュが全く効かないプロセスで、 このような作業をしたいと思うかもしれません：" +#. Tag: para +#: batch.xml:29 +#, no-c-format +msgid "" +"Note that Hibernate disables insert batching at the JDBC level transparently " +"if you use an <literal>identiy</literal> identifier generator." +msgstr "" +"Note that Hibernate disables insert batching at the JDBC level transparently " +"if you use an <literal>identiy</literal> identifier generator." -#: index.docbook:34 -msgid "You also might like to do this kind of work in a process where interaction with the second-level cache is completely disabled:" -msgstr "<![CDATA[hibernate.cache.use_second_level_cache false]]>" +#. Tag: para +#: batch.xml:34 +#, no-c-format +msgid "" +"You also might like to do this kind of work in a process where interaction " +"with the second-level cache is completely disabled:" +msgstr "" +"また二次キャッシュが全く効かないプロセスで、 このような作業をしたいと思うかも" +"しれません：" -#: index.docbook:39 +#. Tag: programlisting +#: batch.xml:39 +#, no-c-format msgid "<![CDATA[hibernate.cache.use_second_level_cache false]]>" -msgstr "しかし、これは絶対に必要というわけではありません。 なぜなら明示的に <literal>CacheMode</literal> を設定して、 二次キャッシュとの相互作用を無効にすることができるからです。" +msgstr "" -#: index.docbook:41 -msgid "However, this is not absolutely necessary, since we can explicitly set the <literal>CacheMode</literal> to disable interaction with the second-level cache." -msgstr "バッチ挿入" +#. Tag: para +#: batch.xml:41 +#, no-c-format +msgid "" +"However, this is not absolutely necessary, since we can explicitly set the " +"<literal>CacheMode</literal> to disable interaction with the second-level " +"cache." +msgstr "" +"しかし、これは絶対に必要というわけではありません。 なぜなら明示的に " +"<literal>CacheMode</literal> を設定して、 二次キャッシュとの相互作用を無効に" +"することができるからです。" -#: index.docbook:47 +#. Tag: title +#: batch.xml:47 +#, no-c-format msgid "Batch inserts" -msgstr "新しいオブジェクトを永続化するとき、一次キャッシュのサイズを制限するため、 セッションを <literal>flush()</literal> して <literal>clear()</literal> しなければなりません。" +msgstr "バッチ挿入" -#: index.docbook:49 -msgid "When making new objects persistent, you must <literal>flush()</literal> and then <literal>clear()</literal> the session regularly, to control the size of the first-level cache." +#. Tag: para +#: batch.xml:49 +#, no-c-format +msgid "" +"When making new objects persistent, you must <literal>flush()</literal> and " +"then <literal>clear()</literal> the session regularly, to control the size " +"of the first-level cache." msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "for ( int i=0; i<100000; i++ ) { -\n" - " Customer customer = new Customer(.....); -\n" - " session.save(customer); -\n" - " if ( i % 20 == 0 ) { //20, same as the JDBC batch size -\n" - " //flush a batch of inserts and release memory: -\n" - " session.flush(); -\n" - " session.clear(); -\n" - " } -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" +"新しいオブジェクトを永続化するとき、一次キャッシュのサイズを制限するため、 " +"セッションを <literal>flush()</literal> して <literal>clear()</literal> しな" +"ければなりません。" -#: index.docbook:55 +#. Tag: programlisting +#: batch.xml:55 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "for ( int i=0; i<100000; i++ ) {\n" - " Customer customer = new Customer(.....);\n" - " session.save(customer);\n" - " if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" - " //flush a batch of inserts and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "バッチ更新" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"for ( int i=0; i<100000; i++ ) {\n" +" Customer customer = new Customer(.....);\n" +" session.save(customer);\n" +" if ( i % 20 == 0 ) { //20, same as the JDBC batch size\n" +" //flush a batch of inserts and release memory:\n" +" session.flush();\n" +" session.clear();\n" +" }\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:60 +#. Tag: title +#: batch.xml:60 +#, no-c-format msgid "Batch updates" -msgstr "データを復元したり更新したりするには同じアイディアを適用します。 それに加えて、データの行を多く返すクエリに対して有効な サーバーサイドのカーソルの利点を生かしたければ <literal>scroll()</literal> を使う必要があります。" +msgstr "バッチ更新" -#: index.docbook:62 -msgid "For retrieving and updating data the same ideas apply. In addition, you need to use <literal>scroll()</literal> to take advantage of server-side cursors for queries that return many rows of data." +#. Tag: para +#: batch.xml:62 +#, no-c-format +msgid "" +"For retrieving and updating data the same ideas apply. In addition, you need " +"to use <literal>scroll()</literal> to take advantage of server-side cursors " +"for queries that return many rows of data." msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\") -\n" - " .setCacheMode(CacheMode.IGNORE) -\n" - " .scroll(ScrollMode.FORWARD_ONLY); -\n" - "int count=0; -\n" - "while ( customers.next() ) { -\n" - " Customer customer = (Customer) customers.get(0); -\n" - " customer.updateStuff(...); -\n" - " if ( ++count % 20 == 0 ) { -\n" - " //flush a batch of updates and release memory: -\n" - " session.flush(); -\n" - " session.clear(); -\n" - " } -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" +"データを復元したり更新したりするには同じアイディアを適用します。 それに加え" +"て、データの行を多く返すクエリに対して有効な サーバーサイドのカーソルの利点を" +"生かしたければ <literal>scroll()</literal> を使う必要があります。" -#: index.docbook:68 +#. Tag: programlisting +#: batch.xml:68 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .setCacheMode(CacheMode.IGNORE)\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "int count=0;\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " if ( ++count % 20 == 0 ) {\n" - " //flush a batch of updates and release memory:\n" - " session.flush();\n" - " session.clear();\n" - " }\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "StatelessSessionインターフェイス" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +" .setCacheMode(CacheMode.IGNORE)\n" +" .scroll(ScrollMode.FORWARD_ONLY);\n" +"int count=0;\n" +"while ( customers.next() ) {\n" +" Customer customer = (Customer) customers.get(0);\n" +" customer.updateStuff(...);\n" +" if ( ++count % 20 == 0 ) {\n" +" //flush a batch of updates and release memory:\n" +" session.flush();\n" +" session.clear();\n" +" }\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:73 +#. Tag: title +#: batch.xml:73 +#, no-c-format msgid "The StatelessSession interface" -msgstr "また別の方法として、Hibernateはコマンド指向のAPIを用意しています。 これは分離オブジェクトの形で、 データベースとのデータストリームのやり取りに使うことができます。 <literal>StatelessSession</literal> は関連する永続コンテキストを持たず、 高レベルのライフサイクルセマンティクスの多くを提供しません。 特にステートレスセッションは、一時キャッシュを実装せず、 またどのような二次キャッシュやクエリキャッシュとも相互作用しません。 トランザクショナルなwrite-behindや自動ダーティチェックも実装しません。 ステートレスセッションを使って行われる操作が、 関連するインスタンスへカスケードされることは決してありません。 コレクションは、ステートレスセッションからは無視されます。 ステートレスセ! ッションを通して行われる操作は、 Hibernateのイベントモデルやインターセプタの影響を受けません。 一時キャッシュを持たないため、 ステートレスセッションは別名を持つデータに上手く対処できません。 ステートレスセッションは低レベルの抽象化であり、JDBCに非常によく似ています。" +msgstr "StatelessSessionインターフェイス" -#: index.docbook:74 -msgid "Alternatively, Hibernate provides a command-oriented API that may be used for streaming data to and from the database in the form of detached objects. A <literal>StatelessSession</literal> has no persistence context associated with it and does not provide many of the higher-level life cycle semantics. In particular, a stateless session does not implement a first-level cache nor interact with any second-level or query cache. It does not implement transactional write-behind or automatic dirty checking. Operations performed using a stateless session do not ever cascade to associated instances. Collections are ignored by a stateless session. Operations performed via a stateless session bypass Hibernate's event model and interceptors. Stateless sessions are vulnerable to data aliasing effects, due to the lack of a first-level cache. A stateless session is a lower-level abstraction, much closer to the underlying JDBC." +#. Tag: para +#: batch.xml:74 +#, no-c-format +msgid "" +"Alternatively, Hibernate provides a command-oriented API that may be used " +"for streaming data to and from the database in the form of detached objects. " +"A <literal>StatelessSession</literal> has no persistence context associated " +"with it and does not provide many of the higher-level life cycle semantics. " +"In particular, a stateless session does not implement a first-level cache " +"nor interact with any second-level or query cache. It does not implement " +"transactional write-behind or automatic dirty checking. Operations performed " +"using a stateless session do not ever cascade to associated instances. " +"Collections are ignored by a stateless session. Operations performed via a " +"stateless session bypass Hibernate's event model and interceptors. Stateless " +"sessions are vulnerable to data aliasing effects, due to the lack of a first-" +"level cache. A stateless session is a lower-level abstraction, much closer " +"to the underlying JDBC." msgstr "" - "<![CDATA[StatelessSession session = sessionFactory.openStatelessSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\") -\n" - " .scroll(ScrollMode.FORWARD_ONLY); -\n" - "while ( customers.next() ) { -\n" - " Customer customer = (Customer) customers.get(0); -\n" - " customer.updateStuff(...); -\n" - " session.update(customer); -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" +"また別の方法として、Hibernateはコマンド指向のAPIを用意しています。 これは分離" +"オブジェクトの形で、 データベースとのデータストリームのやり取りに使うことがで" +"きます。 <literal>StatelessSession</literal> は関連する永続コンテキストを持た" +"ず、 高レベルのライフサイクルセマンティクスの多くを提供しません。 特にステー" +"トレスセッションは、一時キャッシュを実装せず、 またどのような二次キャッシュや" +"クエリキャッシュとも相互作用しません。 トランザクショナルなwrite-behindや自動" +"ダーティチェックも実装しません。 ステートレスセッションを使って行われる操作" +"が、 関連するインスタンスへカスケードされることは決してありません。 コレク" +"ションは、ステートレスセッションからは無視されます。 ステートレスセッションを" +"通して行われる操作は、 Hibernateのイベントモデルやインターセプタの影響を受け" +"ません。 一時キャッシュを持たないため、 ステートレスセッションは別名を持つ" +"データに上手く対処できません。 ステートレスセッションは低レベルの抽象化であ" +"り、JDBCに非常によく似ています。" -#: index.docbook:89 +#. Tag: programlisting +#: batch.xml:89 +#, no-c-format msgid "" - "<![CDATA[StatelessSession session = sessionFactory.openStatelessSession();\n" - "Transaction tx = session.beginTransaction();\n" - " \n" - "ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" - " .scroll(ScrollMode.FORWARD_ONLY);\n" - "while ( customers.next() ) {\n" - " Customer customer = (Customer) customers.get(0);\n" - " customer.updateStuff(...);\n" - " session.update(customer);\n" - "}\n" - " \n" - "tx.commit();\n" - "session.close();]]>" -msgstr "このコード例では、クエリが返す <literal>Customer</literal> インスタンスは即座に（セッションから）分離されることに注意してください。 これは、どのような永続コンテキストとも決して関連しません。" +"<![CDATA[StatelessSession session = sessionFactory.openStatelessSession();\n" +"Transaction tx = session.beginTransaction();\n" +" \n" +"ScrollableResults customers = session.getNamedQuery(\"GetCustomers\")\n" +" .scroll(ScrollMode.FORWARD_ONLY);\n" +"while ( customers.next() ) {\n" +" Customer customer = (Customer) customers.get(0);\n" +" customer.updateStuff(...);\n" +" session.update(customer);\n" +"}\n" +" \n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:91 -msgid "Note that in this code example, the <literal>Customer</literal> instances returned by the query are immediately detached. They are never associated with any persistence context." -msgstr "<literal>StatelessSession</literal> インターフェイスで定義されている <literal>insert(), update(), delete()</literal> は、 低レベルの直接的なデータベース操作と考えられます。 結果として、SQLの <literal>INSERT, UPDATE, DELETE</literal> がそれぞれ即座に実行されます。 このように、これらは <literal>Session</literal> インターフェイスで定義されている <literal>save(), saveOrUpdate(), delete()</literal> とは非常に異なる意味を持ちます。" +#. Tag: para +#: batch.xml:91 +#, no-c-format +msgid "" +"Note that in this code example, the <literal>Customer</literal> instances " +"returned by the query are immediately detached. They are never associated " +"with any persistence context." +msgstr "" +"このコード例では、クエリが返す <literal>Customer</literal> インスタンスは即座" +"に（セッションから）分離されることに注意してください。 これは、どのような永続" +"コンテキストとも決して関連しません。" -#: index.docbook:97 -msgid "The <literal>insert(), update()</literal> and <literal>delete()</literal> operations defined by the <literal>StatelessSession</literal> interface are considered to be direct database row-level operations, which result in immediate execution of a SQL <literal>INSERT, UPDATE</literal> or <literal>DELETE</literal> respectively. Thus, they have very different semantics to the <literal>save(), saveOrUpdate()</literal> and <literal>delete()</literal> operations defined by the <literal>Session</literal> interface." -msgstr "DMLスタイルの操作" +#. Tag: para +#: batch.xml:97 +#, no-c-format +msgid "" +"The <literal>insert(), update()</literal> and <literal>delete()</literal> " +"operations defined by the <literal>StatelessSession</literal> interface are " +"considered to be direct database row-level operations, which result in " +"immediate execution of a SQL <literal>INSERT, UPDATE</literal> or " +"<literal>DELETE</literal> respectively. Thus, they have very different " +"semantics to the <literal>save(), saveOrUpdate()</literal> and " +"<literal>delete()</literal> operations defined by the <literal>Session</" +"literal> interface." +msgstr "" +"<literal>StatelessSession</literal> インターフェイスで定義されている " +"<literal>insert(), update(), delete()</literal> は、 低レベルの直接的なデータ" +"ベース操作と考えられます。 結果として、SQLの <literal>INSERT, UPDATE, " +"DELETE</literal> がそれぞれ即座に実行されます。 このように、これらは " +"<literal>Session</literal> インターフェイスで定義されている <literal>save(), " +"saveOrUpdate(), delete()</literal> とは非常に異なる意味を持ちます。" -#: index.docbook:110 +#. Tag: title +#: batch.xml:110 +#, no-c-format msgid "DML-style operations" -msgstr "すでに議論したように、自動的かつ透過的なオブジェクト/リレーショナルマッピングは、 オブジェクトの状態の管理であると考えられます。 これはメモリ内のオブジェクトの状態を利用できるということです。 そのため（SQLの <literal>データ操作言語</literal> (DML) 文： <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal> を使って）データベース内のデータを直接操作しても、 メモリ内の状態には影響を与えません。 しかしHibernateは、バルクSQLスタイルのDML文実行に対応するメソッドを用意しています。 これはHibernateクエリ言語（<xref linkend=\"queryhql\"/>HQL） を通して実行されます。" +msgstr "DMLスタイルの操作" -#: index.docbook:112 -msgid "As already discussed, automatic and transparent object/relational mapping is concerned with the management of object state. This implies that the object state is available in memory, hence manipulating (using the SQL <literal>Data Manipulation Language</literal> (DML) statements: <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>) data directly in the database will not affect in-memory state. However, Hibernate provides methods for bulk SQL-style DML statement execution which are performed through the Hibernate Query Language (<xref linkend=\"queryhql\"/>HQL)." -msgstr "<literal>UPDATE</literal> と <literal>DELETE</literal> 文の疑似構文は： <literal>( UPDATE | DELETE ) FROM? エンティティ名 (WHERE 条件節)?</literal> です。 注意すべき点がいくつかあります：" +#. Tag: para +#: batch.xml:112 +#, no-c-format +msgid "" +"As already discussed, automatic and transparent object/relational mapping is " +"concerned with the management of object state. This implies that the object " +"state is available in memory, hence manipulating (using the SQL " +"<literal>Data Manipulation Language</literal> (DML) statements: " +"<literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</" +"literal>) data directly in the database will not affect in-memory state. " +"However, Hibernate provides methods for bulk SQL-style DML statement " +"execution which are performed through the Hibernate Query Language (<link " +"linkend=\"queryhql\">HQL</link>)." +msgstr "" +"すでに議論したように、自動的かつ透過的なオブジェクト/リレーショナルマッピング" +"は、 オブジェクトの状態の管理であると考えられます。 これはメモリ内のオブジェ" +"クトの状態を利用できるということです。 そのため（SQLの <literal>データ操作言" +"語</literal> (DML) 文： <literal>INSERT</literal>, <literal>UPDATE</" +"literal>, <literal>DELETE</literal> を使って）データベース内のデータを直接操" +"作しても、 メモリ内の状態には影響を与えません。 しかしHibernateは、バルクSQL" +"スタイルのDML文実行に対応するメソッドを用意しています。 これはHibernateクエリ" +"言語（<xref linkend=\"queryhql\">HQL</xref>） を通して実行されます。" -#: index.docbook:122 -msgid "The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE where_conditions)?</literal>. Some points to note:" -msgstr "from節において、FROMキーワードはオプションです。" +#. Tag: para +#: batch.xml:122 +#, no-c-format +msgid "" +"The pseudo-syntax for <literal>UPDATE</literal> and <literal>DELETE</" +"literal> statements is: <literal>( UPDATE | DELETE ) FROM? EntityName (WHERE " +"where_conditions)?</literal>. Some points to note:" +msgstr "" +"<literal>UPDATE</literal> と <literal>DELETE</literal> 文の疑似構文は： " +"<literal>( UPDATE | DELETE ) FROM? エンティティ名 (WHERE 条件節)?</literal> " +"です。 注意すべき点がいくつかあります：" -#: index.docbook:130 +#. Tag: para +#: batch.xml:130 +#, no-c-format msgid "In the from-clause, the FROM keyword is optional" -msgstr "from節では単一のエンティティ名だけが可能で、 任意で別名を付けることができます。 エンティティ名に別名が与えられると、どのようなプロパティ参照も、 その別名を使って修飾しなければなりません。 もしエンティティ名に別名が与えられなければ、 どのようなプロパティ参照も修飾してはなりません。" +msgstr "from節において、FROMキーワードはオプションです。" -#: index.docbook:135 -msgid "There can only be a single entity named in the from-clause; it can optionally be aliased. If the entity name is aliased, then any property references must be qualified using that alias; if the entity name is not aliased, then it is illegal for any property references to be qualified." -msgstr "（暗黙的であれ明示的であれ）<xref linkend=\"queryhql-joins-forms\"/>結合 をバルクHQLクエリ内で指定することはできません。 サブクエリはwhere節で使うことができます サブクエリそのものは、結合を含められます。" +#. Tag: para +#: batch.xml:135 +#, no-c-format +msgid "" +"There can only be a single entity named in the from-clause; it can " +"optionally be aliased. If the entity name is aliased, then any property " +"references must be qualified using that alias; if the entity name is not " +"aliased, then it is illegal for any property references to be qualified." +msgstr "" +"from節では単一のエンティティ名だけが可能で、 任意で別名を付けることができま" +"す。 エンティティ名に別名が与えられると、どのようなプロパティ参照も、 その別" +"名を使って修飾しなければなりません。 もしエンティティ名に別名が与えられなけれ" +"ば、 どのようなプロパティ参照も修飾してはなりません。" -#: index.docbook:143 -msgid "No <xref linkend=\"queryhql-joins-forms\"/>joins (either implicit or explicit) can be specified in a bulk HQL query. Sub-queries may be used in the where-clause; the subqueries, themselves, may contain joins." -msgstr "where節はオプションです。" +#. Tag: para +#: batch.xml:143 +#, no-c-format +msgid "" +"No <link linkend=\"queryhql-joins-forms\">joins</link> (either implicit or " +"explicit) can be specified in a bulk HQL query. Sub-queries may be used in " +"the where-clause; the subqueries, themselves, may contain joins." +msgstr "" +"（暗黙的であれ明示的であれ）<xref linkend=\"queryhql-joins-forms\">結合</" +"xref> をバルクHQLクエリ内で指定することはできません。 サブクエリはwhere節で使" +"うことができます サブクエリそのものは、結合を含められます。" -#: index.docbook:150 +#. Tag: para +#: batch.xml:150 +#, no-c-format msgid "The where-clause is also optional." -msgstr "例として、HQLの <literal>UPDATE</literal> を実行するには、 <literal>Query.executeUpdate()</literal> メソッドを使ってください。 （このメソッドはおなじみのJDBC <literal>PreparedStatement.executeUpdate()</literal> から名付けられました）： d" +msgstr "where節はオプションです。" -#: index.docbook:156 -msgid "As an example, to execute an HQL <literal>UPDATE</literal>, use the <literal>Query.executeUpdate()</literal> method (the method is named for those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</literal>):" +#. Tag: para +#: batch.xml:156 +#, no-c-format +msgid "" +"As an example, to execute an HQL <literal>UPDATE</literal>, use the " +"<literal>Query.executeUpdate()</literal> method (the method is named for " +"those familiar with JDBC's <literal>PreparedStatement.executeUpdate()</" +"literal>):" msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :oldName\"; -\n" - "// or String hqlUpdate = \"update Customer set name = :newName where name = :oldName\"; -\n" - "int updatedEntities = s.createQuery( hqlUpdate ) -\n" - " .setString( \"newName\", newName ) -\n" - " .setString( \"oldName\", oldName ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +"例として、HQLの <literal>UPDATE</literal> を実行するには、 <literal>Query." +"executeUpdate()</literal> メソッドを使ってください。 （このメソッドはおなじみ" +"のJDBC <literal>PreparedStatement.executeUpdate()</literal> から名付けられま" +"した）： d" -#: index.docbook:162 +#. Tag: programlisting +#: batch.xml:162 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :oldName\";\n" - "// or String hqlUpdate = \"update Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "HQLの <literal>UPDATE</literal> 文は、デフォルトでは、作用するエンティティの <xref linkend=\"mapping-declaration-version\"/>version や <xref linkend=\"mapping-declaration-timestamp\"/>timestamp プロパティの値には影響しません。 これはEJB3の仕様にも受け継がれています。 しかし <literal>versioned update</literal> を使って、 <literal>version</literal> や <literal>timestamp</literal> プロパティの値を強制的にリセットさせることができます。 これは <literal>UPDATE</literal> キーワードの後に <literal>VERSIONED</literal> キーワードを追加することで行えます。" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlUpdate = \"update Customer c set c.name = :newName where c.name = :" +"oldName\";\n" +"// or String hqlUpdate = \"update Customer set name = :newName where name = :" +"oldName\";\n" +"int updatedEntities = s.createQuery( hqlUpdate )\n" +" .setString( \"newName\", newName )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:164 -msgid "HQL <literal>UPDATE</literal> statements, by default do not effect the <xref linkend=\"mapping-declaration-version\"/>version or the <xref linkend=\"mapping-declaration-timestamp\"/>timestamp property values for the affected entities; this is in keeping with the EJB3 specification. However, you can force Hibernate to properly reset the <literal>version</literal> or <literal>timestamp</literal> property values through the use of a <literal>versioned update</literal>. This is achieved by adding the <literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> keyword." +#. Tag: para +#: batch.xml:164 +#, no-c-format +msgid "" +"HQL <literal>UPDATE</literal> statements, by default do not effect the <link " +"linkend=\"mapping-declaration-version\">version</link> or the <link linkend=" +"\"mapping-declaration-timestamp\">timestamp</link> property values for the " +"affected entities; this is in keeping with the EJB3 specification. However, " +"you can force Hibernate to properly reset the <literal>version</literal> or " +"<literal>timestamp</literal> property values through the use of a " +"<literal>versioned update</literal>. This is achieved by adding the " +"<literal>VERSIONED</literal> keyword after the <literal>UPDATE</literal> " +"keyword." msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - "String hqlVersionedUpdate = \"update versioned Customer set name = :newName where name = :oldName\"; -\n" - "int updatedEntities = s.createQuery( hqlUpdate ) -\n" - " .setString( \"newName\", newName ) -\n" - " .setString( \"oldName\", oldName ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +"HQLの <literal>UPDATE</literal> 文は、デフォルトでは、作用するエンティティの " +"<xref linkend=\"mapping-declaration-version\">version</xref> や <xref " +"linkend=\"mapping-declaration-timestamp\">timestamp</xref> プロパティの値には" +"影響しません。 これはEJB3の仕様にも受け継がれています。 しかし " +"<literal>versioned update</literal> を使って、 <literal>version</literal> や " +"<literal>timestamp</literal> プロパティの値を強制的にリセットさせることができ" +"ます。 これは <literal>UPDATE</literal> キーワードの後に <literal>VERSIONED</" +"literal> キーワードを追加することで行えます。" -#: index.docbook:174 +#. Tag: programlisting +#: batch.xml:174 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "String hqlVersionedUpdate = \"update versioned Customer set name = :newName where name = :oldName\";\n" - "int updatedEntities = s.createQuery( hqlUpdate )\n" - " .setString( \"newName\", newName )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "カスタムバージョン型（<literal>org.hibernate.usertype.UserVersionType</literal>） は <literal>update versioned</literal> 文と一緒に使えないことに注意してください。" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"String hqlVersionedUpdate = \"update versioned Customer set name = :newName " +"where name = :oldName\";\n" +"int updatedEntities = s.createQuery( hqlUpdate )\n" +" .setString( \"newName\", newName )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:176 -msgid "Note that custom version types (<literal>org.hibernate.usertype.UserVersionType</literal>) are not allowed in conjunction with a <literal>update versioned</literal> statement." -msgstr "HQLの <literal>DELETE</literal> を実行するには、 同じ <literal>Query.executeUpdate()</literal> メソッドを使ってください：" +#. Tag: para +#: batch.xml:176 +#, no-c-format +msgid "" +"Note that custom version types (<literal>org.hibernate.usertype." +"UserVersionType</literal>) are not allowed in conjunction with a " +"<literal>update versioned</literal> statement." +msgstr "" +"カスタムバージョン型（<literal>org.hibernate.usertype.UserVersionType</" +"literal>） は <literal>update versioned</literal> 文と一緒に使えないことに注" +"意してください。" -#: index.docbook:181 -msgid "To execute an HQL <literal>DELETE</literal>, use the same <literal>Query.executeUpdate()</literal> method:" +#. Tag: para +#: batch.xml:181 +#, no-c-format +msgid "" +"To execute an HQL <literal>DELETE</literal>, use the same <literal>Query." +"executeUpdate()</literal> method:" msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "String hqlDelete = \"delete Customer c where c.name = :oldName\"; -\n" - "// or String hqlDelete = \"delete Customer where name = :oldName\"; -\n" - "int deletedEntities = s.createQuery( hqlDelete ) -\n" - " .setString( \"oldName\", oldName ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +"HQLの <literal>DELETE</literal> を実行するには、 同じ <literal>Query." +"executeUpdate()</literal> メソッドを使ってください：" -#: index.docbook:186 +#. Tag: programlisting +#: batch.xml:186 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" - "// or String hqlDelete = \"delete Customer where name = :oldName\";\n" - "int deletedEntities = s.createQuery( hqlDelete )\n" - " .setString( \"oldName\", oldName )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" -msgstr "<literal>Query.executeUpdate()</literal> メソッドが返す <literal>int</literal> の値は、この操作が影響を及ぼしたエンティティの数です。 これが影響するデータベース内の行数と、相互に関係するかどうかを考えてみてください。 HQLバルク操作は、結果として、実際のSQL文が複数実行されることになります。 例えばjoined-subclassです。 返される数は、その文によって影響された実際のエンティティの数を示します。 joined-subclassの例に戻ると、サブクラスの一つに対する削除は、 そのサブクラスがマッピングされたテーブルだけではなく、 「ルート」テーブルと継承階層をさらに下ったjoined-subclassのテーブルの削除になります。" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlDelete = \"delete Customer c where c.name = :oldName\";\n" +"// or String hqlDelete = \"delete Customer where name = :oldName\";\n" +"int deletedEntities = s.createQuery( hqlDelete )\n" +" .setString( \"oldName\", oldName )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" +msgstr "" -#: index.docbook:188 -msgid "The <literal>int</literal> value returned by the <literal>Query.executeUpdate()</literal> method indicate the number of entities effected by the operation. Consider this may or may not correlate to the number of rows effected in the database. An HQL bulk operation might result in multiple actual SQL statements being executed, for joined-subclass, for example. The returned number indicates the number of actual entities affected by the statement. Going back to the example of joined-subclass, a delete against one of the subclasses may actually result in deletes against not just the table to which that subclass is mapped, but also the \"root\" table and potentially joined-subclass tables further down the inheritence hierarchy." -msgstr "<literal>INSERT</literal> 文の疑似構文は： <literal>INSERT INTO エンティティ名 プロパティリスト select文</literal> です。 注意すべき点がいくつかあります：" +#. Tag: para +#: batch.xml:188 +#, no-c-format +msgid "" +"The <literal>int</literal> value returned by the <literal>Query.executeUpdate" +"()</literal> method indicate the number of entities effected by the " +"operation. Consider this may or may not correlate to the number of rows " +"effected in the database. An HQL bulk operation might result in multiple " +"actual SQL statements being executed, for joined-subclass, for example. The " +"returned number indicates the number of actual entities affected by the " +"statement. Going back to the example of joined-subclass, a delete against " +"one of the subclasses may actually result in deletes against not just the " +"table to which that subclass is mapped, but also the \"root\" table and " +"potentially joined-subclass tables further down the inheritence hierarchy." +msgstr "" +"<literal>Query.executeUpdate()</literal> メソッドが返す <literal>int</" +"literal> の値は、この操作が影響を及ぼしたエンティティの数です。 これが影響す" +"るデータベース内の行数と、相互に関係するかどうかを考えてみてください。 HQLバ" +"ルク操作は、結果として、実際のSQL文が複数実行されることになります。 例えば" +"joined-subclassです。 返される数は、その文によって影響された実際のエンティ" +"ティの数を示します。 joined-subclassの例に戻ると、サブクラスの一つに対する削" +"除は、 そのサブクラスがマッピングされたテーブルだけではなく、 「ルート」テー" +"ブルと継承階層をさらに下ったjoined-subclassのテーブルの削除になります。" -#: index.docbook:199 -msgid "The pseudo-syntax for <literal>INSERT</literal> statements is: <literal>INSERT INTO EntityName properties_list select_statement</literal>. Some points to note:" -msgstr "INSERT INTO ... SELECT ... の形式だけがサポートされています。 INSERT INTO ... VALUES ... の形式はサポートされていません。" +#. Tag: para +#: batch.xml:199 +#, no-c-format +msgid "" +"The pseudo-syntax for <literal>INSERT</literal> statements is: " +"<literal>INSERT INTO EntityName properties_list select_statement</literal>. " +"Some points to note:" +msgstr "" +"<literal>INSERT</literal> 文の疑似構文は： <literal>INSERT INTO エンティティ" +"名 プロパティリスト select文</literal> です。 注意すべき点がいくつかありま" +"す：" -#: index.docbook:207 -msgid "Only the INSERT INTO ... SELECT ... form is supported; not the INSERT INTO ... VALUES ... form." -msgstr "プロパティリストは、SQLの <literal>INSERT</literal> 文における <literal>カラムの仕様</literal> に類似しています。 継承のマッピングに含まれるエンティティに対して、 クラスレベルで直接定義されたプロパティだけが、プロパティリストに使えます。 スーパークラスのプロパティは認められず、サブクラスのプロパティは効果がありません。 言い換えると <literal>INSERT</literal> 文は、本質的にポリモーフィックではありません。" +#. Tag: para +#: batch.xml:207 +#, no-c-format +msgid "" +"Only the INSERT INTO ... SELECT ... form is supported; not the INSERT " +"INTO ... VALUES ... form." +msgstr "" +"INSERT INTO ... SELECT ... の形式だけがサポートされています。 INSERT " +"INTO ... VALUES ... の形式はサポートされていません。" -#: index.docbook:210 -msgid "The properties_list is analogous to the <literal>column speficiation</literal> in the SQL <literal>INSERT</literal> statement. For entities involved in mapped inheritence, only properties directly defined on that given class-level can be used in the properties_list. Superclass properties are not allowed; and subclass properties do not make sense. In other words, <literal>INSERT</literal> statements are inherently non-polymorphic." -msgstr "select文の返り値の型がinsert文が期待する型とマッチしていれば、 そのselect文は妥当なHQL selectクエリとなりえます。 現在このチェックをデータベースへ任せるのではなく、クエリのコンパイル時にチェックします。 このことは、<emphasis>equal</emphasis>とは違い、 Hibernateの <literal>Type</literal> 間の <emphasis>equivalent</emphasis> に関する 問題を引き起こすことに注意してください。 これは <literal>org.hibernate.type.DataType</literal> として定義されたプロパティと、 <literal>org.hibernate.type.TimestampType</literal> として定義されたプロパティの間のミスマッチの問題を引き起こします。 データベースがそれらを区別できなくても、変換することができても、この問題は発生します。" +#. Tag: para +#: batch.xml:210 +#, no-c-format +msgid "" +"The properties_list is analogous to the <literal>column speficiation</" +"literal> in the SQL <literal>INSERT</literal> statement. For entities " +"involved in mapped inheritence, only properties directly defined on that " +"given class-level can be used in the properties_list. Superclass properties " +"are not allowed; and subclass properties do not make sense. In other words, " +"<literal>INSERT</literal> statements are inherently non-polymorphic." +msgstr "" +"プロパティリストは、SQLの <literal>INSERT</literal> 文における <literal>カラ" +"ムの仕様</literal> に類似しています。 継承のマッピングに含まれるエンティティ" +"に対して、 クラスレベルで直接定義されたプロパティだけが、プロパティリストに使" +"えます。 スーパークラスのプロパティは認められず、サブクラスのプロパティは効果" +"がありません。 言い換えると <literal>INSERT</literal> 文は、本質的にポリモー" +"フィックではありません。" -#: index.docbook:220 -msgid "select_statement can be any valid HQL select query, with the caveat that the return types must match the types expected by the insert. Currently, this is checked during query compilation rather than allowing the check to relegate to the database. Note however that this might cause problems between Hibernate <literal>Type</literal>s which are <emphasis>equivalent</emphasis> as opposed to <emphasis>equal</emphasis>. This might cause issues with mismatches between a property defined as a <literal>org.hibernate.type.DateType</literal> and a property defined as a <literal>org.hibernate.type.TimestampType</literal>, even though the database might not make a distinction or might be able to handle the conversion." -msgstr "idプロパティに対して、insert文には二つの選択肢があります。 プロパティリストで明示的にidプロパティを指定するか （この場合、対応するselect式から値が取られます）、 プロパティリストから除外するか （この場合、生成される値が使われます）のいずれかです。 後者の選択肢は、データベース内を操作するidジェネレータを使うときのみ、利用可能です。 この選択肢を採る場合、「インメモリ」型のジェネレータを使うと、構文解析時に例外が発生します。 この議論では、インデータベース型ジェネレータは <literal>org.hibernate.id.SequenceGenerator</literal> （とそのサブクラス）と、<literal>org.hibernate.id.PostInsertIdentifierGenerator</literal> の実装であると考えています。 ここで最も注意すべき例外は、<literal>org.hibernate.id.TableHiLoGenerator! </literal> です。 値を取得する選択可能な方法がないため、このジェネレータを使うことはできません。" +#. Tag: para +#: batch.xml:220 +#, no-c-format +msgid "" +"select_statement can be any valid HQL select query, with the caveat that the " +"return types must match the types expected by the insert. Currently, this is " +"checked during query compilation rather than allowing the check to relegate " +"to the database. Note however that this might cause problems between " +"Hibernate <literal>Type</literal>s which are <emphasis>equivalent</emphasis> " +"as opposed to <emphasis>equal</emphasis>. This might cause issues with " +"mismatches between a property defined as a <literal>org.hibernate.type." +"DateType</literal> and a property defined as a <literal>org.hibernate.type." +"TimestampType</literal>, even though the database might not make a " +"distinction or might be able to handle the conversion." +msgstr "" +"select文の返り値の型がinsert文が期待する型とマッチしていれば、 そのselect文は" +"妥当なHQL selectクエリとなりえます。 現在このチェックをデータベースへ任せるの" +"ではなく、クエリのコンパイル時にチェックします。 このことは、" +"<emphasis>equal</emphasis>とは違い、 Hibernateの <literal>Type</literal> 間" +"の <emphasis>equivalent</emphasis> に関する 問題を引き起こすことに注意してく" +"ださい。 これは <literal>org.hibernate.type.DataType</literal> として定義され" +"たプロパティと、 <literal>org.hibernate.type.TimestampType</literal> として定" +"義されたプロパティの間のミスマッチの問題を引き起こします。 データベースがそれ" +"らを区別できなくても、変換することができても、この問題は発生します。" -#: index.docbook:232 -msgid "For the id property, the insert statement gives you two options. You can either explicitly specify the id property in the properties_list (in which case its value is taken from the corresponding select expression) or omit it from the properties_list (in which case a generated value is used). This later option is only available when using id generators that operate in the database; attempting to use this option with any \"in memory\" type generators will cause an exception during parsing. Note that for the purposes of this discussion, in-database generators are considered to be <literal>org.hibernate.id.SequenceGenerator</literal> (and its subclasses) and any implementors of <literal>org.hibernate.id.PostInsertIdentifierGenerator</literal>. The most notable exception here is <literal>org.hibernate.id.TableHiLoGenerator</literal>, which cannot be used because it does not expose a selectable way to get its values." -msgstr "<literal>version</literal> や <literal>timestamp</literal> としてマッピングされるプロパティに対して、 insert文には二つの選択肢があります。 プロパティリストで明示的にプロパティを指定するか （この場合、対応するselect式から値が取られます）、 プロパティリストから除外するか （この場合、<literal>org.hibernate.type.VersionType</literal> で定義された <literal>シード値</literal> が使われます）のいずれかです。" +#. Tag: para +#: batch.xml:232 +#, no-c-format +msgid "" +"For the id property, the insert statement gives you two options. You can " +"either explicitly specify the id property in the properties_list (in which " +"case its value is taken from the corresponding select expression) or omit it " +"from the properties_list (in which case a generated value is used). This " +"later option is only available when using id generators that operate in the " +"database; attempting to use this option with any \"in memory\" type " +"generators will cause an exception during parsing. Note that for the " +"purposes of this discussion, in-database generators are considered to be " +"<literal>org.hibernate.id.SequenceGenerator</literal> (and its subclasses) " +"and any implementors of <literal>org.hibernate.id." +"PostInsertIdentifierGenerator</literal>. The most notable exception here is " +"<literal>org.hibernate.id.TableHiLoGenerator</literal>, which cannot be used " +"because it does not expose a selectable way to get its values." +msgstr "" +"idプロパティに対して、insert文には二つの選択肢があります。 プロパティリストで" +"明示的にidプロパティを指定するか （この場合、対応するselect式から値が取られま" +"す）、 プロパティリストから除外するか （この場合、生成される値が使われます）" +"のいずれかです。 後者の選択肢は、データベース内を操作するidジェネレータを使う" +"ときのみ、利用可能です。 この選択肢を採る場合、「インメモリ」型のジェネレータ" +"を使うと、構文解析時に例外が発生します。 この議論では、インデータベース型ジェ" +"ネレータは <literal>org.hibernate.id.SequenceGenerator</literal> （とそのサブ" +"クラス）と、<literal>org.hibernate.id.PostInsertIdentifierGenerator</" +"literal> の実装であると考えています。 ここで最も注意すべき例外は、" +"<literal>org.hibernate.id.TableHiLoGenerator</literal> です。 値を取得する選" +"択可能な方法がないため、このジェネレータを使うことはできません。" -#: index.docbook:247 -msgid "For properties mapped as either <literal>version</literal> or <literal>timestamp</literal>, the insert statement gives you two options. You can either specify the property in the properties_list (in which case its value is taken from the corresponding select expressions) or omit it from the properties_list (in which case the <literal>seed value</literal> defined by the <literal>org.hibernate.type.VersionType</literal> is used)." -msgstr "HQLの <literal>INSERT</literal> 文の実行例です：" +#. Tag: para +#: batch.xml:247 +#, no-c-format +msgid "" +"For properties mapped as either <literal>version</literal> or " +"<literal>timestamp</literal>, the insert statement gives you two options. " +"You can either specify the property in the properties_list (in which case " +"its value is taken from the corresponding select expressions) or omit it " +"from the properties_list (in which case the <literal>seed value</literal> " +"defined by the <literal>org.hibernate.type.VersionType</literal> is used)." +msgstr "" +"<literal>version</literal> や <literal>timestamp</literal> としてマッピングさ" +"れるプロパティに対して、 insert文には二つの選択肢があります。 プロパティリス" +"トで明示的にプロパティを指定するか （この場合、対応するselect式から値が取られ" +"ます）、 プロパティリストから除外するか （この場合、<literal>org.hibernate." +"type.VersionType</literal> で定義された <literal>シード値</literal> が使われ" +"ます）のいずれかです。" -#: index.docbook:257 +#. Tag: para +#: batch.xml:257 +#, no-c-format msgid "An example HQL <literal>INSERT</literal> statement execution:" -msgstr "" - "<![CDATA[Session session = sessionFactory.openSession(); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ...\"; -\n" - "int createdEntities = s.createQuery( hqlInsert ) -\n" - " .executeUpdate(); -\n" - "tx.commit(); -\n" - "session.close();]]>" +msgstr "HQLの <literal>INSERT</literal> 文の実行例です：" -#: index.docbook:261 +#. Tag: programlisting +#: batch.xml:261 +#, no-c-format msgid "" - "<![CDATA[Session session = sessionFactory.openSession();\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c.name from Customer c where ...\";\n" - "int createdEntities = s.createQuery( hqlInsert )\n" - " .executeUpdate();\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = sessionFactory.openSession();\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"String hqlInsert = \"insert into DelinquentAccount (id, name) select c.id, c." +"name from Customer c where ...\";\n" +"int createdEntities = s.createQuery( hqlInsert )\n" +" .executeUpdate();\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - Modified: core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/best_practices.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,168 +1,447 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: best_practices.xml:5 +#, no-c-format msgid "Best Practices" msgstr "ベストプラクティス" -#: index.docbook:9 -msgid "Write fine-grained classes and map them using <literal>&lt;component&gt;</literal>." -msgstr "クラスは細かい粒度で書き <literal>&lt;component&gt;</literal> でマッピングしましょう。" +#. Tag: term +#: best_practices.xml:9 +#, no-c-format +msgid "" +"Write fine-grained classes and map them using <literal>&lt;component&gt;</" +"literal>." +msgstr "" +"クラスは細かい粒度で書き <literal>&lt;component&gt;</literal> でマッピングし" +"ましょう。" -#: index.docbook:11 -msgid "Use an <literal>Address</literal> class to encapsulate <literal>street</literal>, <literal>suburb</literal>, <literal>state</literal>, <literal>postcode</literal>. This encourages code reuse and simplifies refactoring." -msgstr "<literal>street</literal>（通り）, <literal>suburb</literal> （都市）, <literal>state</literal>（州）, <literal>postcode</literal> （郵便番号）をカプセル化する <literal>Address</literal>（住所）クラスを使いましょう。 そうすればコードが再利用しやすくなり、リファクタリングも簡単になります。" +#. Tag: para +#: best_practices.xml:11 +#, no-c-format +msgid "" +"Use an <literal>Address</literal> class to encapsulate <literal>street</" +"literal>, <literal>suburb</literal>, <literal>state</literal>, " +"<literal>postcode</literal>. This encourages code reuse and simplifies " +"refactoring." +msgstr "" +"<literal>street</literal>（通り）, <literal>suburb</literal> （都市）, " +"<literal>state</literal>（州）, <literal>postcode</literal> （郵便番号）をカ" +"プセル化する <literal>Address</literal>（住所）クラスを使いましょう。 そうす" +"ればコードが再利用しやすくなり、リファクタリングも簡単になります。" -#: index.docbook:19 +#. Tag: term +#: best_practices.xml:19 +#, no-c-format msgid "Declare identifier properties on persistent classes." msgstr "永続クラスには識別子プロパティを定義しましょう。" -#: index.docbook:21 -msgid "Hibernate makes identifier properties optional. There are all sorts of reasons why you should use them. We recommend that identifiers be 'synthetic' (generated, with no business meaning)." -msgstr "Hibernateでは識別子プロパティはオプションですが、 使用すべき理由がたくさんあります。 識別子は「人工的」（生成された、業務的な意味を持たない） なものにすることをおすすめします。" +#. Tag: para +#: best_practices.xml:21 +#, no-c-format +msgid "" +"Hibernate makes identifier properties optional. There are all sorts of " +"reasons why you should use them. We recommend that identifiers be " +"'synthetic' (generated, with no business meaning)." +msgstr "" +"Hibernateでは識別子プロパティはオプションですが、 使用すべき理由がたくさんあ" +"ります。 識別子は「人工的」（生成された、業務的な意味を持たない） なものにす" +"ることをおすすめします。" -#: index.docbook:29 +#. Tag: term +#: best_practices.xml:29 +#, no-c-format msgid "Identify natural keys." msgstr "自然キーを見つけましょう。" -#: index.docbook:31 -msgid "Identify natural keys for all entities, and map them using <literal>&lt;natural-id&gt;</literal>. Implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the properties that make up the natural key." -msgstr "すべてのエンティティに対して自然キーを見つけて、 <literal>&lt;natural-id&gt;</literal> でマッピングしましょう。 自然キーを構成するプロパティを比較するために、 <literal>equals()</literal> と <literal>hashCode()</literal> を実装しましょう。" +#. Tag: para +#: best_practices.xml:31 +#, no-c-format +msgid "" +"Identify natural keys for all entities, and map them using <literal>&lt;" +"natural-id&gt;</literal>. Implement <literal>equals()</literal> and " +"<literal>hashCode()</literal> to compare the properties that make up the " +"natural key." +msgstr "" +"すべてのエンティティに対して自然キーを見つけて、 <literal>&lt;natural-id&gt;" +"</literal> でマッピングしましょう。 自然キーを構成するプロパティを比較するた" +"めに、 <literal>equals()</literal> と <literal>hashCode()</literal> を実装し" +"ましょう。" -#: index.docbook:39 +#. Tag: term +#: best_practices.xml:39 +#, no-c-format msgid "Place each class mapping in its own file." msgstr "クラスのマッピングはそれぞれのクラス専用のファイルに書きましょう。" -#: index.docbook:41 -msgid "Don't use a single monolithic mapping document. Map <literal>com.eg.Foo</literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes particularly good sense in a team environment." -msgstr "単一の巨大なマッピングドキュメントを使用しないでください。 <literal>com.eg.Foo</literal> クラスなら <literal>com/eg/Foo.hbm.xml</literal> ファイルにマッピングしましょう。 このことは、特にチームでの開発に意味があります。" +#. Tag: para +#: best_practices.xml:41 +#, no-c-format +msgid "" +"Don't use a single monolithic mapping document. Map <literal>com.eg.Foo</" +"literal> in the file <literal>com/eg/Foo.hbm.xml</literal>. This makes " +"particularly good sense in a team environment." +msgstr "" +"単一の巨大なマッピングドキュメントを使用しないでください。 <literal>com.eg." +"Foo</literal> クラスなら <literal>com/eg/Foo.hbm.xml</literal> ファイルにマッ" +"ピングしましょう。 このことは、特にチームでの開発に意味があります。" -#: index.docbook:49 +#. Tag: term +#: best_practices.xml:49 +#, no-c-format msgid "Load mappings as resources." msgstr "リソースとしてマッピングをロードしましょう。" -#: index.docbook:51 +#. Tag: para +#: best_practices.xml:51 +#, no-c-format msgid "Deploy the mappings along with the classes they map." msgstr "マッピングを、それらがマッピングするするクラスと一緒に配置しましょう。" -#: index.docbook:57 +#. Tag: term +#: best_practices.xml:57 +#, no-c-format msgid "Consider externalising query strings." msgstr "クエリ文字列を外部に置くことを考えましょう" -#: index.docbook:59 -msgid "This is a good practice if your queries call non-ANSI-standard SQL functions. Externalising the query strings to mapping files will make the application more portable." -msgstr "クエリがANSI標準でないSQL関数を呼んでいるなら、これはよいプラクティスです。 クエリ文字列をマッピングファイルへ外出しすればアプリケーションがポータブルになります。" +#. Tag: para +#: best_practices.xml:59 +#, no-c-format +msgid "" +"This is a good practice if your queries call non-ANSI-standard SQL " +"functions. Externalising the query strings to mapping files will make the " +"application more portable." +msgstr "" +"クエリがANSI標準でないSQL関数を呼んでいるなら、これはよいプラクティスです。 " +"クエリ文字列をマッピングファイルへ外出しすればアプリケーションがポータブルに" +"なります。" -#: index.docbook:67 +#. Tag: term +#: best_practices.xml:67 +#, no-c-format msgid "Use bind variables." msgstr "バインド変数を使いましょう。" -#: index.docbook:69 -msgid "As in JDBC, always replace non-constant values by \"?\". Never use string manipulation to bind a non-constant value in a query! Even better, consider using named parameters in queries." -msgstr "JDBCの場合と同じように、定数でない値は必ず\"?\"で置き換えましょう。 定数でない値をバインドするために、クエリで文字列操作を使ってはいけません。 名前付きのパラメータを使うようにするとさらに良いです。" +#. Tag: para +#: best_practices.xml:69 +#, no-c-format +msgid "" +"As in JDBC, always replace non-constant values by \"?\". Never use string " +"manipulation to bind a non-constant value in a query! Even better, consider " +"using named parameters in queries." +msgstr "" +"JDBCの場合と同じように、定数でない値は必ず\"?\"で置き換えましょう。 定数でな" +"い値をバインドするために、クエリで文字列操作を使ってはいけません。 名前付きの" +"パラメータを使うようにするとさらに良いです。" -#: index.docbook:77 +#. Tag: term +#: best_practices.xml:77 +#, no-c-format msgid "Don't manage your own JDBC connections." msgstr "JDBCコネクションを管理してはいけません。" -#: index.docbook:79 -msgid "Hibernate lets the application manage JDBC connections. This approach should be considered a last-resort. If you can't use the built-in connections providers, consider providing your own implementation of <literal>org.hibernate.connection.ConnectionProvider</literal>." -msgstr "HibernateではアプリケーションがJDBCコネクションを管理することが許されています。 しかしこれは最終手段だと思ってください。 組み込みのコネクションプロバイダを使うことができなければ、 <literal>org.hibernate.connection.ConnectionProvider</literal> を実装することを考えてください。" +#. Tag: para +#: best_practices.xml:79 +#, no-c-format +msgid "" +"Hibernate lets the application manage JDBC connections. This approach should " +"be considered a last-resort. If you can't use the built-in connections " +"providers, consider providing your own implementation of <literal>org." +"hibernate.connection.ConnectionProvider</literal>." +msgstr "" +"HibernateではアプリケーションがJDBCコネクションを管理することが許されていま" +"す。 しかしこれは最終手段だと思ってください。 組み込みのコネクションプロバイ" +"ダを使うことができなければ、 <literal>org.hibernate.connection." +"ConnectionProvider</literal> を実装することを考えてください。" -#: index.docbook:87 +#. Tag: term +#: best_practices.xml:87 +#, no-c-format msgid "Consider using a custom type." msgstr "カスタム型の使用を考えましょう。" -#: index.docbook:89 -msgid "Suppose you have a Java type, say from some library, that needs to be persisted but doesn't provide the accessors needed to map it as a component. You should consider implementing <literal>org.hibernate.UserType</literal>. This approach frees the application code from implementing transformations to / from a Hibernate type." -msgstr "あるライブラリから持ってきたJava型を永続化する必要があるとしましょう。 しかしその型には、コンポーネントとしてマッピングするために必要なアクセサがないとします。 このような場合は <literal>org.hibernate.UserType</literal> の実装を考えるべきです。 そうすればHibernate型との実装変換を心配せずにアプリケーションのコードを扱えます。" +#. Tag: para +#: best_practices.xml:89 +#, no-c-format +msgid "" +"Suppose you have a Java type, say from some library, that needs to be " +"persisted but doesn't provide the accessors needed to map it as a component. " +"You should consider implementing <literal>org.hibernate.UserType</literal>. " +"This approach frees the application code from implementing transformations " +"to / from a Hibernate type." +msgstr "" +"あるライブラリから持ってきたJava型を永続化する必要があるとしましょう。 しかし" +"その型には、コンポーネントとしてマッピングするために必要なアクセサがないとし" +"ます。 このような場合は <literal>org.hibernate.UserType</literal> の実装を考" +"えるべきです。 そうすればHibernate型との実装変換を心配せずにアプリケーション" +"のコードを扱えます。" -#: index.docbook:98 +#. Tag: term +#: best_practices.xml:98 +#, no-c-format msgid "Use hand-coded JDBC in bottlenecks." msgstr "ボトルネックを解消するにはJDBCをハンドコードしましょう。" -#: index.docbook:100 -msgid "In performance-critical areas of the system, some kinds of operations might benefit from direct JDBC. But please, wait until you <emphasis>know</emphasis> something is a bottleneck. And don't assume that direct JDBC is necessarily faster. If you need to use direct JDBC, it might be worth opening a Hibernate <literal>Session</literal> and using that JDBC connection. That way you can still use the same transaction strategy and underlying connection provider." -msgstr "システムのパフォーマンスクリティカルな領域では、 ある種の操作にJDBCを直接使うと良いかもしれません。 しかし何がボトルネックになっているか <emphasis>はっきりする</emphasis> までは待ってください。 またJDBCを直接使うからといって、必ずしも速くなるとは限らないことも理解してください。 JDBCを直接使う必要があれば、Hibernateの <literal>Session</literal> をオープンして、 JDBCコネクションを使うと良いかもしれません。 依然として同じトランザクション戦略とコネクションプロバイダが使えるからです。" +#. Tag: para +#: best_practices.xml:100 +#, no-c-format +msgid "" +"In performance-critical areas of the system, some kinds of operations might " +"benefit from direct JDBC. But please, wait until you <emphasis>know</" +"emphasis> something is a bottleneck. And don't assume that direct JDBC is " +"necessarily faster. If you need to use direct JDBC, it might be worth " +"opening a Hibernate <literal>Session</literal> and using that JDBC " +"connection. That way you can still use the same transaction strategy and " +"underlying connection provider." +msgstr "" +"システムのパフォーマンスクリティカルな領域では、 ある種の操作にJDBCを直接使う" +"と良いかもしれません。 しかし何がボトルネックになっているか <emphasis>はっき" +"りする</emphasis> までは待ってください。 またJDBCを直接使うからといって、必ず" +"しも速くなるとは限らないことも理解してください。 JDBCを直接使う必要があれば、" +"Hibernateの <literal>Session</literal> をオープンして、 JDBCコネクションを使" +"うと良いかもしれません。 依然として同じトランザクション戦略とコネクションプロ" +"バイダが使えるからです。" -#: index.docbook:110 +#. Tag: term +#: best_practices.xml:110 +#, no-c-format msgid "Understand <literal>Session</literal> flushing." msgstr "<literal>Session</literal> のフラッシュを理解しましょう。" -#: index.docbook:112 -msgid "From time to time the Session synchronizes its persistent state with the database. Performance will be affected if this process occurs too often. You may sometimes minimize unnecessary flushing by disabling automatic flushing or even by changing the order of queries and other operations within a particular transaction." -msgstr "Sessionが永続状態をデータベースと同期させることがときどきあります。 しかしこれがあまりに頻繁に起こるようだと、パフォーマンスに影響が出てきます。 自動フラッシュを無効にしたり、特定のトランザクションのクエリや操作の順番を変更することで、 不必要なフラッシュを最小限にできます。" +#. Tag: para +#: best_practices.xml:112 +#, no-c-format +msgid "" +"From time to time the Session synchronizes its persistent state with the " +"database. Performance will be affected if this process occurs too often. You " +"may sometimes minimize unnecessary flushing by disabling automatic flushing " +"or even by changing the order of queries and other operations within a " +"particular transaction." +msgstr "" +"Sessionが永続状態をデータベースと同期させることがときどきあります。 しかしこ" +"れがあまりに頻繁に起こるようだと、パフォーマンスに影響が出てきます。 自動フ" +"ラッシュを無効にしたり、特定のトランザクションのクエリや操作の順番を変更する" +"ことで、 不必要なフラッシュを最小限にできます。" -#: index.docbook:121 +#. Tag: term +#: best_practices.xml:121 +#, no-c-format msgid "In a three tiered architecture, consider using detached objects." msgstr "3層アーキテクチャでは分離オブジェクトの使用を考えましょう。" -#: index.docbook:123 -msgid "When using a servlet / session bean architecture, you could pass persistent objects loaded in the session bean to and from the servlet / JSP layer. Use a new session to service each request. Use <literal>Session.merge()</literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects with the database." -msgstr "サーブレット / セッションビーンアーキテクチャを使うとき、 サーブレット層 / JSP層間でセッションビーンでロードした永続オブジェクトをやり取りできます。 その際リクエストごとに新しいSessionを使ってください。 また <literal>Session.merge()</literal> や <literal>Session.saveOrUpdate()</literal> を使って、オブジェクトとデータベースを同期させてください。" +#. Tag: para +#: best_practices.xml:123 +#, no-c-format +msgid "" +"When using a servlet / session bean architecture, you could pass persistent " +"objects loaded in the session bean to and from the servlet / JSP layer. Use " +"a new session to service each request. Use <literal>Session.merge()</" +"literal> or <literal>Session.saveOrUpdate()</literal> to synchronize objects " +"with the database." +msgstr "" +"サーブレット / セッションビーンアーキテクチャを使うとき、 サーブレット層 / " +"JSP層間でセッションビーンでロードした永続オブジェクトをやり取りできます。 そ" +"の際リクエストごとに新しいSessionを使ってください。 また <literal>Session." +"merge()</literal> や <literal>Session.saveOrUpdate()</literal> を使って、オブ" +"ジェクトとデータベースを同期させてください。" -#: index.docbook:132 +#. Tag: term +#: best_practices.xml:132 +#, no-c-format msgid "In a two tiered architecture, consider using long persistence contexts." msgstr "2層アーキテクチャでは長い永続コンテキストの使用を考えましょう。" -#: index.docbook:134 -msgid "Database Transactions have to be as short as possible for best scalability. However, it is often neccessary to implement long running <emphasis>application transactions</emphasis>, a single unit-of-work from the point of view of a user. An application transaction might span several client request/response cycles. It is common to use detached objects to implement application transactions. An alternative, extremely appropriate in two tiered architecture, is to maintain a single open persistence contact (session) for the whole life cycle of the application transaction and simply disconnect from the JDBC connection at the end of each request and reconnect at the beginning of the subsequent request. Never share a single session across more than one application transaction, or you will be working with stale data." -msgstr "最高のスケーラビリティを得るには、 データベーストランザクションをできるだけ短くしなければなりません。 しかし長い間実行する <emphasis>アプリケーショントランザクション</emphasis> の実装が必要なことはしばしばです。 これはユーザの視点からは1個の作業単位（unit of work）になります。 アプリケーショントランザクションはいくつかのクライアントのリクエスト/レスポンスサイクルにまたがります。 アプリケーショントランザクションの実装に分離オブジェクトを使うのは一般的です。 そうでなければ、2層アーキテクチャの場合は特に適切なことですが、 アプリケーショントランザクションのライフサイクル全体に対して 単一のオープンな永続化コンテキスト（セッション）を維持してください。 そして単純にリ! クエストの最後にJDBCコネクションから切断し、 次のリクエストの最初に再接続します。 決して複数のアプリケーショントランザクションユースケースに渡って 1個のSessionを使い回さないでください。 そうでなければ、古いデータで作業することになります。" +#. Tag: para +#: best_practices.xml:134 +#, no-c-format +msgid "" +"Database Transactions have to be as short as possible for best scalability. " +"However, it is often neccessary to implement long running " +"<emphasis>application transactions</emphasis>, a single unit-of-work from " +"the point of view of a user. An application transaction might span several " +"client request/response cycles. It is common to use detached objects to " +"implement application transactions. An alternative, extremely appropriate in " +"two tiered architecture, is to maintain a single open persistence contact " +"(session) for the whole life cycle of the application transaction and simply " +"disconnect from the JDBC connection at the end of each request and reconnect " +"at the beginning of the subsequent request. Never share a single session " +"across more than one application transaction, or you will be working with " +"stale data." +msgstr "" +"最高のスケーラビリティを得るには、 データベーストランザクションをできるだけ短" +"くしなければなりません。 しかし長い間実行する <emphasis>アプリケーショントラ" +"ンザクション</emphasis> の実装が必要なことはしばしばです。 これはユーザの視点" +"からは1個の作業単位（unit of work）になります。 アプリケーショントランザク" +"ションはいくつかのクライアントのリクエスト/レスポンスサイクルにまたがりま" +"す。 アプリケーショントランザクションの実装に分離オブジェクトを使うのは一般的" +"です。 そうでなければ、2層アーキテクチャの場合は特に適切なことですが、 アプリ" +"ケーショントランザクションのライフサイクル全体に対して 単一のオープンな永続化" +"コンテキスト（セッション）を維持してください。 そして単純にリクエストの最後に" +"JDBCコネクションから切断し、 次のリクエストの最初に再接続します。 決して複数" +"のアプリケーショントランザクションユースケースに渡って 1個のSessionを使い回さ" +"ないでください。 そうでなければ、古いデータで作業することになります。" -#: index.docbook:148 +#. Tag: term +#: best_practices.xml:148 +#, no-c-format msgid "Don't treat exceptions as recoverable." msgstr "例外を復帰可能なものとして扱ってはいけません。" -#: index.docbook:150 -msgid "This is more of a necessary practice than a \"best\" practice. When an exception occurs, roll back the <literal>Transaction</literal> and close the <literal>Session</literal>. If you don't, Hibernate can't guarantee that in-memory state accurately represents persistent state. As a special case of this, do not use <literal>Session.load()</literal> to determine if an instance with the given identifier exists on the database; use <literal>Session.get()</literal> or a query instead." -msgstr "これは「ベスト」プラクティス以上の、必須のプラクティスです。 例外が発生したときは <literal>Transaction</literal> をロールバックして、 <literal>Session</literal> をクローズしてください。 そうしないとHibernateはメモリの状態が永続状態を正確に表現していることを保証できません。 この特別な場合として、与えられた識別子を持つインスタンスがデータベースに存在するかどうかを判定するために、 <literal>Session.load()</literal> を使うことはやめてください。 その代わりに <literal>Session.get()</literal> かクエリを使ってください。" +#. Tag: para +#: best_practices.xml:150 +#, no-c-format +msgid "" +"This is more of a necessary practice than a \"best\" practice. When an " +"exception occurs, roll back the <literal>Transaction</literal> and close the " +"<literal>Session</literal>. If you don't, Hibernate can't guarantee that in-" +"memory state accurately represents persistent state. As a special case of " +"this, do not use <literal>Session.load()</literal> to determine if an " +"instance with the given identifier exists on the database; use " +"<literal>Session.get()</literal> or a query instead." +msgstr "" +"これは「ベスト」プラクティス以上の、必須のプラクティスです。 例外が発生したと" +"きは <literal>Transaction</literal> をロールバックして、 <literal>Session</" +"literal> をクローズしてください。 そうしないとHibernateはメモリの状態が永続状" +"態を正確に表現していることを保証できません。 この特別な場合として、与えられた" +"識別子を持つインスタンスがデータベースに存在するかどうかを判定するために、 " +"<literal>Session.load()</literal> を使うことはやめてください。 その代わりに " +"<literal>Session.get()</literal> かクエリを使ってください。" -#: index.docbook:160 +#. Tag: term +#: best_practices.xml:160 +#, no-c-format msgid "Prefer lazy fetching for associations." msgstr "関連にはなるべく遅延フェッチを使いましょう。" -#: index.docbook:162 -msgid "Use eager fetching sparingly. Use proxies and lazy collections for most associations to classes that are not likely to be completely held in the second-level cache. For associations to cached classes, where there is an a extremely high probability of a cache hit, explicitly disable eager fetching using <literal>lazy=\"false\"</literal>. When an join fetching is appropriate to a particular use case, use a query with a <literal>left join fetch</literal>." -msgstr "即時フェッチは控えめにしましょう。 二次キャッシュには完全に保持されないようなクラスの関連には、 プロキシと遅延コレクションを使ってください。 キャッシュされるクラスの関連、つまりキャッシュがヒットする可能性が非常に高い関連は、 <literal>lazy=\"false\"</literal> で積極的なフェッチを明示的に無効にしてください。 結合フェッチが適切な特定のユースケースには、 クエリで <literal>left join fetch</literal> を使ってください。" +#. Tag: para +#: best_practices.xml:162 +#, no-c-format +msgid "" +"Use eager fetching sparingly. Use proxies and lazy collections for most " +"associations to classes that are not likely to be completely held in the " +"second-level cache. For associations to cached classes, where there is an a " +"extremely high probability of a cache hit, explicitly disable eager fetching " +"using <literal>lazy=\"false\"</literal>. When an join fetching is " +"appropriate to a particular use case, use a query with a <literal>left join " +"fetch</literal>." +msgstr "" +"即時フェッチは控えめにしましょう。 二次キャッシュには完全に保持されないような" +"クラスの関連には、 プロキシと遅延コレクションを使ってください。 キャッシュさ" +"れるクラスの関連、つまりキャッシュがヒットする可能性が非常に高い関連は、 " +"<literal>lazy=\"false\"</literal> で積極的なフェッチを明示的に無効にしてくだ" +"さい。 結合フェッチが適切な特定のユースケースには、 クエリで <literal>left " +"join fetch</literal> を使ってください。" -#: index.docbook:172 -msgid "Use the <emphasis>open session in view</emphasis> pattern, or a disciplined <emphasis>assembly phase</emphasis> to avoid problems with unfetched data." -msgstr "フェッチされていないデータに関わる問題を避けるために、 <emphasis>ビューの中でオープンセッションを使う(open session in view)</emphasis> パターンか、統制された <emphasis>組み立てフェーズ(assembly phase)</emphasis> を使いましょう。" +#. Tag: term +#: best_practices.xml:172 +#, no-c-format +msgid "" +"Use the <emphasis>open session in view</emphasis> pattern, or a disciplined " +"<emphasis>assembly phase</emphasis> to avoid problems with unfetched data." +msgstr "" +"フェッチされていないデータに関わる問題を避けるために、 <emphasis>ビューの中で" +"オープンセッションを使う(open session in view)</emphasis> パターンか、統制さ" +"れた <emphasis>組み立てフェーズ(assembly phase)</emphasis> を使いましょう。" -#: index.docbook:177 -msgid "Hibernate frees the developer from writing tedious <emphasis>Data Transfer Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual purposes: first, they work around the problem that entity beans are not serializable; second, they implicitly define an assembly phase where all data to be used by the view is fetched and marshalled into the DTOs before returning control to the presentation tier. Hibernate eliminates the first purpose. However, you will still need an assembly phase (think of your business methods as having a strict contract with the presentation tier about what data is available in the detached objects) unless you are prepared to hold the persistence context (the session) open across the view rendering process. This is not a limitation of Hibernate! It is a fundamental requirement of safe transactional data access." -msgstr "Hibernateは <emphasis>Data Transfer Objects</emphasis> (DTO)を書く退屈な作業から開発者を解放します。 伝統的なEJBアーキテクチャではDTOは二つ目的があります： 1つ目は、エンティティビーンがシリアライズされない問題への対策です。 2つ目は、プレゼンテーション層に制御が戻る前に、 ビューに使われるすべてのデータがフェッチされて、DTOに復元されるような組み立てフェーズを暗黙的に定義します。 Hibernateでは1つ目の目的が不要になります。 しかしビューのレンダリング処理の間、永続コンテキスト（セッション）をオープンにしたままにしなければ、 組み立てフェーズはまだ必要です（分離オブジェクトの中のどのデータが利用可能かについて、 プレゼンテーション層と厳密な取り決めをしているビジネスメソッドを考えて�! �てください）。 これはHibernate側の問題ではありません。 トランザクション内で安全にデータアクセスするための基本的な要件です。" +#. Tag: para +#: best_practices.xml:177 +#, no-c-format +msgid "" +"Hibernate frees the developer from writing tedious <emphasis>Data Transfer " +"Objects</emphasis> (DTO). In a traditional EJB architecture, DTOs serve dual " +"purposes: first, they work around the problem that entity beans are not " +"serializable; second, they implicitly define an assembly phase where all " +"data to be used by the view is fetched and marshalled into the DTOs before " +"returning control to the presentation tier. Hibernate eliminates the first " +"purpose. However, you will still need an assembly phase (think of your " +"business methods as having a strict contract with the presentation tier " +"about what data is available in the detached objects) unless you are " +"prepared to hold the persistence context (the session) open across the view " +"rendering process. This is not a limitation of Hibernate! It is a " +"fundamental requirement of safe transactional data access." +msgstr "" +"Hibernateは <emphasis>Data Transfer Objects</emphasis> (DTO)を書く退屈な作業" +"から開発者を解放します。 伝統的なEJBアーキテクチャではDTOは二つ目的がありま" +"す： 1つ目は、エンティティビーンがシリアライズされない問題への対策です。 2つ" +"目は、プレゼンテーション層に制御が戻る前に、 ビューに使われるすべてのデータが" +"フェッチされて、DTOに復元されるような組み立てフェーズを暗黙的に定義します。 " +"Hibernateでは1つ目の目的が不要になります。 しかしビューのレンダリング処理の" +"間、永続コンテキスト（セッション）をオープンにしたままにしなければ、 組み立て" +"フェーズはまだ必要です（分離オブジェクトの中のどのデータが利用可能かについ" +"て、 プレゼンテーション層と厳密な取り決めをしているビジネスメソッドを考えてみ" +"てください）。 これはHibernate側の問題ではありません。 トランザクション内で安" +"全にデータアクセスするための基本的な要件です。" -#: index.docbook:191 +#. Tag: term +#: best_practices.xml:191 +#, no-c-format msgid "Consider abstracting your business logic from Hibernate." msgstr "Hibernateからビジネスロジックを抽象化することを考えましょう。" -#: index.docbook:193 -msgid "Hide (Hibernate) data-access code behind an interface. Combine the <emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> patterns. You can even have some classes persisted by handcoded JDBC, associated to Hibernate via a <literal>UserType</literal>. (This advice is intended for \"sufficiently large\" applications; it is not appropriate for an application with five tables!)" -msgstr "インターフェイスで（Hibernateの）データアクセスコードを隠蔽しましょう。 <emphasis>DAO</emphasis> と <emphasis>Thread Local Session</emphasis> パターンを組み合わせましょう。 <literal>UserType</literal> でHibernateに関連付けると、 ハンドコードしたJDBCで永続化するクラスを持つこともできます。 （このアドバイスは「十分大きな」アプリケーションに対してのものです。 テーブルが5個しかないようなアプリケーションには当てはまりません。）" +#. Tag: para +#: best_practices.xml:193 +#, no-c-format +msgid "" +"Hide (Hibernate) data-access code behind an interface. Combine the " +"<emphasis>DAO</emphasis> and <emphasis>Thread Local Session</emphasis> " +"patterns. You can even have some classes persisted by handcoded JDBC, " +"associated to Hibernate via a <literal>UserType</literal>. (This advice is " +"intended for \"sufficiently large\" applications; it is not appropriate for " +"an application with five tables!)" +msgstr "" +"インターフェイスで（Hibernateの）データアクセスコードを隠蔽しましょう。 " +"<emphasis>DAO</emphasis> と <emphasis>Thread Local Session</emphasis> パター" +"ンを組み合わせましょう。 <literal>UserType</literal> でHibernateに関連付ける" +"と、 ハンドコードしたJDBCで永続化するクラスを持つこともできます。 （このアド" +"バイスは「十分大きな」アプリケーションに対してのものです。 テーブルが5個しか" +"ないようなアプリケーションには当てはまりません。）" -#: index.docbook:203 +#. Tag: term +#: best_practices.xml:203 +#, no-c-format msgid "Don't use exotic association mappings." msgstr "珍しい関連マッピングは使わないようにしましょう。" -#: index.docbook:205 -msgid "Good usecases for a real many-to-many associations are rare. Most of the time you need additional information stored in the \"link table\". In this case, it is much better to use two one-to-many associations to an intermediate link class. In fact, we think that most associations are one-to-many and many-to-one, you should be careful when using any other association style and ask yourself if it is really neccessary." -msgstr "よいユースケースに本当の多対多関連があることは稀（まれ）です。 ほとんどの場合「リンクテーブル」の付加的な情報が必要になります。 この場合、リンククラスに2つの1対多関連を使う方がずっと良いです。 実際ほとんどの場合関連は1対多と多対1なので、 他のスタイルの関連を使うときは本当に必要かどうかを考えてみてください。" +#. Tag: para +#: best_practices.xml:205 +#, no-c-format +msgid "" +"Good usecases for a real many-to-many associations are rare. Most of the " +"time you need additional information stored in the \"link table\". In this " +"case, it is much better to use two one-to-many associations to an " +"intermediate link class. In fact, we think that most associations are one-to-" +"many and many-to-one, you should be careful when using any other association " +"style and ask yourself if it is really neccessary." +msgstr "" +"よいユースケースに本当の多対多関連があることは稀（まれ）です。 ほとんどの場合" +"「リンクテーブル」の付加的な情報が必要になります。 この場合、リンククラスに2" +"つの1対多関連を使う方がずっと良いです。 実際ほとんどの場合関連は1対多と多対1" +"なので、 他のスタイルの関連を使うときは本当に必要かどうかを考えてみてくださ" +"い。" -#: index.docbook:215 +#. Tag: term +#: best_practices.xml:215 +#, no-c-format msgid "Prefer bidirectional associations." msgstr "なるべく双方向関連にしましょう。" -#: index.docbook:217 -msgid "Unidirectional associations are more difficult to query. In a large application, almost all associations must be navigable in both directions in queries." -msgstr "単方向関連は双方向に比べて検索が難しくなります。 大きなアプリケーションでは、 ほとんどすべての関連が双方向にナビゲーションできなければなりません。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: best_practices.xml:217 +#, no-c-format +msgid "" +"Unidirectional associations are more difficult to query. In a large " +"application, almost all associations must be navigable in both directions in " +"queries." +msgstr "" +"単方向関連は双方向に比べて検索が難しくなります。 大きなアプリケーションで" +"は、 ほとんどすべての関連が双方向にナビゲーションできなければなりません。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/collection_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1287 +1,1899 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: collection_mapping.xml:5 +#, no-c-format msgid "Collection Mapping" msgstr "コレクションのマッピング" -#: index.docbook:8 +#. Tag: title +#: collection_mapping.xml:8 +#, no-c-format msgid "Persistent collections" msgstr "コレクションの永続化" -#: index.docbook:10 -msgid "Hibernate requires that persistent collection-valued fields be declared as an interface type, for example:" -msgstr "コレクション型のフィールドを永続化するには、 そのコレクション型がインターフェイス型である必要があります。 例えば、" +#. Tag: para +#: collection_mapping.xml:10 +#, no-c-format +msgid "" +"Hibernate requires that persistent collection-valued fields be declared as " +"an interface type, for example:" +msgstr "" +"コレクション型のフィールドを永続化するには、 そのコレクション型がインターフェ" +"イス型である必要があります。 例えば、" -#: index.docbook:15 +#. Tag: programlisting +#: collection_mapping.xml:15 +#, no-c-format msgid "" - "<![CDATA[public class Product {\n" - " private String serialNumber;\n" - " private Set parts = new HashSet();\n" - " \n" - " public Set getParts() { return parts; }\n" - " void setParts(Set parts) { this.parts = parts; }\n" - " public String getSerialNumber() { return serialNumber; }\n" - " void setSerialNumber(String sn) { serialNumber = sn; }\n" - "}]]>" +"<![CDATA[public class Product {\n" +" private String serialNumber;\n" +" private Set parts = new HashSet();\n" +" \n" +" public Set getParts() { return parts; }\n" +" void setParts(Set parts) { this.parts = parts; }\n" +" public String getSerialNumber() { return serialNumber; }\n" +" void setSerialNumber(String sn) { serialNumber = sn; }\n" +"}]]>" msgstr "" - "<![CDATA[public class Product {\n" - " private String serialNumber;\n" - " private Set parts = new HashSet();\n" - " \n" - " public Set getParts() { return parts; }\n" - " void setParts(Set parts) { this.parts = parts; }\n" - " public String getSerialNumber() { return serialNumber; }\n" - " void setSerialNumber(String sn) { serialNumber = sn; }\n" - "}]]>" -#: index.docbook:17 -msgid "The actual interface might be <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> or ... anything you like! (Where \"anything you like\" means you will have to write an implementation of <literal>org.hibernate.usertype.UserCollectionType</literal>.)" -msgstr "実在するインターフェイスには <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> などがあります。 または、任意のインターフェイスが使えます！ （ただし、任意のインターフェイスを使用する場合は、 <literal>org.hibernate.usertype.UserCollectionType</literal> の実装クラスを作成する必要があります。）" +#. Tag: para +#: collection_mapping.xml:17 +#, no-c-format +msgid "" +"The actual interface might be <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> or ... anything you like! (Where " +"\"anything you like\" means you will have to write an implementation of " +"<literal>org.hibernate.usertype.UserCollectionType</literal>.)" +msgstr "" +"実在するインターフェイスには <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> などがあります。 または、任意のイン" +"ターフェイスが使えます！ （ただし、任意のインターフェイスを使用する場合は、 " +"<literal>org.hibernate.usertype.UserCollectionType</literal> の実装クラスを作" +"成する必要があります。）" -#: index.docbook:26 -msgid "Notice how we initialized the instance variable with an instance of <literal>HashSet</literal>. This is the best way to initialize collection valued properties of newly instantiated (non-persistent) instances. When you make the instance persistent - by calling <literal>persist()</literal>, for example - Hibernate will actually replace the <literal>HashSet</literal> with an instance of Hibernate's own implementation of <literal>Set</literal>. Watch out for errors like this:" -msgstr "<literal>HashSet</literal> のインスタンスを持つインスタンス変数が どのように初期化されるかに注目してみましょう。 これは新たに生成された（永続化されていない）コレクション型のプロパティを 初期化する最適な方法です。 （例えば <literal>persist()</literal> により）インスタンスを永続化しようとしたとき、 Hibernateは <literal>HashSet</literal> をHibernate独自の <literal>Set</literal> の実装クラスに置き換えます。 このため、次のようなエラーには注意が必要です。" +#. Tag: para +#: collection_mapping.xml:26 +#, no-c-format +msgid "" +"Notice how we initialized the instance variable with an instance of " +"<literal>HashSet</literal>. This is the best way to initialize collection " +"valued properties of newly instantiated (non-persistent) instances. When you " +"make the instance persistent - by calling <literal>persist()</literal>, for " +"example - Hibernate will actually replace the <literal>HashSet</literal> " +"with an instance of Hibernate's own implementation of <literal>Set</" +"literal>. Watch out for errors like this:" +msgstr "" +"<literal>HashSet</literal> のインスタンスを持つインスタンス変数が どのように" +"初期化されるかに注目してみましょう。 これは新たに生成された（永続化されていな" +"い）コレクション型のプロパティを 初期化する最適な方法です。 （例えば " +"<literal>persist()</literal> により）インスタンスを永続化しようとしたとき、 " +"Hibernateは <literal>HashSet</literal> をHibernate独自の <literal>Set</" +"literal> の実装クラスに置き換えます。 このため、次のようなエラーには注意が必" +"要です。" -#: index.docbook:36 +#. Tag: programlisting +#: collection_mapping.xml:36 +#, no-c-format msgid "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "Cat kitten = new DomesticCat();\n" - "....\n" - "Set kittens = new HashSet();\n" - "kittens.add(kitten);\n" - "cat.setKittens(kittens);\n" - "session.persist(cat);\n" - "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" - "(HashSet) cat.getKittens(); // Error!]]>" +"<![CDATA[Cat cat = new DomesticCat();\n" +"Cat kitten = new DomesticCat();\n" +"....\n" +"Set kittens = new HashSet();\n" +"kittens.add(kitten);\n" +"cat.setKittens(kittens);\n" +"session.persist(cat);\n" +"kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" +"(HashSet) cat.getKittens(); // Error!]]>" msgstr "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "Cat kitten = new DomesticCat();\n" - "....\n" - "Set kittens = new HashSet();\n" - "kittens.add(kitten);\n" - "cat.setKittens(kittens);\n" - "session.persist(cat);\n" - "kittens = cat.getKittens(); // Okay, kittens collection is a Set\n" - "(HashSet) cat.getKittens(); // Error!]]>" -#: index.docbook:38 -msgid "The persistent collections injected by Hibernate behave like <literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, depending upon the interface type." -msgstr "Hibernateにより注入された永続性コレクションは、インターフェイス型に応じて、 <literal>HashMap</literal> や <literal>HashSet</literal>、 <literal>TreeMap</literal>、 <literal>TreeSet</literal>、 <literal>ArrayList</literal> のように振舞います。" +#. Tag: para +#: collection_mapping.xml:38 +#, no-c-format +msgid "" +"The persistent collections injected by Hibernate behave like " +"<literal>HashMap</literal>, <literal>HashSet</literal>, <literal>TreeMap</" +"literal>, <literal>TreeSet</literal> or <literal>ArrayList</literal>, " +"depending upon the interface type." +msgstr "" +"Hibernateにより注入された永続性コレクションは、インターフェイス型に応じて、 " +"<literal>HashMap</literal> や <literal>HashSet</literal>、 <literal>TreeMap</" +"literal>、 <literal>TreeSet</literal>、 <literal>ArrayList</literal> のように" +"振舞います。" -#: index.docbook:45 -msgid "Collections instances have the usual behavior of value types. They are automatically persisted when referenced by a persistent object and automatically deleted when unreferenced. If a collection is passed from one persistent object to another, its elements might be moved from one table to another. Two entities may not share a reference to the same collection instance. Due to the underlying relational model, collection-valued properties do not support null value semantics; Hibernate does not distinguish between a null collection reference and an empty collection." -msgstr "コレクションインスタンスは、値型として普通に振舞います。 永続化オブジェクトに参照されたときに自動的に永続化され、 参照がなくなったときに自動的に削除されます。 もしある永続化オブジェクトから別の永続化オブジェクトに渡されたら、 その要素は現在のテーブルから別のテーブルに移動するかもしれません。 ２つのエンティティが同じコレクションインスタンスを共有してはいけません。 リレーショナルモデルをベースにしているため、コレクション型のプロパティに null値を代入しても意味がありません。 つまりHibernateは参照先のないコレクションと空のコレクションを区別しません。" +#. Tag: para +#: collection_mapping.xml:45 +#, no-c-format +msgid "" +"Collections instances have the usual behavior of value types. They are " +"automatically persisted when referenced by a persistent object and " +"automatically deleted when unreferenced. If a collection is passed from one " +"persistent object to another, its elements might be moved from one table to " +"another. Two entities may not share a reference to the same collection " +"instance. Due to the underlying relational model, collection-valued " +"properties do not support null value semantics; Hibernate does not " +"distinguish between a null collection reference and an empty collection." +msgstr "" +"コレクションインスタンスは、値型として普通に振舞います。 永続化オブジェクトに" +"参照されたときに自動的に永続化され、 参照がなくなったときに自動的に削除されま" +"す。 もしある永続化オブジェクトから別の永続化オブジェクトに渡されたら、 その" +"要素は現在のテーブルから別のテーブルに移動するかもしれません。 ２つのエンティ" +"ティが同じコレクションインスタンスを共有してはいけません。 リレーショナルモデ" +"ルをベースにしているため、コレクション型のプロパティに null値を代入しても意味" +"がありません。 つまりHibernateは参照先のないコレクションと空のコレクションを" +"区別しません。" -#: index.docbook:56 -msgid "You shouldn't have to worry much about any of this. Use persistent collections the same way you use ordinary Java collections. Just make sure you understand the semantics of bidirectional associations (discussed later)." -msgstr "しかしそれほど心配しなくても構いません。 普段使っているJavaのコレクションと同じように、永続化コレクションを使ってください。 双方向関連の意味を理解すればよいのです（これは後ほど説明します）。" +#. Tag: para +#: collection_mapping.xml:56 +#, no-c-format +msgid "" +"You shouldn't have to worry much about any of this. Use persistent " +"collections the same way you use ordinary Java collections. Just make sure " +"you understand the semantics of bidirectional associations (discussed later)." +msgstr "" +"しかしそれほど心配しなくても構いません。 普段使っているJavaのコレクションと同" +"じように、永続化コレクションを使ってください。 双方向関連の意味を理解すればよ" +"いのです（これは後ほど説明します）。" -#: index.docbook:65 +#. Tag: title +#: collection_mapping.xml:65 +#, no-c-format msgid "Collection mappings" msgstr "コレクションのマッピング" -#: index.docbook:67 -msgid "The Hibernate mapping element used for mapping a collection depends upon the type of the interface. For example, a <literal>&lt;set&gt;</literal> element is used for mapping properties of type <literal>Set</literal>." -msgstr "コレクションをマッピングするためのマッピング要素は、インターフェイスの型に依存します。 例えば、<literal>&lt;set&gt;</literal> 要素は <literal>Set</literal> 型を マッピングするために使います。" +#. Tag: para +#: collection_mapping.xml:67 +#, no-c-format +msgid "" +"The Hibernate mapping element used for mapping a collection depends upon the " +"type of the interface. For example, a <literal>&lt;set&gt;</literal> element " +"is used for mapping properties of type <literal>Set</literal>." +msgstr "" +"コレクションをマッピングするためのマッピング要素は、インターフェイスの型に依" +"存します。 例えば、<literal>&lt;set&gt;</literal> 要素は <literal>Set</" +"literal> 型を マッピングするために使います。" -#: index.docbook:73 +#. Tag: programlisting +#: collection_mapping.xml:73 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Product\">\n" - " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" - " <set name=\"parts\">\n" - " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" - " <one-to-many class=\"Part\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Product\">\n" +" <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" +" <set name=\"parts\">\n" +" <key column=\"productSerialNumber\" not-null=\"true\"/>\n" +" <one-to-many class=\"Part\"/>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Product\">\n" - " <id name=\"serialNumber\" column=\"productSerialNumber\"/>\n" - " <set name=\"parts\">\n" - " <key column=\"productSerialNumber\" not-null=\"true\"/>\n" - " <one-to-many class=\"Part\"/>\n" - " </set>\n" - "</class>]]>" -#: index.docbook:75 -msgid "Apart from <literal>&lt;set&gt;</literal>, there is also <literal>&lt;list&gt;</literal>, <literal>&lt;map&gt;</literal>, <literal>&lt;bag&gt;</literal>, <literal>&lt;array&gt;</literal> and <literal>&lt;primitive-array&gt;</literal> mapping elements. The <literal>&lt;map&gt;</literal> element is representative:" -msgstr "マッピング要素には <literal>&lt;set&gt;</literal> の他に <literal>&lt;list&gt;</literal>、 <literal>&lt;map&gt;</literal>、<literal>&lt;bag&gt;</literal>、 <literal>&lt;array&gt;</literal>、<literal>&lt;primitive-array&gt;</literal> があります。 代表として、<literal>&lt;map&gt;</literal> 要素を下記に示します。" +#. Tag: para +#: collection_mapping.xml:75 +#, no-c-format +msgid "" +"Apart from <literal>&lt;set&gt;</literal>, there is also <literal>&lt;" +"list&gt;</literal>, <literal>&lt;map&gt;</literal>, <literal>&lt;bag&gt;</" +"literal>, <literal>&lt;array&gt;</literal> and <literal>&lt;primitive-" +"array&gt;</literal> mapping elements. The <literal>&lt;map&gt;</literal> " +"element is representative:" +msgstr "" +"マッピング要素には <literal>&lt;set&gt;</literal> の他に <literal>&lt;" +"list&gt;</literal>、 <literal>&lt;map&gt;</literal>、<literal>&lt;bag&gt;</" +"literal>、 <literal>&lt;array&gt;</literal>、<literal>&lt;primitive-array&gt;" +"</literal> があります。 代表として、<literal>&lt;map&gt;</literal> 要素を下記" +"に示します。" -#: index.docbook:100 +#. Tag: programlisting +#: collection_mapping.xml:100 +#, no-c-format msgid "" - "<![CDATA[<map\n" - " name=\"propertyName\"\n" - " table=\"table_name\"\n" - " schema=\"schema_name\"\n" - " lazy=\"true|extra|false\"\n" - " inverse=\"true|false\"\n" - " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" - " sort=\"unsorted|natural|comparatorClass\"\n" - " order-by=\"column_name asc|desc\"\n" - " where=\"arbitrary sql where condition\"\n" - " fetch=\"join|select|subselect\"\n" - " batch-size=\"N\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - " mutable=\"true|false\"\n" - " node=\"element-name|.\"\n" - " embed-xml=\"true|false\"\n" - ">\n" - "\n" - " <key .... />\n" - " <map-key .... />\n" - " <element .... />\n" - "</map>]]>" +"<![CDATA[<map\n" +" name=\"propertyName\"\n" +" table=\"table_name\"\n" +" schema=\"schema_name\"\n" +" lazy=\"true|extra|false\"\n" +" inverse=\"true|false\"\n" +" cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" +" sort=\"unsorted|natural|comparatorClass\"\n" +" order-by=\"column_name asc|desc\"\n" +" where=\"arbitrary sql where condition\"\n" +" fetch=\"join|select|subselect\"\n" +" batch-size=\"N\"\n" +" access=\"field|property|ClassName\"\n" +" optimistic-lock=\"true|false\"\n" +" mutable=\"true|false\"\n" +" node=\"element-name|.\"\n" +" embed-xml=\"true|false\"\n" +">\n" +"\n" +" <key .... />\n" +" <map-key .... />\n" +" <element .... />\n" +"</map>]]>" msgstr "" - "<![CDATA[<map\n" - " name=\"propertyName\"\n" - " table=\"table_name\"\n" - " schema=\"schema_name\"\n" - " lazy=\"true|extra|false\"\n" - " inverse=\"true|false\"\n" - " cascade=\"all|none|save-update|delete|all-delete-orphan|delete-orphan\"\n" - " sort=\"unsorted|natural|comparatorClass\"\n" - " order-by=\"column_name asc|desc\"\n" - " where=\"arbitrary sql where condition\"\n" - " fetch=\"join|select|subselect\"\n" - " batch-size=\"N\"\n" - " access=\"field|property|ClassName\"\n" - " optimistic-lock=\"true|false\"\n" - " mutable=\"true|false\"\n" - " node=\"element-name|.\"\n" - " embed-xml=\"true|false\"\n" - ">\n" - "\n" - " <key .... />\n" - " <map-key .... />\n" - " <element .... />\n" - "</map>]]>" -#: index.docbook:103 +#. Tag: para +#: collection_mapping.xml:103 +#, no-c-format msgid "<literal>name</literal> the collection property name" msgstr "<literal>name</literal> コレクション型であるプロパティの名前" -#: index.docbook:108 -msgid "<literal>table</literal> (optional - defaults to property name) the name of the collection table (not used for one-to-many associations)" -msgstr "<literal>table</literal> （オプション - デフォルトはプロパティ名）コレクションテーブルの名前 （一対多関連では使用しません）。" +#. Tag: para +#: collection_mapping.xml:108 +#, no-c-format +msgid "" +"<literal>table</literal> (optional - defaults to property name) the name of " +"the collection table (not used for one-to-many associations)" +msgstr "" +"<literal>table</literal> （オプション - デフォルトはプロパティ名）コレクショ" +"ンテーブルの名前 （一対多関連では使用しません）。" -#: index.docbook:114 -msgid "<literal>schema</literal> (optional) the name of a table schema to override the schema declared on the root element" -msgstr "<literal>schema</literal> （オプション）テーブルスキーマの名前。 ルート要素で宣言されているスキーマより優先されます。" +#. Tag: para +#: collection_mapping.xml:114 +#, no-c-format +msgid "" +"<literal>schema</literal> (optional) the name of a table schema to override " +"the schema declared on the root element" +msgstr "" +"<literal>schema</literal> （オプション）テーブルスキーマの名前。 ルート要素で" +"宣言されているスキーマより優先されます。" -#: index.docbook:120 -msgid "<literal>lazy</literal> (optional - defaults to <literal>true</literal>) may be used to disable lazy fetching and specify that the association is always eagerly fetched, or to enable \"extra-lazy\" fetching where most operations do not initialize the collection (suitable for very large collections)" -msgstr "<literal>lazy</literal> （オプション - デフォルトは <literal>true</literal>） 遅延フェッチを無効にし、関連を常に即時にフェッチにするために使用します。 または、「extra-lazy」フェッチを有効にするために使用します。 「extra-lazy」フェッチは、ほとんどの操作ではコレクションを初期化しません （非常に大きなコレクションに適しています）。" +#. Tag: para +#: collection_mapping.xml:120 +#, no-c-format +msgid "" +"<literal>lazy</literal> (optional - defaults to <literal>true</literal>) may " +"be used to disable lazy fetching and specify that the association is always " +"eagerly fetched, or to enable \"extra-lazy\" fetching where most operations " +"do not initialize the collection (suitable for very large collections)" +msgstr "" +"<literal>lazy</literal> （オプション - デフォルトは <literal>true</" +"literal>） 遅延フェッチを無効にし、関連を常に即時にフェッチにするために使用し" +"ます。 または、「extra-lazy」フェッチを有効にするために使用します。 「extra-" +"lazy」フェッチは、ほとんどの操作ではコレクションを初期化しません （非常に大き" +"なコレクションに適しています）。" -#: index.docbook:129 -msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>) mark this collection as the \"inverse\" end of a bidirectional association" -msgstr "<literal>inverse</literal> （オプション - デフォルトは <literal>false</literal>） このコレクションが双方向関連の「逆」側であるとマークします。" +#. Tag: para +#: collection_mapping.xml:129 +#, no-c-format +msgid "" +"<literal>inverse</literal> (optional - defaults to <literal>false</literal>) " +"mark this collection as the \"inverse\" end of a bidirectional association" +msgstr "" +"<literal>inverse</literal> （オプション - デフォルトは <literal>false</" +"literal>） このコレクションが双方向関連の「逆」側であるとマークします。" -#: index.docbook:135 -msgid "<literal>cascade</literal> (optional - defaults to <literal>none</literal>) enable operations to cascade to child entities" -msgstr "<literal>cascade</literal> （オプション - デフォルトは <literal>none</literal>） 子エンティティへのカスケード操作を有効にします。" +#. Tag: para +#: collection_mapping.xml:135 +#, no-c-format +msgid "" +"<literal>cascade</literal> (optional - defaults to <literal>none</literal>) " +"enable operations to cascade to child entities" +msgstr "" +"<literal>cascade</literal> （オプション - デフォルトは <literal>none</" +"literal>） 子エンティティへのカスケード操作を有効にします。" -#: index.docbook:141 -msgid "<literal>sort</literal> (optional) specify a sorted collection with <literal>natural</literal> sort order, or a given comparator class" -msgstr "<literal>sort</literal> （オプション）コレクションを自然な順序でソートする場合は <literal>natural</literal> を指定します。 あるいはComparatorクラスを指定します。" +#. Tag: para +#: collection_mapping.xml:141 +#, no-c-format +msgid "" +"<literal>sort</literal> (optional) specify a sorted collection with " +"<literal>natural</literal> sort order, or a given comparator class" +msgstr "" +"<literal>sort</literal> （オプション）コレクションを自然な順序でソートする場" +"合は <literal>natural</literal> を指定します。 あるいはComparatorクラスを指定" +"します。" -#: index.docbook:147 -msgid "<literal>order-by</literal> (optional, JDK1.4 only) specify a table column (or columns) that define the iteration order of the <literal>Map</literal>, <literal>Set</literal> or bag, together with an optional <literal>asc</literal> or <literal>desc</literal>" -msgstr "<literal>order-by</literal> （オプション、JDK1.4のみ） <literal>Map</literal>、<literal>Set</literal>、bagのイテレーション順序を定義する テーブルカラムを指定すると共に、 オプションとして <literal>asc</literal>、<literal>desc</literal> を指定します。" +#. Tag: para +#: collection_mapping.xml:147 +#, no-c-format +msgid "" +"<literal>order-by</literal> (optional, JDK1.4 only) specify a table column " +"(or columns) that define the iteration order of the <literal>Map</literal>, " +"<literal>Set</literal> or bag, together with an optional <literal>asc</" +"literal> or <literal>desc</literal>" +msgstr "" +"<literal>order-by</literal> （オプション、JDK1.4のみ） <literal>Map</" +"literal>、<literal>Set</literal>、bagのイテレーション順序を定義する テーブル" +"カラムを指定すると共に、 オプションとして <literal>asc</literal>、" +"<literal>desc</literal> を指定します。" -#: index.docbook:154 -msgid "<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</literal> condition to be used when retrieving or removing the collection (useful if the collection should contain only a subset of the available data)" -msgstr "<literal>where</literal> （オプション）コレクションの検索や削除の際に使う 任意のSQLの<literal>WHERE</literal> 条件を指定します （利用可能なデータの一部分だけをコレクションが含むべきときに、これは有用です）。" +#. Tag: para +#: collection_mapping.xml:154 +#, no-c-format +msgid "" +"<literal>where</literal> (optional) specify an arbitrary SQL <literal>WHERE</" +"literal> condition to be used when retrieving or removing the collection " +"(useful if the collection should contain only a subset of the available data)" +msgstr "" +"<literal>where</literal> （オプション）コレクションの検索や削除の際に使う 任" +"意のSQLの<literal>WHERE</literal> 条件を指定します （利用可能なデータの一部分" +"だけをコレクションが含むべきときに、これは有用です）。" -#: index.docbook:161 -msgid "<literal>fetch</literal> (optional, defaults to <literal>select</literal>) Choose between outer-join fetching, fetching by sequential select, and fetching by sequential subselect." -msgstr "<literal>fetch</literal>（オプション - デフォルトは <literal>select</literal>） 外部結合によるフェッチ、順次選択フェッチ（sequential select fetch）、 順次サブセレクトフェッチ（sequential subselect fetch）のどれかを選択してください。" +#. Tag: para +#: collection_mapping.xml:161 +#, no-c-format +msgid "" +"<literal>fetch</literal> (optional, defaults to <literal>select</literal>) " +"Choose between outer-join fetching, fetching by sequential select, and " +"fetching by sequential subselect." +msgstr "" +"<literal>fetch</literal>（オプション - デフォルトは <literal>select</" +"literal>） 外部結合によるフェッチ、順次選択フェッチ（sequential select " +"fetch）、 順次サブセレクトフェッチ（sequential subselect fetch）のどれかを選" +"択してください。" -#: index.docbook:168 -msgid "<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) specify a \"batch size\" for lazily fetching instances of this collection." -msgstr "<literal>batch-size</literal> （オプション - デフォルトは <literal>1</literal>） コレクションのインスタンスの遅延フェッチのための「バッチサイズ」を指定します。" +#. Tag: para +#: collection_mapping.xml:168 +#, no-c-format +msgid "" +"<literal>batch-size</literal> (optional, defaults to <literal>1</literal>) " +"specify a \"batch size\" for lazily fetching instances of this collection." +msgstr "" +"<literal>batch-size</literal> （オプション - デフォルトは <literal>1</" +"literal>） コレクションのインスタンスの遅延フェッチのための「バッチサイズ」を" +"指定します。" -#: index.docbook:174 -msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing the collection property value." -msgstr "<literal>access</literal> （オプション - デフォルトは <literal>property</literal>） コレクション型プロパティの値にアクセスするために使用する戦略です。" +#. Tag: para +#: collection_mapping.xml:174 +#, no-c-format +msgid "" +"<literal>access</literal> (optional - defaults to <literal>property</" +"literal>): The strategy Hibernate should use for accessing the collection " +"property value." +msgstr "" +"<literal>access</literal> （オプション - デフォルトは <literal>property</" +"literal>） コレクション型プロパティの値にアクセスするために使用する戦略です。" -#: index.docbook:180 -msgid "<literal>optimistic-lock</literal> (optional - defaults to <literal>true</literal>): Species that changes to the state of the collection results in increment of the owning entity's version. (For one to many associations, it is often reasonable to disable this setting.)" -msgstr "<literal>optimistic-lock</literal>（オプション - デフォルトは <literal>true</literal>） コレクションの状態を変えることによって、 そのオーナーであるエンティティのバージョンがインクリメントされるかを指定します。 （一対多関連では、ほとんどの場合において無効に設定するのが妥当です。）" +#. Tag: para +#: collection_mapping.xml:180 +#, no-c-format +msgid "" +"<literal>optimistic-lock</literal> (optional - defaults to <literal>true</" +"literal>): Species that changes to the state of the collection results in " +"increment of the owning entity's version. (For one to many associations, it " +"is often reasonable to disable this setting.)" +msgstr "" +"<literal>optimistic-lock</literal>（オプション - デフォルトは <literal>true</" +"literal>） コレクションの状態を変えることによって、 そのオーナーであるエン" +"ティティのバージョンがインクリメントされるかを指定します。 （一対多関連では、" +"ほとんどの場合において無効に設定するのが妥当です。）" -#: index.docbook:188 -msgid "<literal>mutable</literal> (optional - defaults to <literal>true</literal>): A value of <literal>false</literal> specifies that the elements of the collection never change (a minor performance optimization in some cases)." -msgstr "<literal>mutable</literal>（オプション - デフォルトは <literal>true</literal>） <literal>false</literal> 値は、コレクションの要素が変更されないことを表します （ある場合には、少しパフォーマンスを高めます）。" +#. Tag: para +#: collection_mapping.xml:188 +#, no-c-format +msgid "" +"<literal>mutable</literal> (optional - defaults to <literal>true</literal>): " +"A value of <literal>false</literal> specifies that the elements of the " +"collection never change (a minor performance optimization in some cases)." +msgstr "" +"<literal>mutable</literal>（オプション - デフォルトは <literal>true</" +"literal>） <literal>false</literal> 値は、コレクションの要素が変更されないこ" +"とを表します （ある場合には、少しパフォーマンスを高めます）。" -#: index.docbook:198 +#. Tag: title +#: collection_mapping.xml:198 +#, no-c-format msgid "Collection foreign keys" msgstr "コレクションの外部キー" -#: index.docbook:200 -msgid "Collection instances are distinguished in the database by the foreign key of the entity that owns the collection. This foreign key is referred to as the <emphasis>collection key column</emphasis> (or columns) of the collection table. The collection key column is mapped by the <literal>&lt;key&gt;</literal> element." -msgstr "コレクションのインスタンスは、データベース内では、 そのコレクションを所有するエンティティの外部キーによって識別されます。 この外部キーはコレクションテーブルの <emphasis>コレクションキーカラム</emphasis> と呼ばれます。 コレクションキーカラムは <literal>&lt;key&gt;</literal> 要素によりマッピングします。" +#. Tag: para +#: collection_mapping.xml:200 +#, no-c-format +msgid "" +"Collection instances are distinguished in the database by the foreign key of " +"the entity that owns the collection. This foreign key is referred to as the " +"<emphasis>collection key column</emphasis> (or columns) of the collection " +"table. The collection key column is mapped by the <literal>&lt;key&gt;</" +"literal> element." +msgstr "" +"コレクションのインスタンスは、データベース内では、 そのコレクションを所有する" +"エンティティの外部キーによって識別されます。 この外部キーはコレクションテーブ" +"ルの <emphasis>コレクションキーカラム</emphasis> と呼ばれます。 コレクション" +"キーカラムは <literal>&lt;key&gt;</literal> 要素によりマッピングします。" -#: index.docbook:208 -msgid "There may be a nullability constraint on the foreign key column. For most collections, this is implied. For unidirectional one to many associations, the foreign key column is nullable by default, so you might need to specify <literal>not-null=\"true\"</literal>." -msgstr "外部キーカラムにはnull設定制約があるかもしれません。 ほとんどのコレクションに当てはまるでしょう。 単方向の一対多関連において、外部キーカラムはデフォルトでnullを許す設定になっています。 よって、<literal>not-null=\"true\"</literal> を指定する必要があるかもしれません。" +#. Tag: para +#: collection_mapping.xml:208 +#, no-c-format +msgid "" +"There may be a nullability constraint on the foreign key column. For most " +"collections, this is implied. For unidirectional one to many associations, " +"the foreign key column is nullable by default, so you might need to specify " +"<literal>not-null=\"true\"</literal>." +msgstr "" +"外部キーカラムにはnull設定制約があるかもしれません。 ほとんどのコレクションに" +"当てはまるでしょう。 単方向の一対多関連において、外部キーカラムはデフォルトで" +"nullを許す設定になっています。 よって、<literal>not-null=\"true\"</literal> " +"を指定する必要があるかもしれません。" -#: index.docbook:215 +#. Tag: programlisting +#: collection_mapping.xml:215 +#, no-c-format msgid "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>" -msgstr "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>" +msgstr "" -#: index.docbook:217 -msgid "The foreign key constraint may use <literal>ON DELETE CASCADE</literal>." -msgstr "外部キーの制約が <literal>ON DELETE CASCADE</literal> を使うかもしれません。" +#. Tag: para +#: collection_mapping.xml:217 +#, no-c-format +msgid "" +"The foreign key constraint may use <literal>ON DELETE CASCADE</literal>." +msgstr "" +"外部キーの制約が <literal>ON DELETE CASCADE</literal> を使うかもしれません。" -#: index.docbook:221 +#. Tag: programlisting +#: collection_mapping.xml:221 +#, no-c-format msgid "<![CDATA[<key column=\"productSerialNumber\" on-delete=\"cascade\"/>]]>" -msgstr "<![CDATA[<key column=\"productSerialNumber\" on-delete=\"cascade\"/>]]>" +msgstr "" -#: index.docbook:223 -msgid "See the previous chapter for a full definition of the <literal>&lt;key&gt;</literal> element." -msgstr "<literal>&lt;key&gt;</literal> 要素のすべての定義については前の章を参照してください。" +#. Tag: para +#: collection_mapping.xml:223 +#, no-c-format +msgid "" +"See the previous chapter for a full definition of the <literal>&lt;key&gt;</" +"literal> element." +msgstr "" +"<literal>&lt;key&gt;</literal> 要素のすべての定義については前の章を参照してく" +"ださい。" -#: index.docbook:231 +#. Tag: title +#: collection_mapping.xml:231 +#, no-c-format msgid "Collection elements" msgstr "コレクションの要素" -#: index.docbook:233 -msgid "Collections may contain almost any other Hibernate type, including all basic types, custom types, components, and of course, references to other entities. This is an important distinction: an object in a collection might be handled with \"value\" semantics (its life cycle fully depends on the collection owner) or it might be a reference to another entity, with its own life cycle. In the latter case, only the \"link\" between the two objects is considered to be state held by the collection." -msgstr "コレクションは他のHibernateの型のほとんど（すべての基本型、カスタム型、コンポーネント、 他のエンティティへの参照）を格納することができます。 次の点は重要な違いになります。 コレクションに格納されたオブジェクトが「値」セマンティクスとして扱われるのか （ライフサイクルはコレクションのオーナーに完全に依存します）、 もしくはそれ自身のライフサイクルを持った別のエンティティへの参照であるかのかという違いです。 後者は、2つのオブジェクト間の「リンク」をコレクションに保持していると見なしているだけです。" +#. Tag: para +#: collection_mapping.xml:233 +#, no-c-format +msgid "" +"Collections may contain almost any other Hibernate type, including all basic " +"types, custom types, components, and of course, references to other " +"entities. This is an important distinction: an object in a collection might " +"be handled with \"value\" semantics (its life cycle fully depends on the " +"collection owner) or it might be a reference to another entity, with its own " +"life cycle. In the latter case, only the \"link\" between the two objects is " +"considered to be state held by the collection." +msgstr "" +"コレクションは他のHibernateの型のほとんど（すべての基本型、カスタム型、コン" +"ポーネント、 他のエンティティへの参照）を格納することができます。 次の点は重" +"要な違いになります。 コレクションに格納されたオブジェクトが「値」セマンティク" +"スとして扱われるのか （ライフサイクルはコレクションのオーナーに完全に依存しま" +"す）、 もしくはそれ自身のライフサイクルを持った別のエンティティへの参照である" +"かのかという違いです。 後者は、2つのオブジェクト間の「リンク」をコレクション" +"に保持していると見なしているだけです。" -#: index.docbook:242 -msgid "The contained type is referred to as the <emphasis>collection element type</emphasis>. Collection elements are mapped by <literal>&lt;element&gt;</literal> or <literal>&lt;composite-element&gt;</literal>, or in the case of entity references, with <literal>&lt;one-to-many&gt;</literal> or <literal>&lt;many-to-many&gt;</literal>. The first two map elements with value semantics, the next two are used to map entity associations." -msgstr "格納される型は <emphasis>コレクション要素型</emphasis> と呼ばれます。 コレクション要素は、<literal>&lt;element&gt;</literal> または <literal>&lt;composite-element&gt;</literal> によりマッピングされ、エンティティへの参照の場合には <literal>&lt;one-to-many&gt;</literal> または <literal>&lt;many-to-many&gt;</literal> によりマッピングされます。 最初の二つは値として要素をマッピングし、次の二つはエンティティの関連をマッピングするのに使われます。" +#. Tag: para +#: collection_mapping.xml:242 +#, no-c-format +msgid "" +"The contained type is referred to as the <emphasis>collection element type</" +"emphasis>. Collection elements are mapped by <literal>&lt;element&gt;</" +"literal> or <literal>&lt;composite-element&gt;</literal>, or in the case of " +"entity references, with <literal>&lt;one-to-many&gt;</literal> or " +"<literal>&lt;many-to-many&gt;</literal>. The first two map elements with " +"value semantics, the next two are used to map entity associations." +msgstr "" +"格納される型は <emphasis>コレクション要素型</emphasis> と呼ばれます。 コレク" +"ション要素は、<literal>&lt;element&gt;</literal> または <literal>&lt;" +"composite-element&gt;</literal> によりマッピングされ、エンティティへの参照の" +"場合には <literal>&lt;one-to-many&gt;</literal> または <literal>&lt;many-to-" +"many&gt;</literal> によりマッピングされます。 最初の二つは値として要素をマッ" +"ピングし、次の二つはエンティティの関連をマッピングするのに使われます。" -#: index.docbook:254 +#. Tag: title +#: collection_mapping.xml:254 +#, no-c-format msgid "Indexed collections" msgstr "インデックス付きのコレクション" -#: index.docbook:256 -msgid "All collection mappings, except those with set and bag semantics, need an <emphasis>index column</emphasis> in the collection table - a column that maps to an array index, or <literal>List</literal> index, or <literal>Map</literal> key. The index of a <literal>Map</literal> may be of any basic type, mapped with <literal>&lt;map-key&gt;</literal>, it may be an entity reference mapped with <literal>&lt;map-key-many-to-many&gt;</literal>, or it may be a composite type, mapped with <literal>&lt;composite-map-key&gt;</literal>. The index of an array or list is always of type <literal>integer</literal> and is mapped using the <literal>&lt;list-index&gt;</literal> element. The mapped column contains sequential integers (numbered from zero, by default)." -msgstr "setとbagを除く全てのコレクションマッピングには、 コレクションテーブルの中に <emphasis>インデックス用のカラム</emphasis> が必要です。 そのカラムに、配列や <literal>List</literal> のインデックス、 もしくは <literal>Map</literal> のキーをマッピングします。 <literal>Map</literal> のインデックスは、 <literal>&lt;map-key&gt;</literal> によりマッピングされた基本型か、 <literal>&lt;map-key-many-to-many&gt;</literal> によりマッピングされたエンティティの関連か、 あるいは <literal>&lt;composite-map-key&gt;</literal> によりマッピングされたコンポジット型になります。 配列かリストのインデックスは、常に <literal>integer</literal> 型で、 <literal>&lt;list-index&gt;</literal> 要素によりマッピングします。 マッピングされたカラムにはシーケンシャルな整数を格納します�! �デフォルトでは0から番号が付けられます）。" +#. Tag: para +#: collection_mapping.xml:256 +#, no-c-format +msgid "" +"All collection mappings, except those with set and bag semantics, need an " +"<emphasis>index column</emphasis> in the collection table - a column that " +"maps to an array index, or <literal>List</literal> index, or <literal>Map</" +"literal> key. The index of a <literal>Map</literal> may be of any basic " +"type, mapped with <literal>&lt;map-key&gt;</literal>, it may be an entity " +"reference mapped with <literal>&lt;map-key-many-to-many&gt;</literal>, or it " +"may be a composite type, mapped with <literal>&lt;composite-map-key&gt;</" +"literal>. The index of an array or list is always of type <literal>integer</" +"literal> and is mapped using the <literal>&lt;list-index&gt;</literal> " +"element. The mapped column contains sequential integers (numbered from zero, " +"by default)." +msgstr "" +"setとbagを除く全てのコレクションマッピングには、 コレクションテーブルの中に " +"<emphasis>インデックス用のカラム</emphasis> が必要です。 そのカラムに、配列" +"や <literal>List</literal> のインデックス、 もしくは <literal>Map</literal> " +"のキーをマッピングします。 <literal>Map</literal> のインデックスは、 " +"<literal>&lt;map-key&gt;</literal> によりマッピングされた基本型か、 " +"<literal>&lt;map-key-many-to-many&gt;</literal> によりマッピングされたエン" +"ティティの関連か、 あるいは <literal>&lt;composite-map-key&gt;</literal> によ" +"りマッピングされたコンポジット型になります。 配列かリストのインデックスは、常" +"に <literal>integer</literal> 型で、 <literal>&lt;list-index&gt;</literal> 要" +"素によりマッピングします。 マッピングされたカラムにはシーケンシャルな整数を格" +"納します（デフォルトでは0から番号が付けられます）。" -#: index.docbook:267 +#. Tag: sect2 +#: collection_mapping.xml:267 +#, no-c-format msgid "" - "<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-index \n" - " column=\"column_name\"\n" - " base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout arearefs=\"index1\"> <para> <literal>column_name</literal> (required): The name of the column holding the collection index values. </para> </callout> <callout arearefs=\"index1\"> <para> <literal>base</literal> (optional, defaults to <literal>0</literal>): The value of the index column that corresponds to the first element of the list or array. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key \n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"type_name\"\n" - " node=\"@attribute-name\"\n" - " length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=\"mapkey1\"> <para> <literal>column</literal> (optional): The name of the column holding the collection index values. </para> </callout> <callout arearefs=\"mapkey2\"> <para> <literal>formula</literal> (optional): A SQL formula used to evaluate the key of the map. </para> </callout> <callout arearefs=\"mapkey3\"> <para> <literal>type</literal> (reguired): The type of the map keys. </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> <para> <literal>column</literal> (optional): The name of the foreign key column for the collection index values. </para> </callout> <callout arearefs=\"indexmanytomany2\"> <para> <literal>formula</literal> (optional): A SQL formula used to evaluate the foreign key of the map key. </para> </callout> <callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> (required): The entity class used as the map key. </para> </callout> </calloutlist> </programlistingco>" +"<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=" +"\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-" +"index \n" +" column=\"column_name\"\n" +" base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout " +"arearefs=\"index1\"> <para> <literal>column_name</literal> (required): The " +"name of the column holding the collection index values. </para> </callout> " +"<callout arearefs=\"index1\"> <para> <literal>base</literal> (optional, " +"defaults to <literal>0</literal>): The value of the index column that " +"corresponds to the first element of the list or array. </para> </callout> </" +"calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=" +"\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area " +"id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-" +"key \n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" type=\"type_name\"\n" +" node=\"@attribute-name\"\n" +" length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=" +"\"mapkey1\"> <para> <literal>column</literal> (optional): The name of the " +"column holding the collection index values. </para> </callout> <callout " +"arearefs=\"mapkey2\"> <para> <literal>formula</literal> (optional): A SQL " +"formula used to evaluate the key of the map. </para> </callout> <callout " +"arearefs=\"mapkey3\"> <para> <literal>type</literal> (reguired): The type of " +"the map keys. </para> </callout> </calloutlist> </programlistingco> " +"<programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/" +"> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3" +"\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-" +"many\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" class=\"ClassName\"\n" +"/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> " +"<para> <literal>column</literal> (optional): The name of the foreign key " +"column for the collection index values. </para> </callout> <callout arearefs=" +"\"indexmanytomany2\"> <para> <literal>formula</literal> (optional): A SQL " +"formula used to evaluate the foreign key of the map key. </para> </callout> " +"<callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> " +"(required): The entity class used as the map key. </para> </callout> </" +"calloutlist> </programlistingco>" msgstr "" - "<programlistingco> <areaspec> <area id=\"index1\" coords=\"2 45\"/> <area id=\"index2\" coords=\"3 45\"/> </areaspec> <programlisting><![CDATA[<list-index \n" - " column=\"column_name\"\n" - " base=\"0|1|...\"/>]]></programlisting> <calloutlist> <callout arearefs=\"index1\"> <para> <literal>column_name</literal>（必須）:コレクションインデックスの値を保持するカラムの名前。 </para> </callout> <callout arearefs=\"index2\"> <para> <literal>base</literal>（オプション、デフォルトは <literal>0</literal>）: リストもしくは配列の最初の要素に該当するインデックスカラムの値。 </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"mapkey1\" coords=\"2 45\"/> <area id=\"mapkey2\" coords=\"3 45\"/> <area id=\"mapkey3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key \n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"type_name\"\n" - " node=\"@attribute-name\"\n" - " length=\"N\"/>]]></programlisting> <calloutlist> <callout arearefs=\"mapkey1\"> <para> <literal>column</literal>（オプション）: コレクションインデックスの値を保持するカラムの名前。 </para> </callout> <callout arearefs=\"mapkey2\"> <para> <literal>formula</literal>（オプション）: Mapのキーを評価するのに使われるSQL式。 </para> </callout> <callout arearefs=\"mapkey3\"> <para> <literal>type</literal>（必須）: Mapのキーの型。 </para> </callout> </calloutlist> </programlistingco> <programlistingco> <areaspec> <area id=\"indexmanytomany1\" coords=\"2 45\"/> <area id=\"indexmanytomany2\" coords=\"3 45\"/> <area id=\"indexmanytomany3\" coords=\"4 45\"/> </areaspec> <programlisting><![CDATA[<map-key-many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"indexmanytomany1\"> <para> <literal>column</literal> （オプション）: コレクションインデックスの値のための外部キーカラムの名前。 </para> </callout> <callout arearefs=\"indexmanytomany2\"> <para> <literal>formula</literal> （オプション）: Mapのキーのための外部キーを評価するために使うSQL式。 </para> </callout> <callout arearefs=\"indexmanytomany3\"> <para> <literal>class</literal> （必須）: Mapのキーとして使われるエンティティクラス。 </para> </callout> </calloutlist> </programlistingco>" -#: index.docbook:348 -msgid "If your table doesn't have an index column, and you still wish to use <literal>List</literal> as the property type, you should map the property as a Hibernate <emphasis>&lt;bag&gt;</emphasis>. A bag does not retain its order when it is retrieved from the database, but it may be optionally sorted or ordered." -msgstr "もしテーブルにインデックスカラムがなくても、プロパティ型として <literal>List</literal> を使いたければ、 Hibernateの <emphasis>&lt;bag&gt;</emphasis> としてプロパティをマッピングします。 bagはデータベースから復元される時、順序を保持しません。 しかし、（メモリ上で）ソートしたり、（SQLで）順序付けしたり（order by）することもできます。" +#. Tag: para +#: collection_mapping.xml:348 +#, no-c-format +msgid "" +"If your table doesn't have an index column, and you still wish to use " +"<literal>List</literal> as the property type, you should map the property as " +"a Hibernate <emphasis>&lt;bag&gt;</emphasis>. A bag does not retain its " +"order when it is retrieved from the database, but it may be optionally " +"sorted or ordered." +msgstr "" +"もしテーブルにインデックスカラムがなくても、プロパティ型として " +"<literal>List</literal> を使いたければ、 Hibernateの <emphasis>&lt;bag&gt;</" +"emphasis> としてプロパティをマッピングします。 bagはデータベースから復元され" +"る時、順序を保持しません。 しかし、（メモリ上で）ソートしたり、（SQLで）順序" +"付けしたり（order by）することもできます。" -#: index.docbook:357 -msgid "There are quite a range of mappings that can be generated for collections, covering many common relational models. We suggest you experiment with the schema generation tool to get a feeling for how various mapping declarations translate to database tables." -msgstr "多くの一般的なリレーショナルモデルをカバーしたために、 コレクションのために利用できるマッピングにはかなりの幅があります。 様々なマッピング宣言がどのようにデータベーステーブルに変換されるかを知るために、 スキーマ生成ツールを使ってみると良いでしょう。" +#. Tag: para +#: collection_mapping.xml:357 +#, no-c-format +msgid "" +"There are quite a range of mappings that can be generated for collections, " +"covering many common relational models. We suggest you experiment with the " +"schema generation tool to get a feeling for how various mapping declarations " +"translate to database tables." +msgstr "" +"多くの一般的なリレーショナルモデルをカバーしたために、 コレクションのために利" +"用できるマッピングにはかなりの幅があります。 様々なマッピング宣言がどのように" +"データベーステーブルに変換されるかを知るために、 スキーマ生成ツールを使ってみ" +"ると良いでしょう。" -#: index.docbook:364 +#. Tag: title +#: collection_mapping.xml:364 +#, no-c-format msgid "Collections of values and many-to-many associations" msgstr "値のコレクションと多対多関連" -#: index.docbook:366 -msgid "Any collection of values or many-to-many association requires a dedicated <emphasis>collection table</emphasis> with a foreign key column or columns, <emphasis>collection element column</emphasis> or columns and possibly an index column or columns." -msgstr "値のコレクションや多対多関連は、専用の <emphasis>コレクションテーブル</emphasis> が必要です。 このテーブルは、外部キーカラムと、 <emphasis>コレクション要素のカラム</emphasis> と、 場合によってはインデックスカラムを持ちます。" +#. Tag: para +#: collection_mapping.xml:366 +#, no-c-format +msgid "" +"Any collection of values or many-to-many association requires a dedicated " +"<emphasis>collection table</emphasis> with a foreign key column or columns, " +"<emphasis>collection element column</emphasis> or columns and possibly an " +"index column or columns." +msgstr "" +"値のコレクションや多対多関連は、専用の <emphasis>コレクションテーブル</" +"emphasis> が必要です。 このテーブルは、外部キーカラムと、 <emphasis>コレク" +"ション要素のカラム</emphasis> と、 場合によってはインデックスカラムを持ちま" +"す。" -#: index.docbook:373 -msgid "For a collection of values, we use the <literal>&lt;element&gt;</literal> tag." -msgstr "値のコレクションのために、<literal>&lt;element&gt;</literal>タグを使用します。" +#. Tag: para +#: collection_mapping.xml:373 +#, no-c-format +msgid "" +"For a collection of values, we use the <literal>&lt;element&gt;</literal> " +"tag." +msgstr "" +"値のコレクションのために、<literal>&lt;element&gt;</literal>タグを使用しま" +"す。" -#: index.docbook:375 +#. Tag: sect2 +#: collection_mapping.xml:375 +#, no-c-format msgid "" - "<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> </areaspec> <programlisting><![CDATA[<element\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"typename\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> <literal>column</literal> (optional): The name of the column holding the collection element values. </para> </callout> <callout arearefs=\"element2b\"> <para> <literal>formula</literal> (optional): An SQL formula used to evaluate the element. </para> </callout> <callout arearefs=\"element3b\"> <para> <literal>type</literal> (required): The type of the collection element. </para> </callout> </calloutlist> </programlistingco> <para> A <emphasis>many-to-many association</emphasis> is specified using the <literal>&lt;many-to-many&gt;</literal> element. </para> <programlistingco> <areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> <area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=\"8 60\"/> <area id=\! "manytomany8\" coords=\"9 60\"/> </areaspec> <programlisting><![CDATA[<many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - " fetch=\"select|join\"\n" - " unique=\"true|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> <para> <literal>column</literal> (optional): The name of the element foreign key column. </para> </callout> <callout arearefs=\"manytomany2\"> <para> <literal>formula</literal> (optional): An SQL formula used to evaluate the element foreign key value. </para> </callout> <callout arearefs=\"manytomany3\"> <para> <literal>class</literal> (required): The name of the associated class. </para> </callout> <callout arearefs=\"manytomany4\"> <para> <literal>fetch</literal> (optional - defaults to <literal>join</literal>): enables outer-join or sequential select fetching for this association. This is a special case; for full eager fetching (in a single <literal>SELECT</literal>) of an entity and its many-to-many relationships to other entities, you would enable <literal>join</literal> fetching not only of the collection itself, but also with this attribute on the <literal>&lt;many-to-many&gt;</literal! is used. </para> </callout> </calloutlist> </programlistingco>" +"<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area " +"id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> " +"</areaspec> <programlisting><![CDATA[<element\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" type=\"typename\"\n" +" length=\"L\"\n" +" precision=\"P\"\n" +" scale=\"S\"\n" +" not-null=\"true|false\"\n" +" unique=\"true|false\"\n" +" node=\"element-name\"\n" +"/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> " +"<literal>column</literal> (optional): The name of the column holding the " +"collection element values. </para> </callout> <callout arearefs=\"element2b" +"\"> <para> <literal>formula</literal> (optional): An SQL formula used to " +"evaluate the element. </para> </callout> <callout arearefs=\"element3b\"> " +"<para> <literal>type</literal> (required): The type of the collection " +"element. </para> </callout> </calloutlist> </programlistingco> <para> A " +"<emphasis>many-to-many association</emphasis> is specified using the " +"<literal>&lt;many-to-many&gt;</literal> element. </para> <programlistingco> " +"<areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2" +"\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=" +"\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> " +"<area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=" +"\"8 60\"/> <area id=\"manytomany8\" coords=\"9 60\"/> </areaspec> " +"<programlisting><![CDATA[<many-to-many\n" +" column=\"column_name\"\n" +" formula=\"any SQL expression\"\n" +" class=\"ClassName\"\n" +" fetch=\"select|join\"\n" +" unique=\"true|false\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" property-ref=\"propertyNameFromAssociatedClass\"\n" +" node=\"element-name\"\n" +" embed-xml=\"true|false\"\n" +" />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> " +"<para> <literal>column</literal> (optional): The name of the element foreign " +"key column. </para> </callout> <callout arearefs=\"manytomany2\"> <para> " +"<literal>formula</literal> (optional): An SQL formula used to evaluate the " +"element foreign key value. </para> </callout> <callout arearefs=\"manytomany3" +"\"> <para> <literal>class</literal> (required): The name of the associated " +"class. </para> </callout> <callout arearefs=\"manytomany4\"> <para> " +"<literal>fetch</literal> (optional - defaults to <literal>join</literal>): " +"enables outer-join or sequential select fetching for this association. This " +"is a special case; for full eager fetching (in a single <literal>SELECT</" +"literal>) of an entity and its many-to-many relationships to other entities, " +"you would enable <literal>join</literal> fetching not only of the collection " +"itself, but also with this attribute on the <literal>&lt;many-to-many&gt;</" +"literal> nested element. </para> </callout> <callout arearefs=\"manytomany5" +"\"> <para> <literal>unique</literal> (optional): Enable the DDL generation " +"of a unique constraint for the foreign-key column. This makes the " +"association multiplicity effectively one to many. </para> </callout> " +"<callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> " +"(optional - defaults to <literal>exception</literal>): Specifies how foreign " +"keys that reference missing rows will be handled: <literal>ignore</literal> " +"will treat a missing row as a null association. </para> </callout> <callout " +"arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> (optional): " +"The entity name of the associated class, as an alternative to " +"<literal>class</literal>. </para> </callout> <callout arearefs=\"manytomany8" +"\"> <para> <literal>property-ref</literal>: (optional) The name of a " +"property of the associated class that is joined to this foreign key. If not " +"specified, the primary key of the associated class is used. </para> </" +"callout> </calloutlist> </programlistingco>" msgstr "" - "<programlistingco> <areaspec> <area id=\"element1b\" coords=\"2 50\"/> <area id=\"element2b\" coords=\"3 50\"/> <area id=\"element3b\" coords=\"4 50\"/> </areaspec> <programlisting><![CDATA[<element\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " type=\"typename\"\n" - " length=\"L\"\n" - " precision=\"P\"\n" - " scale=\"S\"\n" - " not-null=\"true|false\"\n" - " unique=\"true|false\"\n" - " node=\"element-name\"\n" - "/>]]></programlisting> <calloutlist> <callout arearefs=\"element1b\"> <para> <literal>column</literal> （オプション）: コレクションの要素の値を保持するカラムの名前。 </para> </callout> <callout arearefs=\"element2b\"> <para> <literal>formula</literal> （オプション）: 要素を評価するために使うSQL式。 </para> </callout> <callout arearefs=\"element3b\"> <para> <literal>type</literal> （必須）コレクションの要素の型。 </para> </callout> </calloutlist> </programlistingco> <para> <emphasis>多対多関連</emphasis> は <literal>&lt;many-to-many&gt;</literal> 要素で指定します。 </para> <programlistingco> <areaspec> <area id=\"manytomany1\" coords=\"2 60\"/> <area id=\"manytomany2\" coords=\"3 60\"/> <area id=\"manytomany3\" coords=\"4 60\"/> <area id=\"manytomany4\" coords=\"5 60\"/> <area id=\"manytomany5\" coords=\"6 60\"/> <area id=\"manytomany6\" coords=\"7 60\"/> <area id=\"manytomany7\" coords=! \"8 60\"/> <area id=\"manytomany8\" coords=\"9 60\"/> </areaspec> <programlisting><![CDATA[<many-to-many\n" - " column=\"column_name\"\n" - " formula=\"any SQL expression\"\n" - " class=\"ClassName\"\n" - " fetch=\"select|join\"\n" - " unique=\"true|false\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " property-ref=\"propertyNameFromAssociatedClass\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]></programlisting> <calloutlist> <callout arearefs=\"manytomany1\"> <para> <literal>column</literal> （オプション）: 外部キーカラムの要素の名前。 </para> </callout> <callout arearefs=\"manytomany2\"> <para> <literal>formula</literal> （オプション）: 外部キー値の要素を評価するために使うSQL式。 </para> </callout> <callout arearefs=\"manytomany3\"> <para> <literal>class</literal> （必須）: 関連クラスの名前。 </para> </callout> <callout arearefs=\"manytomany4\"> <para> <literal>fetch</literal> (オプション - デフォルトは <literal>join</literal>): 関連のために、外部結合か順次選択フェッチを有効にします。 これは特殊なケースですが、エンティティと他のエンティティとの多対多関係を （１つの <literal>SELECT</literal> により）完全に即時にフェッチするためには、 そのコレクション自体だけでなく、 ネス�! ��した要素である <literal>&lt;many-to-many&gt;</literal> のこの属性についても <literal>join</literal> フェッチを有効する必要があります。 </para> </callout> <callout arearefs=\"manytomany5\"> <para> <literal>unique</literal> （オプション）: 外部キーカラムのユニーク制約のDDL生成を有効にします。 これは、関連の多重度を事実上一対多にします。 </para> </callout> <callout arearefs=\"manytomany6\"> <para> <literal>not-found</literal> （オプション - デフォルトは <literal>exception</literal>） 参照先の行がない外部キーをどのように扱うかを指定します。 <literal>ignore</literal> にすると、行がないことを関連が無いものとして扱います。 </para> </callout> <callout arearefs=\"manytomany7\"> <para> <literal>entity-name</literal> （オプション）: <literal>class</literal> の代替である関連クラスのエンティティ名。 <lite! ral>class</literal> の代わりに指定する、関連クラスの� �ンティティ名。 </para> </callout> <callout arearefs=\"manytomany8\"> <para> <literal>property-ref</literal>: （オプション） この外部キーに結合する関連クラスのプロパティ名。 指定しなかった場合は、関連クラスの主キーを使います。 </para> </callout> </calloutlist> </programlistingco>" -#: index.docbook:480 +#. Tag: para +#: collection_mapping.xml:480 +#, no-c-format msgid "Some examples, first, a set of strings:" msgstr "以下にいくつか例を示します。 まずはStringのsetに関しての例です。" -#: index.docbook:484 +#. Tag: programlisting +#: collection_mapping.xml:484 +#, no-c-format msgid "" - "<![CDATA[<set name=\"names\" table=\"person_names\">\n" - " <key column=\"person_id\"/>\n" - " <element column=\"person_name\" type=\"string\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"names\" table=\"person_names\">\n" +" <key column=\"person_id\"/>\n" +" <element column=\"person_name\" type=\"string\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"names\" table=\"person_names\">\n" - " <key column=\"person_id\"/>\n" - " <element column=\"person_name\" type=\"string\"/>\n" - "</set>]]>" -#: index.docbook:486 -msgid "A bag containing integers (with an iteration order determined by the <literal>order-by</literal> attribute):" -msgstr "整数値を含むbag（bagは <literal>order-by</literal> 属性によって反復順序が定義されています）" +#. Tag: para +#: collection_mapping.xml:486 +#, no-c-format +msgid "" +"A bag containing integers (with an iteration order determined by the " +"<literal>order-by</literal> attribute):" +msgstr "" +"整数値を含むbag（bagは <literal>order-by</literal> 属性によって反復順序が定義" +"されています）" -#: index.docbook:491 +#. Tag: programlisting +#: collection_mapping.xml:491 +#, no-c-format msgid "" - "<![CDATA[<bag name=\"sizes\" \n" - " table=\"item_sizes\" \n" - " order-by=\"size asc\">\n" - " <key column=\"item_id\"/>\n" - " <element column=\"size\" type=\"integer\"/>\n" - "</bag>]]>" +"<![CDATA[<bag name=\"sizes\" \n" +" table=\"item_sizes\" \n" +" order-by=\"size asc\">\n" +" <key column=\"item_id\"/>\n" +" <element column=\"size\" type=\"integer\"/>\n" +"</bag>]]>" msgstr "" - "<![CDATA[<bag name=\"sizes\" \n" - " table=\"item_sizes\" \n" - " order-by=\"size asc\">\n" - " <key column=\"item_id\"/>\n" - " <element column=\"size\" type=\"integer\"/>\n" - "</bag>]]>" -#: index.docbook:493 +#. Tag: para +#: collection_mapping.xml:493 +#, no-c-format msgid "An array of entities - in this case, a many to many association:" msgstr "エンティティの配列 - この場合、多対多の関連です。" -#: index.docbook:497 +#. Tag: programlisting +#: collection_mapping.xml:497 +#, no-c-format msgid "" - "<![CDATA[<array name=\"addresses\" \n" - " table=\"PersonAddress\" \n" - " cascade=\"persist\">\n" - " <key column=\"personId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <many-to-many column=\"addressId\" class=\"Address\"/>\n" - "</array>]]>" +"<![CDATA[<array name=\"addresses\" \n" +" table=\"PersonAddress\" \n" +" cascade=\"persist\">\n" +" <key column=\"personId\"/>\n" +" <list-index column=\"sortOrder\"/>\n" +" <many-to-many column=\"addressId\" class=\"Address\"/>\n" +"</array>]]>" msgstr "" - "<![CDATA[<array name=\"addresses\" \n" - " table=\"PersonAddress\" \n" - " cascade=\"persist\">\n" - " <key column=\"personId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <many-to-many column=\"addressId\" class=\"Address\"/>\n" - "</array>]]>" -#: index.docbook:499 +#. Tag: para +#: collection_mapping.xml:499 +#, no-c-format msgid "A map from string indices to dates:" msgstr "文字列と日付のmap" -#: index.docbook:503 +#. Tag: programlisting +#: collection_mapping.xml:503 +#, no-c-format msgid "" - "<![CDATA[<map name=\"holidays\" \n" - " table=\"holidays\" \n" - " schema=\"dbo\" \n" - " order-by=\"hol_name asc\">\n" - " <key column=\"id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"holidays\" \n" +" table=\"holidays\" \n" +" schema=\"dbo\" \n" +" order-by=\"hol_name asc\">\n" +" <key column=\"id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date\" type=\"date\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"holidays\" \n" - " table=\"holidays\" \n" - " schema=\"dbo\" \n" - " order-by=\"hol_name asc\">\n" - " <key column=\"id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" -#: index.docbook:505 +#. Tag: para +#: collection_mapping.xml:505 +#, no-c-format msgid "A list of components (discussed in the next chapter):" msgstr "コンポーネントのlist（次の章で詳しく説明します）" -#: index.docbook:509 +#. Tag: programlisting +#: collection_mapping.xml:509 +#, no-c-format msgid "" - "<![CDATA[<list name=\"carComponents\" \n" - " table=\"CarComponents\">\n" - " <key column=\"carId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <composite-element class=\"CarComponent\">\n" - " <property name=\"price\"/>\n" - " <property name=\"type\"/>\n" - " <property name=\"serialNumber\" column=\"serialNum\"/>\n" - " </composite-element>\n" - "</list>]]>" +"<![CDATA[<list name=\"carComponents\" \n" +" table=\"CarComponents\">\n" +" <key column=\"carId\"/>\n" +" <list-index column=\"sortOrder\"/>\n" +" <composite-element class=\"CarComponent\">\n" +" <property name=\"price\"/>\n" +" <property name=\"type\"/>\n" +" <property name=\"serialNumber\" column=\"serialNum\"/>\n" +" </composite-element>\n" +"</list>]]>" msgstr "" - "<![CDATA[<list name=\"carComponents\" \n" - " table=\"CarComponents\">\n" - " <key column=\"carId\"/>\n" - " <list-index column=\"sortOrder\"/>\n" - " <composite-element class=\"CarComponent\">\n" - " <property name=\"price\"/>\n" - " <property name=\"type\"/>\n" - " <property name=\"serialNumber\" column=\"serialNum\"/>\n" - " </composite-element>\n" - "</list>]]>" -#: index.docbook:514 +#. Tag: title +#: collection_mapping.xml:514 +#, no-c-format msgid "One-to-many associations" msgstr "一対多関連" -#: index.docbook:516 -msgid "A <emphasis>one to many association</emphasis> links the tables of two classes via a foreign key, with no intervening collection table. This mapping loses certain semantics of normal Java collections:" -msgstr "<emphasis>一対多関連</emphasis> は、コレクション･テーブルを介さず、 外部キーにより2つのクラスのテーブルを関連付けます。 このマッピングは標準的なJavaのコレクションのセマンティクスをいくつか失います。" +#. Tag: para +#: collection_mapping.xml:516 +#, no-c-format +msgid "" +"A <emphasis>one to many association</emphasis> links the tables of two " +"classes via a foreign key, with no intervening collection table. This " +"mapping loses certain semantics of normal Java collections:" +msgstr "" +"<emphasis>一対多関連</emphasis> は、コレクション･テーブルを介さず、 外部キー" +"により2つのクラスのテーブルを関連付けます。 このマッピングは標準的なJavaのコ" +"レクションのセマンティクスをいくつか失います。" -#: index.docbook:524 -msgid "An instance of the contained entity class may not belong to more than one instance of the collection" -msgstr "エンティティクラスのインスタンスは、 2つ以上のコレクションのインスタンスに属してはいけません。" +#. Tag: para +#: collection_mapping.xml:524 +#, no-c-format +msgid "" +"An instance of the contained entity class may not belong to more than one " +"instance of the collection" +msgstr "" +"エンティティクラスのインスタンスは、 2つ以上のコレクションのインスタンスに属" +"してはいけません。" -#: index.docbook:530 -msgid "An instance of the contained entity class may not appear at more than one value of the collection index" -msgstr "コレクションに含まれるエンティティクラスのインスタンスは、 コレクションインデックスの値として2度以上現れてはいけません。" +#. Tag: para +#: collection_mapping.xml:530 +#, no-c-format +msgid "" +"An instance of the contained entity class may not appear at more than one " +"value of the collection index" +msgstr "" +"コレクションに含まれるエンティティクラスのインスタンスは、 コレクションイン" +"デックスの値として2度以上現れてはいけません。" -#: index.docbook:537 -msgid "An association from <literal>Product</literal> to <literal>Part</literal> requires existence of a foreign key column and possibly an index column to the <literal>Part</literal> table. A <literal>&lt;one-to-many&gt;</literal> tag indicates that this is a one to many association." -msgstr "<literal>Product</literal> から <literal>Part</literal> への関連は、 <literal>Part</literal> テーブルへの外部キーカラムと、場合によってはインデックスカラムが必要です。 <literal>&lt;one-to-many&gt;</literal> タグは、これが一対多関連であることを表しています。" +#. Tag: para +#: collection_mapping.xml:537 +#, no-c-format +msgid "" +"An association from <literal>Product</literal> to <literal>Part</literal> " +"requires existence of a foreign key column and possibly an index column to " +"the <literal>Part</literal> table. A <literal>&lt;one-to-many&gt;</literal> " +"tag indicates that this is a one to many association." +msgstr "" +"<literal>Product</literal> から <literal>Part</literal> への関連は、 " +"<literal>Part</literal> テーブルへの外部キーカラムと、場合によってはインデッ" +"クスカラムが必要です。 <literal>&lt;one-to-many&gt;</literal> タグは、これが" +"一対多関連であることを表しています。" -#: index.docbook:550 +#. Tag: programlisting +#: collection_mapping.xml:550 +#, no-c-format msgid "" - "<![CDATA[<one-to-many \n" - " class=\"ClassName\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]>" +"<![CDATA[<one-to-many \n" +" class=\"ClassName\"\n" +" not-found=\"ignore|exception\"\n" +" entity-name=\"EntityName\"\n" +" node=\"element-name\"\n" +" embed-xml=\"true|false\"\n" +" />]]>" msgstr "" - "<![CDATA[<one-to-many \n" - " class=\"ClassName\"\n" - " not-found=\"ignore|exception\"\n" - " entity-name=\"EntityName\"\n" - " node=\"element-name\"\n" - " embed-xml=\"true|false\"\n" - " />]]>" -#: index.docbook:553 +#. Tag: para +#: collection_mapping.xml:553 +#, no-c-format msgid "<literal>class</literal> (required): The name of the associated class." msgstr "<literal>class</literal> （必須）: 関連クラスの名前。" -#: index.docbook:558 -msgid "<literal>not-found</literal> (optional - defaults to <literal>exception</literal>): Specifies how cached identifiers that reference missing rows will be handled: <literal>ignore</literal> will treat a missing row as a null association." -msgstr "<literal>not-found</literal> （オプション - デフォルトは <literal>exception</literal>）: 参照先の行がないキャッシュされた識別子をどのように扱うかを指定します。 <literal>ignore</literal> を指定すると、行がないことを関連がないものとして扱います。" +#. Tag: para +#: collection_mapping.xml:558 +#, no-c-format +msgid "" +"<literal>not-found</literal> (optional - defaults to <literal>exception</" +"literal>): Specifies how cached identifiers that reference missing rows will " +"be handled: <literal>ignore</literal> will treat a missing row as a null " +"association." +msgstr "" +"<literal>not-found</literal> （オプション - デフォルトは <literal>exception</" +"literal>）: 参照先の行がないキャッシュされた識別子をどのように扱うかを指定し" +"ます。 <literal>ignore</literal> を指定すると、行がないことを関連がないものと" +"して扱います。" -#: index.docbook:565 -msgid "<literal>entity-name</literal> (optional): The entity name of the associated class, as an alternative to <literal>class</literal>." -msgstr "<literal>entity-name</literal> （オプション）: <literal>class</literal> の代替である関連クラスのエンティティ名。 <literal>class</literal> の代わりに指定する、関連クラスのエンティティ名。" +#. Tag: para +#: collection_mapping.xml:565 +#, no-c-format +msgid "" +"<literal>entity-name</literal> (optional): The entity name of the associated " +"class, as an alternative to <literal>class</literal>." +msgstr "" +"<literal>entity-name</literal> （オプション）: <literal>class</literal> の代" +"替である関連クラスのエンティティ名。 <literal>class</literal> の代わりに指定" +"する、関連クラスのエンティティ名。" -#: index.docbook:573 -msgid "Notice that the <literal>&lt;one-to-many&gt;</literal> element does not need to declare any columns. Nor is it necessary to specify the <literal>table</literal> name anywhere." -msgstr "<literal>&lt;one-to-many&gt;</literal> 要素はカラムを宣言する必要がないことに注意してください。 同様に <literal>テーブル</literal> 名を指定する必要もありません。" +#. Tag: para +#: collection_mapping.xml:573 +#, no-c-format +msgid "" +"Notice that the <literal>&lt;one-to-many&gt;</literal> element does not need " +"to declare any columns. Nor is it necessary to specify the <literal>table</" +"literal> name anywhere." +msgstr "" +"<literal>&lt;one-to-many&gt;</literal> 要素はカラムを宣言する必要がないことに" +"注意してください。 同様に <literal>テーブル</literal> 名を指定する必要もあり" +"ません。" -#: index.docbook:579 -msgid "<emphasis>Very important note:</emphasis> If the foreign key column of a <literal>&lt;one-to-many&gt;</literal> association is declared <literal>NOT NULL</literal>, you must declare the <literal>&lt;key&gt;</literal> mapping <literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional association</emphasis> with the collection mapping marked <literal>inverse=\"true\"</literal>. See the discussion of bidirectional associations later in this chapter." -msgstr "<emphasis>とても重要な注意:</emphasis> もし <literal>&lt;one-to-many&gt;</literal> 関連の外部キーカラムが <literal>NOT NULL</literal>と宣言された場合、 <literal>&lt;key&gt;</literal> マッピングに <literal>not-null=\"true\"</literal> を宣言するか、 コレクションマッピングに <literal>inverse=\"true\"</literal> を付けた上で、 <emphasis>双方向関連を使う</emphasis> 必要があります。 双方向関連についてはこの章の後のほうで説明します。" +#. Tag: para +#: collection_mapping.xml:579 +#, no-c-format +msgid "" +"<emphasis>Very important note:</emphasis> If the foreign key column of a " +"<literal>&lt;one-to-many&gt;</literal> association is declared <literal>NOT " +"NULL</literal>, you must declare the <literal>&lt;key&gt;</literal> mapping " +"<literal>not-null=\"true\"</literal> or <emphasis>use a bidirectional " +"association</emphasis> with the collection mapping marked <literal>inverse=" +"\"true\"</literal>. See the discussion of bidirectional associations later " +"in this chapter." +msgstr "" +"<emphasis>とても重要な注意:</emphasis> もし <literal>&lt;one-to-many&gt;</" +"literal> 関連の外部キーカラムが <literal>NOT NULL</literal>と宣言された場" +"合、 <literal>&lt;key&gt;</literal> マッピングに <literal>not-null=\"true\"</" +"literal> を宣言するか、 コレクションマッピングに <literal>inverse=\"true\"</" +"literal> を付けた上で、 <emphasis>双方向関連を使う</emphasis> 必要がありま" +"す。 双方向関連についてはこの章の後のほうで説明します。" -#: index.docbook:588 -msgid "This example shows a map of <literal>Part</literal> entities by name (where <literal>partName</literal> is a persistent property of <literal>Part</literal>). Notice the use of a formula-based index." -msgstr "次の例は、名称（<literal>Part</literal> の永続的なプロパティである <literal>partName</literal>） による <literal>Part</literal> エンティティのmapを表しています。 formulaによるインデックスを使っていることに注意してください。" +#. Tag: para +#: collection_mapping.xml:588 +#, no-c-format +msgid "" +"This example shows a map of <literal>Part</literal> entities by name (where " +"<literal>partName</literal> is a persistent property of <literal>Part</" +"literal>). Notice the use of a formula-based index." +msgstr "" +"次の例は、名称（<literal>Part</literal> の永続的なプロパティである " +"<literal>partName</literal>） による <literal>Part</literal> エンティティの" +"mapを表しています。 formulaによるインデックスを使っていることに注意してくださ" +"い。" -#: index.docbook:594 +#. Tag: programlisting +#: collection_mapping.xml:594 +#, no-c-format msgid "" - "<![CDATA[<map name=\"parts\"\n" - " cascade=\"all\">\n" - " <key column=\"productId\" not-null=\"true\"/>\n" - " <map-key formula=\"partName\"/>\n" - " <one-to-many class=\"Part\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"parts\"\n" +" cascade=\"all\">\n" +" <key column=\"productId\" not-null=\"true\"/>\n" +" <map-key formula=\"partName\"/>\n" +" <one-to-many class=\"Part\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"parts\"\n" - " cascade=\"all\">\n" - " <key column=\"productId\" not-null=\"true\"/>\n" - " <map-key formula=\"partName\"/>\n" - " <one-to-many class=\"Part\"/>\n" - "</map>]]>" -#: index.docbook:600 +#. Tag: title +#: collection_mapping.xml:600 +#, no-c-format msgid "Advanced collection mappings" msgstr "高度なコレクション･マッピング" -#: index.docbook:603 +#. Tag: title +#: collection_mapping.xml:603 +#, no-c-format msgid "Sorted collections" msgstr "ソートされたコレクション" -#: index.docbook:605 -msgid "Hibernate supports collections implementing <literal>java.util.SortedMap</literal> and <literal>java.util.SortedSet</literal>. You must specify a comparator in the mapping file:" -msgstr "Hibernateは <literal>java.util.SortedMap</literal> と <literal>java.util.SortedSet</literal> を実装したコレクションをサポートしています。 開発者はマッピング定義ファイルにコンパレータを指定しなければなりません。" +#. Tag: para +#: collection_mapping.xml:605 +#, no-c-format +msgid "" +"Hibernate supports collections implementing <literal>java.util.SortedMap</" +"literal> and <literal>java.util.SortedSet</literal>. You must specify a " +"comparator in the mapping file:" +msgstr "" +"Hibernateは <literal>java.util.SortedMap</literal> と <literal>java.util." +"SortedSet</literal> を実装したコレクションをサポートしています。 開発者はマッ" +"ピング定義ファイルにコンパレータを指定しなければなりません。" -#: index.docbook:610 +#. Tag: programlisting +#: collection_mapping.xml:610 +#, no-c-format msgid "" - "<![CDATA[<set name=\"aliases\" \n" - " table=\"person_aliases\" \n" - " sort=\"natural\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<set name=\"aliases\" \n" +" table=\"person_aliases\" \n" +" sort=\"natural\">\n" +" <key column=\"person\"/>\n" +" <element column=\"name\" type=\"string\"/>\n" +"</set>\n" +"\n" +"<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" +" <key column=\"year_id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date\" type=\"date\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<set name=\"aliases\" \n" - " table=\"person_aliases\" \n" - " sort=\"natural\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" sort=\"my.custom.HolidayComparator\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" -#: index.docbook:612 -msgid "Allowed values of the <literal>sort</literal> attribute are <literal>unsorted</literal>, <literal>natural</literal> and the name of a class implementing <literal>java.util.Comparator</literal>." -msgstr "<literal>sort</literal> 属性に設定できる値は <literal>unsorted</literal> と <literal>natural</literal> および、<literal>java.util.Comparator</literal> を実装したクラスの名前です。" +#. Tag: para +#: collection_mapping.xml:612 +#, no-c-format +msgid "" +"Allowed values of the <literal>sort</literal> attribute are " +"<literal>unsorted</literal>, <literal>natural</literal> and the name of a " +"class implementing <literal>java.util.Comparator</literal>." +msgstr "" +"<literal>sort</literal> 属性に設定できる値は <literal>unsorted</literal> と " +"<literal>natural</literal> および、<literal>java.util.Comparator</literal> を" +"実装したクラスの名前です。" -#: index.docbook:618 -msgid "Sorted collections actually behave like <literal>java.util.TreeSet</literal> or <literal>java.util.TreeMap</literal>." -msgstr "ソートされたコレクションは実質的には <literal>java.util.TreeSet</literal> や <literal>java.util.TreeMap</literal> のように振舞います。" +#. Tag: para +#: collection_mapping.xml:618 +#, no-c-format +msgid "" +"Sorted collections actually behave like <literal>java.util.TreeSet</literal> " +"or <literal>java.util.TreeMap</literal>." +msgstr "" +"ソートされたコレクションは実質的には <literal>java.util.TreeSet</literal> や " +"<literal>java.util.TreeMap</literal> のように振舞います。" -#: index.docbook:623 -msgid "If you want the database itself to order the collection elements use the <literal>order-by</literal> attribute of <literal>set</literal>, <literal>bag</literal> or <literal>map</literal> mappings. This solution is only available under JDK 1.4 or higher (it is implemented using <literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>). This performs the ordering in the SQL query, not in memory." -msgstr "もしデータベース自身にコレクションの要素を並べさせたいなら、 <literal>set</literal> や <literal>bag</literal>、<literal>map</literal> の <literal>order-by</literal> 属性を使います。 この解決法はJDK1.4、もしくはそれ以上のバージョンで利用可能です （<literal>LinkedHashSet</literal> または <literal>LinkedHashMap</literal>を使って実装されています）。 整列はメモリ上ではなく、SQLクエリ内で実行されます。" +#. Tag: para +#: collection_mapping.xml:623 +#, no-c-format +msgid "" +"If you want the database itself to order the collection elements use the " +"<literal>order-by</literal> attribute of <literal>set</literal>, " +"<literal>bag</literal> or <literal>map</literal> mappings. This solution is " +"only available under JDK 1.4 or higher (it is implemented using " +"<literal>LinkedHashSet</literal> or <literal>LinkedHashMap</literal>). This " +"performs the ordering in the SQL query, not in memory." +msgstr "" +"もしデータベース自身にコレクションの要素を並べさせたいなら、 <literal>set</" +"literal> や <literal>bag</literal>、<literal>map</literal> の <literal>order-" +"by</literal> 属性を使います。 この解決法はJDK1.4、もしくはそれ以上のバージョ" +"ンで利用可能です （<literal>LinkedHashSet</literal> または " +"<literal>LinkedHashMap</literal>を使って実装されています）。 整列はメモリ上で" +"はなく、SQLクエリ内で実行されます。" -#: index.docbook:632 +#. Tag: programlisting +#: collection_mapping.xml:632 +#, no-c-format msgid "" - "<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower(name) asc\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date type=\"date\"/>\n" - "</map>]]>" +"<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower" +"(name) asc\">\n" +" <key column=\"person\"/>\n" +" <element column=\"name\" type=\"string\"/>\n" +"</set>\n" +"\n" +"<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" +" <key column=\"year_id\"/>\n" +" <map-key column=\"hol_name\" type=\"string\"/>\n" +" <element column=\"hol_date type=\"date\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<set name=\"aliases\" table=\"person_aliases\" order-by=\"lower(name) asc\">\n" - " <key column=\"person\"/>\n" - " <element column=\"name\" type=\"string\"/>\n" - "</set>\n" - "\n" - "<map name=\"holidays\" order-by=\"hol_date, hol_name\">\n" - " <key column=\"year_id\"/>\n" - " <map-key column=\"hol_name\" type=\"string\"/>\n" - " <element column=\"hol_date\" type=\"date\"/>\n" - "</map>]]>" -#: index.docbook:634 -msgid "Note that the value of the <literal>order-by</literal> attribute is an SQL ordering, not a HQL ordering!" -msgstr "<literal>order-by</literal> 属性の値がSQL命令であって、HQL命令ではないことに注意してください！" +#. Tag: para +#: collection_mapping.xml:634 +#, no-c-format +msgid "" +"Note that the value of the <literal>order-by</literal> attribute is an SQL " +"ordering, not a HQL ordering!" +msgstr "" +"<literal>order-by</literal> 属性の値がSQL命令であって、HQL命令ではないことに" +"注意してください！" -#: index.docbook:639 -msgid "Associations may even be sorted by some arbitrary criteria at runtime using a collection <literal>filter()</literal>." -msgstr "関連は、コレクションの <literal>filter()</literal> を使うことで、 実行時に任意のcriteriaによってソートすることも可能です。" +#. Tag: para +#: collection_mapping.xml:639 +#, no-c-format +msgid "" +"Associations may even be sorted by some arbitrary criteria at runtime using " +"a collection <literal>filter()</literal>." +msgstr "" +"関連は、コレクションの <literal>filter()</literal> を使うことで、 実行時に任" +"意のcriteriaによってソートすることも可能です。" -#: index.docbook:644 -msgid "<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" ).list();]]>" -msgstr "<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name\" ).list();]]>" +#. Tag: programlisting +#: collection_mapping.xml:644 +#, no-c-format +msgid "" +"<![CDATA[sortedUsers = s.createFilter( group.getUsers(), \"order by this.name" +"\" ).list();]]>" +msgstr "" -#: index.docbook:649 +#. Tag: title +#: collection_mapping.xml:649 +#, no-c-format msgid "Bidirectional associations" msgstr "双方向関連" -#: index.docbook:651 -msgid "A <emphasis>bidirectional association</emphasis> allows navigation from both \"ends\" of the association. Two kinds of bidirectional association are supported:" -msgstr "<emphasis>双方向関連</emphasis> は関連のどちら「側」からでもナビゲーションできます。 2種類の双方向関連がサポートされています。" +#. Tag: para +#: collection_mapping.xml:651 +#, fuzzy, no-c-format +msgid "" +"A <emphasis>bidirectional association</emphasis> allows navigation from both " +"\"ends\" of the association. Two kinds of bidirectional association are " +"supported:" +msgstr "" +"<emphasis>双方向関連</emphasis> は関連のどちら「側」からでもナビゲーションで" +"きます。 2種類の双方向関連がサポートされています。 <placeholder-1/>" -#: index.docbook:658 +#. Tag: term +#: collection_mapping.xml:658 +#, no-c-format msgid "one-to-many" msgstr "one-to-many" -#: index.docbook:660 +#. Tag: para +#: collection_mapping.xml:660 +#, no-c-format msgid "set or bag valued at one end, single-valued at the other" msgstr "片側がsetかbag、もう片方が単一値です。" -#: index.docbook:666 +#. Tag: term +#: collection_mapping.xml:666 +#, no-c-format msgid "many-to-many" msgstr "many-to-many" -#: index.docbook:668 +#. Tag: para +#: collection_mapping.xml:668 +#, no-c-format msgid "set or bag valued at both ends" msgstr "両側がsetかbagです。" -#: index.docbook:677 -msgid "You may specify a bidirectional many-to-many association simply by mapping two many-to-many associations to the same database table and declaring one end as <emphasis>inverse</emphasis> (which one is your choice, but it can not be an indexed collection)." -msgstr "2つの多対多関連で同じデータベーステーブルをマッピングし、 片方を <emphasis>inverse</emphasis> として宣言することで、 双方向の多対多関連を指定することが出来ます （どちらをinverseに選んだとしても、そちら側にはインデックス付きのコレクションは使えません）。" +#. Tag: para +#: collection_mapping.xml:677 +#, no-c-format +msgid "" +"You may specify a bidirectional many-to-many association simply by mapping " +"two many-to-many associations to the same database table and declaring one " +"end as <emphasis>inverse</emphasis> (which one is your choice, but it can " +"not be an indexed collection)." +msgstr "" +"2つの多対多関連で同じデータベーステーブルをマッピングし、 片方を " +"<emphasis>inverse</emphasis> として宣言することで、 双方向の多対多関連を指定" +"することが出来ます （どちらをinverseに選んだとしても、そちら側にはインデック" +"ス付きのコレクションは使えません）。" -#: index.docbook:684 -msgid "Here's an example of a bidirectional many-to-many association; each category can have many items and each item can be in many categories:" -msgstr "次に双方向の多対多関連の例を示します。 各カテゴリは多数のアイテムを持つことができ、各アイテムは多くのカテゴリに属することが出来ます。" +#. Tag: para +#: collection_mapping.xml:684 +#, no-c-format +msgid "" +"Here's an example of a bidirectional many-to-many association; each category " +"can have many items and each item can be in many categories:" +msgstr "" +"次に双方向の多対多関連の例を示します。 各カテゴリは多数のアイテムを持つことが" +"でき、各アイテムは多くのカテゴリに属することが出来ます。" -#: index.docbook:689 +#. Tag: programlisting +#: collection_mapping.xml:689 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Category\">\n" - " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" - " ...\n" - " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" - " <key column=\"CATEGORY_ID\"/>\n" - " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" - " </bag>\n" - "</class>\n" - "\n" - "<class name=\"Item\">\n" - " <id name=\"id\" column=\"ITEM_ID\"/>\n" - " ...\n" - "\n" - " <!-- inverse end -->\n" - " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" - " <key column=\"ITEM_ID\"/>\n" - " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" - " </bag>\n" - "</class>]]>" +"<![CDATA[<class name=\"Category\">\n" +" <id name=\"id\" column=\"CATEGORY_ID\"/>\n" +" ...\n" +" <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" +" <key column=\"CATEGORY_ID\"/>\n" +" <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" +" </bag>\n" +"</class>\n" +"\n" +"<class name=\"Item\">\n" +" <id name=\"id\" column=\"ITEM_ID\"/>\n" +" ...\n" +"\n" +" <!-- inverse end -->\n" +" <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" +" <key column=\"ITEM_ID\"/>\n" +" <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" +" </bag>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Category\">\n" - " <id name=\"id\" column=\"CATEGORY_ID\"/>\n" - " ...\n" - " <bag name=\"items\" table=\"CATEGORY_ITEM\">\n" - " <key column=\"CATEGORY_ID\"/>\n" - " <many-to-many class=\"Item\" column=\"ITEM_ID\"/>\n" - " </bag>\n" - "</class>\n" - "\n" - "<class name=\"Item\">\n" - " <id name=\"id\" column=\"ITEM_ID\"/> -\n" - " ...\n" - "\n" - " <!-- inverse end -->\n" - " <bag name=\"categories\" table=\"CATEGORY_ITEM\" inverse=\"true\">\n" - " <key column=\"ITEM_ID\"/>\n" - " <many-to-many class=\"Category\" column=\"CATEGORY_ID\"/>\n" - " </bag>\n" - "</class>]]>" -#: index.docbook:691 -msgid "Changes made only to the inverse end of the association are <emphasis>not</emphasis> persisted. This means that Hibernate has two representations in memory for every bidirectional association, one link from A to B and another link from B to A. This is easier to understand if you think about the Java object model and how we create a many-to-many relationship in Java:" -msgstr "関連のinverse側にのみ行われた変更は永続化 <emphasis>されません</emphasis>。 これは、Hibernateは全ての双方向関連について、メモリ上に２つの表現を持っているという意味です。 つまり一つはAからBへのリンクで、もう一つはBからAへのリンクということです。 Javaのオブジェクトモデルについて考え、Javaで双方向関係をどうやって作るかを考えれば、 これは理解しやすいです。下記に、Javaでの双方向関連を示します。" +#. Tag: para +#: collection_mapping.xml:691 +#, no-c-format +msgid "" +"Changes made only to the inverse end of the association are <emphasis>not</" +"emphasis> persisted. This means that Hibernate has two representations in " +"memory for every bidirectional association, one link from A to B and another " +"link from B to A. This is easier to understand if you think about the Java " +"object model and how we create a many-to-many relationship in Java:" +msgstr "" +"関連のinverse側にのみ行われた変更は永続化 <emphasis>されません</emphasis>。 " +"これは、Hibernateは全ての双方向関連について、メモリ上に２つの表現を持っている" +"という意味です。 つまり一つはAからBへのリンクで、もう一つはBからAへのリンクと" +"いうことです。 Javaのオブジェクトモデルについて考え、Javaで双方向関係をどう" +"やって作るかを考えれば、 これは理解しやすいです。下記に、Javaでの双方向関連を" +"示します。" -#: index.docbook:699 +#. Tag: programlisting +#: collection_mapping.xml:699 +#, no-c-format msgid "" - "<![CDATA[\n" - "category.getItems().add(item); // The category now \"knows\" about the relationship\n" - "item.getCategories().add(category); // The item now \"knows\" about the relationship\n" - "\n" - "session.persist(item); // The relationship won't be saved!\n" - "session.persist(category); // The relationship will be saved]]>" +"<![CDATA[\n" +"category.getItems().add(item); // The category now \"knows\" about " +"the relationship\n" +"item.getCategories().add(category); // The item now \"knows\" about the " +"relationship\n" +"\n" +"session.persist(item); // The relationship won't be " +"saved!\n" +"session.persist(category); // The relationship will be saved]]>" msgstr "" - "<![CDATA[\n" - "category.getItems().add(item); // The category now \"knows\" about the relationship\n" - "item.getCategories().add(category); // The item now \"knows\" about the relationship\n" - "\n" - "session.persist(item); // The relationship won't be saved!\n" - "session.persist(category); // The relationship will be saved]]>" -#: index.docbook:701 -msgid "The non-inverse side is used to save the in-memory representation to the database." -msgstr "関連のinverseではない側は、メモリ上の表現をデータベースに保存するのに使われます。" +#. Tag: para +#: collection_mapping.xml:701 +#, no-c-format +msgid "" +"The non-inverse side is used to save the in-memory representation to the " +"database." +msgstr "" +"関連のinverseではない側は、メモリ上の表現をデータベースに保存するのに使われま" +"す。" -#: index.docbook:705 -msgid "You may define a bidirectional one-to-many association by mapping a one-to-many association to the same table column(s) as a many-to-one association and declaring the many-valued end <literal>inverse=\"true\"</literal>." -msgstr "双方向の一対多関連を定義するには、 一対多関連を多対一関連と同じテーブルのカラムにマッピングし、 多側に <literal>inverse=\"true\"</literal> と宣言します。" +#. Tag: para +#: collection_mapping.xml:705 +#, no-c-format +msgid "" +"You may define a bidirectional one-to-many association by mapping a one-to-" +"many association to the same table column(s) as a many-to-one association " +"and declaring the many-valued end <literal>inverse=\"true\"</literal>." +msgstr "" +"双方向の一対多関連を定義するには、 一対多関連を多対一関連と同じテーブルのカラ" +"ムにマッピングし、 多側に <literal>inverse=\"true\"</literal> と宣言します。" -#: index.docbook:711 +#. Tag: programlisting +#: collection_mapping.xml:711 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -#: index.docbook:713 -msgid "Mapping one end of an association with <literal>inverse=\"true\"</literal> doesn't affect the operation of cascades, these are orthogonal concepts!" -msgstr "関連の片側に <literal>inverse=\"true\"</literal> を設定しても、 カスケード操作に影響を与えません。これらは直交した概念です！" +#. Tag: para +#: collection_mapping.xml:713 +#, no-c-format +msgid "" +"Mapping one end of an association with <literal>inverse=\"true\"</literal> " +"doesn't affect the operation of cascades, these are orthogonal concepts!" +msgstr "" +"関連の片側に <literal>inverse=\"true\"</literal> を設定しても、 カスケード操" +"作に影響を与えません。これらは直交した概念です！" -#: index.docbook:721 +#. Tag: title +#: collection_mapping.xml:721 +#, no-c-format msgid "Bidirectional associations with indexed collections" msgstr "インデックス付きコレクションと双方向関連" -#: index.docbook:722 -msgid "A bidirectional association where one end is represented as a <literal>&lt;list&gt;</literal> or <literal>&lt;map&gt;</literal> requires special consideration. If there is a property of the child class which maps to the index column, no problem, we can continue using <literal>inverse=\"true\"</literal> on the collection mapping:" -msgstr "片側が <literal>&lt;list&gt;</literal> や <literal>&lt;map&gt;</literal> である 双方向関連は、特によく考える必要があります。 インデックスカラムにマップされる子クラスのプロパティがある場合は、問題ないです。 コレクションのマッピングで <literal>inverse=\"true\"</literal> を使い続けられます。" +#. Tag: para +#: collection_mapping.xml:722 +#, no-c-format +msgid "" +"A bidirectional association where one end is represented as a <literal>&lt;" +"list&gt;</literal> or <literal>&lt;map&gt;</literal> requires special " +"consideration. If there is a property of the child class which maps to the " +"index column, no problem, we can continue using <literal>inverse=\"true\"</" +"literal> on the collection mapping:" +msgstr "" +"片側が <literal>&lt;list&gt;</literal> や <literal>&lt;map&gt;</literal> であ" +"る 双方向関連は、特によく考える必要があります。 インデックスカラムにマップさ" +"れる子クラスのプロパティがある場合は、問題ないです。 コレクションのマッピング" +"で <literal>inverse=\"true\"</literal> を使い続けられます。" -#: index.docbook:729 +#. Tag: programlisting +#: collection_mapping.xml:729 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <property name=\"name\" \n" - " not-null=\"true\"/>\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <map name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <map-key column=\"name\" \n" +" type=\"string\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </map>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <property name=\"name\" \n" +" not-null=\"true\"/>\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <property name=\"name\" \n" - " not-null=\"true\"/>\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -#: index.docbook:731 -msgid "But, if there is no such property on the child class, we can't think of the association as truly bidirectional (there is information available at one end of the association that is not available at the other end). In this case, we can't map the collection <literal>inverse=\"true\"</literal>. Instead, we could use the following mapping:" -msgstr "しかし、子クラスにそのようなプロパティがない場合は、 関連を真に双方向であると考えることができません （関連の片側に利用できる情報がありますが、もう一方にはありません）。 この場合は、コレクションに <literal>inverse=\"true\"</literal> をマッピングできません。 代わりに、次のようなマッピングが使えます。" +#. Tag: para +#: collection_mapping.xml:731 +#, no-c-format +msgid "" +"But, if there is no such property on the child class, we can't think of the " +"association as truly bidirectional (there is information available at one " +"end of the association that is not available at the other end). In this " +"case, we can't map the collection <literal>inverse=\"true\"</literal>. " +"Instead, we could use the following mapping:" +msgstr "" +"しかし、子クラスにそのようなプロパティがない場合は、 関連を真に双方向であると" +"考えることができません （関連の片側に利用できる情報がありますが、もう一方には" +"ありません）。 この場合は、コレクションに <literal>inverse=\"true\"</" +"literal> をマッピングできません。 代わりに、次のようなマッピングが使えます。" -#: index.docbook:738 +#. Tag: programlisting +#: collection_mapping.xml:738 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\">\n" - " <key column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " insert=\"false\"\n" - " update=\"false\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Parent\">\n" +" <id name=\"id\" column=\"parent_id\"/>\n" +" ....\n" +" <map name=\"children\">\n" +" <key column=\"parent_id\"\n" +" not-null=\"true\"/>\n" +" <map-key column=\"name\" \n" +" type=\"string\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </map>\n" +"</class>\n" +"\n" +"<class name=\"Child\">\n" +" <id name=\"id\" column=\"child_id\"/>\n" +" ....\n" +" <many-to-one name=\"parent\" \n" +" class=\"Parent\" \n" +" column=\"parent_id\"\n" +" insert=\"false\"\n" +" update=\"false\"\n" +" not-null=\"true\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Parent\">\n" - " <id name=\"id\" column=\"parent_id\"/>\n" - " ....\n" - " <map name=\"children\">\n" - " <key column=\"parent_id\"\n" - " not-null=\"true\"/>\n" - " <map-key column=\"name\" \n" - " type=\"string\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </map>\n" - "</class>\n" - "\n" - "<class name=\"Child\">\n" - " <id name=\"id\" column=\"child_id\"/>\n" - " ....\n" - " <many-to-one name=\"parent\" \n" - " class=\"Parent\" \n" - " column=\"parent_id\"\n" - " insert=\"false\"\n" - " update=\"false\"\n" - " not-null=\"true\"/>\n" - "</class>]]>" -#: index.docbook:740 -msgid "Note that in this mapping, the collection-valued end of the association is responsible for updates to the foreign key. TODO: Does this really result in some unnecessary update statements?" -msgstr "注意： このマッピングでは、関連のコレクション値の側は、 外部キーをアップデートする責任があります。" +#. Tag: para +#: collection_mapping.xml:740 +#, no-c-format +msgid "" +"Note that in this mapping, the collection-valued end of the association is " +"responsible for updates to the foreign key. TODO: Does this really result in " +"some unnecessary update statements?" +msgstr "" +"注意： このマッピングでは、関連のコレクション値の側は、 外部キーをアップデー" +"トする責任があります。" -#: index.docbook:748 +#. Tag: title +#: collection_mapping.xml:748 +#, no-c-format msgid "Ternary associations" msgstr "3項関連" -#: index.docbook:750 -msgid "There are three possible approaches to mapping a ternary association. One is to use a <literal>Map</literal> with an association as its index:" -msgstr "3項関連のマッピングには3つのアプローチがあります。 1つ目は関連をインデックスとして <literal>Map</literal> を使用するアプローチです。" +#. Tag: para +#: collection_mapping.xml:750 +#, no-c-format +msgid "" +"There are three possible approaches to mapping a ternary association. One is " +"to use a <literal>Map</literal> with an association as its index:" +msgstr "" +"3項関連のマッピングには3つのアプローチがあります。 1つ目は関連をインデックス" +"として <literal>Map</literal> を使用するアプローチです。" -#: index.docbook:755 +#. Tag: programlisting +#: collection_mapping.xml:755 +#, no-c-format msgid "" - "<![CDATA[<map name=\"contracts\">\n" - " <key column=\"employer_id\" not-null=\"true\"/>\n" - " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" - " <one-to-many class=\"Contract\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"contracts\">\n" +" <key column=\"employer_id\" not-null=\"true\"/>\n" +" <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" +" <one-to-many class=\"Contract\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"contracts\">\n" - " <key column=\"employer_id\" not-null=\"true\"/>\n" - " <map-key-many-to-many column=\"employee_id\" class=\"Employee\"/>\n" - " <one-to-many class=\"Contract\"/>\n" - "</map>]]>" -#: index.docbook:757 +#. Tag: programlisting +#: collection_mapping.xml:757 +#, no-c-format msgid "" - "<![CDATA[<map name=\"connections\">\n" - " <key column=\"incoming_node_id\"/>\n" - " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" - " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" - "</map>]]>" +"<![CDATA[<map name=\"connections\">\n" +" <key column=\"incoming_node_id\"/>\n" +" <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" +" <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" +"</map>]]>" msgstr "" - "<![CDATA[<map name=\"connections\">\n" - " <key column=\"incoming_node_id\"/>\n" - " <map-key-many-to-many column=\"outgoing_node_id\" class=\"Node\"/>\n" - " <many-to-many column=\"connection_id\" class=\"Connection\"/>\n" - "</map>]]>" -#: index.docbook:759 -msgid "A second approach is to simply remodel the association as an entity class. This is the approach we use most commonly." -msgstr "2つ目は単純に関連をエンティティ･クラスとしてモデルを作り直すアプローチで、 頻繁に使われます。" +#. Tag: para +#: collection_mapping.xml:759 +#, no-c-format +msgid "" +"A second approach is to simply remodel the association as an entity class. " +"This is the approach we use most commonly." +msgstr "" +"2つ目は単純に関連をエンティティ･クラスとしてモデルを作り直すアプローチで、 頻" +"繁に使われます。" -#: index.docbook:764 -msgid "A final alternative is to use composite elements, which we will discuss later." -msgstr "最後はcomposite要素を使うアプローチです。これに関する議論は後ほど行います。" +#. Tag: para +#: collection_mapping.xml:764 +#, no-c-format +msgid "" +"A final alternative is to use composite elements, which we will discuss " +"later." +msgstr "" +"最後はcomposite要素を使うアプローチです。これに関する議論は後ほど行います。" -#: index.docbook:771 +#. Tag: literal +#: collection_mapping.xml:771 +#, no-c-format msgid "Using an &lt;idbag&gt;" msgstr "<literal>&lt;idbag&gt;</literal>の使用" -#: index.docbook:773 -msgid "If you've fully embraced our view that composite keys are a bad thing and that entities should have synthetic identifiers (surrogate keys), then you might find it a bit odd that the many to many associations and collections of values that we've shown so far all map to tables with composite keys! Now, this point is quite arguable; a pure association table doesn't seem to benefit much from a surrogate key (though a collection of composite values <emphasis>might</emphasis>). Nevertheless, Hibernate provides a feature that allows you to map many to many associations and collections of values to a table with a surrogate key." -msgstr "複合キーは悪いもので、エンティティは人工の識別子(代理キー)を持つべきであるという考え方からは、 多対多関連と値のコレクションを複合キーを用いたテーブルへマッピングするのは少し奇妙に感じるかもしれません！ 確かにこの考え方には議論の余地があります。 純粋な関連テーブルは代理キーを使っても利益を得られないように思えるからです （合成値のコレクションは利益がある <emphasis>かも</emphasis> しれませんが）。 とはいえ、Hibernateは代理キーを持つテーブルへ多対多関連と値のコレクションを マッピングする機能も備えています。" +#. Tag: para +#: collection_mapping.xml:773 +#, no-c-format +msgid "" +"If you've fully embraced our view that composite keys are a bad thing and " +"that entities should have synthetic identifiers (surrogate keys), then you " +"might find it a bit odd that the many to many associations and collections " +"of values that we've shown so far all map to tables with composite keys! " +"Now, this point is quite arguable; a pure association table doesn't seem to " +"benefit much from a surrogate key (though a collection of composite values " +"<emphasis>might</emphasis>). Nevertheless, Hibernate provides a feature that " +"allows you to map many to many associations and collections of values to a " +"table with a surrogate key." +msgstr "" +"複合キーは悪いもので、エンティティは人工の識別子(代理キー)を持つべきであると" +"いう考え方からは、 多対多関連と値のコレクションを複合キーを用いたテーブルへ" +"マッピングするのは少し奇妙に感じるかもしれません！ 確かにこの考え方には議論の" +"余地があります。 純粋な関連テーブルは代理キーを使っても利益を得られないように" +"思えるからです （合成値のコレクションは利益がある <emphasis>かも</emphasis> " +"しれませんが）。 とはいえ、Hibernateは代理キーを持つテーブルへ多対多関連と値" +"のコレクションを マッピングする機能も備えています。" -#: index.docbook:784 -msgid "The <literal>&lt;idbag&gt;</literal> element lets you map a <literal>List</literal> (or <literal>Collection</literal>) with bag semantics." -msgstr "bagのセマンティックスを持った <literal>List</literal>（または <literal>Collection</literal>）を <literal>&lt;idbag&gt;</literal> 要素にマッピングできます。" +#. Tag: para +#: collection_mapping.xml:784 +#, no-c-format +msgid "" +"The <literal>&lt;idbag&gt;</literal> element lets you map a <literal>List</" +"literal> (or <literal>Collection</literal>) with bag semantics." +msgstr "" +"bagのセマンティックスを持った <literal>List</literal>（または " +"<literal>Collection</literal>）を <literal>&lt;idbag&gt;</literal> 要素にマッ" +"ピングできます。" -#: index.docbook:789 +#. Tag: programlisting +#: collection_mapping.xml:789 +#, no-c-format msgid "" - "<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" - " <collection-id column=\"ID\" type=\"long\">\n" - " <generator class=\"sequence\"/>\n" - " </collection-id>\n" - " <key column=\"PERSON1\"/>\n" - " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" - "</idbag>]]>" +"<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" +" <collection-id column=\"ID\" type=\"long\">\n" +" <generator class=\"sequence\"/>\n" +" </collection-id>\n" +" <key column=\"PERSON1\"/>\n" +" <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" +"</idbag>]]>" msgstr "" - "<![CDATA[<idbag name=\"lovers\" table=\"LOVERS\">\n" - " <collection-id column=\"ID\" type=\"long\">\n" - " <generator class=\"sequence\"/>\n" - " </collection-id>\n" - " <key column=\"PERSON1\"/>\n" - " <many-to-many column=\"PERSON2\" class=\"Person\" fetch=\"join\"/>\n" - "</idbag>]]>" -#: index.docbook:791 -msgid "As you can see, an <literal>&lt;idbag&gt;</literal> has a synthetic id generator, just like an entity class! A different surrogate key is assigned to each collection row. Hibernate does not provide any mechanism to discover the surrogate key value of a particular row, however." -msgstr "ご存知のように <literal>&lt;idbag&gt;</literal> はエンティティ･クラスのように 人工的なidジェネレータを持っています！ 異なる代理キーをそれぞれのコレクションの列に割り当てます。 しかしながら、Hibernateはある行の代理キーの値を見つけ出す機構を持っていません。" +#. Tag: para +#: collection_mapping.xml:791 +#, no-c-format +msgid "" +"As you can see, an <literal>&lt;idbag&gt;</literal> has a synthetic id " +"generator, just like an entity class! A different surrogate key is assigned " +"to each collection row. Hibernate does not provide any mechanism to discover " +"the surrogate key value of a particular row, however." +msgstr "" +"ご存知のように <literal>&lt;idbag&gt;</literal> はエンティティ･クラスのよう" +"に 人工的なidジェネレータを持っています！ 異なる代理キーをそれぞれのコレク" +"ションの列に割り当てます。 しかしながら、Hibernateはある行の代理キーの値を見" +"つけ出す機構を持っていません。" -#: index.docbook:798 -msgid "Note that the update performance of an <literal>&lt;idbag&gt;</literal> is <emphasis>much</emphasis> better than a regular <literal>&lt;bag&gt;</literal>! Hibernate can locate individual rows efficiently and update or delete them individually, just like a list, map or set." -msgstr "<literal>&lt;idbag&gt;</literal> を更新するパフォーマンスは 通常の <literal>&lt;bag&gt;</literal> よりも良いことに注目してください！ Hibernateは個々の行を効果的に見つけることができ、 listやmap、setのように個別にその行を更新、削除できます。" +#. Tag: para +#: collection_mapping.xml:798 +#, no-c-format +msgid "" +"Note that the update performance of an <literal>&lt;idbag&gt;</literal> is " +"<emphasis>much</emphasis> better than a regular <literal>&lt;bag&gt;</" +"literal>! Hibernate can locate individual rows efficiently and update or " +"delete them individually, just like a list, map or set." +msgstr "" +"<literal>&lt;idbag&gt;</literal> を更新するパフォーマンスは 通常の " +"<literal>&lt;bag&gt;</literal> よりも良いことに注目してください！ Hibernateは" +"個々の行を効果的に見つけることができ、 listやmap、setのように個別にその行を更" +"新、削除できます。" -#: index.docbook:805 -msgid "In the current implementation, the <literal>native</literal> identifier generation strategy is not supported for <literal>&lt;idbag&gt;</literal> collection identifiers." -msgstr "現在の実装では、<literal>native</literal> というid生成戦略を <literal>&lt;idbag&gt;</literal> コレクションの識別子に対して使えません。" +#. Tag: para +#: collection_mapping.xml:805 +#, no-c-format +msgid "" +"In the current implementation, the <literal>native</literal> identifier " +"generation strategy is not supported for <literal>&lt;idbag&gt;</literal> " +"collection identifiers." +msgstr "" +"現在の実装では、<literal>native</literal> というid生成戦略を <literal>&lt;" +"idbag&gt;</literal> コレクションの識別子に対して使えません。" -#: index.docbook:829 +#. Tag: title +#: collection_mapping.xml:829 +#, no-c-format msgid "Collection examples" msgstr "コレクションの例" -#: index.docbook:831 -msgid "The previous sections are pretty confusing. So lets look at an example. This class:" +#. Tag: para +#: collection_mapping.xml:831 +#, no-c-format +msgid "" +"The previous sections are pretty confusing. So lets look at an example. This " +"class:" msgstr "これまでの節の説明では理解しにくいので、以下の例を見てください。" -#: index.docbook:836 +#. Tag: programlisting +#: collection_mapping.xml:836 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "\n" - "public class Parent {\n" - " private long id;\n" - " private Set children;\n" - "\n" - " public long getId() { return id; }\n" - " private void setId(long id) { this.id=id; }\n" - "\n" - " private Set getChildren() { return children; }\n" - " private void setChildren(Set children) { this.children=children; }\n" - "\n" - " ....\n" - " ....\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"\n" +"public class Parent {\n" +" private long id;\n" +" private Set children;\n" +"\n" +" public long getId() { return id; }\n" +" private void setId(long id) { this.id=id; }\n" +"\n" +" private Set getChildren() { return children; }\n" +" private void setChildren(Set children) { this.children=children; }\n" +"\n" +" ....\n" +" ....\n" +"}]]>" msgstr "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "\n" - "public class Parent {\n" - " private long id;\n" - " private Set children;\n" - "\n" - " public long getId() { return id; }\n" - " private void setId(long id) { this.id=id; }\n" - "\n" - " private Set getChildren() { return children; }\n" - " private void setChildren(Set children) { this.children=children; }\n" - "\n" - " ....\n" - " ....\n" - "}]]>" -#: index.docbook:838 -msgid "has a collection of <literal>Child</literal> instances. If each child has at most one parent, the most natural mapping is a one-to-many association:" -msgstr "このクラスは <literal>Child</literal> インスタンスのコレクションを持っています。 もし各々のchildが最大でも一つのparentを持っているならば、最も自然なマッピングは一対多関連です。" +#. Tag: para +#: collection_mapping.xml:838 +#, no-c-format +msgid "" +"has a collection of <literal>Child</literal> instances. If each child has at " +"most one parent, the most natural mapping is a one-to-many association:" +msgstr "" +"このクラスは <literal>Child</literal> インスタンスのコレクションを持っていま" +"す。 もし各々のchildが最大でも一つのparentを持っているならば、最も自然なマッ" +"ピングは一対多関連です。" -#: index.docbook:844 +#. Tag: programlisting +#: collection_mapping.xml:844 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:846 +#. Tag: para +#: collection_mapping.xml:846 +#, no-c-format msgid "This maps to the following table definitions:" msgstr "これは以下のテーブル定義にマッピングします。" -#: index.docbook:850 +#. Tag: programlisting +#: collection_mapping.xml:850 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255), parent_id bigint )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null primary key, name varchar(255), " +"parent_id bigint )\n" +"alter table child add constraint childfk0 (parent_id) references parent]]>" msgstr "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255), parent_id bigint )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" -#: index.docbook:852 -msgid "If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-many association:" -msgstr "もしparentが <emphasis>要求</emphasis> されるなら、双方向の一対多関連を使用してください。" +#. Tag: para +#: collection_mapping.xml:852 +#, no-c-format +msgid "" +"If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-" +"many association:" +msgstr "" +"もしparentが <emphasis>要求</emphasis> されるなら、双方向の一対多関連を使用し" +"てください。" -#: index.docbook:857 +#. Tag: programlisting +#: collection_mapping.xml:857 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" not-null=\"true\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" " +"not-null=\"true\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <many-to-one name=\"parent\" class=\"Parent\" column=\"parent_id\" not-null=\"true\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:859 +#. Tag: para +#: collection_mapping.xml:859 +#, no-c-format msgid "Notice the <literal>NOT NULL</literal> constraint:" msgstr "<literal>NOT NULL</literal> 制約に注意してください。" -#: index.docbook:863 +#. Tag: programlisting +#: collection_mapping.xml:863 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null\n" - " primary key,\n" - " name varchar(255),\n" - " parent_id bigint not null )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null\n" +" primary key,\n" +" name varchar(255),\n" +" parent_id bigint not null )\n" +"alter table child add constraint childfk0 (parent_id) references parent]]>" msgstr "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null\n" - " primary key,\n" - " name varchar(255),\n" - " parent_id bigint not null )\n" - "alter table child add constraint childfk0 (parent_id) references parent]]>" -#: index.docbook:865 -msgid "Alternatively, if you absolutely insist that this association should be unidirectional, you can declare the <literal>NOT NULL</literal> constraint on the <literal>&lt;key&gt;</literal> mapping:" -msgstr "あるいは、もしこの関連は単方向であるべきと強く主張するのであれば、 <literal>&lt;key&gt;</literal> に <literal>NOT NULL</literal> 制約を宣言できます。" +#. Tag: para +#: collection_mapping.xml:865 +#, no-c-format +msgid "" +"Alternatively, if you absolutely insist that this association should be " +"unidirectional, you can declare the <literal>NOT NULL</literal> constraint " +"on the <literal>&lt;key&gt;</literal> mapping:" +msgstr "" +"あるいは、もしこの関連は単方向であるべきと強く主張するのであれば、 " +"<literal>&lt;key&gt;</literal> に <literal>NOT NULL</literal> 制約を宣言でき" +"ます。" -#: index.docbook:871 +#. Tag: programlisting +#: collection_mapping.xml:871 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\">\n" +" <key column=\"parent_id\" not-null=\"true\"/>\n" +" <one-to-many class=\"Child\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:873 -msgid "On the other hand, if a child might have multiple parents, a many-to-many association is appropriate:" +#. Tag: para +#: collection_mapping.xml:873 +#, no-c-format +msgid "" +"On the other hand, if a child might have multiple parents, a many-to-many " +"association is appropriate:" msgstr "一方で、もしchildが複数のparentを持てるならば、多対多関連が妥当です。" -#: index.docbook:878 +#. Tag: programlisting +#: collection_mapping.xml:878 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" table=\"childset\">\n" - " <key column=\"parent_id\"/>\n" - " <many-to-many class=\"Child\" column=\"child_id\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Parent\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <set name=\"children\" table=\"childset\">\n" +" <key column=\"parent_id\"/>\n" +" <many-to-many class=\"Child\" column=\"child_id\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Child\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Parent\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <set name=\"children\" table=\"childset\">\n" - " <key column=\"parent_id\"/>\n" - " <many-to-many class=\"Child\" column=\"child_id\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Child\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" -#: index.docbook:880 +#. Tag: para +#: collection_mapping.xml:880 +#, no-c-format msgid "Table definitions:" msgstr "テーブル定義は以下のようになります。" -#: index.docbook:884 +#. Tag: programlisting +#: collection_mapping.xml:884 +#, no-c-format msgid "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255) )\n" - "create table childset ( parent_id bigint not null,\n" - " child_id bigint not null,\n" - " primary key ( parent_id, child_id ) )\n" - "alter table childset add constraint childsetfk0 (parent_id) references parent\n" - "alter table childset add constraint childsetfk1 (child_id) references child]]>" +"<![CDATA[create table parent ( id bigint not null primary key )\n" +"create table child ( id bigint not null primary key, name varchar(255) )\n" +"create table childset ( parent_id bigint not null,\n" +" child_id bigint not null,\n" +" primary key ( parent_id, child_id ) )\n" +"alter table childset add constraint childsetfk0 (parent_id) references " +"parent\n" +"alter table childset add constraint childsetfk1 (child_id) references child]]" +">" msgstr "" - "<![CDATA[create table parent ( id bigint not null primary key )\n" - "create table child ( id bigint not null primary key, name varchar(255) )\n" - "create table childset ( parent_id bigint not null,\n" - " child_id bigint not null,\n" - " primary key ( parent_id, child_id ) )\n" - "alter table childset add constraint childsetfk0 (parent_id) references parent\n" - "alter table childset add constraint childsetfk1 (child_id) references child]]>" -#: index.docbook:886 -msgid "For more examples and a complete walk-through a parent/child relationship mapping, see <xref linkend=\"example-parentchild\"/>." -msgstr "parent/child関係のマッピングについてのより多くの例や完全な手順が必要であれば、 <xref linkend=\"example-parentchild\"/> をご覧ください。" +#. Tag: para +#: collection_mapping.xml:886 +#, no-c-format +msgid "" +"For more examples and a complete walk-through a parent/child relationship " +"mapping, see <xref linkend=\"example-parentchild\"/>." +msgstr "" +"parent/child関係のマッピングについてのより多くの例や完全な手順が必要であれ" +"ば、 <xref linkend=\"example-parentchild\"/> をご覧ください。" -#: index.docbook:891 -msgid "Even more exotic association mappings are possible, we will catalog all possibilities in the next chapter." +#. Tag: para +#: collection_mapping.xml:891 +#, no-c-format +msgid "" +"Even more exotic association mappings are possible, we will catalog all " +"possibilities in the next chapter." msgstr "また、さらに特殊な関連マッピングも可能です。次の章で詳しく述べます。" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" +#~ msgid "" +#~ "<literal>column_name</literal> (required): The name of the column holding " +#~ "the collection index values." +#~ msgstr "" +#~ "<literal>column_name</literal>（必須）:コレクションインデックスの値を保持" +#~ "するカラムの名前。" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" +#~ msgid "" +#~ "<literal>base</literal> (optional, defaults to <literal>0</literal>): The " +#~ "value of the index column that corresponds to the first element of the " +#~ "list or array." +#~ msgstr "" +#~ "<literal>base</literal>（オプション、デフォルトは <literal>0</literal>）: " +#~ "リストもしくは配列の最初の要素に該当するインデックスカラムの値。" +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection index values." +#~ msgstr "" +#~ "<literal>column</literal>（オプション）: コレクションインデックスの値を保" +#~ "持するカラムの名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "key of the map." +#~ msgstr "" +#~ "<literal>formula</literal>（オプション）: Mapのキーを評価するのに使われる" +#~ "SQL式。" + +#~ msgid "<literal>type</literal> (reguired): The type of the map keys." +#~ msgstr "<literal>type</literal>（必須）: Mapのキーの型。" + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the foreign key column " +#~ "for the collection index values." +#~ msgstr "" +#~ "<literal>column</literal> （オプション）: コレクションインデックスの値のた" +#~ "めの外部キーカラムの名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the " +#~ "foreign key of the map key." +#~ msgstr "" +#~ "<literal>formula</literal> （オプション）: Mapのキーのための外部キーを評価" +#~ "するために使うSQL式。" + +#~ msgid "" +#~ "<literal>class</literal> (required): The entity class used as the map key." +#~ msgstr "" +#~ "<literal>class</literal> （必須）: Mapのキーとして使われるエンティティクラ" +#~ "ス。" + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the column holding the " +#~ "collection element values." +#~ msgstr "" +#~ "<literal>column</literal> （オプション）: コレクションの要素の値を保持する" +#~ "カラムの名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element." +#~ msgstr "" +#~ "<literal>formula</literal> （オプション）: 要素を評価するために使うSQL式。" + +#~ msgid "" +#~ "<literal>type</literal> (required): The type of the collection element." +#~ msgstr "<literal>type</literal> （必須）コレクションの要素の型。" + +#~ msgid "" +#~ "A <emphasis>many-to-many association</emphasis> is specified using the " +#~ "<literal>&lt;many-to-many&gt;</literal> element." +#~ msgstr "" +#~ "<emphasis>多対多関連</emphasis> は <literal>&lt;many-to-many&gt;</" +#~ "literal> 要素で指定します。" + +#~ msgid "" +#~ "<literal>column</literal> (optional): The name of the element foreign key " +#~ "column." +#~ msgstr "" +#~ "<literal>column</literal> （オプション）: 外部キーカラムの要素の名前。" + +#~ msgid "" +#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate " +#~ "the element foreign key value." +#~ msgstr "" +#~ "<literal>formula</literal> （オプション）: 外部キー値の要素を評価するため" +#~ "に使うSQL式。" + +#~ msgid "" +#~ "<literal>fetch</literal> (optional - defaults to <literal>join</" +#~ "literal>): enables outer-join or sequential select fetching for this " +#~ "association. This is a special case; for full eager fetching (in a single " +#~ "<literal>SELECT</literal>) of an entity and its many-to-many " +#~ "relationships to other entities, you would enable <literal>join</literal> " +#~ "fetching not only of the collection itself, but also with this attribute " +#~ "on the <literal>&lt;many-to-many&gt;</literal> nested element." +#~ msgstr "" +#~ "<literal>fetch</literal> (オプション - デフォルトは <literal>join</" +#~ "literal>): 関連のために、外部結合か順次選択フェッチを有効にします。 これは" +#~ "特殊なケースですが、エンティティと他のエンティティとの多対多関係を （１つ" +#~ "の <literal>SELECT</literal> により）完全に即時にフェッチするためには、 そ" +#~ "のコレクション自体だけでなく、 ネストした要素である <literal>&lt;many-to-" +#~ "many&gt;</literal> のこの属性についても <literal>join</literal> フェッチを" +#~ "有効する必要があります。" + +#~ msgid "" +#~ "<literal>unique</literal> (optional): Enable the DDL generation of a " +#~ "unique constraint for the foreign-key column. This makes the association " +#~ "multiplicity effectively one to many." +#~ msgstr "" +#~ "<literal>unique</literal> （オプション）: 外部キーカラムのユニーク制約の" +#~ "DDL生成を有効にします。 これは、関連の多重度を事実上一対多にします。" + +#~ msgid "" +#~ "<literal>not-found</literal> (optional - defaults to <literal>exception</" +#~ "literal>): Specifies how foreign keys that reference missing rows will be " +#~ "handled: <literal>ignore</literal> will treat a missing row as a null " +#~ "association." +#~ msgstr "" +#~ "<literal>not-found</literal> （オプション - デフォルトは " +#~ "<literal>exception</literal>） 参照先の行がない外部キーをどのように扱うか" +#~ "を指定します。 <literal>ignore</literal> にすると、行がないことを関連が無" +#~ "いものとして扱います。" + +#~ msgid "" +#~ "<literal>property-ref</literal>: (optional) The name of a property of the " +#~ "associated class that is joined to this foreign key. If not specified, " +#~ "the primary key of the associated class is used." +#~ msgstr "" +#~ "<literal>property-ref</literal>: （オプション） この外部キーに結合する関連" +#~ "クラスのプロパティ名。 指定しなかった場合は、関連クラスの主キーを使いま" +#~ "す。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/component_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,679 +1,676 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: component_mapping.xml:5 +#, no-c-format msgid "Component Mapping" msgstr "コンポーネントのマッピング" -#: index.docbook:7 -msgid "The notion of a <emphasis>component</emphasis> is re-used in several different contexts, for different purposes, throughout Hibernate." -msgstr "<emphasis>コンポーネント</emphasis> の概念は、Hibernateを通して様々な状況の中で 異なる目的のために再利用されます。" +#. Tag: para +#: component_mapping.xml:7 +#, no-c-format +msgid "" +"The notion of a <emphasis>component</emphasis> is re-used in several " +"different contexts, for different purposes, throughout Hibernate." +msgstr "" +"<emphasis>コンポーネント</emphasis> の概念は、Hibernateを通して様々な状況の中" +"で 異なる目的のために再利用されます。" -#: index.docbook:13 +#. Tag: title +#: component_mapping.xml:13 +#, no-c-format msgid "Dependent objects" msgstr "依存オブジェクト" -#: index.docbook:15 -msgid "A component is a contained object that is persisted as a value type, not an entity reference. The term \"component\" refers to the object-oriented notion of composition (not to architecture-level components). For example, you might model a person like this:" -msgstr "コンポーネントは、エンティティの参照ではなく値型として永続化された、 包含されたオブジェクトです。コンポーネントという言葉については、コンポジションという オブジェクト指向の概念を参照してください（アーキテクチャレベルのコンポーネントではありません）。 例えば、以下のPersonモデルのようなものです。" +#. Tag: para +#: component_mapping.xml:15 +#, no-c-format +msgid "" +"A component is a contained object that is persisted as a value type, not an " +"entity reference. The term \"component\" refers to the object-oriented " +"notion of composition (not to architecture-level components). For example, " +"you might model a person like this:" +msgstr "" +"コンポーネントは、エンティティの参照ではなく値型として永続化された、 包含され" +"たオブジェクトです。コンポーネントという言葉については、コンポジションという " +"オブジェクト指向の概念を参照してください（アーキテクチャレベルのコンポーネン" +"トではありません）。 例えば、以下のPersonモデルのようなものです。" -#: index.docbook:21 +#. Tag: programlisting +#: component_mapping.xml:21 +#, no-c-format msgid "" - "<![CDATA[public class Person {\n" - " private java.util.Date birthday;\n" - " private Name name;\n" - " private String key;\n" - " public String getKey() {\n" - " return key;\n" - " }\n" - " private void setKey(String key) {\n" - " this.key=key;\n" - " }\n" - " public java.util.Date getBirthday() {\n" - " return birthday;\n" - " }\n" - " public void setBirthday(java.util.Date birthday) {\n" - " this.birthday = birthday;\n" - " }\n" - " public Name getName() {\n" - " return name;\n" - " }\n" - " public void setName(Name name) {\n" - " this.name = name;\n" - " }\n" - " ......\n" - " ......\n" - "}]]>" +"<![CDATA[public class Person {\n" +" private java.util.Date birthday;\n" +" private Name name;\n" +" private String key;\n" +" public String getKey() {\n" +" return key;\n" +" }\n" +" private void setKey(String key) {\n" +" this.key=key;\n" +" }\n" +" public java.util.Date getBirthday() {\n" +" return birthday;\n" +" }\n" +" public void setBirthday(java.util.Date birthday) {\n" +" this.birthday = birthday;\n" +" }\n" +" public Name getName() {\n" +" return name;\n" +" }\n" +" public void setName(Name name) {\n" +" this.name = name;\n" +" }\n" +" ......\n" +" ......\n" +"}]]>" msgstr "" - "<![CDATA[public class Person { -\n" - " private java.util.Date birthday; -\n" - " private Name name; -\n" - " private String key; -\n" - " public String getKey() { -\n" - " return key; -\n" - " } -\n" - " private void setKey(String key) { -\n" - " this.key=key; -\n" - " } -\n" - " public java.util.Date getBirthday() { -\n" - " return birthday; -\n" - " } -\n" - " public void setBirthday(java.util.Date birthday) { -\n" - " this.birthday = birthday; -\n" - " } -\n" - " public Name getName() { -\n" - " return name; -\n" - " } -\n" - " public void setName(Name name) { -\n" - " this.name = name; -\n" - " } -\n" - " ...... -\n" - " ...... -\n" - "}]]>" -#: index.docbook:23 +#. Tag: programlisting +#: component_mapping.xml:23 +#, no-c-format msgid "" - "<![CDATA[public class Name {\n" - " char initial;\n" - " String first;\n" - " String last;\n" - " public String getFirst() {\n" - " return first;\n" - " }\n" - " void setFirst(String first) {\n" - " this.first = first;\n" - " }\n" - " public String getLast() {\n" - " return last;\n" - " }\n" - " void setLast(String last) {\n" - " this.last = last;\n" - " }\n" - " public char getInitial() {\n" - " return initial;\n" - " }\n" - " void setInitial(char initial) {\n" - " this.initial = initial;\n" - " }\n" - "}]]>" +"<![CDATA[public class Name {\n" +" char initial;\n" +" String first;\n" +" String last;\n" +" public String getFirst() {\n" +" return first;\n" +" }\n" +" void setFirst(String first) {\n" +" this.first = first;\n" +" }\n" +" public String getLast() {\n" +" return last;\n" +" }\n" +" void setLast(String last) {\n" +" this.last = last;\n" +" }\n" +" public char getInitial() {\n" +" return initial;\n" +" }\n" +" void setInitial(char initial) {\n" +" this.initial = initial;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[public class Name { -\n" - " char initial; -\n" - " String first; -\n" - " String last; -\n" - " public String getFirst() { -\n" - " return first; -\n" - " } -\n" - " void setFirst(String first) { -\n" - " this.first = first; -\n" - " } -\n" - " public String getLast() { -\n" - " return last; -\n" - " } -\n" - " void setLast(String last) { -\n" - " this.last = last; -\n" - " } -\n" - " public char getInitial() { -\n" - " return initial; -\n" - " } -\n" - " void setInitial(char initial) { -\n" - " this.initial = initial; -\n" - " } -\n" - "}]]>" -#: index.docbook:25 -msgid "Now <literal>Name</literal> may be persisted as a component of <literal>Person</literal>. Notice that <literal>Name</literal> defines getter and setter methods for its persistent properties, but doesn't need to declare any interfaces or identifier properties." -msgstr "いま、<literal>Name</literal> は <literal>Person</literal> のコンポーネントとして 永続化することが出来ます。ここで <literal>Name</literal> は永続化属性に対してgetter、 setterメソッドを定義しますが、インターフェイスや識別子プロパティを定義する必要が ないことに注意して下さい。" +#. Tag: para +#: component_mapping.xml:25 +#, no-c-format +msgid "" +"Now <literal>Name</literal> may be persisted as a component of " +"<literal>Person</literal>. Notice that <literal>Name</literal> defines " +"getter and setter methods for its persistent properties, but doesn't need to " +"declare any interfaces or identifier properties." +msgstr "" +"いま、<literal>Name</literal> は <literal>Person</literal> のコンポーネントと" +"して 永続化することが出来ます。ここで <literal>Name</literal> は永続化属性に" +"対してgetter、 setterメソッドを定義しますが、インターフェイスや識別子プロパ" +"ティを定義する必要が ないことに注意して下さい。" -#: index.docbook:32 +#. Tag: para +#: component_mapping.xml:32 +#, no-c-format msgid "Our Hibernate mapping would look like:" msgstr "マッピング定義は以下のようになります。" -#: index.docbook:36 +#. Tag: programlisting +#: component_mapping.xml:36 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\"> <!-- class attribute optional -->\n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +" <id name=\"Key\" column=\"pid\" type=\"string\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" <property name=\"birthday\" type=\"date\"/>\n" +" <component name=\"Name\" class=\"eg.Name\"> <!-- class attribute " +"optional -->\n" +" <property name=\"initial\"/>\n" +" <property name=\"first\"/>\n" +" <property name=\"last\"/>\n" +" </component>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\"> -\n" - " <id name=\"Key\" column=\"pid\" type=\"string\"> -\n" - " <generator class=\"uuid\"/> -\n" - " </id> -\n" - " <property name=\"birthday\" type=\"date\"/> -\n" - " <component name=\"Name\" class=\"eg.Name\"> <!-- class attribute optional --> -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"first\"/> -\n" - " <property name=\"last\"/> -\n" - " </component> -\n" - "</class>]]>" -#: index.docbook:38 -msgid "The person table would have the columns <literal>pid</literal>, <literal>birthday</literal>, <literal>initial</literal>, <literal>first</literal> and <literal>last</literal>." -msgstr "Personテーブルは <literal>pid</literal>、 <literal>birthday</literal>、 <literal>initial</literal>、 <literal>first</literal>、 <literal>last</literal> カラムを持ちます。" +#. Tag: para +#: component_mapping.xml:38 +#, no-c-format +msgid "" +"The person table would have the columns <literal>pid</literal>, " +"<literal>birthday</literal>, <literal>initial</literal>, <literal>first</" +"literal> and <literal>last</literal>." +msgstr "" +"Personテーブルは <literal>pid</literal>、 <literal>birthday</literal>、 " +"<literal>initial</literal>、 <literal>first</literal>、 <literal>last</" +"literal> カラムを持ちます。" -#: index.docbook:46 -msgid "Like all value types, components do not support shared references. In other words, two persons could have the same name, but the two person objects would contain two independent name ojects, only \"the same\" by value. The null value semantics of a component are <emphasis>ad hoc</emphasis>. When reloading the containing object, Hibernate will assume that if all component columns are null, then the entire component is null. This should be okay for most purposes." -msgstr "全ての値型のように、コンポーネントは参照の共有をすることができません。 言い換えると、二人のPersonは同じ名前を持つことができますが、二つのPersonオブジェクトは \"値が同じだけ\"の別々のnameオブジェクトを含んでいるということです。 コンポーネントのnull値のセマンティクスは <emphasis>アドホック</emphasis> です。 コンポーネントのオブジェクトを再読み込みする際、Hibernateはコンポーネントのすべてのカラムが nullであるならコンポーネント自体がnullであると考えます。 これは大抵の場合問題ありません。" +#. Tag: para +#: component_mapping.xml:46 +#, no-c-format +msgid "" +"Like all value types, components do not support shared references. In other " +"words, two persons could have the same name, but the two person objects " +"would contain two independent name ojects, only \"the same\" by value. The " +"null value semantics of a component are <emphasis>ad hoc</emphasis>. When " +"reloading the containing object, Hibernate will assume that if all component " +"columns are null, then the entire component is null. This should be okay for " +"most purposes." +msgstr "" +"全ての値型のように、コンポーネントは参照の共有をすることができません。 言い換" +"えると、二人のPersonは同じ名前を持つことができますが、二つのPersonオブジェク" +"トは \"値が同じだけ\"の別々のnameオブジェクトを含んでいるということです。 コ" +"ンポーネントのnull値のセマンティクスは <emphasis>アドホック</emphasis> で" +"す。 コンポーネントのオブジェクトを再読み込みする際、Hibernateはコンポーネン" +"トのすべてのカラムが nullであるならコンポーネント自体がnullであると考えま" +"す。 これは大抵の場合問題ありません。" -#: index.docbook:55 -msgid "The properties of a component may be of any Hibernate type (collections, many-to-one associations, other components, etc). Nested components should <emphasis>not</emphasis> be considered an exotic usage. Hibernate is intended to support a very fine-grained object model." -msgstr "コンポーネントの属性はどんなHibernateの型でも構いません（コレクション、many-to-one関連、 他のコンポーネントなど）。ネストされたコンポーネントは滅多に使わないと考えるべきでは <emphasis>ありません</emphasis> 。Hibernateは非常にきめの細かいオブジェクトモデルをサポートするように意図されています。" +#. Tag: para +#: component_mapping.xml:55 +#, no-c-format +msgid "" +"The properties of a component may be of any Hibernate type (collections, " +"many-to-one associations, other components, etc). Nested components should " +"<emphasis>not</emphasis> be considered an exotic usage. Hibernate is " +"intended to support a very fine-grained object model." +msgstr "" +"コンポーネントの属性はどんなHibernateの型でも構いません（コレクション、many-" +"to-one関連、 他のコンポーネントなど）。ネストされたコンポーネントは滅多に使わ" +"ないと考えるべきでは <emphasis>ありません</emphasis> 。Hibernateは非常にきめ" +"の細かいオブジェクトモデルをサポートするように意図されています。" -#: index.docbook:62 -msgid "The <literal>&lt;component&gt;</literal> element allows a <literal>&lt;parent&gt;</literal> subelement that maps a property of the component class as a reference back to the containing entity." -msgstr "<literal>&lt;component&gt;</literal> 要素は親エンティティへの逆参照として、コンポーネントクラスの 属性をマッピングする <literal>&lt;parent&gt;</literal> サブ要素を使用できます。" +#. Tag: para +#: component_mapping.xml:62 +#, no-c-format +msgid "" +"The <literal>&lt;component&gt;</literal> element allows a <literal>&lt;" +"parent&gt;</literal> subelement that maps a property of the component class " +"as a reference back to the containing entity." +msgstr "" +"<literal>&lt;component&gt;</literal> 要素は親エンティティへの逆参照として、コ" +"ンポーネントクラスの 属性をマッピングする <literal>&lt;parent&gt;</literal> " +"サブ要素を使用できます。" -#: index.docbook:68 +#. Tag: programlisting +#: component_mapping.xml:68 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" - " <id name=\"Key\" column=\"pid\" type=\"string\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " <property name=\"birthday\" type=\"date\"/>\n" - " <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" - " <parent name=\"namedPerson\"/> <!-- reference back to the Person -->\n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </component>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Person\" table=\"person\">\n" +" <id name=\"Key\" column=\"pid\" type=\"string\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" <property name=\"birthday\" type=\"date\"/>\n" +" <component name=\"Name\" class=\"eg.Name\" unique=\"true\">\n" +" <parent name=\"namedPerson\"/> <!-- reference back to the Person --" +">\n" +" <property name=\"initial\"/>\n" +" <property name=\"first\"/>\n" +" <property name=\"last\"/>\n" +" </component>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Person\" table=\"person\"> -\n" - " <id name=\"Key\" column=\"pid\" type=\"string\"> -\n" - " <generator class=\"uuid\"/> -\n" - " </id> -\n" - " <property name=\"birthday\" type=\"date\"/> -\n" - " <component name=\"Name\" class=\"eg.Name\" unique=\"true\"> -\n" - " <parent name=\"namedPerson\"/> <!-- reference back to the Person --> -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"first\"/> -\n" - " <property name=\"last\"/> -\n" - " </component> -\n" - "</class>]]>" -#: index.docbook:73 +#. Tag: title +#: component_mapping.xml:73 +#, no-c-format msgid "Collections of dependent objects" msgstr "従属するオブジェクトのコレクション" -#: index.docbook:75 -msgid "Collections of components are supported (eg. an array of type <literal>Name</literal>). Declare your component collection by replacing the <literal>&lt;element&gt;</literal> tag with a <literal>&lt;composite-element&gt;</literal> tag." -msgstr "Hibernateはコンポーネントのコレクションをサポートしています（例えば <literal>Name</literal> 型の配列）。 <literal>&lt;element&gt;</literal> タグを <literal>&lt;composite-element&gt;</literal> タグに取り替えることにより コンポーネントコレクションを宣言してください。" +#. Tag: para +#: component_mapping.xml:75 +#, no-c-format +msgid "" +"Collections of components are supported (eg. an array of type <literal>Name</" +"literal>). Declare your component collection by replacing the <literal>&lt;" +"element&gt;</literal> tag with a <literal>&lt;composite-element&gt;</" +"literal> tag." +msgstr "" +"Hibernateはコンポーネントのコレクションをサポートしています（例えば " +"<literal>Name</literal> 型の配列）。 <literal>&lt;element&gt;</literal> タグ" +"を <literal>&lt;composite-element&gt;</literal> タグに取り替えることにより コ" +"ンポーネントコレクションを宣言してください。" -#: index.docbook:82 +#. Tag: programlisting +#: component_mapping.xml:82 +#, no-c-format msgid "" - "<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\">\n" - " <key column=\"id\"/>\n" - " <composite-element class=\"eg.Name\"> <!-- class attribute required -->\n" - " <property name=\"initial\"/>\n" - " <property name=\"first\"/>\n" - " <property name=\"last\"/>\n" - " </composite-element>\n" - "</set>]]>" +"<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\">\n" +" <key column=\"id\"/>\n" +" <composite-element class=\"eg.Name\"> <!-- class attribute required -->\n" +" <property name=\"initial\"/>\n" +" <property name=\"first\"/>\n" +" <property name=\"last\"/>\n" +" </composite-element>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"someNames\" table=\"some_names\" lazy=\"true\"> -\n" - " <key column=\"id\"/> -\n" - " <composite-element class=\"eg.Name\"> <!-- class attribute required --> -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"first\"/> -\n" - " <property name=\"last\"/> -\n" - " </composite-element> -\n" - "</set>]]>" -#: index.docbook:84 -msgid "Note: if you define a <literal>Set</literal> of composite elements, it is very important to implement <literal>equals()</literal> and <literal>hashCode()</literal> correctly." -msgstr "注意: コンポジットエレメントの <literal>Set</literal> を定義したなら、 <literal>equals()</literal> と <literal>hashCode()</literal> を正しく実装することが重要です。" +#. Tag: para +#: component_mapping.xml:84 +#, no-c-format +msgid "" +"Note: if you define a <literal>Set</literal> of composite elements, it is " +"very important to implement <literal>equals()</literal> and <literal>hashCode" +"()</literal> correctly." +msgstr "" +"注意: コンポジットエレメントの <literal>Set</literal> を定義したなら、 " +"<literal>equals()</literal> と <literal>hashCode()</literal> を正しく実装する" +"ことが重要です。" -#: index.docbook:90 -msgid "Composite elements may contain components but not collections. If your composite element itself contains components, use the <literal>&lt;nested-composite-element&gt;</literal> tag. This is a pretty exotic case - a collection of components which themselves have components. By this stage you should be asking yourself if a one-to-many association is more appropriate. Try remodelling the composite element as an entity - but note that even though the Java model is the same, the relational model and persistence semantics are still slightly different." -msgstr "コンポジットエレメントはコレクションを含まず、コンポーネントを含むこともあります。 コンポジットエレメント自身がコンポーネントを含んでいる場合は <literal>&lt;nested-composite-element&gt;</literal> を 使用してください。コンポーネントのコレクション自身がコンポーネントを持つというケースはめったにありません。 この段階までに、one-to-many関連の方がより適切でないかと熟考してください。 コンポジットエレメントをエンティティとして再度モデリングしてみてください。 しかしこれはJavaのモデルとしては同じですが、リレーショナルモデルと永続動作はまだ若干異なることに注意してください。" +#. Tag: para +#: component_mapping.xml:90 +#, no-c-format +msgid "" +"Composite elements may contain components but not collections. If your " +"composite element itself contains components, use the <literal>&lt;nested-" +"composite-element&gt;</literal> tag. This is a pretty exotic case - a " +"collection of components which themselves have components. By this stage you " +"should be asking yourself if a one-to-many association is more appropriate. " +"Try remodelling the composite element as an entity - but note that even " +"though the Java model is the same, the relational model and persistence " +"semantics are still slightly different." +msgstr "" +"コンポジットエレメントはコレクションを含まず、コンポーネントを含むこともあり" +"ます。 コンポジットエレメント自身がコンポーネントを含んでいる場合は " +"<literal>&lt;nested-composite-element&gt;</literal> を 使用してください。コン" +"ポーネントのコレクション自身がコンポーネントを持つというケースはめったにあり" +"ません。 この段階までに、one-to-many関連の方がより適切でないかと熟考してくだ" +"さい。 コンポジットエレメントをエンティティとして再度モデリングしてみてくださ" +"い。 しかしこれはJavaのモデルとしては同じですが、リレーショナルモデルと永続動" +"作はまだ若干異なることに注意してください。" -#: index.docbook:102 -msgid "Please note that a composite element mapping doesn't support null-able properties if you're using a <literal>&lt;set&gt;</literal>. Hibernate has to use each columns value to identify a record when deleting objects (there is no separate primary key column in the composite element table), which is not possible with null values. You have to either use only not-null properties in a composite-element or choose a <literal>&lt;list&gt;</literal>, <literal>&lt;map&gt;</literal>, <literal>&lt;bag&gt;</literal> or <literal>&lt;idbag&gt;</literal>." -msgstr "もし <literal>&lt;set&gt;</literal> を使用するのであれば、コンポジットエレメントのマッピングがnull値が可能な 属性をサポートしていないことに注意してください。Hibernateはオブジェクトを削除するとき、 レコードを識別するためにそれぞれのカラムの値を使用する必要があるため、null値を持つことが出来ません （コンポジットエレメントテーブルには別の主キーカラムはありません）。 コンポジットエレメントにnot-nullの属性のみを使用するか、または <literal>&lt;list&gt;</literal>、<literal>&lt;map&gt;</literal>、 <literal>&lt;bag&gt;</literal>、<literal>&lt;idbag&gt;</literal> を選択する必要があります。" +#. Tag: para +#: component_mapping.xml:102 +#, no-c-format +msgid "" +"Please note that a composite element mapping doesn't support null-able " +"properties if you're using a <literal>&lt;set&gt;</literal>. Hibernate has " +"to use each columns value to identify a record when deleting objects (there " +"is no separate primary key column in the composite element table), which is " +"not possible with null values. You have to either use only not-null " +"properties in a composite-element or choose a <literal>&lt;list&gt;</" +"literal>, <literal>&lt;map&gt;</literal>, <literal>&lt;bag&gt;</literal> or " +"<literal>&lt;idbag&gt;</literal>." +msgstr "" +"もし <literal>&lt;set&gt;</literal> を使用するのであれば、コンポジットエレメ" +"ントのマッピングがnull値が可能な 属性をサポートしていないことに注意してくださ" +"い。Hibernateはオブジェクトを削除するとき、 レコードを識別するためにそれぞれ" +"のカラムの値を使用する必要があるため、null値を持つことが出来ません （コンポ" +"ジットエレメントテーブルには別の主キーカラムはありません）。 コンポジットエレ" +"メントにnot-nullの属性のみを使用するか、または <literal>&lt;list&gt;</" +"literal>、<literal>&lt;map&gt;</literal>、 <literal>&lt;bag&gt;</literal>、" +"<literal>&lt;idbag&gt;</literal> を選択する必要があります。" -#: index.docbook:113 -msgid "A special case of a composite element is a composite element with a nested <literal>&lt;many-to-one&gt;</literal> element. A mapping like this allows you to map extra columns of a many-to-many association table to the composite element class. The following is a many-to-many association from <literal>Order</literal> to <literal>Item</literal> where <literal>purchaseDate</literal>, <literal>price</literal> and <literal>quantity</literal> are properties of the association:" -msgstr "コンポジットエレメントの特別なケースとして、ネストされた <literal>&lt;many-to-one&gt;</literal> 属性を持つ コンポジットエレメントがあります。 このマッピングは、コンポジットエレメントクラスを多対多関連テーブルの 余分なカラムへマッピングします。 次の例は <literal>Order</literal> から、<literal>Item</literal> への多対多関連です。 <literal>purchaseDate</literal>、<literal>price</literal>、<literal>quantity</literal> は関連の属性となります。" +#. Tag: para +#: component_mapping.xml:113 +#, no-c-format +msgid "" +"A special case of a composite element is a composite element with a nested " +"<literal>&lt;many-to-one&gt;</literal> element. A mapping like this allows " +"you to map extra columns of a many-to-many association table to the " +"composite element class. The following is a many-to-many association from " +"<literal>Order</literal> to <literal>Item</literal> where " +"<literal>purchaseDate</literal>, <literal>price</literal> and " +"<literal>quantity</literal> are properties of the association:" +msgstr "" +"コンポジットエレメントの特別なケースとして、ネストされた <literal>&lt;many-" +"to-one&gt;</literal> 属性を持つ コンポジットエレメントがあります。 このマッピ" +"ングは、コンポジットエレメントクラスを多対多関連テーブルの 余分なカラムへマッ" +"ピングします。 次の例は <literal>Order</literal> から、<literal>Item</" +"literal> への多対多関連です。 <literal>purchaseDate</literal>、" +"<literal>price</literal>、<literal>quantity</literal> は関連の属性となりま" +"す。" -#: index.docbook:123 +#. Tag: programlisting +#: component_mapping.xml:123 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.Purchase\">\n" - " <property name=\"purchaseDate\"/>\n" - " <property name=\"price\"/>\n" - " <property name=\"quantity\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/> <!-- class attribute is optional -->\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Order\" .... >\n" +" ....\n" +" <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +" <key column=\"order_id\">\n" +" <composite-element class=\"eg.Purchase\">\n" +" <property name=\"purchaseDate\"/>\n" +" <property name=\"price\"/>\n" +" <property name=\"quantity\"/>\n" +" <many-to-one name=\"item\" class=\"eg.Item\"/> <!-- class " +"attribute is optional -->\n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Order\" .... > -\n" - " .... -\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\"> -\n" - " <key column=\"order_id\"> -\n" - " <composite-element class=\"eg.Purchase\"> -\n" - " <property name=\"purchaseDate\"/> -\n" - " <property name=\"price\"/> -\n" - " <property name=\"quantity\"/> -\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/> <!-- class attribute is optional --> -\n" - " </composite-element> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:125 -msgid "Of course, there can't be a reference to the purchae on the other side, for bidirectional association navigation. Remember that components are value types and don't allow shared references. A single <literal>Purchase</literal> can be in the set of an <literal>Order</literal>, but it can't be referenced by the <literal>Item</literal> at the same time." -msgstr "もちろん、双方向関連のナビゲーションのために反対側からpurchaseへの参照を作ることは出来ません。 コンポーネントは値型であり、参照を共有できないことを覚えておいてください。 一つの <literal>Purchase</literal> は一つの <literal>Order</literal> のsetに存在できますが、 同時に <literal>Item</literal> から参照することは出来ません。" +#. Tag: para +#: component_mapping.xml:125 +#, no-c-format +msgid "" +"Of course, there can't be a reference to the purchae on the other side, for " +"bidirectional association navigation. Remember that components are value " +"types and don't allow shared references. A single <literal>Purchase</" +"literal> can be in the set of an <literal>Order</literal>, but it can't be " +"referenced by the <literal>Item</literal> at the same time." +msgstr "" +"もちろん、双方向関連のナビゲーションのために反対側からpurchaseへの参照を作る" +"ことは出来ません。 コンポーネントは値型であり、参照を共有できないことを覚えて" +"おいてください。 一つの <literal>Purchase</literal> は一つの <literal>Order</" +"literal> のsetに存在できますが、 同時に <literal>Item</literal> から参照する" +"ことは出来ません。" -#: index.docbook:133 +#. Tag: para +#: component_mapping.xml:133 +#, no-c-format msgid "Even ternary (or quaternary, etc) associations are possible:" msgstr "3項関連（あるいは4項など）も可能です。" -#: index.docbook:135 +#. Tag: programlisting +#: component_mapping.xml:135 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Order\" .... >\n" - " ....\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" - " <key column=\"order_id\">\n" - " <composite-element class=\"eg.OrderLine\">\n" - " <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/>\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"eg.Order\" .... >\n" +" ....\n" +" <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\">\n" +" <key column=\"order_id\">\n" +" <composite-element class=\"eg.OrderLine\">\n" +" <many-to-one name=\"purchaseDetails class=\"eg.Purchase\"/>\n" +" <many-to-one name=\"item\" class=\"eg.Item\"/>\n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Order\" .... > -\n" - " .... -\n" - " <set name=\"purchasedItems\" table=\"purchase_items\" lazy=\"true\"> -\n" - " <key column=\"order_id\"> -\n" - " <composite-element class=\"eg.OrderLine\"> -\n" - " <many-to-one name=\"purchaseDetails\" class=\"eg.Purchase\"/> -\n" - " <many-to-one name=\"item\" class=\"eg.Item\"/> -\n" - " </composite-element> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:137 -msgid "Composite elements may appear in queries using the same syntax as associations to other entities." -msgstr "コンポジットエレメントは他のエンティティへの関連として、 同じシンタックスを使っているクエリ内で使用できます。" +#. Tag: para +#: component_mapping.xml:137 +#, no-c-format +msgid "" +"Composite elements may appear in queries using the same syntax as " +"associations to other entities." +msgstr "" +"コンポジットエレメントは他のエンティティへの関連として、 同じシンタックスを" +"使っているクエリ内で使用できます。" -#: index.docbook:145 +#. Tag: title +#: component_mapping.xml:145 +#, no-c-format msgid "Components as Map indices" msgstr "Mapのインデックスとしてのコンポーネント" -#: index.docbook:147 -msgid "The <literal>&lt;composite-map-key&gt;</literal> element lets you map a component class as the key of a <literal>Map</literal>. Make sure you override <literal>hashCode()</literal> and <literal>equals()</literal> correctly on the component class." -msgstr "<literal>&lt;composite-map-key&gt;</literal> 要素は <literal>Map</literal> のキーとしてコンポーネントクラスを マッピングします。コンポーネントクラス上で <literal>hashCode()</literal> と <literal>equals()</literal> を正確にオーバーライドしてください。" +#. Tag: para +#: component_mapping.xml:147 +#, no-c-format +msgid "" +"The <literal>&lt;composite-map-key&gt;</literal> element lets you map a " +"component class as the key of a <literal>Map</literal>. Make sure you " +"override <literal>hashCode()</literal> and <literal>equals()</literal> " +"correctly on the component class." +msgstr "" +"<literal>&lt;composite-map-key&gt;</literal> 要素は <literal>Map</literal> の" +"キーとしてコンポーネントクラスを マッピングします。コンポーネントクラス上で " +"<literal>hashCode()</literal> と <literal>equals()</literal> を正確にオーバー" +"ライドしてください。" -#: index.docbook:156 +#. Tag: title +#: component_mapping.xml:156 +#, no-c-format msgid "Components as composite identifiers" msgstr "複合識別子としてのコンポーネント" -#: index.docbook:158 -msgid "You may use a component as an identifier of an entity class. Your component class must satisfy certain requirements:" -msgstr "コンポーネントをエンティティクラスの識別子として使うことができます。 コンポーネントクラスは以下の条件を満たす必要があります。" +#. Tag: para +#: component_mapping.xml:158 +#, no-c-format +msgid "" +"You may use a component as an identifier of an entity class. Your component " +"class must satisfy certain requirements:" +msgstr "" +"コンポーネントをエンティティクラスの識別子として使うことができます。 コンポー" +"ネントクラスは以下の条件を満たす必要があります。" -#: index.docbook:165 +#. Tag: para +#: component_mapping.xml:165 +#, no-c-format msgid "It must implement <literal>java.io.Serializable</literal>." msgstr "<literal>java.io.Serializable</literal> を実装しなければなりません。" -#: index.docbook:170 -msgid "It must re-implement <literal>equals()</literal> and <literal>hashCode()</literal>, consistently with the database's notion of composite key equality." -msgstr "データベース上の複合キーの等価性と矛盾のないように、<literal>equals()</literal> と <literal>hashCode()</literal> を再実装しなければなりません。" +#. Tag: para +#: component_mapping.xml:170 +#, no-c-format +msgid "" +"It must re-implement <literal>equals()</literal> and <literal>hashCode()</" +"literal>, consistently with the database's notion of composite key equality." +msgstr "" +"データベース上の複合キーの等価性と矛盾のないように、<literal>equals()</" +"literal> と <literal>hashCode()</literal> を再実装しなければなりません。" -#: index.docbook:179 -msgid "Note: in Hibernate3, the second requirement is not an absolutely hard requirement of Hibernate. But do it anyway." -msgstr "注意: Hibernate3において、2番目の条件は絶対的な条件ではありません。 しかしとにかく条件を満たしてください。" +#. Tag: emphasis +#: component_mapping.xml:179 +#, no-c-format +msgid "" +"Note: in Hibernate3, the second requirement is not an absolutely hard " +"requirement of Hibernate. But do it anyway." +msgstr "" +"注意: Hibernate3において、2番目の条件は絶対的な条件ではありません。 しかしと" +"にかく条件を満たしてください。" -#: index.docbook:183 -msgid "You can't use an <literal>IdentifierGenerator</literal> to generate composite keys. Instead the application must assign its own identifiers." -msgstr "複合キーを生成するために <literal>IdentifierGenerator</literal> を使用することはできません。 代わりにアプリケーションが識別子を割り当てなくてはなりません。" +#. Tag: para +#: component_mapping.xml:183 +#, no-c-format +msgid "" +"You can't use an <literal>IdentifierGenerator</literal> to generate " +"composite keys. Instead the application must assign its own identifiers." +msgstr "" +"複合キーを生成するために <literal>IdentifierGenerator</literal> を使用するこ" +"とはできません。 代わりにアプリケーションが識別子を割り当てなくてはなりませ" +"ん。" -#: index.docbook:188 -msgid "Use the <literal>&lt;composite-id&gt;</literal> tag (with nested <literal>&lt;key-property&gt;</literal> elements) in place of the usual <literal>&lt;id&gt;</literal> declaration. For example, the <literal>OrderLine</literal> class has a primary key that depends upon the (composite) primary key of <literal>Order</literal>." -msgstr "通常の <literal>&lt;id&gt;</literal> 宣言の代わりに <literal>&lt;composite-id&gt;</literal> タグを （ネストされた <literal>&lt;key-property&gt;</literal> 属性と共に）使います。 以下の例では、<literal>OrderLine</literal> クラスは <literal>Order</literal> の（複合）主キーに 依存した主キーを持っています。" +#. Tag: para +#: component_mapping.xml:188 +#, no-c-format +msgid "" +"Use the <literal>&lt;composite-id&gt;</literal> tag (with nested " +"<literal>&lt;key-property&gt;</literal> elements) in place of the usual " +"<literal>&lt;id&gt;</literal> declaration. For example, the " +"<literal>OrderLine</literal> class has a primary key that depends upon the " +"(composite) primary key of <literal>Order</literal>." +msgstr "" +"通常の <literal>&lt;id&gt;</literal> 宣言の代わりに <literal>&lt;composite-" +"id&gt;</literal> タグを （ネストされた <literal>&lt;key-property&gt;</" +"literal> 属性と共に）使います。 以下の例では、<literal>OrderLine</literal> ク" +"ラスは <literal>Order</literal> の（複合）主キーに 依存した主キーを持っていま" +"す。" -#: index.docbook:196 +#. Tag: programlisting +#: component_mapping.xml:196 +#, no-c-format msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " \n" - " <composite-id name=\"id\" class=\"OrderLineId\">\n" - " <key-property name=\"lineId\"/>\n" - " <key-property name=\"orderId\"/>\n" - " <key-property name=\"customerId\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"name\"/>\n" - " \n" - " <many-to-one name=\"order\" class=\"Order\"\n" - " insert=\"false\" update=\"false\">\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-one>\n" - " ....\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"OrderLine\">\n" +" \n" +" <composite-id name=\"id\" class=\"OrderLineId\">\n" +" <key-property name=\"lineId\"/>\n" +" <key-property name=\"orderId\"/>\n" +" <key-property name=\"customerId\"/>\n" +" </composite-id>\n" +" \n" +" <property name=\"name\"/>\n" +" \n" +" <many-to-one name=\"order\" class=\"Order\"\n" +" insert=\"false\" update=\"false\">\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </many-to-one>\n" +" ....\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"OrderLine\"> -\n" - " -\n" - " <composite-id name=\"id\" class=\"OrderLineId\"> -\n" - " <key-property name=\"lineId\"/> -\n" - " <key-property name=\"orderId\"/> -\n" - " <key-property name=\"customerId\"/> -\n" - " </composite-id> -\n" - " -\n" - " <property name=\"name\"/> -\n" - " -\n" - " <many-to-one name=\"order\" class=\"Order\" -\n" - " insert=\"false\" update=\"false\"> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </many-to-one> -\n" - " .... -\n" - " -\n" - "</class>]]>" -#: index.docbook:198 -msgid "Now, any foreign keys referencing the <literal>OrderLine</literal> table are also composite. You must declare this in your mappings for other classes. An association to <literal>OrderLine</literal> would be mapped like this:" -msgstr "このとき、<literal>OrderLine</literal> テーブルへ関連する外部キーもまた複合です。 他のクラスのマッピングでこれを宣言しなければなりません。 <literal>OrderLine</literal> への関連は次のようにマッピングされます。" +#. Tag: para +#: component_mapping.xml:198 +#, no-c-format +msgid "" +"Now, any foreign keys referencing the <literal>OrderLine</literal> table are " +"also composite. You must declare this in your mappings for other classes. An " +"association to <literal>OrderLine</literal> would be mapped like this:" +msgstr "" +"このとき、<literal>OrderLine</literal> テーブルへ関連する外部キーもまた複合で" +"す。 他のクラスのマッピングでこれを宣言しなければなりません。 " +"<literal>OrderLine</literal> への関連は次のようにマッピングされます。" -#: index.docbook:204 +#. Tag: programlisting +#: component_mapping.xml:204 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" - "<!-- the \"class\" attribute is optional, as usual -->\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - "</many-to-one>]]>" +"<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\">\n" +"<!-- the \"class\" attribute is optional, as usual -->\n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +"</many-to-one>]]>" msgstr "" - "<![CDATA[<many-to-one name=\"orderLine\" class=\"OrderLine\"> -\n" - "<!-- the \"class\" attribute is optional, as usual --> -\n" - " <column name=\"lineId\"/> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - "</many-to-one>]]>" -#: index.docbook:206 -msgid "(Note that the <literal>&lt;column&gt;</literal> tag is an alternative to the <literal>column</literal> attribute everywhere.)" -msgstr "（<literal>&lt;column&gt;</literal> タグはどこであっても <literal>column</literal> 属性の 代わりになります。）" +#. Tag: para +#: component_mapping.xml:206 +#, no-c-format +msgid "" +"(Note that the <literal>&lt;column&gt;</literal> tag is an alternative to " +"the <literal>column</literal> attribute everywhere.)" +msgstr "" +"（<literal>&lt;column&gt;</literal> タグはどこであっても <literal>column</" +"literal> 属性の 代わりになります。）" -#: index.docbook:211 -msgid "A <literal>many-to-many</literal> association to <literal>OrderLine</literal> also uses the composite foreign key:" -msgstr "<literal>OrderLine</literal> への <literal>many-to-many</literal> 関連も 複合外部キーを使います。" +#. Tag: para +#: component_mapping.xml:211 +#, no-c-format +msgid "" +"A <literal>many-to-many</literal> association to <literal>OrderLine</" +"literal> also uses the composite foreign key:" +msgstr "" +"<literal>OrderLine</literal> への <literal>many-to-many</literal> 関連も 複合" +"外部キーを使います。" -#: index.docbook:216 +#. Tag: programlisting +#: component_mapping.xml:216 +#, no-c-format msgid "" - "<![CDATA[<set name=\"undeliveredOrderLines\">\n" - " <key column name=\"warehouseId\"/>\n" - " <many-to-many class=\"OrderLine\">\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </many-to-many>\n" - "</set>]]>" +"<![CDATA[<set name=\"undeliveredOrderLines\">\n" +" <key column name=\"warehouseId\"/>\n" +" <many-to-many class=\"OrderLine\">\n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </many-to-many>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"undeliveredOrderLines\"> -\n" - " <key column name=\"warehouseId\"/> -\n" - " <many-to-many class=\"OrderLine\"> -\n" - " <column name=\"lineId\"/> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </many-to-many> -\n" - "</set>]]>" -#: index.docbook:218 -msgid "The collection of <literal>OrderLine</literal>s in <literal>Order</literal> would use:" -msgstr "<literal>Order</literal> にある <literal>OrderLine</literal> のコレクションは 次のものを使用します。" +#. Tag: para +#: component_mapping.xml:218 +#, no-c-format +msgid "" +"The collection of <literal>OrderLine</literal>s in <literal>Order</literal> " +"would use:" +msgstr "" +"<literal>Order</literal> にある <literal>OrderLine</literal> のコレクション" +"は 次のものを使用します。" -#: index.docbook:223 +#. Tag: programlisting +#: component_mapping.xml:223 +#, no-c-format msgid "" - "<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" - " <key>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <one-to-many class=\"OrderLine\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"orderLines\" inverse=\"true\">\n" +" <key>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </key>\n" +" <one-to-many class=\"OrderLine\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"orderLines\" inverse=\"true\"> -\n" - " <key> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </key> -\n" - " <one-to-many class=\"OrderLine\"/> -\n" - "</set>]]>" -#: index.docbook:225 -msgid "(The <literal>&lt;one-to-many&gt;</literal> element, as usual, declares no columns.)" -msgstr "（<literal>&lt;one-to-many&gt;</literal> 属性は、例によってカラムを宣言しません）" +#. Tag: para +#: component_mapping.xml:225 +#, no-c-format +msgid "" +"(The <literal>&lt;one-to-many&gt;</literal> element, as usual, declares no " +"columns.)" +msgstr "" +"（<literal>&lt;one-to-many&gt;</literal> 属性は、例によってカラムを宣言しませ" +"ん）" -#: index.docbook:229 -msgid "If <literal>OrderLine</literal> itself owns a collection, it also has a composite foreign key." -msgstr "<literal>OrderLine</literal> 自身がコレクションを持っている場合、 同時に複合外部キーも持っています。" +#. Tag: para +#: component_mapping.xml:229 +#, no-c-format +msgid "" +"If <literal>OrderLine</literal> itself owns a collection, it also has a " +"composite foreign key." +msgstr "" +"<literal>OrderLine</literal> 自身がコレクションを持っている場合、 同時に複合" +"外部キーも持っています。" -#: index.docbook:234 +#. Tag: programlisting +#: component_mapping.xml:234 +#, no-c-format msgid "" - "<![CDATA[<class name=\"OrderLine\">\n" - " ....\n" - " ....\n" - " <list name=\"deliveryAttempts\">\n" - " <key> <!-- a collection inherits the composite key type -->\n" - " <column name=\"lineId\"/>\n" - " <column name=\"orderId\"/>\n" - " <column name=\"customerId\"/>\n" - " </key>\n" - " <list-index column=\"attemptId\" base=\"1\"/>\n" - " <composite-element class=\"DeliveryAttempt\">\n" - " ...\n" - " </composite-element>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"OrderLine\">\n" +" ....\n" +" ....\n" +" <list name=\"deliveryAttempts\">\n" +" <key> <!-- a collection inherits the composite key type -->\n" +" <column name=\"lineId\"/>\n" +" <column name=\"orderId\"/>\n" +" <column name=\"customerId\"/>\n" +" </key>\n" +" <list-index column=\"attemptId\" base=\"1\"/>\n" +" <composite-element class=\"DeliveryAttempt\">\n" +" ...\n" +" </composite-element>\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"OrderLine\"> -\n" - " .... -\n" - " .... -\n" - " <list name=\"deliveryAttempts\"> -\n" - " <key> <!-- a collection inherits the composite key type --> -\n" - " <column name=\"lineId\"/> -\n" - " <column name=\"orderId\"/> -\n" - " <column name=\"customerId\"/> -\n" - " </key> -\n" - " <list-index column=\"attemptId\" base=\"1\"/> -\n" - " <composite-element class=\"DeliveryAttempt\"> -\n" - " ... -\n" - " </composite-element> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:239 +#. Tag: title +#: component_mapping.xml:239 +#, no-c-format msgid "Dynamic components" msgstr "動的コンポーネント" -#: index.docbook:241 +#. Tag: para +#: component_mapping.xml:241 +#, no-c-format msgid "You may even map a property of type <literal>Map</literal>:" msgstr "<literal>Map</literal> 型のプロパティのマッピングも可能です。" -#: index.docbook:245 +#. Tag: programlisting +#: component_mapping.xml:245 +#, no-c-format msgid "" - "<![CDATA[<dynamic-component name=\"userAttributes\">\n" - " <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" - " <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" - " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" - "</dynamic-component>]]>" +"<![CDATA[<dynamic-component name=\"userAttributes\">\n" +" <property name=\"foo\" column=\"FOO\" type=\"string\"/>\n" +" <property name=\"bar\" column=\"BAR\" type=\"integer\"/>\n" +" <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/>\n" +"</dynamic-component>]]>" msgstr "" - "<![CDATA[<dynamic-component name=\"userAttributes\"> -\n" - " <property name=\"foo\" column=\"FOO\" type=\"string\"/> -\n" - " <property name=\"bar\" column=\"BAR\" type=\"integer\"/> -\n" - " <many-to-one name=\"baz\" class=\"Baz\" column=\"BAZ_ID\"/> -\n" - "</dynamic-component>]]>" -#: index.docbook:247 -msgid "The semantics of a <literal>&lt;dynamic-component&gt;</literal> mapping are identical to <literal>&lt;component&gt;</literal>. The advantage of this kind of mapping is the ability to determine the actual properties of the bean at deployment time, just by editing the mapping document. Runtime manipulation of the mapping document is also possible, using a DOM parser. Even better, you can access (and change) Hibernate's configuration-time metamodel via the <literal>Configuration</literal> object." -msgstr "<literal>&lt;dynamic-component&gt;</literal> マッピングのセマンティクスは <literal>&lt;component&gt;</literal> と同一のものです。この種のマッピングの利点は、マッピングドキュメントの編集により、配置時にbeanの属性を 決定できる点です。また、DOMパーサを利用して、マッピングドキュメントのランタイム操作が可能です。 さらに、<literal>Configuration</literal> オブジェクト経由でHibernateのコンフィグレーション時のメタモデルに アクセス（または変更）が可能です。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: component_mapping.xml:247 +#, no-c-format +msgid "" +"The semantics of a <literal>&lt;dynamic-component&gt;</literal> mapping are " +"identical to <literal>&lt;component&gt;</literal>. The advantage of this " +"kind of mapping is the ability to determine the actual properties of the " +"bean at deployment time, just by editing the mapping document. Runtime " +"manipulation of the mapping document is also possible, using a DOM parser. " +"Even better, you can access (and change) Hibernate's configuration-time " +"metamodel via the <literal>Configuration</literal> object." +msgstr "" +"<literal>&lt;dynamic-component&gt;</literal> マッピングのセマンティクスは " +"<literal>&lt;component&gt;</literal> と同一のものです。この種のマッピングの利" +"点は、マッピングドキュメントの編集により、配置時にbeanの属性を 決定できる点で" +"す。また、DOMパーサを利用して、マッピングドキュメントのランタイム操作が可能で" +"す。 さらに、<literal>Configuration</literal> オブジェクト経由でHibernateのコ" +"ンフィグレーション時のメタモデルに アクセス（または変更）が可能です。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/configuration.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/configuration.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/configuration.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1599 +1,3233 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: configuration.xml:5 +#, no-c-format msgid "Configuration" -msgstr "<title>設定</title>" +msgstr "設定" -#: index.docbook:7 -msgid "Because Hibernate is designed to operate in many different environments, there are a large number of configuration parameters. Fortunately, most have sensible default values and Hibernate is distributed with an example <literal>hibernate.properties</literal> file in <literal>etc/</literal> that shows the various options. Just put the example file in your classpath and customize it." -msgstr "Hibernateはさまざまな環境で動作するようにデザインされているため、非常に多くの設定要素があります。 幸いなことに、Hibernateは、公開されているパッケージの <literal>etc/</literal> フォルダの <literal>hibernate.properties</literal> に、ほとんどの設定要素の適切なデフォルト値が記述されています。 この <literal>hibernate.properties</literal> をクラスパスに設定し、設定要素をカスタマイズするだけです。" +#. Tag: para +#: configuration.xml:7 +#, no-c-format +msgid "" +"Because Hibernate is designed to operate in many different environments, " +"there are a large number of configuration parameters. Fortunately, most have " +"sensible default values and Hibernate is distributed with an example " +"<literal>hibernate.properties</literal> file in <literal>etc/</literal> that " +"shows the various options. Just put the example file in your classpath and " +"customize it." +msgstr "" +"Hibernateはさまざまな環境で動作するようにデザインされているため、非常に多くの" +"設定要素があります。 幸いなことに、Hibernateは、公開されているパッケージの " +"<literal>etc/</literal> フォルダの <literal>hibernate.properties</literal> " +"に、ほとんどの設定要素の適切なデフォルト値が記述されています。 この " +"<literal>hibernate.properties</literal> をクラスパスに設定し、設定要素をカス" +"タマイズするだけです。" -#: index.docbook:16 +#. Tag: title +#: configuration.xml:16 +#, no-c-format msgid "Programmatic configuration" msgstr "プログラム上の設定" -#: index.docbook:18 -msgid "An instance of <literal>org.hibernate.cfg.Configuration</literal> represents an entire set of mappings of an application's Java types to an SQL database. The <literal>Configuration</literal> is used to build an (immutable) <literal>SessionFactory</literal>. The mappings are compiled from various XML mapping files." -msgstr "<literal>org.hibernate.cfg.Configuration</literal> のインスタンスは、 Javaの型とSQLデータベースのマッピング情報をすべて持っています。 The <literal>Configuration</literal> は、（不変の） <literal>SessionFactory</literal> を生成するときに使用します。 複数のXMLマッピングファイルを変換し、マッピング情報にします。" +#. Tag: para +#: configuration.xml:18 +#, no-c-format +msgid "" +"An instance of <literal>org.hibernate.cfg.Configuration</literal> represents " +"an entire set of mappings of an application's Java types to an SQL database. " +"The <literal>Configuration</literal> is used to build an (immutable) " +"<literal>SessionFactory</literal>. The mappings are compiled from various " +"XML mapping files." +msgstr "" +"<literal>org.hibernate.cfg.Configuration</literal> のインスタンスは、 Javaの" +"型とSQLデータベースのマッピング情報をすべて持っています。 The " +"<literal>Configuration</literal> は、（不変の） <literal>SessionFactory</" +"literal> を生成するときに使用します。 複数のXMLマッピングファイルを変換し、" +"マッピング情報にします。" -#: index.docbook:26 -msgid "You may obtain a <literal>Configuration</literal> instance by instantiating it directly and specifying XML mapping documents. If the mapping files are in the classpath, use <literal>addResource()</literal>:" -msgstr "通常、<literal>Configuration</literal> インスタンスは、特定のXMLマッピングファイル によって直接初期化されます。もし、マッピングファイルがクラスパスに設定されている場合、 次のメソッドを使ってください。 <literal>addResource()</literal> :" +#. Tag: para +#: configuration.xml:26 +#, no-c-format +msgid "" +"You may obtain a <literal>Configuration</literal> instance by instantiating " +"it directly and specifying XML mapping documents. If the mapping files are " +"in the classpath, use <literal>addResource()</literal>:" +msgstr "" +"通常、<literal>Configuration</literal> インスタンスは、特定のXMLマッピング" +"ファイル によって直接初期化されます。もし、マッピングファイルがクラスパスに設" +"定されている場合、 次のメソッドを使ってください。 <literal>addResource()</" +"literal> :" -#: index.docbook:32 +#. Tag: programlisting +#: configuration.xml:32 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addResource(\"Item.hbm.xml\")\n" - " .addResource(\"Bid.hbm.xml\");]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addResource(\"Item.hbm.xml\")\n" +" .addResource(\"Bid.hbm.xml\");]]>" msgstr "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addResource(\"Item.hbm.xml\")\n" - " .addResource(\"Bid.hbm.xml\");]]>" -#: index.docbook:34 -msgid "An alternative (sometimes better) way is to specify the mapped class, and let Hibernate find the mapping document for you:" -msgstr "代替案(こちらのほうが良いときもあります)としてマッピングクラスを指定する方法もあります。Hibernateに、マッピングファイルを 見つけさせてください：" +#. Tag: para +#: configuration.xml:34 +#, no-c-format +msgid "" +"An alternative (sometimes better) way is to specify the mapped class, and " +"let Hibernate find the mapping document for you:" +msgstr "" +"代替案(こちらのほうが良いときもあります)としてマッピングクラスを指定する方法" +"もあります。Hibernateに、マッピングファイルを 見つけさせてください：" -#: index.docbook:39 +#. Tag: programlisting +#: configuration.xml:39 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class);]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addClass(org.hibernate.auction.Item.class)\n" +" .addClass(org.hibernate.auction.Bid.class);]]>" msgstr "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class);]]>" -#: index.docbook:41 -msgid "Then Hibernate will look for mapping files named <literal>/org/hibernate/auction/Item.hbm.xml</literal> and <literal>/org/hibernate/auction/Bid.hbm.xml</literal> in the classpath. This approach eliminates any hardcoded filenames." -msgstr "Hibernateは、クラスパスにある以下のような名前のマッピングファイルを見つけます。 <literal>/org/hibernate/auction/Item.hbm.xml</literal> 、 <literal>/org/hibernate/auction/Bid.hbm.xml</literal> 。 この方法だと、ハードコーディングされたファイル名を排除できます。" +#. Tag: para +#: configuration.xml:41 +#, no-c-format +msgid "" +"Then Hibernate will look for mapping files named <literal>/org/hibernate/" +"auction/Item.hbm.xml</literal> and <literal>/org/hibernate/auction/Bid.hbm." +"xml</literal> in the classpath. This approach eliminates any hardcoded " +"filenames." +msgstr "" +"Hibernateは、クラスパスにある以下のような名前のマッピングファイルを見つけま" +"す。 <literal>/org/hibernate/auction/Item.hbm.xml</literal> 、 <literal>/org/" +"hibernate/auction/Bid.hbm.xml</literal> 。 この方法だと、ハードコーディングさ" +"れたファイル名を排除できます。" -#: index.docbook:48 -msgid "A <literal>Configuration</literal> also allows you to specify configuration properties:" -msgstr "<literal>Configuration</literal> は、設定プロパティを指定することもできます：" +#. Tag: para +#: configuration.xml:48 +#, no-c-format +msgid "" +"A <literal>Configuration</literal> also allows you to specify configuration " +"properties:" +msgstr "" +"<literal>Configuration</literal> は、設定プロパティを指定することもできます：" -#: index.docbook:53 +#. Tag: programlisting +#: configuration.xml:53 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class)\n" - " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect.MySQLInnoDBDialect\")\n" - " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/test\")\n" - " .setProperty(\"hibernate.order_updates\", \"true\");]]>" +"<![CDATA[Configuration cfg = new Configuration()\n" +" .addClass(org.hibernate.auction.Item.class)\n" +" .addClass(org.hibernate.auction.Bid.class)\n" +" .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect." +"MySQLInnoDBDialect\")\n" +" .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/" +"test\")\n" +" .setProperty(\"hibernate.order_updates\", \"true\");]]>" msgstr "" - "<![CDATA[Configuration cfg = new Configuration()\n" - " .addClass(org.hibernate.auction.Item.class)\n" - " .addClass(org.hibernate.auction.Bid.class)\n" - " .setProperty(\"hibernate.dialect\", \"org.hibernate.dialect.MySQLInnoDBDialect\")\n" - " .setProperty(\"hibernate.connection.datasource\", \"java:comp/env/jdbc/test\")\n" - " .setProperty(\"hibernate.order_updates\", \"true\");]]>" -#: index.docbook:55 -msgid "This is not the only way to pass configuration properties to Hibernate. The various options include:" -msgstr "Hibernateに設定プロパティを通す方法は1つではありません。 さまざまなオプションを用意しています：" +#. Tag: para +#: configuration.xml:55 +#, no-c-format +msgid "" +"This is not the only way to pass configuration properties to Hibernate. The " +"various options include:" +msgstr "" +"Hibernateに設定プロパティを通す方法は1つではありません。 さまざまなオプション" +"を用意しています：" -#: index.docbook:62 -msgid "Pass an instance of <literal>java.util.Properties</literal> to <literal>Configuration.setProperties()</literal>." -msgstr "<literal>java.util.Properties</literal> インスタンスを <literal>Configuration.setProperties()</literal> に渡します。" +#. Tag: para +#: configuration.xml:62 +#, no-c-format +msgid "" +"Pass an instance of <literal>java.util.Properties</literal> to " +"<literal>Configuration.setProperties()</literal>." +msgstr "" +"<literal>java.util.Properties</literal> インスタンスを " +"<literal>Configuration.setProperties()</literal> に渡します。" -#: index.docbook:68 -msgid "Place <literal>hibernate.properties</literal> in a root directory of the classpath." -msgstr "<literal>hibernate.properties</literal> を クラスパスのルートディレクトリに置きます。" +#. Tag: para +#: configuration.xml:68 +#, no-c-format +msgid "" +"Place <literal>hibernate.properties</literal> in a root directory of the " +"classpath." +msgstr "" +"<literal>hibernate.properties</literal> を クラスパスのルートディレクトリに置" +"きます。" -#: index.docbook:74 -msgid "Set <literal>System</literal> properties using <literal>java -Dproperty=value</literal>." -msgstr "<literal>System</literal> プロパティが <literal>java -Dproperty=value</literal> を使うように設定します。" +#. Tag: para +#: configuration.xml:74 +#, no-c-format +msgid "" +"Set <literal>System</literal> properties using <literal>java -" +"Dproperty=value</literal>." +msgstr "" +"<literal>System</literal> プロパティが <literal>java -Dproperty=value</" +"literal> を使うように設定します。" -#: index.docbook:80 -msgid "Include <literal>&lt;property&gt;</literal> elements in <literal>hibernate.cfg.xml</literal> (discussed later)." -msgstr "<literal>&lt;property&gt;</literal> 要素を <literal>hibernate.cfg.xml</literal> （後述）に設定します。" +#. Tag: para +#: configuration.xml:80 +#, no-c-format +msgid "" +"Include <literal>&lt;property&gt;</literal> elements in <literal>hibernate." +"cfg.xml</literal> (discussed later)." +msgstr "" +"<literal>&lt;property&gt;</literal> 要素を <literal>hibernate.cfg.xml</" +"literal> （後述）に設定します。" -#: index.docbook:87 -msgid "<literal>hibernate.properties</literal> is the easiest approach if you want to get started quickly." -msgstr "今すぐ始めたいのなら、<literal>hibernate.properties</literal> を使うのが一番の近道です。" +#. Tag: para +#: configuration.xml:87 +#, no-c-format +msgid "" +"<literal>hibernate.properties</literal> is the easiest approach if you want " +"to get started quickly." +msgstr "" +"今すぐ始めたいのなら、<literal>hibernate.properties</literal> を使うのが一番" +"の近道です。" -#: index.docbook:92 -msgid "The <literal>Configuration</literal> is intended as a startup-time object, to be discarded once a <literal>SessionFactory</literal> is created." -msgstr "<literal>Configuration</literal> は、起動時にだけあるオブジェクトであり、 一度 <literal>SessionFactory</literal> を生成した後は、破棄されることを意図しています。" +#. Tag: para +#: configuration.xml:92 +#, no-c-format +msgid "" +"The <literal>Configuration</literal> is intended as a startup-time object, " +"to be discarded once a <literal>SessionFactory</literal> is created." +msgstr "" +"<literal>Configuration</literal> は、起動時にだけあるオブジェクトであり、 一" +"度 <literal>SessionFactory</literal> を生成した後は、破棄されることを意図して" +"います。" -#: index.docbook:100 +#. Tag: title +#: configuration.xml:100 +#, no-c-format msgid "Obtaining a SessionFactory" msgstr "SessionFactoryを取得する" -#: index.docbook:102 -msgid "When all mappings have been parsed by the <literal>Configuration</literal>, the application must obtain a factory for <literal>Session</literal> instances. This factory is intended to be shared by all application threads:" -msgstr "<literal>Configuration</literal> がすべてのマッピング情報を解析したら、 アプリケーションは、 <literal>Session</literal> ファクトリインスタンスを取得します。 このSessionFactoryは、Hibernateを使用するすべてのスレッドで共有されるべきです。" +#. Tag: para +#: configuration.xml:102 +#, no-c-format +msgid "" +"When all mappings have been parsed by the <literal>Configuration</literal>, " +"the application must obtain a factory for <literal>Session</literal> " +"instances. This factory is intended to be shared by all application threads:" +msgstr "" +"<literal>Configuration</literal> がすべてのマッピング情報を解析したら、 アプ" +"リケーションは、 <literal>Session</literal> ファクトリインスタンスを取得しま" +"す。 このSessionFactoryは、Hibernateを使用するすべてのスレッドで共有されるべ" +"きです。" -#: index.docbook:108 +#. Tag: programlisting +#: configuration.xml:108 +#, no-c-format msgid "<![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]>" -msgstr "<![CDATA[SessionFactory sessions = cfg.buildSessionFactory();]]>" +msgstr "" -#: index.docbook:110 -msgid "Hibernate does allow your application to instantiate more than one <literal>SessionFactory</literal>. This is useful if you are using more than one database." -msgstr "Hibernateは、 <literal>SessionFactory</literal> を複数生成することができます。 これは、複数のデータベースを使用する場合に便利です。" +#. Tag: para +#: configuration.xml:110 +#, no-c-format +msgid "" +"Hibernate does allow your application to instantiate more than one " +"<literal>SessionFactory</literal>. This is useful if you are using more than " +"one database." +msgstr "" +"Hibernateは、 <literal>SessionFactory</literal> を複数生成することができま" +"す。 これは、複数のデータベースを使用する場合に便利です。" -#: index.docbook:119 +#. Tag: title +#: configuration.xml:119 +#, no-c-format msgid "JDBC connections" msgstr "JDBCコネクション" -#: index.docbook:121 -msgid "Usually, you want to have the <literal>SessionFactory</literal> create and pool JDBC connections for you. If you take this approach, opening a <literal>Session</literal> is as simple as:" -msgstr "通常、開発者は <literal>SessionFactory</literal> を生成し、SessionFactoryでJDBCコネクションをプーリングしたいと考えます。 そのアプローチを採用する場合、単純に <literal>Session</literal> をオープンしてください：" +#. Tag: para +#: configuration.xml:121 +#, no-c-format +msgid "" +"Usually, you want to have the <literal>SessionFactory</literal> create and " +"pool JDBC connections for you. If you take this approach, opening a " +"<literal>Session</literal> is as simple as:" +msgstr "" +"通常、開発者は <literal>SessionFactory</literal> を生成し、SessionFactoryで" +"JDBCコネクションをプーリングしたいと考えます。 そのアプローチを採用する場合、" +"単純に <literal>Session</literal> をオープンしてください：" -#: index.docbook:127 -msgid "<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" -msgstr "<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" +#. Tag: programlisting +#: configuration.xml:127 +#, no-c-format +msgid "" +"<![CDATA[Session session = sessions.openSession(); // open a new Session]]>" +msgstr "" -#: index.docbook:129 -msgid "As soon as you do something that requires access to the database, a JDBC connection will be obtained from the pool." -msgstr "これだけで、プーリングしたJDBCコネクションを使って目的のデータベース にアクセスすることができます。" +#. Tag: para +#: configuration.xml:129 +#, no-c-format +msgid "" +"As soon as you do something that requires access to the database, a JDBC " +"connection will be obtained from the pool." +msgstr "" +"これだけで、プーリングしたJDBCコネクションを使って目的のデータベース にアクセ" +"スすることができます。" -#: index.docbook:134 -msgid "For this to work, we need to pass some JDBC connection properties to Hibernate. All Hibernate property names and semantics are defined on the class <literal>org.hibernate.cfg.Environment</literal>. We will now describe the most important settings for JDBC connection configuration." -msgstr "そのためには、JDBCコネクションのプロパティをHibernateに設定する必要があります。 すべてのHibernateプロパティ名とセマンティクスは <literal>org.hibernate.cfg.Environment</literal> クラスに定義されています。 この設定はJDBCコネクション設定の中で一番重要なものです。" +#. Tag: para +#: configuration.xml:134 +#, no-c-format +msgid "" +"For this to work, we need to pass some JDBC connection properties to " +"Hibernate. All Hibernate property names and semantics are defined on the " +"class <literal>org.hibernate.cfg.Environment</literal>. We will now describe " +"the most important settings for JDBC connection configuration." +msgstr "" +"そのためには、JDBCコネクションのプロパティをHibernateに設定する必要がありま" +"す。 すべてのHibernateプロパティ名とセマンティクスは <literal>org.hibernate." +"cfg.Environment</literal> クラスに定義されています。 この設定はJDBCコネクショ" +"ン設定の中で一番重要なものです。" -#: index.docbook:141 -msgid "Hibernate will obtain (and pool) connections using <literal>java.sql.DriverManager</literal> if you set the following properties:" -msgstr "もし、以下のプロパティを設定すると、Hibernateはコネクションを取得する（プールも）ために <literal>java.sql.DriverManager</literal> を使います。" +#. Tag: para +#: configuration.xml:141 +#, no-c-format +msgid "" +"Hibernate will obtain (and pool) connections using <literal>java.sql." +"DriverManager</literal> if you set the following properties:" +msgstr "" +"もし、以下のプロパティを設定すると、Hibernateはコネクションを取得する（プール" +"も）ために <literal>java.sql.DriverManager</literal> を使います。" -#: index.docbook:147 +#. Tag: title +#: configuration.xml:147 +#, no-c-format msgid "Hibernate JDBC Properties" msgstr "Hibernate JDBCプロパティ" -#: index.docbook:153, index.docbook:241, index.docbook:338, index.docbook:529, index.docbook:725, index.docbook:832, index.docbook:920 +#. Tag: entry +#: configuration.xml:153 configuration.xml:241 configuration.xml:338 +#: configuration.xml:529 configuration.xml:725 configuration.xml:832 +#: configuration.xml:920 +#, no-c-format msgid "Property name" msgstr "プロパティ名" -#: index.docbook:154, index.docbook:242, index.docbook:339, index.docbook:530, index.docbook:726, index.docbook:833, index.docbook:921 +#. Tag: entry +#: configuration.xml:154 configuration.xml:242 configuration.xml:339 +#: configuration.xml:530 configuration.xml:726 configuration.xml:833 +#: configuration.xml:921 +#, no-c-format msgid "Purpose" -msgstr "<entry>意味</entry>" +msgstr "意味" -#: index.docbook:160 +#. Tag: literal +#: configuration.xml:160 +#, no-c-format msgid "hibernate.connection.driver_class" msgstr "hibernate.connection.driver_class" -#: index.docbook:163 +#. Tag: emphasis +#: configuration.xml:163 +#, no-c-format msgid "JDBC driver class" msgstr "JDBCドライバクラス" -#: index.docbook:168 +#. Tag: literal +#: configuration.xml:168 +#, no-c-format msgid "hibernate.connection.url" msgstr "hibernate.connection.url" -#: index.docbook:171 +#. Tag: emphasis +#: configuration.xml:171 +#, no-c-format msgid "JDBC URL" msgstr "jdbc URL" -#: index.docbook:176, index.docbook:272 +#. Tag: literal +#: configuration.xml:176 configuration.xml:272 +#, no-c-format msgid "hibernate.connection.username" msgstr "hibernate.connection.username" -#: index.docbook:179 +#. Tag: emphasis +#: configuration.xml:179 +#, no-c-format msgid "database user" msgstr "database user" -#: index.docbook:184, index.docbook:280 +#. Tag: literal +#: configuration.xml:184 configuration.xml:280 +#, no-c-format msgid "hibernate.connection.password" msgstr "hibernate.connection.password" -#: index.docbook:187 +#. Tag: emphasis +#: configuration.xml:187 +#, no-c-format msgid "database user password" msgstr "database user password" -#: index.docbook:192 +#. Tag: literal +#: configuration.xml:192 +#, no-c-format msgid "hibernate.connection.pool_size" msgstr "hibernate.connection.pool_size" -#: index.docbook:195 +#. Tag: emphasis +#: configuration.xml:195 +#, no-c-format msgid "maximum number of pooled connections" msgstr "プールするコネクションの最大数" -#: index.docbook:202 -msgid "Hibernate's own connection pooling algorithm is however quite rudimentary. It is intended to help you get started and is <emphasis>not intended for use in a production system</emphasis> or even for performance testing. You should use a third party pool for best performance and stability. Just replace the <literal>hibernate.connection.pool_size</literal> property with connection pool specific settings. This will turn off Hibernate's internal pool. For example, you might like to use C3P0." -msgstr "Hibernateのコネクションプールアルゴリズムは非常に初歩的なものです。 これはすぐに始められるようにと用意されたもので、<emphasis>製品として使用することを意図していません</emphasis> 。 また、パフォーマンスのテストのためのものでもありません。 最高のパフォーマンスと安定性を持ったプールを実現したければ、サードパーティのツールをお勧めします。 <literal>hibernate.connection.pool_size</literal> プロパティに 適切なコネクションプールサイズを記述してください。 このままだとHibernateのコネクションプールを使います。 例えば次のようにC3P0を使います。" +#. Tag: para +#: configuration.xml:202 +#, no-c-format +msgid "" +"Hibernate's own connection pooling algorithm is however quite rudimentary. " +"It is intended to help you get started and is <emphasis>not intended for use " +"in a production system</emphasis> or even for performance testing. You " +"should use a third party pool for best performance and stability. Just " +"replace the <literal>hibernate.connection.pool_size</literal> property with " +"connection pool specific settings. This will turn off Hibernate's internal " +"pool. For example, you might like to use C3P0." +msgstr "" +"Hibernateのコネクションプールアルゴリズムは非常に初歩的なものです。 これはす" +"ぐに始められるようにと用意されたもので、<emphasis>製品として使用することを意" +"図していません</emphasis> 。 また、パフォーマンスのテストのためのものでもあり" +"ません。 最高のパフォーマンスと安定性を持ったプールを実現したければ、サード" +"パーティのツールをお勧めします。 <literal>hibernate.connection.pool_size</" +"literal> プロパティに 適切なコネクションプールサイズを記述してください。 この" +"ままだとHibernateのコネクションプールを使います。 例えば次のようにC3P0を使い" +"ます。" -#: index.docbook:212 -msgid "C3P0 is an open source JDBC connection pool distributed along with Hibernate in the <literal>lib</literal> directory. Hibernate will use its <literal>C3P0ConnectionProvider</literal> for connection pooling if you set <literal>hibernate.c3p0.*</literal> properties. If you'd like to use Proxool refer to the packaged <literal>hibernate.properties</literal> and the Hibernate web site for more information." -msgstr "C3P0はオープンソースJDBCコネクションプールで、Hibernateの <literal>lib</literal> ディレクトリにあります。もし、<literal>hibernate.c3p0.*</literal> プロパティを セットすれば、Hibernateは、 <literal>C3P0ConnectionProvider</literal> を使います。 もしProxoolを使いたい場合は、 <literal>hibernate.properties</literal> パッケージを 参照したり、HibernateのWebサイトでより多くの情報を取得してください。" +#. Tag: para +#: configuration.xml:212 +#, no-c-format +msgid "" +"C3P0 is an open source JDBC connection pool distributed along with Hibernate " +"in the <literal>lib</literal> directory. Hibernate will use its " +"<literal>C3P0ConnectionProvider</literal> for connection pooling if you set " +"<literal>hibernate.c3p0.*</literal> properties. If you'd like to use Proxool " +"refer to the packaged <literal>hibernate.properties</literal> and the " +"Hibernate web site for more information." +msgstr "" +"C3P0はオープンソースJDBCコネクションプールで、Hibernateの <literal>lib</" +"literal> ディレクトリにあります。もし、<literal>hibernate.c3p0.*</literal> プ" +"ロパティを セットすれば、Hibernateは、 <literal>C3P0ConnectionProvider</" +"literal> を使います。 もしProxoolを使いたい場合は、 <literal>hibernate." +"properties</literal> パッケージを 参照したり、HibernateのWebサイトでより多く" +"の情報を取得してください。" -#: index.docbook:221 -msgid "Here is an example <literal>hibernate.properties</literal> file for C3P0:" -msgstr "C3P0用の <literal>hibernate.properties</literal> ファイルを例として示します：" +#. Tag: para +#: configuration.xml:221 +#, no-c-format +msgid "" +"Here is an example <literal>hibernate.properties</literal> file for C3P0:" +msgstr "" +"C3P0用の <literal>hibernate.properties</literal> ファイルを例として示します：" -#: index.docbook:225 +#. Tag: programlisting +#: configuration.xml:225 +#, no-c-format msgid "" - "<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" - "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" - "hibernate.connection.username = myuser\n" - "hibernate.connection.password = secret\n" - "hibernate.c3p0.min_size=5\n" - "hibernate.c3p0.max_size=20\n" - "hibernate.c3p0.timeout=1800\n" - "hibernate.c3p0.max_statements=50\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +"<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" +"hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" +"hibernate.connection.username = myuser\n" +"hibernate.connection.password = secret\n" +"hibernate.c3p0.min_size=5\n" +"hibernate.c3p0.max_size=20\n" +"hibernate.c3p0.timeout=1800\n" +"hibernate.c3p0.max_statements=50\n" +"hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" msgstr "" - "<![CDATA[hibernate.connection.driver_class = org.postgresql.Driver\n" - "hibernate.connection.url = jdbc:postgresql://localhost/mydatabase\n" - "hibernate.connection.username = myuser\n" - "hibernate.connection.password = secret\n" - "hibernate.c3p0.min_size=5\n" - "hibernate.c3p0.max_size=20\n" - "hibernate.c3p0.timeout=1800\n" - "hibernate.c3p0.max_statements=50\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" -#: index.docbook:227 -msgid "For use inside an application server, you should almost always configure Hibernate to obtain connections from an application server <literal>Datasource</literal> registered in JNDI. You'll need to set at least one of the following properties:" -msgstr "アプリケーションサーバ上で使う場合は、Hibernateを設定し、 アプリケーションサーバからコネクションを取得するようにしてください。 <literal>Datasource</literal> をJNDIに登録します。そして プロパティを以下のように設定してください。" +#. Tag: para +#: configuration.xml:227 +#, no-c-format +msgid "" +"For use inside an application server, you should almost always configure " +"Hibernate to obtain connections from an application server " +"<literal>Datasource</literal> registered in JNDI. You'll need to set at " +"least one of the following properties:" +msgstr "" +"アプリケーションサーバ上で使う場合は、Hibernateを設定し、 アプリケーション" +"サーバからコネクションを取得するようにしてください。 <literal>Datasource</" +"literal> をJNDIに登録します。そして プロパティを以下のように設定してくださ" +"い。" -#: index.docbook:235 +#. Tag: title +#: configuration.xml:235 +#, no-c-format msgid "Hibernate Datasource Properties" msgstr "Hibernate データソースプロパティ" -#: index.docbook:248 +#. Tag: literal +#: configuration.xml:248 +#, no-c-format msgid "hibernate.connection.datasource" msgstr "hibernate.connection.datasource" -#: index.docbook:251 +#. Tag: emphasis +#: configuration.xml:251 +#, no-c-format msgid "datasource JNDI name" msgstr "データソースのJNDI名" -#: index.docbook:256 +#. Tag: literal +#: configuration.xml:256 +#, no-c-format msgid "hibernate.jndi.url" msgstr "hibernate.jndi.url" -#: index.docbook:258 +#. Tag: entry +#: configuration.xml:258 +#, fuzzy, no-c-format msgid "<emphasis>URL of the JNDI provider</emphasis> (optional)" -msgstr "<emphasis>JNDIプロバイダのURL</emphasis> (オプション)" +msgstr "JNDIプロバイダのURL" -#: index.docbook:264 +#. Tag: literal +#: configuration.xml:264 +#, no-c-format msgid "hibernate.jndi.class" msgstr "hibernate.jndi.class" -#: index.docbook:266 -msgid "<emphasis>class of the JNDI <literal>InitialContextFactory</literal></emphasis> (optional)" -msgstr "<emphasis>JNDIクラス <literal>InitialContextFactory</literal> </emphasis> (オプション)" +#. Tag: entry +#: configuration.xml:266 +#, no-c-format +msgid "" +"<emphasis>class of the JNDI <literal>InitialContextFactory</literal></" +"emphasis> (optional)" +msgstr "" -#: index.docbook:274 +#. Tag: entry +#: configuration.xml:274 +#, no-c-format msgid "<emphasis>database user</emphasis> (optional)" -msgstr "<emphasis>database user</emphasis> (オプション)" +msgstr "" -#: index.docbook:282 +#. Tag: entry +#: configuration.xml:282 +#, no-c-format msgid "<emphasis>database user password</emphasis> (optional)" -msgstr "<emphasis>database user password</emphasis> (オプション)" +msgstr "" -#: index.docbook:290 -msgid "Here's an example <literal>hibernate.properties</literal> file for an application server provided JNDI datasource:" -msgstr "アプリケーションサーバから提供されたJNDIデータソースを使う <literal>hibernate.properties</literal> ファイルの例を示します：" +#. Tag: para +#: configuration.xml:290 +#, no-c-format +msgid "" +"Here's an example <literal>hibernate.properties</literal> file for an " +"application server provided JNDI datasource:" +msgstr "" +"アプリケーションサーバから提供されたJNDIデータソースを使う " +"<literal>hibernate.properties</literal> ファイルの例を示します：" -#: index.docbook:295 +#. Tag: programlisting +#: configuration.xml:295 +#, no-c-format msgid "" - "<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" - "hibernate.transaction.factory_class = \\\n" - " org.hibernate.transaction.JTATransactionFactory\n" - "hibernate.transaction.manager_lookup_class = \\\n" - " org.hibernate.transaction.JBossTransactionManagerLookup\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" +"<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" +"hibernate.transaction.factory_class = \\\n" +" org.hibernate.transaction.JTATransactionFactory\n" +"hibernate.transaction.manager_lookup_class = \\\n" +" org.hibernate.transaction.JBossTransactionManagerLookup\n" +"hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" msgstr "" - "<![CDATA[hibernate.connection.datasource = java:/comp/env/jdbc/test\n" - "hibernate.transaction.factory_class = ¥\n" - " org.hibernate.transaction.JTATransactionFactory\n" - "hibernate.transaction.manager_lookup_class = ¥\n" - " org.hibernate.transaction.JBossTransactionManagerLookup\n" - "hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]>" -#: index.docbook:297 -msgid "JDBC connections obtained from a JNDI datasource will automatically participate in the container-managed transactions of the application server." -msgstr "JNDIデータソースから取得したJDBCコネクションは、アプリケーションサーバの コンテナ管理トランザクションに自動的に参加します。" +#. Tag: para +#: configuration.xml:297 +#, no-c-format +msgid "" +"JDBC connections obtained from a JNDI datasource will automatically " +"participate in the container-managed transactions of the application server." +msgstr "" +"JNDIデータソースから取得したJDBCコネクションは、アプリケーションサーバの コン" +"テナ管理トランザクションに自動的に参加します。" -#: index.docbook:302 -msgid "Arbitrary connection properties may be given by prepending \"<literal>hibernate.connection</literal>\" to the property name. For example, you may specify a <literal>charSet</literal> using <literal>hibernate.connection.charSet</literal>." -msgstr "任意のコネクションプロパティは、与えられた” <literal>hibernate.connnection</literal> ” プロパティ名によって与えられます。例えば、 <literal>charSet</literal> を設定したい場合は、 <literal>hibernate.connection.charSet</literal> を使います。" +#. Tag: para +#: configuration.xml:302 +#, no-c-format +msgid "" +"Arbitrary connection properties may be given by prepending " +"\"<literal>hibernate.connection</literal>\" to the property name. For " +"example, you may specify a <literal>charSet</literal> using " +"<literal>hibernate.connection.charSet</literal>." +msgstr "" +"任意のコネクションプロパティは、与えられた” <literal>hibernate.connnection</" +"literal> ” プロパティ名によって与えられます。例えば、 <literal>charSet</" +"literal> を設定したい場合は、 <literal>hibernate.connection.charSet</" +"literal> を使います。" -#: index.docbook:308 -msgid "You may define your own plugin strategy for obtaining JDBC connections by implementing the interface <literal>org.hibernate.connection.ConnectionProvider</literal>. You may select a custom implementation by setting <literal>hibernate.connection.provider_class</literal>." -msgstr "JDBCコネクションを取得する戦略を持つ独自のプラグインを定義する場合は、 <literal>org.hibernate.connection.ConnectionProvider</literal> インターフェイスを 実装してください。そして、実装クラスを <literal>hibernate.connection.provider_class</literal> に設定してください。" +#. Tag: para +#: configuration.xml:308 +#, no-c-format +msgid "" +"You may define your own plugin strategy for obtaining JDBC connections by " +"implementing the interface <literal>org.hibernate.connection." +"ConnectionProvider</literal>. You may select a custom implementation by " +"setting <literal>hibernate.connection.provider_class</literal>." +msgstr "" +"JDBCコネクションを取得する戦略を持つ独自のプラグインを定義する場合は、 " +"<literal>org.hibernate.connection.ConnectionProvider</literal> インターフェイ" +"スを 実装してください。そして、実装クラスを <literal>hibernate.connection." +"provider_class</literal> に設定してください。" -#: index.docbook:317 +#. Tag: title +#: configuration.xml:317 +#, no-c-format msgid "Optional configuration properties" msgstr "オプション設定プロパティ" -#: index.docbook:319 -msgid "There are a number of other properties that control the behaviour of Hibernate at runtime. All are optional and have reasonable default values." -msgstr "これらのプロパティはHibernateの挙動を制御するものです。 これらのプロパティはすべて妥当なデフォルト値があり、任意で設定します。" +#. Tag: para +#: configuration.xml:319 +#, no-c-format +msgid "" +"There are a number of other properties that control the behaviour of " +"Hibernate at runtime. All are optional and have reasonable default values." +msgstr "" +"これらのプロパティはHibernateの挙動を制御するものです。 これらのプロパティは" +"すべて妥当なデフォルト値があり、任意で設定します。" -#: index.docbook:324 -msgid "<emphasis>Warning: some of these properties are \"system-level\" only.</emphasis> System-level properties can be set only via <literal>java -Dproperty=value</literal> or <literal>hibernate.properties</literal>. They may <emphasis>not</emphasis> be set by the other techniques described above." -msgstr "<emphasis>注意：これらのプロパティは\"システムレベル\"のみです。</emphasis> システムレベルプロパティは <literal>java -Dproperty=value</literal> 、もしくは <literal>hibernate.properties</literal> でのみ設定可能です。 それ以外の設定方法は <emphasis>ありません</emphasis> 。" +#. Tag: para +#: configuration.xml:324 +#, no-c-format +msgid "" +"<emphasis>Warning: some of these properties are \"system-level\" only.</" +"emphasis> System-level properties can be set only via <literal>java -" +"Dproperty=value</literal> or <literal>hibernate.properties</literal>. They " +"may <emphasis>not</emphasis> be set by the other techniques described above." +msgstr "" +"<emphasis>注意：これらのプロパティは\"システムレベル\"のみです。</emphasis> " +"システムレベルプロパティは <literal>java -Dproperty=value</literal> 、もしく" +"は <literal>hibernate.properties</literal> でのみ設定可能です。 それ以外の設" +"定方法は <emphasis>ありません</emphasis> 。" -#: index.docbook:332 +#. Tag: title +#: configuration.xml:332 +#, no-c-format msgid "Hibernate Configuration Properties" msgstr "Hibernate設定プロパティ" -#: index.docbook:345 +#. Tag: literal +#: configuration.xml:345 +#, no-c-format msgid "hibernate.dialect" msgstr "hibernate.dialect" -#: index.docbook:347 -msgid "The classname of a Hibernate <literal>Dialect</literal> which allows Hibernate to generate SQL optimized for a particular relational database." -msgstr "Hibernate <literal>Dialect</literal> クラス名が入ります。 これはリレーショナルデータベースごとに最適化されたSQLを生成します。" +#. Tag: entry +#: configuration.xml:347 +#, fuzzy, no-c-format +msgid "" +"The classname of a Hibernate <literal>Dialect</literal> which allows " +"Hibernate to generate SQL optimized for a particular relational database." +msgstr "" +"Hibernate <placeholder-1/> クラス名が入ります。 これはリレーショナルデータ" +"ベースごとに最適化されたSQLを生成します。 <placeholder-2/>" -#: index.docbook:351 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>full.classname.of.Dialect</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>full.classname.of.Dialect</literal>" +#. Tag: para +#: configuration.xml:351 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>full.classname.of.Dialect</" +"literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:359 +#. Tag: literal +#: configuration.xml:359 +#, no-c-format msgid "hibernate.show_sql" msgstr "hibernate.show_sql" -#: index.docbook:361 -msgid "Write all SQL statements to console. This is an alternative to setting the log category <literal>org.hibernate.SQL</literal> to <literal>debug</literal>." -msgstr "発行されたすべてのSQLをコンソールに出力します。 これはログカテゴリの <literal>org.hibernate.SQL</literal> に <literal>debug</literal> を設定する方法の代替手段です。" +#. Tag: entry +#: configuration.xml:361 +#, fuzzy, no-c-format +msgid "" +"Write all SQL statements to console. This is an alternative to setting the " +"log category <literal>org.hibernate.SQL</literal> to <literal>debug</" +"literal>." +msgstr "" +"発行されたすべてのSQLをコンソールに出力します。 これはログカテゴリの " +"<placeholder-1/> に <placeholder-2/> を設定する方法の代替手段です。 " +"<placeholder-3/>" -#: index.docbook:365, index.docbook:377, index.docbook:471, index.docbook:484, index.docbook:497, index.docbook:510, index.docbook:564, index.docbook:591, index.docbook:605, index.docbook:660, index.docbook:888, index.docbook:903, index.docbook:993 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>true</literal> | <literal>false</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>true</literal> | <literal>false</literal>" +#. Tag: para +#: configuration.xml:365 configuration.xml:377 configuration.xml:471 +#: configuration.xml:484 configuration.xml:497 configuration.xml:510 +#: configuration.xml:564 configuration.xml:591 configuration.xml:605 +#: configuration.xml:660 configuration.xml:888 configuration.xml:903 +#: configuration.xml:993 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>true</literal> | " +"<literal>false</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:373 +#. Tag: literal +#: configuration.xml:373 +#, no-c-format msgid "hibernate.format_sql" msgstr "hibernate.format_sql" -#: index.docbook:375 +#. Tag: entry +#: configuration.xml:375 +#, fuzzy, no-c-format msgid "Pretty print the SQL in the log and console." -msgstr "ログとコンソールのSQLを美しく表示します。" +msgstr "ログとコンソールのSQLを美しく表示します。 <placeholder-1/>" -#: index.docbook:385 +#. Tag: literal +#: configuration.xml:385 +#, no-c-format msgid "hibernate.default_schema" msgstr "hibernate.default_schema" -#: index.docbook:387 -msgid "Qualify unqualified table names with the given schema/tablespace in generated SQL." -msgstr "生成されるSQL文のテーブルに設定するスキーマ/テーブルスペースです。" +#. Tag: entry +#: configuration.xml:387 +#, fuzzy, no-c-format +msgid "" +"Qualify unqualified table names with the given schema/tablespace in " +"generated SQL." +msgstr "" +"生成されるSQL文のテーブルに設定するスキーマ/テーブルスペースです。 " +"<placeholder-1/>" -#: index.docbook:390 +#. Tag: para +#: configuration.xml:390 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>SCHEMA_NAME</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>SCHEMA_NAME</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:398 +#. Tag: literal +#: configuration.xml:398 +#, no-c-format msgid "hibernate.default_catalog" msgstr "hibernate.default_catalog" -#: index.docbook:400 -msgid "Qualify unqualified table names with the given catalog in generated SQL." -msgstr "生成されるSQL文のテーブルに設定するカタログです。" +#. Tag: entry +#: configuration.xml:400 +#, fuzzy, no-c-format +msgid "" +"Qualify unqualified table names with the given catalog in generated SQL." +msgstr "生成されるSQL文のテーブルに設定するカタログです。 <placeholder-1/>" -#: index.docbook:403 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>CATALOG_NAME</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>CATALOG_NAME</literal>" +#. Tag: para +#: configuration.xml:403 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>CATALOG_NAME</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:411 +#. Tag: literal +#: configuration.xml:411 +#, no-c-format msgid "hibernate.session_factory_name" msgstr "hibernate.session_factory_name" -#: index.docbook:413 -msgid "The <literal>SessionFactory</literal> will be automatically bound to this name in JNDI after it has been created." -msgstr "<literal>SessionFactory</literal> は生成後、この名前でJNDIに登録されます。" +#. Tag: entry +#: configuration.xml:413 +#, fuzzy, no-c-format +msgid "" +"The <literal>SessionFactory</literal> will be automatically bound to this " +"name in JNDI after it has been created." +msgstr "" +"<placeholder-1/> は生成後、この名前でJNDIに登録されます。 <placeholder-2/>" -#: index.docbook:416, index.docbook:859 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>jndi/composite/name</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>jndi/composite/name</literal>" +#. Tag: para +#: configuration.xml:416 configuration.xml:859 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>jndi/composite/name</" +"literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:424 +#. Tag: literal +#: configuration.xml:424 +#, no-c-format msgid "hibernate.max_fetch_depth" msgstr "hibernate.max_fetch_depth" -#: index.docbook:426 -msgid "Set a maximum \"depth\" for the outer join fetch tree for single-ended associations (one-to-one, many-to-one). A <literal>0</literal> disables default outer join fetching." -msgstr "外部結合フェッチの最大深度を設定します。結合する関連は 対一関連のみ（一対一、多対一）です。 <literal>0</literal> を指定すると外部結合フェッチは無効になります。" +#. Tag: entry +#: configuration.xml:426 +#, fuzzy, no-c-format +msgid "" +"Set a maximum \"depth\" for the outer join fetch tree for single-ended " +"associations (one-to-one, many-to-one). A <literal>0</literal> disables " +"default outer join fetching." +msgstr "" +"外部結合フェッチの最大深度を設定します。結合する関連は 対一関連のみ（一対一、" +"多対一）です。 <placeholder-1/> を指定すると外部結合フェッチは無効になりま" +"す。 <placeholder-2/>" -#: index.docbook:430 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>0</literal> and <literal>3</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>0</literal> から <literal>3</literal> です。" +#. Tag: para +#: configuration.xml:430 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values between " +"<literal>0</literal> and <literal>3</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>0</literal> " +"から <literal>3</literal> です。" -#: index.docbook:439 +#. Tag: literal +#: configuration.xml:439 +#, no-c-format msgid "hibernate.default_batch_fetch_size" msgstr "hibernate.default_batch_fetch_size" -#: index.docbook:441 +#. Tag: entry +#: configuration.xml:441 +#, fuzzy, no-c-format msgid "Set a default size for Hibernate batch fetching of associations." -msgstr "関連フェッチのデフォルトバッチサイズを指定します。" +msgstr "関連フェッチのデフォルトバッチサイズを指定します。 <placeholder-1/>" -#: index.docbook:443 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values <literal>4</literal>, <literal>8</literal>, <literal>16</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>4</literal> , <literal>8</literal> , <literal>16</literal> です。" +#. Tag: para +#: configuration.xml:443 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values <literal>4</" +"literal>, <literal>8</literal>, <literal>16</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>4</" +"literal> , <literal>8</literal> , <literal>16</literal> です。" -#: index.docbook:452 +#. Tag: literal +#: configuration.xml:452 +#, no-c-format msgid "hibernate.default_entity_mode" msgstr "hibernate.default_entity_mode" -#: index.docbook:454 -msgid "Set a default mode for entity representation for all sessions opened from this <literal>SessionFactory</literal>" -msgstr "<literal>SessionFactory</literal> からセッションをオープンしたときに 使用するエンティティのデフォルトモードを設定します。" +#. Tag: entry +#: configuration.xml:454 +#, fuzzy, no-c-format +msgid "" +"Set a default mode for entity representation for all sessions opened from " +"this <literal>SessionFactory</literal>" +msgstr "" +"<placeholder-1/> からセッションをオープンしたときに 使用するエンティティのデ" +"フォルトモードを設定します。 <placeholder-2/>" -#: index.docbook:457 -msgid "<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</literal>" -msgstr "<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</literal>" +#. Tag: para +#: configuration.xml:457 +#, no-c-format +msgid "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" +msgstr "" +"<literal>dynamic-map</literal>, <literal>dom4j</literal>, <literal>pojo</" +"literal>" -#: index.docbook:465 +#. Tag: literal +#: configuration.xml:465 +#, no-c-format msgid "hibernate.order_updates" msgstr "hibernate.order_updates" -#: index.docbook:467 -msgid "Force Hibernate to order SQL updates by the primary key value of the items being updated. This will result in fewer transaction deadlocks in highly concurrent systems." -msgstr "項目が更新されたときに、別のSQLで主キーを更新することを強制します。 この場合、同時実行可能なシステムでは、まれにデッドロックが発生する可能性があります。" +#. Tag: entry +#: configuration.xml:467 +#, fuzzy, no-c-format +msgid "" +"Force Hibernate to order SQL updates by the primary key value of the items " +"being updated. This will result in fewer transaction deadlocks in highly " +"concurrent systems." +msgstr "" +"項目が更新されたときに、別のSQLで主キーを更新することを強制します。 この場" +"合、同時実行可能なシステムでは、まれにデッドロックが発生する可能性がありま" +"す。 <placeholder-1/>" -#: index.docbook:479 +#. Tag: literal +#: configuration.xml:479 +#, no-c-format msgid "hibernate.generate_statistics" msgstr "hibernate.generate_statistics" -#: index.docbook:481 -msgid "If enabled, Hibernate will collect statistics useful for performance tuning." -msgstr "有効の場合、Hibernateはパフォーマンスチューニングに 有効な統計情報を収集します。" +#. Tag: entry +#: configuration.xml:481 +#, fuzzy, no-c-format +msgid "" +"If enabled, Hibernate will collect statistics useful for performance tuning." +msgstr "" +"有効の場合、Hibernateはパフォーマンスチューニングに 有効な統計情報を収集しま" +"す。 <placeholder-1/>" -#: index.docbook:492 +#. Tag: literal +#: configuration.xml:492 +#, no-c-format msgid "hibernate.use_identifier_rollback" msgstr "hibernate.use_identifer_rollback" -#: index.docbook:494 -msgid "If enabled, generated identifier properties will be reset to default values when objects are deleted." -msgstr "有効の場合、オブジェクトが削除されたときに 識別子プロパティをリセットし、デフォルト値にしたものを生成します。" +#. Tag: entry +#: configuration.xml:494 +#, fuzzy, no-c-format +msgid "" +"If enabled, generated identifier properties will be reset to default values " +"when objects are deleted." +msgstr "" +"有効の場合、オブジェクトが削除されたときに 識別子プロパティをリセットし、デ" +"フォルト値にしたものを生成します。 <placeholder-1/>" -#: index.docbook:505 +#. Tag: literal +#: configuration.xml:505 +#, no-c-format msgid "hibernate.use_sql_comments" msgstr "hibernate.use_sql_comments" -#: index.docbook:507 -msgid "If turned on, Hibernate will generate comments inside the SQL, for easier debugging, defaults to <literal>false</literal>." -msgstr "有効の場合、SQL内にコメントを生成します。これはデバックを容易にします。 デフォルトの値は <literal>false</literal> です。" +#. Tag: entry +#: configuration.xml:507 +#, fuzzy, no-c-format +msgid "" +"If turned on, Hibernate will generate comments inside the SQL, for easier " +"debugging, defaults to <literal>false</literal>." +msgstr "" +"有効の場合、SQL内にコメントを生成します。これはデバックを容易にします。 デ" +"フォルトの値は <placeholder-1/> です。 <placeholder-2/>" -#: index.docbook:521 +#. Tag: title +#: configuration.xml:521 +#, no-c-format msgid "Hibernate JDBC and Connection Properties" msgstr "Hibernate JDBC とコネクションプロパティ" -#: index.docbook:536 +#. Tag: literal +#: configuration.xml:536 +#, no-c-format msgid "hibernate.jdbc.fetch_size" msgstr "hibernate.jdbc.fetch_size" -#: index.docbook:538 -msgid "A non-zero value determines the JDBC fetch size (calls <literal>Statement.setFetchSize()</literal>)." -msgstr "値が0でない場合、JDBCフェッチサイズを決定します ( <literal>Statement.setFetchSize()</literal> を呼びます)。" +#. Tag: entry +#: configuration.xml:538 +#, fuzzy, no-c-format +msgid "" +"A non-zero value determines the JDBC fetch size (calls <literal>Statement." +"setFetchSize()</literal>)." +msgstr "" +"値が0でない場合、JDBCフェッチサイズを決定します ( <placeholder-1/> を呼びま" +"す)。" -#: index.docbook:545 +#. Tag: literal +#: configuration.xml:545 +#, no-c-format msgid "hibernate.jdbc.batch_size" msgstr "hibernate.jdbc.batch_size" -#: index.docbook:547 +#. Tag: entry +#: configuration.xml:547 +#, fuzzy, no-c-format msgid "A non-zero value enables use of JDBC2 batch updates by Hibernate." -msgstr "値が0でない場合、HibernateがJDBC2バッチ更新を使用します。" +msgstr "" +"値が0でない場合、HibernateがJDBC2バッチ更新を使用します。 <placeholder-1/>" -#: index.docbook:549 -msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>5</literal> and <literal>30</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>5</literal> から <literal>30</literal> です。" +#. Tag: para +#: configuration.xml:549 +#, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> recommended values between " +"<literal>5</literal> and <literal>30</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis> 推奨する値は <literal>5</literal> " +"から <literal>30</literal> です。" -#: index.docbook:557 +#. Tag: literal +#: configuration.xml:557 +#, no-c-format msgid "hibernate.jdbc.batch_versioned_data" msgstr "hibernate.jdbc.batch_versioned_data" -#: index.docbook:559 -msgid "Set this property to <literal>true</literal> if your JDBC driver returns correct row counts from <literal>executeBatch()</literal> (it is usually safe to turn this option on). Hibernate will then use batched DML for automatically versioned data. Defaults to <literal>false</literal>." -msgstr "もしJDBCドライバが <literal>executeBatch()</literal> によって正確な行数を 返す場合、このプロパティを <literal>true</literal> にしてください （通常はこのオプションをONにします）。 Hibernateは、自動バージョンデータのためバッチDMLを使います。 デフォルトの値は <literal>false</literal> です。" +#. Tag: entry +#: configuration.xml:559 +#, fuzzy, no-c-format +msgid "" +"Set this property to <literal>true</literal> if your JDBC driver returns " +"correct row counts from <literal>executeBatch()</literal> (it is usually " +"safe to turn this option on). Hibernate will then use batched DML for " +"automatically versioned data. Defaults to <literal>false</literal>." +msgstr "" +"もしJDBCドライバが <placeholder-1/> によって正確な行数を 返す場合、このプロパ" +"ティを <placeholder-2/> にしてください （通常はこのオプションをONにしま" +"す）。 Hibernateは、自動バージョンデータのためバッチDMLを使います。 デフォル" +"トの値は <placeholder-3/> です。 <placeholder-4/>" -#: index.docbook:572 +#. Tag: literal +#: configuration.xml:572 +#, no-c-format msgid "hibernate.jdbc.factory_class" msgstr "hibernate.jdbc.factory_class" -#: index.docbook:574 -msgid "Select a custom <literal>Batcher</literal>. Most applications will not need this configuration property." -msgstr "カスタム <literal>Batcher</literal> を選びます。 ほとんどのアプリケーションに、この設定は必要ありません。" +#. Tag: entry +#: configuration.xml:574 +#, fuzzy, no-c-format +msgid "" +"Select a custom <literal>Batcher</literal>. Most applications will not need " +"this configuration property." +msgstr "" +"カスタム <placeholder-1/> を選びます。 ほとんどのアプリケーションに、この設定" +"は必要ありません。 <placeholder-2/>" -#: index.docbook:577 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.BatcherFactory</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.BatcherFactory</literal>" +#. Tag: para +#: configuration.xml:577 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"BatcherFactory</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:585 +#. Tag: literal +#: configuration.xml:585 +#, no-c-format msgid "hibernate.jdbc.use_scrollable_resultset" msgstr "hibernate.jdbc.use_scrollable_resultset" -#: index.docbook:587 -msgid "Enables use of JDBC2 scrollable resultsets by Hibernate. This property is only necessary when using user supplied JDBC connections, Hibernate uses connection metadata otherwise." -msgstr "スクロール可能なリザルトセットを、Hibernateが使用します。 このプロパティは、JDBCコネクションがコネクションメタデータを サポートしていることが必須条件になります。" +#. Tag: entry +#: configuration.xml:587 +#, fuzzy, no-c-format +msgid "" +"Enables use of JDBC2 scrollable resultsets by Hibernate. This property is " +"only necessary when using user supplied JDBC connections, Hibernate uses " +"connection metadata otherwise." +msgstr "" +"スクロール可能なリザルトセットを、Hibernateが使用します。 このプロパティは、" +"JDBCコネクションがコネクションメタデータを サポートしていることが必須条件にな" +"ります。 <placeholder-1/>" -#: index.docbook:599 +#. Tag: literal +#: configuration.xml:599 +#, no-c-format msgid "hibernate.jdbc.use_streams_for_binary" msgstr "hibernate.jdbc.use_streams_for_binary" -#: index.docbook:601 -msgid "Use streams when writing/reading <literal>binary</literal> or <literal>serializable</literal> types to/from JDBC (system-level property)." -msgstr "JDBCへ/から <literal>binary</literal> や <literal>serializable</literal> の書き込み/読み込みストリームを使います(システムレベルのプロパティ)。" +#. Tag: entry +#: configuration.xml:601 +#, fuzzy, no-c-format +msgid "" +"Use streams when writing/reading <literal>binary</literal> or " +"<literal>serializable</literal> types to/from JDBC (system-level property)." +msgstr "" +"JDBCへ/から <placeholder-1/> や <placeholder-2/> の書き込み/読み込みストリー" +"ムを使います(システムレベルのプロパティ)。 <placeholder-3/>" -#: index.docbook:613 +#. Tag: literal +#: configuration.xml:613 +#, no-c-format msgid "hibernate.jdbc.use_get_generated_keys" msgstr "hibernate.jdbc.use_get_generated_keys" -#: index.docbook:615 -msgid "Enable use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> to retrieve natively generated keys after insert. Requires JDBC3+ driver and JRE1.4+, set to false if your driver has problems with the Hibernate identifier generators. By default, tries to determine the driver capabilities using connection metadata." -msgstr "挿入の後に自動生成された主キーを取得するための JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> の使用を有効にします。 これはJDBC3+ドライバとJRE1.4+を必要とし、 もしHibernateの識別子ジェネレータに問題が発生するようならfalseに設定してください。 デフォルトではコネクションメタデータを使いドライバの能力を決定します。" +#. Tag: entry +#: configuration.xml:615 +#, fuzzy, no-c-format +msgid "" +"Enable use of JDBC3 <literal>PreparedStatement.getGeneratedKeys()</literal> " +"to retrieve natively generated keys after insert. Requires JDBC3+ driver and " +"JRE1.4+, set to false if your driver has problems with the Hibernate " +"identifier generators. By default, tries to determine the driver " +"capabilities using connection metadata." +msgstr "" +"挿入の後に自動生成された主キーを取得するための JDBC3 <placeholder-1/> の使用" +"を有効にします。 これはJDBC3+ドライバとJRE1.4+を必要とし、 もしHibernateの識" +"別子ジェネレータに問題が発生するようならfalseに設定してください。 デフォルト" +"ではコネクションメタデータを使いドライバの能力を決定します。 <placeholder-2/>" -#: index.docbook:621, index.docbook:751, index.docbook:763, index.docbook:777, index.docbook:815 +#. Tag: para +#: configuration.xml:621 configuration.xml:751 configuration.xml:763 +#: configuration.xml:777 configuration.xml:815 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>true|false</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>true|false</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:629 +#. Tag: literal +#: configuration.xml:629 +#, no-c-format msgid "hibernate.connection.provider_class" msgstr "hibernate.connection.provider_class" -#: index.docbook:631 -msgid "The classname of a custom <literal>ConnectionProvider</literal> which provides JDBC connections to Hibernate." -msgstr "JDBCコネクションをHibernateに提供する独自の <literal>ConnectionProvider</literal> の 名前を指定します。" +#. Tag: entry +#: configuration.xml:631 +#, fuzzy, no-c-format +msgid "" +"The classname of a custom <literal>ConnectionProvider</literal> which " +"provides JDBC connections to Hibernate." +msgstr "" +"JDBCコネクションをHibernateに提供する独自の <placeholder-1/> の 名前を指定し" +"ます。 <placeholder-2/>" -#: index.docbook:634 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.ConnectionProvider</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.ConnectionProvider</literal>" +#. Tag: para +#: configuration.xml:634 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"ConnectionProvider</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:642 +#. Tag: literal +#: configuration.xml:642 +#, no-c-format msgid "hibernate.connection.isolation" msgstr "hibernate.connection.isolation" -#: index.docbook:644 -msgid "Set the JDBC transaction isolation level. Check <literal>java.sql.Connection</literal> for meaningful values but note that most databases do not support all isolation levels." -msgstr "JDBCトランザクション分離レベルを設定します。 妥当な値を調べるためには <literal>java.sql.Connection</literal> をチェックしてください。 しかし使用するデータベースが、すべての分離レベルをサポートしているとは限りません。" +#. Tag: entry +#: configuration.xml:644 +#, fuzzy, no-c-format +msgid "" +"Set the JDBC transaction isolation level. Check <literal>java.sql." +"Connection</literal> for meaningful values but note that most databases do " +"not support all isolation levels." +msgstr "" +"JDBCトランザクション分離レベルを設定します。 妥当な値を調べるためには " +"<placeholder-1/> をチェックしてください。 しかし使用するデータベースが、すべ" +"ての分離レベルをサポートしているとは限りません。 <placeholder-2/>" -#: index.docbook:648 +#. Tag: para +#: configuration.xml:648 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>1, 2, 4, 8</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>1, 2, 4, 8</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:656 +#. Tag: literal +#: configuration.xml:656 +#, no-c-format msgid "hibernate.connection.autocommit" msgstr "hibernate.connection.autocommit" -#: index.docbook:658 +#. Tag: entry +#: configuration.xml:658 +#, fuzzy, no-c-format msgid "Enables autocommit for JDBC pooled connections (not recommended)." -msgstr "プールされているJDBCコネクションの自動コミットを有効にする（非推奨）。" +msgstr "" +"プールされているJDBCコネクションの自動コミットを有効にする（非推奨）。 " +"<placeholder-1/>" -#: index.docbook:668 +#. Tag: literal +#: configuration.xml:668 +#, no-c-format msgid "hibernate.connection.release_mode" msgstr "hibernate.connection.release_mode" -#: index.docbook:670 -msgid "Specify when Hibernate should release JDBC connections. By default, a JDBC connection is held until the session is explicitly closed or disconnected. For an application server JTA datasource, you should use <literal>after_statement</literal> to aggressively release connections after every JDBC call. For a non-JTA connection, it often makes sense to release the connection at the end of each transaction, by using <literal>after_transaction</literal>. <literal>auto</literal> will choose <literal>after_statement</literal> for the JTA and CMT transaction strategies and <literal>after_transaction</literal> for the JDBC transaction strategy." -msgstr "HibernateがJDBCコネクションをリリースするかを指定します。デフォルトでは セッションが明示的にクローズまたは切断されてもコネクションは保持します。 アプリケーションサーバのJTAデータソースの場合、 すべてのJDBCコールの後、強制的にコネクションをリリースするために <literal>after_statement</literal> を 使ってください。 非JTAコネクションの場合、各トランザクションが終了したときに <literal>after_transaction</literal> を使い、コネクションをリリースしてください。 <literal>auto</literal> にすると、 JTAやCMTトランザクションの場合、 <literal>after_statement</literal> でクローズし、 JDBCトランザクションの場合、 <literal>after_transaction</literal> でクローズします。" +#. Tag: entry +#: configuration.xml:670 +#, fuzzy, no-c-format +msgid "" +"Specify when Hibernate should release JDBC connections. By default, a JDBC " +"connection is held until the session is explicitly closed or disconnected. " +"For an application server JTA datasource, you should use " +"<literal>after_statement</literal> to aggressively release connections after " +"every JDBC call. For a non-JTA connection, it often makes sense to release " +"the connection at the end of each transaction, by using " +"<literal>after_transaction</literal>. <literal>auto</literal> will choose " +"<literal>after_statement</literal> for the JTA and CMT transaction " +"strategies and <literal>after_transaction</literal> for the JDBC transaction " +"strategy." +msgstr "" +"HibernateがJDBCコネクションをリリースするかを指定します。デフォルトでは セッ" +"ションが明示的にクローズまたは切断されてもコネクションは保持します。 アプリ" +"ケーションサーバのJTAデータソースの場合、 すべてのJDBCコールの後、強制的にコ" +"ネクションをリリースするために <placeholder-1/> を 使ってください。 非JTAコネ" +"クションの場合、各トランザクションが終了したときに <placeholder-2/> を使い、" +"コネクションをリリースしてください。 <placeholder-3/> にすると、 JTAやCMTトラ" +"ンザクションの場合、 <placeholder-4/> でクローズし、 JDBCトランザクションの場" +"合、 <placeholder-5/> でクローズします。 <placeholder-6/><placeholder-7/>" -#: index.docbook:681 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>auto</literal> (default) | <literal>on_close</literal> | <literal>after_transaction</literal> | <literal>after_statement</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>auto</literal> (default) | <literal>on_close</literal> | <literal>after_transaction</literal> | <literal>after_statement</literal>" +#. Tag: para +#: configuration.xml:681 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>auto</literal> (default) | " +"<literal>on_close</literal> | <literal>after_transaction</literal> | " +"<literal>after_statement</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>auto</literal> (default) | " +"<literal>on_close</literal> | <literal>after_transaction</literal> | " +"<literal>after_statement</literal>" -#: index.docbook:686 -msgid "Note that this setting only affects <literal>Session</literal>s returned from <literal>SessionFactory.openSession</literal>. For <literal>Session</literal>s obtained through <literal>SessionFactory.getCurrentSession</literal>, the <literal>CurrentSessionContext</literal> implementation configured for use controls the connection release mode for those <literal>Session</literal>s. See" -msgstr "注意してください。この設定は <literal>SessionFactory.openSession</literal> から 取得した <literal>Session</literal> だけに効果があります。 <literal>SessionFactory.getCurrentSession</literal> を通じて取得した <literal>Session</literal> では、<literal>CurrentSessionContext</literal> の実装によって、コネクションのリリースモードを設定します。 <xref linkend=\"architecture-current-session\"/> を参照してください。" +#. Tag: para +#: configuration.xml:686 +#, fuzzy, no-c-format +msgid "" +"Note that this setting only affects <literal>Session</literal>s returned " +"from <literal>SessionFactory.openSession</literal>. For <literal>Session</" +"literal>s obtained through <literal>SessionFactory.getCurrentSession</" +"literal>, the <literal>CurrentSessionContext</literal> implementation " +"configured for use controls the connection release mode for those " +"<literal>Session</literal>s. See" +msgstr "" +"注意してください。この設定は <literal>SessionFactory.openSession</literal> か" +"ら 取得した <literal>Session</literal> だけに効果があります。 " +"<literal>SessionFactory.getCurrentSession</literal> を通じて取得した " +"<literal>Session</literal> では、<literal>CurrentSessionContext</literal> の" +"実装によって、コネクションのリリースモードを設定します。 <xref linkend=" +"\"architecture-current-session\"/> を参照してください。" -#: index.docbook:698 -msgid "hibernate.connection.<emphasis>&lt;propertyName&gt;</emphasis>" -msgstr "hibernate.connection.<emphasis>&lt;propertyName&gt;</emphasis>" +#. Tag: entry +#: configuration.xml:697 +#, no-c-format +msgid "" +"<literal>hibernate.connection.</literal><emphasis>&lt;propertyName&gt;</" +"emphasis>" +msgstr "" -#: index.docbook:700 -msgid "Pass the JDBC property <literal>propertyName</literal> to <literal>DriverManager.getConnection()</literal>." -msgstr "JDBCの <literal>propertyName</literal> プロパティを、 <literal>DriverManager.getConnection()</literal> に渡します。" +#. Tag: entry +#: configuration.xml:700 +#, no-c-format +msgid "" +"Pass the JDBC property <emphasis>&lt;propertyName&gt;</emphasis> to " +"<literal>DriverManager.getConnection()</literal>." +msgstr "" -#: index.docbook:707 -msgid "hibernate.jndi.<emphasis>&lt;propertyName&gt;</emphasis>" -msgstr "hibernate.jndi.<emphasis>&lt;propertyName&gt;</emphasis>" +#. Tag: entry +#: configuration.xml:706 +#, no-c-format +msgid "" +"<literal>hibernate.jndi.</literal><emphasis>&lt;propertyName&gt;</emphasis>" +msgstr "" -#: index.docbook:709 -msgid "Pass the property <literal>propertyName</literal> to the JNDI <literal>InitialContextFactory</literal>." -msgstr "<literal>propertyName</literal> プロパティを、 JNDI <literal>InitialContextFactory</literal> に渡します。" +#. Tag: entry +#: configuration.xml:709 +#, no-c-format +msgid "" +"Pass the property <emphasis>&lt;propertyName&gt;</emphasis> to the JNDI " +"<literal>InitialContextFactory</literal>." +msgstr "" -#: index.docbook:719 +#. Tag: title +#: configuration.xml:719 +#, no-c-format msgid "Hibernate Cache Properties" msgstr "Hibernate キャッシュプロパティ" -#: index.docbook:732 +#. Tag: literal +#: configuration.xml:732 +#, no-c-format msgid "hibernate.cache.provider_class" msgstr "hibernate.cache.provider_class" -#: index.docbook:734 +#. Tag: entry +#: configuration.xml:734 +#, fuzzy, no-c-format msgid "The classname of a custom <literal>CacheProvider</literal>." -msgstr "カスタム <literal>CacheProvider</literal> のクラス名です。" +msgstr "カスタム <placeholder-1/> のクラス名です。 <placeholder-2/>" -#: index.docbook:736 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.CacheProvider</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.CacheProvider</literal>" +#. Tag: para +#: configuration.xml:736 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"CacheProvider</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:744 +#. Tag: literal +#: configuration.xml:744 +#, no-c-format msgid "hibernate.cache.use_minimal_puts" msgstr "hibernate.cache.use_minimal_puts" -#: index.docbook:746 -msgid "Optimize second-level cache operation to minimize writes, at the cost of more frequent reads. This setting is most useful for clustered caches and, in Hibernate3, is enabled by default for clustered cache implementations." -msgstr "書き込みを最小限にするために、二次キャッシュの操作を最適化します。 その代わりに、読み込みがより頻繁に発生するようになります。 このセッティングはクラスタキャッシュで役に立ちます。 Hibernate3ではクラスタキャッシュ実装用にデフォルトでは有効になっています。" +#. Tag: entry +#: configuration.xml:746 +#, fuzzy, no-c-format +msgid "" +"Optimize second-level cache operation to minimize writes, at the cost of " +"more frequent reads. This setting is most useful for clustered caches and, " +"in Hibernate3, is enabled by default for clustered cache implementations." +msgstr "" +"書き込みを最小限にするために、二次キャッシュの操作を最適化します。 その代わり" +"に、読み込みがより頻繁に発生するようになります。 このセッティングはクラスタ" +"キャッシュで役に立ちます。 Hibernate3ではクラスタキャッシュ実装用にデフォルト" +"では有効になっています。 <placeholder-1/>" -#: index.docbook:759 +#. Tag: literal +#: configuration.xml:759 +#, no-c-format msgid "hibernate.cache.use_query_cache" msgstr "hibernate.cache.use_query_cache" -#: index.docbook:761 -msgid "Enable the query cache, individual queries still have to be set cachable." -msgstr "特定のクエリがキャッシュ可能な場合に、クエリキャッシュを有効にします。" +#. Tag: entry +#: configuration.xml:761 +#, fuzzy, no-c-format +msgid "" +"Enable the query cache, individual queries still have to be set cachable." +msgstr "" +"特定のクエリがキャッシュ可能な場合に、クエリキャッシュを有効にします。 " +"<placeholder-1/>" -#: index.docbook:771 +#. Tag: literal +#: configuration.xml:771 +#, no-c-format msgid "hibernate.cache.use_second_level_cache" msgstr "hibernate.cache.use_second_level_cache" -#: index.docbook:773 -msgid "May be used to completely disable the second level cache, which is enabled by default for classes which specify a <literal>&lt;cache&gt;</literal> mapping." -msgstr "二次キャッシュを完全に無効にする場合に使います。 デフォルトでは有効で、クラスの <literal>&lt;cache&gt;</literal> マッピング で制御します。" +#. Tag: entry +#: configuration.xml:773 +#, fuzzy, no-c-format +msgid "" +"May be used to completely disable the second level cache, which is enabled " +"by default for classes which specify a <literal>&lt;cache&gt;</literal> " +"mapping." +msgstr "" +"二次キャッシュを完全に無効にする場合に使います。 デフォルトでは有効で、クラス" +"の <placeholder-1/> マッピング で制御します。 <placeholder-2/>" -#: index.docbook:785 +#. Tag: literal +#: configuration.xml:785 +#, no-c-format msgid "hibernate.cache.query_cache_factory" msgstr "hibernate.cache.query_cache_factory" -#: index.docbook:787 -msgid "The classname of a custom <literal>QueryCache</literal> interface, defaults to the built-in <literal>StandardQueryCache</literal>." -msgstr "カスタム <literal>QueryCache</literal> インターフェイスのクラス名を 指定します。デフォルトでは <literal>StandardQueryCache</literal> になります。" +#. Tag: entry +#: configuration.xml:787 +#, fuzzy, no-c-format +msgid "" +"The classname of a custom <literal>QueryCache</literal> interface, defaults " +"to the built-in <literal>StandardQueryCache</literal>." +msgstr "" +"カスタム <placeholder-1/> インターフェイスのクラス名を 指定します。デフォルト" +"では <placeholder-2/> になります。 <placeholder-3/>" -#: index.docbook:790 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.QueryCache</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.QueryCache</literal>" +#. Tag: para +#: configuration.xml:790 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.QueryCache</" +"literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:798 +#. Tag: literal +#: configuration.xml:798 +#, no-c-format msgid "hibernate.cache.region_prefix" msgstr "hibernate.cache.region_prefix" -#: index.docbook:800 +#. Tag: entry +#: configuration.xml:800 +#, fuzzy, no-c-format msgid "A prefix to use for second-level cache region names." -msgstr "二次キャッシュの領域名の接頭辞です。" +msgstr "二次キャッシュの領域名の接頭辞です。 <placeholder-1/>" -#: index.docbook:802 +#. Tag: para +#: configuration.xml:802 +#, fuzzy, no-c-format msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>prefix</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>prefix</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:810 +#. Tag: literal +#: configuration.xml:810 +#, no-c-format msgid "hibernate.cache.use_structured_entries" msgstr "hibernate.cache.use_structured_entries" -#: index.docbook:812 -msgid "Forces Hibernate to store data in the second-level cache in a more human-friendly format." -msgstr "二次キャッシュに格納するデータを、人が理解しやすいフォーマットにします。" +#. Tag: entry +#: configuration.xml:812 +#, fuzzy, no-c-format +msgid "" +"Forces Hibernate to store data in the second-level cache in a more human-" +"friendly format." +msgstr "" +"二次キャッシュに格納するデータを、人が理解しやすいフォーマットにします。 " +"<placeholder-1/>" -#: index.docbook:826 +#. Tag: title +#: configuration.xml:826 +#, no-c-format msgid "Hibernate Transaction Properties" msgstr "Hibernate トランザクションプロパティ" -#: index.docbook:839 +#. Tag: literal +#: configuration.xml:839 +#, no-c-format msgid "hibernate.transaction.factory_class" msgstr "hibernate.transaction.factory_class" -#: index.docbook:841 -msgid "The classname of a <literal>TransactionFactory</literal> to use with Hibernate <literal>Transaction</literal> API (defaults to <literal>JDBCTransactionFactory</literal>)." -msgstr "Hibernate <literal>Transaction</literal> APIと一緒に使われる <literal>TransactionFactory</literal> のクラス名です。 （デフォルトでは <literal>JDBCTransactionFactory</literal> です）。" +#. Tag: entry +#: configuration.xml:841 +#, fuzzy, no-c-format +msgid "" +"The classname of a <literal>TransactionFactory</literal> to use with " +"Hibernate <literal>Transaction</literal> API (defaults to " +"<literal>JDBCTransactionFactory</literal>)." +msgstr "" +"Hibernate <placeholder-1/> APIと一緒に使われる <placeholder-2/> のクラス名で" +"す。 （デフォルトでは <placeholder-3/> です）。 <placeholder-4/>" -#: index.docbook:845 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.TransactionFactory</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.TransactionFactory</literal>" +#. Tag: para +#: configuration.xml:845 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"TransactionFactory</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:853 +#. Tag: literal +#: configuration.xml:853 +#, no-c-format msgid "jta.UserTransaction" msgstr "jta.UserTransaction" -#: index.docbook:855 -msgid "A JNDI name used by <literal>JTATransactionFactory</literal> to obtain the JTA <literal>UserTransaction</literal> from the application server." -msgstr "アプリケーションサーバからJTA <literal>UserTransaction</literal> を取得するために <literal>JTATransactionFactory</literal> に使われるJNDI名です。" +#. Tag: entry +#: configuration.xml:855 +#, fuzzy, no-c-format +msgid "" +"A JNDI name used by <literal>JTATransactionFactory</literal> to obtain the " +"JTA <literal>UserTransaction</literal> from the application server." +msgstr "" +"アプリケーションサーバからJTA <placeholder-1/> を取得するために <placeholder-" +"2/> に使われるJNDI名です。 <placeholder-3/>" -#: index.docbook:867 +#. Tag: literal +#: configuration.xml:867 +#, no-c-format msgid "hibernate.transaction.manager_lookup_class" msgstr "hibernate.transaction.manager_lookup_class" -#: index.docbook:869 -msgid "The classname of a <literal>TransactionManagerLookup</literal> - required when JVM-level caching is enabled or when using hilo generator in a JTA environment." -msgstr "<literal>TransactionManagerLookup</literal> のクラス名です。 JTA環境において、JVMレベルのキャッシュを有効にするために必要です。" +#. Tag: entry +#: configuration.xml:869 +#, fuzzy, no-c-format +msgid "" +"The classname of a <literal>TransactionManagerLookup</literal> - required " +"when JVM-level caching is enabled or when using hilo generator in a JTA " +"environment." +msgstr "" +"<placeholder-1/> のクラス名です。 JTA環境において、JVMレベルのキャッシュを有" +"効にするために必要です。 <placeholder-2/>" -#: index.docbook:873 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of.TransactionManagerLookup</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>classname.of.TransactionManagerLookup</literal>" +#. Tag: para +#: configuration.xml:873 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>classname.of." +"TransactionManagerLookup</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:881 +#. Tag: literal +#: configuration.xml:881 +#, no-c-format msgid "hibernate.transaction.flush_before_completion" msgstr "hibernate.transaction.flush_before_completion" -#: index.docbook:883 -msgid "If enabled, the session will be automatically flushed during the before completion phase of the transaction. Built-in and automatic session context management is preferred, see <xref linkend=\"architecture-current-session\"/>." -msgstr "有効の場合、トランザクションのcompletionフェーズの前に自動的に セッションをフラッシュします。内臓の自動セッションコンテキスト管理に適しています。 <xref linkend=\"architecture-current-session\"/>を参照してください。" +#. Tag: entry +#: configuration.xml:883 +#, fuzzy, no-c-format +msgid "" +"If enabled, the session will be automatically flushed during the before " +"completion phase of the transaction. Built-in and automatic session context " +"management is preferred, see <xref linkend=\"architecture-current-session\"/" +">." +msgstr "" +"有効の場合、トランザクションのcompletionフェーズの前に自動的に セッションをフ" +"ラッシュします。内臓の自動セッションコンテキスト管理に適しています。 <xref " +"linkend=\"architecture-current-session\"/>を参照してください。 <placeholder-" +"1/>" -#: index.docbook:896 +#. Tag: literal +#: configuration.xml:896 +#, no-c-format msgid "hibernate.transaction.auto_close_session" msgstr "hibernate.transaction.auto_close_session" -#: index.docbook:898 -msgid "If enabled, the session will be automatically closed during the after completion phase of the transaction. Built-in and utomatic session context management is preferred, see <xref linkend=\"architecture-current-session\"/>." -msgstr "有効の場合、トランザクションのcompletionフェーズの後に セッションを自動的にクローズします。内臓の自動セッションコンテキスト管理に適しています。 <xref linkend=\"architecture-current-session\"/>を参照してください。" +#. Tag: entry +#: configuration.xml:898 +#, fuzzy, no-c-format +msgid "" +"If enabled, the session will be automatically closed during the after " +"completion phase of the transaction. Built-in and utomatic session context " +"management is preferred, see <xref linkend=\"architecture-current-session\"/" +">." +msgstr "" +"有効の場合、トランザクションのcompletionフェーズの後に セッションを自動的にク" +"ローズします。内臓の自動セッションコンテキスト管理に適しています。 <xref " +"linkend=\"architecture-current-session\"/>を参照してください。 <placeholder-" +"1/>" -#: index.docbook:914 +#. Tag: title +#: configuration.xml:914 +#, no-c-format msgid "Miscellaneous Properties" msgstr "その他のプロパティ" -#: index.docbook:927 +#. Tag: literal +#: configuration.xml:927 +#, no-c-format msgid "hibernate.current_session_context_class" msgstr "hibernate.current_session_context_class" -#: index.docbook:929 -msgid "Supply a (custom) strategy for the scoping of the \"current\" <literal>Session</literal>. See <xref linkend=\"architecture-current-session\"/> for more information about the built-in strategies." -msgstr "「現在の」<literal>Session</literal> のための（カスタム）戦略を提供します。 ビルトインストラテジーに関するその他の情報については <xref linkend=\"architecture-current-session\"/>を参照してください。" +#. Tag: entry +#: configuration.xml:929 +#, fuzzy, no-c-format +msgid "" +"Supply a (custom) strategy for the scoping of the \"current\" " +"<literal>Session</literal>. See <xref linkend=\"architecture-current-session" +"\"/> for more information about the built-in strategies." +msgstr "" +"「現在の」<placeholder-1/> のための（カスタム）戦略を提供します。 ビルトイン" +"ストラテジーに関するその他の情報については <xref linkend=\"architecture-" +"current-session\"/>を参照してください。 <placeholder-2/>" -#: index.docbook:934 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>jta</literal> | <literal>thread</literal> | <literal>managed</literal> | <literal>custom.Class</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>jta</literal> | <literal>thread</literal> | <literal>managed</literal> | <literal>custom.Class</literal>" +#. Tag: para +#: configuration.xml:934 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>jta</literal> | " +"<literal>thread</literal> | <literal>managed</literal> | <literal>custom." +"Class</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>jta</literal> | " +"<literal>thread</literal> | <literal>managed</literal> | <literal>custom." +"Class</literal>" -#: index.docbook:943 +#. Tag: literal +#: configuration.xml:943 +#, no-c-format msgid "hibernate.query.factory_class" msgstr "hibernate.query.factory_class" -#: index.docbook:945 +#. Tag: entry +#: configuration.xml:945 +#, fuzzy, no-c-format msgid "Chooses the HQL parser implementation." -msgstr "HQLパーサーの実装を選択します。" +msgstr "HQLパーサーの実装を選択します。 <placeholder-1/>" -#: index.docbook:947 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic.ClassicQueryTranslatorFactory</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>org.hibernate.hql.ast.ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic.ClassicQueryTranslatorFactory</literal>" +#. Tag: para +#: configuration.xml:947 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>org.hibernate.hql.ast." +"ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic." +"ClassicQueryTranslatorFactory</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>org.hibernate.hql.ast." +"ASTQueryTranslatorFactory</literal> or <literal>org.hibernate.hql.classic." +"ClassicQueryTranslatorFactory</literal>" -#: index.docbook:956 +#. Tag: literal +#: configuration.xml:956 +#, no-c-format msgid "hibernate.query.substitutions" msgstr "hibernate.query.substitutions" -#: index.docbook:958 -msgid "Mapping from tokens in Hibernate queries to SQL tokens (tokens might be function or literal names, for example)." -msgstr "HQLとSQLのトークンをマッピングします。 （例えば、トークンは関数やリテラル名です）。" +#. Tag: entry +#: configuration.xml:958 +#, fuzzy, no-c-format +msgid "" +"Mapping from tokens in Hibernate queries to SQL tokens (tokens might be " +"function or literal names, for example)." +msgstr "" +"HQLとSQLのトークンをマッピングします。 （例えば、トークンは関数やリテラル名で" +"す）。 <placeholder-1/>" -#: index.docbook:961 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC</literal>" +#. Tag: para +#: configuration.xml:961 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>hqlLiteral=SQL_LITERAL, " +"hqlFunction=SQLFUNC</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>true</literal> | " +"<literal>false</literal>" -#: index.docbook:969 +#. Tag: literal +#: configuration.xml:969 +#, no-c-format msgid "hibernate.hbm2ddl.auto" msgstr "hibernate.hbm2ddl.auto" -#: index.docbook:971 -msgid "Automatically validate or export schema DDL to the database when the <literal>SessionFactory</literal> is created. With <literal>create-drop</literal>, the database schema will be dropped when the <literal>SessionFactory</literal> is closed explicitly." -msgstr "<literal>SessionFactory</literal> を生成したときに、 自動的にスキーマDDLをDBに出力します。 <literal>create-drop</literal> の場合、 <literal>SessionFactory</literal> を クローズしたときに、データベーススキーマをドロップします。" +#. Tag: entry +#: configuration.xml:971 +#, fuzzy, no-c-format +msgid "" +"Automatically validate or export schema DDL to the database when the " +"<literal>SessionFactory</literal> is created. With <literal>create-drop</" +"literal>, the database schema will be dropped when the " +"<literal>SessionFactory</literal> is closed explicitly." +msgstr "" +"<placeholder-1/> を生成したときに、 自動的にスキーマDDLをDBに出力します。 " +"<placeholder-2/> の場合、 <placeholder-3/> を クローズしたときに、データベー" +"ススキーマをドロップします。 <placeholder-4/>" -#: index.docbook:977 -msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>validate</literal> | <literal>update</literal> | <literal>create</literal> | <literal>create-drop</literal>" -msgstr "<emphasis role=\"strong\">例：</emphasis> <literal>validate</literal> | <literal>update</literal> | <literal>create</literal> | <literal>create-drop</literal>" +#. Tag: para +#: configuration.xml:977 +#, fuzzy, no-c-format +msgid "" +"<emphasis role=\"strong\">eg.</emphasis> <literal>validate</literal> | " +"<literal>update</literal> | <literal>create</literal> | <literal>create-" +"drop</literal>" +msgstr "" +"<emphasis role=\"strong\">例：</emphasis><literal>validate</literal> | " +"<literal>update</literal> | <literal>create</literal> | <literal>create-" +"drop</literal>" -#: index.docbook:986 +#. Tag: literal +#: configuration.xml:986 +#, no-c-format msgid "hibernate.cglib.use_reflection_optimizer" msgstr "hibernate.cglib.use_reflection_optimizer" -#: index.docbook:988 -msgid "Enables use of CGLIB instead of runtime reflection (System-level property). Reflection can sometimes be useful when troubleshooting, note that Hibernate always requires CGLIB even if you turn off the optimizer. You can not set this property in <literal>hibernate.cfg.xml</literal>." -msgstr "実行時リフレクションの代わりのCGLIBの使用を有効にします （システムレベルのプロパティ） リフレクションはトラブルシューティングのときに役立つことがあります。 オプティマイザをオフにしているときでさえ、 Hibernateには必ずCGLIBが必要なことに注意してください。 このプロパティは <literal>hibernate.cfg.xml</literal> で設定できません。" +#. Tag: entry +#: configuration.xml:988 +#, fuzzy, no-c-format +msgid "" +"Enables use of CGLIB instead of runtime reflection (System-level property). " +"Reflection can sometimes be useful when troubleshooting, note that Hibernate " +"always requires CGLIB even if you turn off the optimizer. You can not set " +"this property in <literal>hibernate.cfg.xml</literal>." +msgstr "" +"実行時リフレクションの代わりのCGLIBの使用を有効にします （システムレベルのプ" +"ロパティ） リフレクションはトラブルシューティングのときに役立つことがありま" +"す。 オプティマイザをオフにしているときでさえ、 Hibernateには必ずCGLIBが必要" +"なことに注意してください。 このプロパティは <placeholder-1/> で設定できませ" +"ん。 <placeholder-2/>" -#: index.docbook:1004 +#. Tag: title +#: configuration.xml:1004 +#, no-c-format msgid "SQL Dialects" msgstr "SQL 方言（Dialect）" -#: index.docbook:1006 -msgid "You should always set the <literal>hibernate.dialect</literal> property to the correct <literal>org.hibernate.dialect.Dialect</literal> subclass for your database. If you specify a dialect, Hibernate will use sensible defaults for some of the other properties listed above, saving you the effort of specifying them manually." -msgstr "<literal>hibernate.dialect</literal> プロパティには、 使用するデータベースの正しい <literal>org.hibernate.dialect.Dialect</literal> のサブクラスを、 必ず指定すべきです。 しかし方言を指定すれば、Hibernateは上述したプロパティのいくつかについて、 より適切なデフォルト値を使います。 そうすれば、それらを手作業で設定する手間が省けます。" +#. Tag: para +#: configuration.xml:1006 +#, no-c-format +msgid "" +"You should always set the <literal>hibernate.dialect</literal> property to " +"the correct <literal>org.hibernate.dialect.Dialect</literal> subclass for " +"your database. If you specify a dialect, Hibernate will use sensible " +"defaults for some of the other properties listed above, saving you the " +"effort of specifying them manually." +msgstr "" +"<literal>hibernate.dialect</literal> プロパティには、 使用するデータベースの" +"正しい <literal>org.hibernate.dialect.Dialect</literal> のサブクラスを、 必ず" +"指定すべきです。 しかし方言を指定すれば、Hibernateは上述したプロパティのいく" +"つかについて、 より適切なデフォルト値を使います。 そうすれば、それらを手作業" +"で設定する手間が省けます。" -#: index.docbook:1014 +#. Tag: title +#: configuration.xml:1014 +#, no-c-format msgid "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)" msgstr "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)" -#: index.docbook:1022 +#. Tag: entry +#: configuration.xml:1022 +#, no-c-format msgid "RDBMS" msgstr "RDBMS" -#: index.docbook:1023 +#. Tag: entry +#: configuration.xml:1023 +#, no-c-format msgid "Dialect" msgstr "Dialect" -#: index.docbook:1028 +#. Tag: entry +#: configuration.xml:1028 +#, no-c-format msgid "<entry>DB2</entry>" -msgstr "<entry>DB2</entry>" +msgstr "" -#: index.docbook:1028 +#. Tag: literal +#: configuration.xml:1028 +#, no-c-format msgid "org.hibernate.dialect.DB2Dialect" msgstr "org.hibernate.dialect.DB2Dialect" -#: index.docbook:1031 +#. Tag: entry +#: configuration.xml:1031 +#, no-c-format msgid "DB2 AS/400" msgstr "DB2 AS/400" -#: index.docbook:1031 +#. Tag: literal +#: configuration.xml:1031 +#, no-c-format msgid "org.hibernate.dialect.DB2400Dialect" msgstr "org.hibernate.dialect.DB2400Dialect" -#: index.docbook:1034 +#. Tag: entry +#: configuration.xml:1034 +#, no-c-format msgid "DB2 OS390" msgstr "DB2 OS390" -#: index.docbook:1034 +#. Tag: literal +#: configuration.xml:1034 +#, no-c-format msgid "org.hibernate.dialect.DB2390Dialect" msgstr "org.hibernate.dialect.DB2390Dialect" -#: index.docbook:1037 +#. Tag: entry +#: configuration.xml:1037 +#, no-c-format msgid "PostgreSQL" msgstr "PostgreSQL" -#: index.docbook:1037 +#. Tag: literal +#: configuration.xml:1037 +#, no-c-format msgid "org.hibernate.dialect.PostgreSQLDialect" msgstr "org.hibernate.dialect.PostgreSQLDialect" -#: index.docbook:1040 +#. Tag: entry +#: configuration.xml:1040 +#, no-c-format msgid "MySQL" msgstr "MySQL" -#: index.docbook:1040 +#. Tag: literal +#: configuration.xml:1040 +#, no-c-format msgid "org.hibernate.dialect.MySQLDialect" msgstr "org.hibernate.dialect.MySQLDialect" -#: index.docbook:1043 +#. Tag: entry +#: configuration.xml:1043 +#, no-c-format msgid "MySQL with InnoDB" msgstr "MySQL with InnoDB" -#: index.docbook:1043 +#. Tag: literal +#: configuration.xml:1043 +#, no-c-format msgid "org.hibernate.dialect.MySQLInnoDBDialect" msgstr "org.hibernate.dialect.MySQLInnoDBDialect" -#: index.docbook:1046 +#. Tag: entry +#: configuration.xml:1046 +#, no-c-format msgid "MySQL with MyISAM" msgstr "MySQL with MyISAM" -#: index.docbook:1046 +#. Tag: literal +#: configuration.xml:1046 +#, no-c-format msgid "org.hibernate.dialect.MySQLMyISAMDialect" msgstr "org.hibernate.dialect.MySQLMyISAMDialect" -#: index.docbook:1049 +#. Tag: entry +#: configuration.xml:1049 +#, no-c-format msgid "Oracle (any version)" msgstr "Oracle (any version)" -#: index.docbook:1049 +#. Tag: literal +#: configuration.xml:1049 +#, no-c-format msgid "org.hibernate.dialect.OracleDialect" msgstr "org.hibernate.dialect.OracleDialect" -#: index.docbook:1052 +#. Tag: entry +#: configuration.xml:1052 +#, no-c-format msgid "Oracle 9i/10g" msgstr "Oracle 9i/10g" -#: index.docbook:1052 +#. Tag: literal +#: configuration.xml:1052 +#, no-c-format msgid "org.hibernate.dialect.Oracle9Dialect" msgstr "org.hibernate.dialect.Oracle9Dialect" -#: index.docbook:1055 +#. Tag: entry +#: configuration.xml:1055 +#, no-c-format msgid "Sybase" msgstr "Sybase" -#: index.docbook:1055 +#. Tag: literal +#: configuration.xml:1055 +#, no-c-format msgid "org.hibernate.dialect.SybaseDialect" msgstr "org.hibernate.dialect.SybaseDialect" -#: index.docbook:1058 +#. Tag: entry +#: configuration.xml:1058 +#, no-c-format msgid "Sybase Anywhere" msgstr "Sybase Anywhere" -#: index.docbook:1058 +#. Tag: literal +#: configuration.xml:1058 +#, no-c-format msgid "org.hibernate.dialect.SybaseAnywhereDialect" msgstr "org.hibernate.dialect.SybaseAnywhereDialect" -#: index.docbook:1061 +#. Tag: entry +#: configuration.xml:1061 +#, no-c-format msgid "Microsoft SQL Server" msgstr "Microsoft SQL Server" -#: index.docbook:1061 +#. Tag: literal +#: configuration.xml:1061 +#, no-c-format msgid "org.hibernate.dialect.SQLServerDialect" msgstr "org.hibernate.dialect.SQLServerDialect" -#: index.docbook:1064 +#. Tag: entry +#: configuration.xml:1064 +#, no-c-format msgid "SAP DB" msgstr "SAP DB" -#: index.docbook:1064 +#. Tag: literal +#: configuration.xml:1064 +#, no-c-format msgid "org.hibernate.dialect.SAPDBDialect" msgstr "org.hibernate.dialect.SAPDBDialect" -#: index.docbook:1067 +#. Tag: entry +#: configuration.xml:1067 +#, no-c-format msgid "Informix" msgstr "Informix" -#: index.docbook:1067 +#. Tag: literal +#: configuration.xml:1067 +#, no-c-format msgid "org.hibernate.dialect.InformixDialect" msgstr "org.hibernate.dialect.InformixDialect" -#: index.docbook:1070 +#. Tag: entry +#: configuration.xml:1070 +#, no-c-format msgid "HypersonicSQL" msgstr "HypersonicSQL" -#: index.docbook:1070 +#. Tag: literal +#: configuration.xml:1070 +#, no-c-format msgid "org.hibernate.dialect.HSQLDialect" msgstr "org.hibernate.dialect.HSQLDialect" -#: index.docbook:1073 +#. Tag: entry +#: configuration.xml:1073 +#, no-c-format msgid "Ingres" msgstr "Ingres" -#: index.docbook:1073 +#. Tag: literal +#: configuration.xml:1073 +#, no-c-format msgid "org.hibernate.dialect.IngresDialect" msgstr "org.hibernate.dialect.IngresDialect" -#: index.docbook:1076 +#. Tag: entry +#: configuration.xml:1076 +#, no-c-format msgid "Progress" msgstr "Progress" -#: index.docbook:1076 +#. Tag: literal +#: configuration.xml:1076 +#, no-c-format msgid "org.hibernate.dialect.ProgressDialect" msgstr "org.hibernate.dialect.ProgressDialect" -#: index.docbook:1079 +#. Tag: entry +#: configuration.xml:1079 +#, no-c-format msgid "Mckoi SQL" msgstr "Mckoi SQL" -#: index.docbook:1079 +#. Tag: literal +#: configuration.xml:1079 +#, no-c-format msgid "org.hibernate.dialect.MckoiDialect" msgstr "org.hibernate.dialect.MckoiDialect" -#: index.docbook:1082 +#. Tag: entry +#: configuration.xml:1082 +#, no-c-format msgid "Interbase" msgstr "Interbase" -#: index.docbook:1082 +#. Tag: literal +#: configuration.xml:1082 +#, no-c-format msgid "org.hibernate.dialect.InterbaseDialect" msgstr "org.hibernate.dialect.InterbaseDialect" -#: index.docbook:1085 +#. Tag: entry +#: configuration.xml:1085 +#, no-c-format msgid "Pointbase" msgstr "Pointbase" -#: index.docbook:1085 +#. Tag: literal +#: configuration.xml:1085 +#, no-c-format msgid "org.hibernate.dialect.PointbaseDialect" msgstr "org.hibernate.dialect.PointbaseDialect" -#: index.docbook:1088 +#. Tag: entry +#: configuration.xml:1088 +#, no-c-format msgid "FrontBase" msgstr "FrontBase" -#: index.docbook:1088 +#. Tag: literal +#: configuration.xml:1088 +#, no-c-format msgid "org.hibernate.dialect.FrontbaseDialect" msgstr "org.hibernate.dialect.FrontbaseDialect" -#: index.docbook:1091 +#. Tag: entry +#: configuration.xml:1091 +#, no-c-format msgid "Firebird" msgstr "Firebird" -#: index.docbook:1091 +#. Tag: literal +#: configuration.xml:1091 +#, no-c-format msgid "org.hibernate.dialect.FirebirdDialect" msgstr "org.hibernate.dialect.FirebirdDialect" -#: index.docbook:1100 +#. Tag: title +#: configuration.xml:1100 +#, no-c-format msgid "Outer Join Fetching" msgstr "外部結合フェッチ" -#: index.docbook:1102 -msgid "If your database supports ANSI, Oracle or Sybase style outer joins, <emphasis>outer join fetching</emphasis> will often increase performance by limiting the number of round trips to and from the database (at the cost of possibly more work performed by the database itself). Outer join fetching allows a whole graph of objects connected by many-to-one, one-to-many, many-to-many and one-to-one associations to be retrieved in a single SQL <literal>SELECT</literal>." -msgstr "もしDBがANSIか、OracleかSybaseスタイルの外部結合をサポートしている場合、 <emphasis>outer join fetching</emphasis> は、DBのSQL発行回数を節約し パフォーマンスを良くします。（DB内でより多くの処理コストが発生します） 外部結合フェッチは、多対一、一対多、多対多、一対一のオブジェクト関連で グループオブジェクトを1つのSQLで <literal>SELECT</literal> します。" +#. Tag: para +#: configuration.xml:1102 +#, no-c-format +msgid "" +"If your database supports ANSI, Oracle or Sybase style outer joins, " +"<emphasis>outer join fetching</emphasis> will often increase performance by " +"limiting the number of round trips to and from the database (at the cost of " +"possibly more work performed by the database itself). Outer join fetching " +"allows a whole graph of objects connected by many-to-one, one-to-many, many-" +"to-many and one-to-one associations to be retrieved in a single SQL " +"<literal>SELECT</literal>." +msgstr "" +"もしDBがANSIか、OracleかSybaseスタイルの外部結合をサポートしている場合、 " +"<emphasis>outer join fetching</emphasis> は、DBのSQL発行回数を節約し パフォー" +"マンスを良くします。（DB内でより多くの処理コストが発生します） 外部結合フェッ" +"チは、多対一、一対多、多対多、一対一のオブジェクト関連で グループオブジェクト" +"を1つのSQLで <literal>SELECT</literal> します。" -#: index.docbook:1111 -msgid "Outer join fetching may be disabled <emphasis>globally</emphasis> by setting the property <literal>hibernate.max_fetch_depth</literal> to <literal>0</literal>. A setting of <literal>1</literal> or higher enables outer join fetching for one-to-one and many-to-one associations which have been mapped with <literal>fetch=\"join\"</literal>." -msgstr "<literal>hibernate.max_fetch_depth</literal> プロパティの値を <literal>0</literal> にすると Outer join fetchingを <emphasis>すべて</emphasis> 無効にすることになります。 <literal>1</literal> やそれ以上の値を設定すると、外部結合フェッチが有効になり、 一対一と多対一関連が <literal>fetch=\"join\"</literal> としてマッピングされます。" +#. Tag: para +#: configuration.xml:1111 +#, no-c-format +msgid "" +"Outer join fetching may be disabled <emphasis>globally</emphasis> by setting " +"the property <literal>hibernate.max_fetch_depth</literal> to <literal>0</" +"literal>. A setting of <literal>1</literal> or higher enables outer join " +"fetching for one-to-one and many-to-one associations which have been mapped " +"with <literal>fetch=\"join\"</literal>." +msgstr "" +"<literal>hibernate.max_fetch_depth</literal> プロパティの値を <literal>0</" +"literal> にすると Outer join fetchingを <emphasis>すべて</emphasis> 無効にす" +"ることになります。 <literal>1</literal> やそれ以上の値を設定すると、外部結合" +"フェッチが有効になり、 一対一と多対一関連が <literal>fetch=\"join\"</" +"literal> としてマッピングされます。" -#: index.docbook:1119 +#. Tag: para +#: configuration.xml:1119 +#, no-c-format msgid "See <xref linkend=\"performance-fetching\"/> for more information." msgstr "See <xref linkend=\"performance-fetching\"/> for more information." -#: index.docbook:1126 +#. Tag: title +#: configuration.xml:1126 +#, no-c-format msgid "Binary Streams" msgstr "バイナリストリーム" -#: index.docbook:1128 -msgid "Oracle limits the size of <literal>byte</literal> arrays that may be passed to/from its JDBC driver. If you wish to use large instances of <literal>binary</literal> or <literal>serializable</literal> type, you should enable <literal>hibernate.jdbc.use_streams_for_binary</literal>. <emphasis>This is a system-level setting only.</emphasis>" -msgstr "OracleはJDBCドライバとの間でやりとりされる <literal>byte</literal> 配列のサイズを制限します。 <literal>binary</literal> や <literal>serializable</literal> 型の大きなインスタンスを使いたければ、 <literal>hibernate.jdbc.use_streams_for_binary</literal> を有効にしてください。 ただし <emphasis>これはシステムレベルの設定だけです</emphasis> 。" +#. Tag: para +#: configuration.xml:1128 +#, no-c-format +msgid "" +"Oracle limits the size of <literal>byte</literal> arrays that may be passed " +"to/from its JDBC driver. If you wish to use large instances of " +"<literal>binary</literal> or <literal>serializable</literal> type, you " +"should enable <literal>hibernate.jdbc.use_streams_for_binary</literal>. " +"<emphasis>This is a system-level setting only.</emphasis>" +msgstr "" +"OracleはJDBCドライバとの間でやりとりされる <literal>byte</literal> 配列のサイ" +"ズを制限します。 <literal>binary</literal> や <literal>serializable</" +"literal> 型の大きなインスタンスを使いたければ、 <literal>hibernate.jdbc." +"use_streams_for_binary</literal> を有効にしてください。 ただし <emphasis>これ" +"はシステムレベルの設定だけです</emphasis> 。" -#: index.docbook:1139 +#. Tag: title +#: configuration.xml:1139 +#, no-c-format msgid "Second-level and query cache" msgstr "2次キャッシュとクエリーキャッシュ" -#: index.docbook:1141 -msgid "The properties prefixed by <literal>hibernate.cache</literal> allow you to use a process or cluster scoped second-level cache system with Hibernate. See the <xref linkend=\"performance-cache\"/> for more details." -msgstr "<literal>hibernate.cache</literal> プロパティ接頭辞は Hibernateでプロセスやクラスタ二次キャッシュを使うとことを許可します。 <xref linkend=\"performance-cache\"/>により多くの詳細があります。" +#. Tag: para +#: configuration.xml:1141 +#, no-c-format +msgid "" +"The properties prefixed by <literal>hibernate.cache</literal> allow you to " +"use a process or cluster scoped second-level cache system with Hibernate. " +"See the <xref linkend=\"performance-cache\"/> for more details." +msgstr "" +"<literal>hibernate.cache</literal> プロパティ接頭辞は Hibernateでプロセスやク" +"ラスタ二次キャッシュを使うとことを許可します。 <xref linkend=\"performance-" +"cache\"/>により多くの詳細があります。" -#: index.docbook:1151 +#. Tag: title +#: configuration.xml:1151 +#, no-c-format msgid "Query Language Substitution" msgstr "クエリー言語の置き換え" -#: index.docbook:1153 -msgid "You may define new Hibernate query tokens using <literal>hibernate.query.substitutions</literal>. For example:" -msgstr "<literal>hibernate.query.substitutions</literal> を使うことで、 新しいHibernateクエリトークンを定義できます。 例：" +#. Tag: para +#: configuration.xml:1153 +#, no-c-format +msgid "" +"You may define new Hibernate query tokens using <literal>hibernate.query." +"substitutions</literal>. For example:" +msgstr "" +"<literal>hibernate.query.substitutions</literal> を使うことで、 新しい" +"Hibernateクエリトークンを定義できます。 例：" -#: index.docbook:1158 +#. Tag: programlisting +#: configuration.xml:1158 +#, no-c-format msgid "hibernate.query.substitutions true=1, false=0" msgstr "hibernate.query.substitutions true=1, false=0" -#: index.docbook:1160 -msgid "would cause the tokens <literal>true</literal> and <literal>false</literal> to be translated to integer literals in the generated SQL." -msgstr "これはトークン <literal>true</literal> と <literal>false</literal> を、 生成されるSQLにおいて整数リテラルに翻訳します。" +#. Tag: para +#: configuration.xml:1160 +#, no-c-format +msgid "" +"would cause the tokens <literal>true</literal> and <literal>false</literal> " +"to be translated to integer literals in the generated SQL." +msgstr "" +"これはトークン <literal>true</literal> と <literal>false</literal> を、 生成" +"されるSQLにおいて整数リテラルに翻訳します。" -#: index.docbook:1165 +#. Tag: programlisting +#: configuration.xml:1165 +#, no-c-format msgid "hibernate.query.substitutions toLowercase=LOWER" msgstr "hibernate.query.substitutions toLowercase=LOWER" -#: index.docbook:1167 +#. Tag: para +#: configuration.xml:1167 +#, no-c-format msgid "would allow you to rename the SQL <literal>LOWER</literal> function." -msgstr "これはSQLの <literal>LOWER</literal> 関数の名前の付け替えを可能にします。" +msgstr "" +"これはSQLの <literal>LOWER</literal> 関数の名前の付け替えを可能にします。" -#: index.docbook:1174 +#. Tag: title +#: configuration.xml:1174 +#, no-c-format msgid "Hibernate statistics" msgstr "Hibernate 統計" -#: index.docbook:1176 -msgid "If you enable <literal>hibernate.generate_statistics</literal>, Hibernate will expose a number of metrics that are useful when tuning a running system via <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be configured to expose these statistics via JMX. Read the Javadoc of the interfaces in <literal>org.hibernate.stats</literal> for more information." -msgstr "<literal>hibernate.generate_statistics</literal> を有効にした場合、 動作しているシステムをチューニングするときに、<literal>SessionFactory.getStatistics()</literal> を経由して、Hibernateは便利な統計情報を出力します。 JMXを経由して統計情報を出力することも可能です。 Javadocの <literal>org.hibernate.stats</literal> パッケージ内の インターフェイスにはより多くの情報があります。" +#. Tag: para +#: configuration.xml:1176 +#, no-c-format +msgid "" +"If you enable <literal>hibernate.generate_statistics</literal>, Hibernate " +"will expose a number of metrics that are useful when tuning a running system " +"via <literal>SessionFactory.getStatistics()</literal>. Hibernate can even be " +"configured to expose these statistics via JMX. Read the Javadoc of the " +"interfaces in <literal>org.hibernate.stats</literal> for more information." +msgstr "" +"<literal>hibernate.generate_statistics</literal> を有効にした場合、 動作して" +"いるシステムをチューニングするときに、<literal>SessionFactory.getStatistics()" +"</literal> を経由して、Hibernateは便利な統計情報を出力します。 JMXを経由して" +"統計情報を出力することも可能です。 Javadocの <literal>org.hibernate.stats</" +"literal> パッケージ内の インターフェイスにはより多くの情報があります。" -#: index.docbook:1188 +#. Tag: title +#: configuration.xml:1188 +#, no-c-format msgid "Logging" msgstr "ロギング" -#: index.docbook:1190 +#. Tag: para +#: configuration.xml:1190 +#, no-c-format msgid "Hibernate logs various events using Apache commons-logging." -msgstr "HibernateはApache commons-logginを使って、さまざまなイベントをログとして 出力します。" +msgstr "" +"HibernateはApache commons-logginを使って、さまざまなイベントをログとして 出力" +"します。" -#: index.docbook:1194 -msgid "The commons-logging service will direct output to either Apache Log4j (if you include <literal>log4j.jar</literal> in your classpath) or JDK1.4 logging (if running under JDK1.4 or above). You may download Log4j from <literal>http://jakarta.apache.org</literal>. To use Log4j you will need to place a <literal>log4j.properties</literal> file in your classpath, an example properties file is distributed with Hibernate in the <literal>src/</literal> directory." -msgstr "commons-loggingサービスは（クラスパスに <literal>log4j.jar</literal> を含めれば）Apache Log4jに、 また（JDK1.4かそれ以上で実行させれば）JDK1.4 loggingに直接出力します。 Log4jは <literal>http://jakarta.apache.org</literal> からダウンロードできます。 Log4jを使うためには、クラスパスに <literal>log4j.properties</literal> ファイルを配置する必要があります。 例のプロパティファイルはHibernateと一緒に配布され、それは <literal>src/</literal> ディレクトリにあります。" +#. Tag: para +#: configuration.xml:1194 +#, no-c-format +msgid "" +"The commons-logging service will direct output to either Apache Log4j (if " +"you include <literal>log4j.jar</literal> in your classpath) or JDK1.4 " +"logging (if running under JDK1.4 or above). You may download Log4j from " +"<literal>http://jakarta.apache.org</literal>. To use Log4j you will need to " +"place a <literal>log4j.properties</literal> file in your classpath, an " +"example properties file is distributed with Hibernate in the <literal>src/</" +"literal> directory." +msgstr "" +"commons-loggingサービスは（クラスパスに <literal>log4j.jar</literal> を含めれ" +"ば）Apache Log4jに、 また（JDK1.4かそれ以上で実行させれば）JDK1.4 loggingに直" +"接出力します。 Log4jは <literal>http://jakarta.apache.org</literal> からダウ" +"ンロードできます。 Log4jを使うためには、クラスパスに <literal>log4j." +"properties</literal> ファイルを配置する必要があります。 例のプロパティファイ" +"ルはHibernateと一緒に配布され、それは <literal>src/</literal> ディレクトリに" +"あります。" -#: index.docbook:1204 -msgid "We strongly recommend that you familiarize yourself with Hibernate's log messages. A lot of work has been put into making the Hibernate log as detailed as possible, without making it unreadable. It is an essential troubleshooting device. The most interesting log categories are the following:" -msgstr "Hibernateのログメッセージに慣れることを強くおすすめします。 Hibernateのログは読みやすく、できる限り詳細になるように努力されています。 これは必須のトラブルシューティングデバイスです。 以下に重要なログのカテゴリを示します。" +#. Tag: para +#: configuration.xml:1204 +#, no-c-format +msgid "" +"We strongly recommend that you familiarize yourself with Hibernate's log " +"messages. A lot of work has been put into making the Hibernate log as " +"detailed as possible, without making it unreadable. It is an essential " +"troubleshooting device. The most interesting log categories are the " +"following:" +msgstr "" +"Hibernateのログメッセージに慣れることを強くおすすめします。 Hibernateのログは" +"読みやすく、できる限り詳細になるように努力されています。 これは必須のトラブル" +"シューティングデバイスです。 以下に重要なログのカテゴリを示します。" -#: index.docbook:1213 +#. Tag: title +#: configuration.xml:1213 +#, no-c-format msgid "Hibernate Log Categories" msgstr "Hibernate ログカテゴリ" -#: index.docbook:1219 +#. Tag: entry +#: configuration.xml:1219 +#, no-c-format msgid "Category" msgstr "カテゴリ" -#: index.docbook:1220 +#. Tag: entry +#: configuration.xml:1220 +#, no-c-format msgid "Function" -msgstr "<entry>機能</entry>" +msgstr "機能" -#: index.docbook:1225 +#. Tag: literal +#: configuration.xml:1225 +#, no-c-format msgid "org.hibernate.SQL" msgstr "org.hibernate.SQL" -#: index.docbook:1226 +#. Tag: entry +#: configuration.xml:1226 +#, no-c-format msgid "Log all SQL DML statements as they are executed" msgstr "実行したすべてのSQL（DDL）ステートメントをロギングします。" -#: index.docbook:1229 +#. Tag: literal +#: configuration.xml:1229 +#, no-c-format msgid "org.hibernate.type" msgstr "org.hibernate.type" -#: index.docbook:1230 +#. Tag: entry +#: configuration.xml:1230 +#, no-c-format msgid "Log all JDBC parameters" msgstr "すべてのJDBCパラメータをロギングします。" -#: index.docbook:1233 +#. Tag: literal +#: configuration.xml:1233 +#, no-c-format msgid "org.hibernate.tool.hbm2ddl" msgstr "org.hibernate.tool.hbm2ddl" -#: index.docbook:1234 +#. Tag: entry +#: configuration.xml:1234 +#, no-c-format msgid "Log all SQL DDL statements as they are executed" msgstr "実行したすべてのSQL（DDL）ステートメントをロギングします。" -#: index.docbook:1237 +#. Tag: literal +#: configuration.xml:1237 +#, no-c-format msgid "org.hibernate.pretty" msgstr "org.hibernate.pretty" -#: index.docbook:1238 -msgid "Log the state of all entities (max 20 entities) associated with the session at flush time" -msgstr "sessionに関連するすべてのエンティティ（最大２０）のフラッシュ時間をロギングします。" +#. Tag: entry +#: configuration.xml:1238 +#, no-c-format +msgid "" +"Log the state of all entities (max 20 entities) associated with the session " +"at flush time" +msgstr "" +"sessionに関連するすべてのエンティティ（最大２０）のフラッシュ時間をロギングし" +"ます。" -#: index.docbook:1244 +#. Tag: literal +#: configuration.xml:1244 +#, no-c-format msgid "org.hibernate.cache" msgstr "org.hibernate.cache" -#: index.docbook:1245 +#. Tag: entry +#: configuration.xml:1245 +#, no-c-format msgid "Log all second-level cache activity" msgstr "すべての２次キャッシュの動作をロギングします。" -#: index.docbook:1248 +#. Tag: literal +#: configuration.xml:1248 +#, no-c-format msgid "org.hibernate.transaction" msgstr "org.hibernate.transaction" -#: index.docbook:1249 +#. Tag: entry +#: configuration.xml:1249 +#, no-c-format msgid "Log transaction related activity" msgstr "トランザクションに関連する動作をロギングします。" -#: index.docbook:1252 +#. Tag: literal +#: configuration.xml:1252 +#, no-c-format msgid "org.hibernate.jdbc" msgstr "org.hibernate.jdbc" -#: index.docbook:1253 +#. Tag: entry +#: configuration.xml:1253 +#, no-c-format msgid "Log all JDBC resource acquisition" msgstr "JDBCリソース取得をロギングします。" -#: index.docbook:1256 +#. Tag: literal +#: configuration.xml:1256 +#, no-c-format msgid "org.hibernate.hql.ast.AST" msgstr "org.hibernate.hql.ast.AST" -#: index.docbook:1257 +#. Tag: entry +#: configuration.xml:1257 +#, no-c-format msgid "Log HQL and SQL ASTs during query parsing" msgstr "HQLとSQLのASTのクエリーパースをロギングします。" -#: index.docbook:1262 +#. Tag: literal +#: configuration.xml:1262 +#, no-c-format msgid "org.hibernate.secure" msgstr "org.hibernate.secure" -#: index.docbook:1263 +#. Tag: entry +#: configuration.xml:1263 +#, no-c-format msgid "Log all JAAS authorization requests" msgstr "すべてのJAAS分析をロギングします。" -#: index.docbook:1266 +#. Tag: literal +#: configuration.xml:1266 +#, no-c-format msgid "org.hibernate" msgstr "org.hibernate" -#: index.docbook:1267 -msgid "Log everything (a lot of information, but very useful for troubleshooting)" -msgstr "すべてをロギングします。（情報が大量になりますが、トラブルシューティングには便利です）" +#. Tag: entry +#: configuration.xml:1267 +#, no-c-format +msgid "" +"Log everything (a lot of information, but very useful for troubleshooting)" +msgstr "" +"すべてをロギングします。（情報が大量になりますが、トラブルシューティングには" +"便利です）" -#: index.docbook:1276 -msgid "When developing applications with Hibernate, you should almost always work with <literal>debug</literal> enabled for the category <literal>org.hibernate.SQL</literal>, or, alternatively, the property <literal>hibernate.show_sql</literal> enabled." -msgstr "Hibernateでアプリケーションを作成するときは、<literal>org.hibernate.SQL</literal> カテゴリの <literal>debug</literal> を常に有効にしておいたほうが良いでしょう。 代替方法として、<literal>hibernate.show_sql</literal> を有効にする方法があります。" +#. Tag: para +#: configuration.xml:1276 +#, no-c-format +msgid "" +"When developing applications with Hibernate, you should almost always work " +"with <literal>debug</literal> enabled for the category <literal>org." +"hibernate.SQL</literal>, or, alternatively, the property <literal>hibernate." +"show_sql</literal> enabled." +msgstr "" +"Hibernateでアプリケーションを作成するときは、<literal>org.hibernate.SQL</" +"literal> カテゴリの <literal>debug</literal> を常に有効にしておいたほうが良い" +"でしょう。 代替方法として、<literal>hibernate.show_sql</literal> を有効にする" +"方法があります。" -#: index.docbook:1286 +#. Tag: title +#: configuration.xml:1286 +#, no-c-format msgid "Implementing a <literal>NamingStrategy</literal>" msgstr "<literal>NamingStrategy</literal> の実装" -#: index.docbook:1288 -msgid "The interface <literal>org.hibernate.cfg.NamingStrategy</literal> allows you to specify a \"naming standard\" for database objects and schema elements." -msgstr "インターフェイス <literal>net.sf.hibernate.cfg.NamingStrategy</literal> を使うと データベースオブジェクトとスキーマ要素のための「命名標準」を指定できます。" +#. Tag: para +#: configuration.xml:1288 +#, no-c-format +msgid "" +"The interface <literal>org.hibernate.cfg.NamingStrategy</literal> allows you " +"to specify a \"naming standard\" for database objects and schema elements." +msgstr "" +"インターフェイス <literal>net.sf.hibernate.cfg.NamingStrategy</literal> を使" +"うと データベースオブジェクトとスキーマ要素のための「命名標準」を指定できま" +"す。" -#: index.docbook:1293 -msgid "You may provide rules for automatically generating database identifiers from Java identifiers or for processing \"logical\" column and table names given in the mapping file into \"physical\" table and column names. This feature helps reduce the verbosity of the mapping document, eliminating repetitive noise (<literal>TBL_</literal> prefixes, for example). The default strategy used by Hibernate is quite minimal." -msgstr "Javaの識別子からデータベースの識別子を自動生成するためのルールや、 マッピングファイルで与えた「論理的な」カラムとテーブル名から 「物理的な」テーブルとカラム名を生成するためのルールを用意することができます。 この機能は繰り返しの雑音（例えば <literal>TBL_</literal> プリフィックス）を取り除き、 マッピングドキュメントの冗長さを減らすことに役立ちます。 Hibernateが使うデフォルトの戦略はかなり最小限に近いものです。" +#. Tag: para +#: configuration.xml:1293 +#, no-c-format +msgid "" +"You may provide rules for automatically generating database identifiers from " +"Java identifiers or for processing \"logical\" column and table names given " +"in the mapping file into \"physical\" table and column names. This feature " +"helps reduce the verbosity of the mapping document, eliminating repetitive " +"noise (<literal>TBL_</literal> prefixes, for example). The default strategy " +"used by Hibernate is quite minimal." +msgstr "" +"Javaの識別子からデータベースの識別子を自動生成するためのルールや、 マッピング" +"ファイルで与えた「論理的な」カラムとテーブル名から 「物理的な」テーブルとカラ" +"ム名を生成するためのルールを用意することができます。 この機能は繰り返しの雑音" +"（例えば <literal>TBL_</literal> プリフィックス）を取り除き、 マッピングド" +"キュメントの冗長さを減らすことに役立ちます。 Hibernateが使うデフォルトの戦略" +"はかなり最小限に近いものです。" -#: index.docbook:1302 -msgid "You may specify a different strategy by calling <literal>Configuration.setNamingStrategy()</literal> before adding mappings:" -msgstr "マッピングを追加する前に <literal>Configuration.setNamingStrategy()</literal> を呼ぶことで 以下のように異なる戦略を指定することができます：" +#. Tag: para +#: configuration.xml:1302 +#, no-c-format +msgid "" +"You may specify a different strategy by calling <literal>Configuration." +"setNamingStrategy()</literal> before adding mappings:" +msgstr "" +"マッピングを追加する前に <literal>Configuration.setNamingStrategy()</" +"literal> を呼ぶことで 以下のように異なる戦略を指定することができます：" -#: index.docbook:1307 +#. Tag: programlisting +#: configuration.xml:1307 +#, no-c-format msgid "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" - " .addFile(\"Item.hbm.xml\")\n" - " .addFile(\"Bid.hbm.xml\")\n" - " .buildSessionFactory();]]>" +"<![CDATA[SessionFactory sf = new Configuration()\n" +" .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" +" .addFile(\"Item.hbm.xml\")\n" +" .addFile(\"Bid.hbm.xml\")\n" +" .buildSessionFactory();]]>" msgstr "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)\n" - " .addFile(\"Item.hbm.xml\")\n" - " .addFile(\"Bid.hbm.xml\")\n" - " .buildSessionFactory();]]>" -#: index.docbook:1309 -msgid "<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> is a built-in strategy that might be a useful starting point for some applications." -msgstr "<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> は組み込みの戦略です。 これはいくつかのアプリケーションにとって有用な開始点となるかもしれません。" +#. Tag: para +#: configuration.xml:1309 +#, no-c-format +msgid "" +"<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> is a built-in " +"strategy that might be a useful starting point for some applications." +msgstr "" +"<literal>org.hibernate.cfg.ImprovedNamingStrategy</literal> は組み込みの戦略" +"です。 これはいくつかのアプリケーションにとって有用な開始点となるかもしれませ" +"ん。" -#: index.docbook:1317 +#. Tag: title +#: configuration.xml:1317 +#, no-c-format msgid "XML configuration file" msgstr "XML設定ファイル" -#: index.docbook:1319 -msgid "An alternative approach to configuration is to specify a full configuration in a file named <literal>hibernate.cfg.xml</literal>. This file can be used as a replacement for the <literal>hibernate.properties</literal> file or, if both are present, to override properties." -msgstr "もう1つの方法は <literal>hibernate.cfg.xml</literal> という名前のファイルで 十分な設定を指定する方法です。 このファイルは <literal>hibernate.properties</literal> ファイルの代わりとなります。 もし両方のファイルがあれば、プロパティが置き換えられます。" +#. Tag: para +#: configuration.xml:1319 +#, no-c-format +msgid "" +"An alternative approach to configuration is to specify a full configuration " +"in a file named <literal>hibernate.cfg.xml</literal>. This file can be used " +"as a replacement for the <literal>hibernate.properties</literal> file or, if " +"both are present, to override properties." +msgstr "" +"もう1つの方法は <literal>hibernate.cfg.xml</literal> という名前のファイルで " +"十分な設定を指定する方法です。 このファイルは <literal>hibernate.properties</" +"literal> ファイルの代わりとなります。 もし両方のファイルがあれば、プロパティ" +"が置き換えられます。" -#: index.docbook:1326 -msgid "The XML configuration file is by default expected to be in the root o your <literal>CLASSPATH</literal>. Here is an example:" -msgstr "XML設定ファイルは初期設定で <literal>CLASSPATH</literal> に配置してください。 これが例です：" +#. Tag: para +#: configuration.xml:1326 +#, no-c-format +msgid "" +"The XML configuration file is by default expected to be in the root o your " +"<literal>CLASSPATH</literal>. Here is an example:" +msgstr "" +"XML設定ファイルは初期設定で <literal>CLASSPATH</literal> に配置してくださ" +"い。 これが例です：" -#: index.docbook:1331 +#. Tag: programlisting +#: configuration.xml:1331 +#, no-c-format msgid "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" - "<!DOCTYPE hibernate-configuration PUBLIC\n" - " \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" - "\n" - "<hibernate-configuration>\n" - "\n" - " <!-- a SessionFactory instance listed as /jndi/name -->\n" - " <session-factory\n" - " name=\"java:hibernate/SessionFactory\">\n" - "\n" - " <!-- properties -->\n" - " <property name=\"connection.datasource\">java:/comp/env/jdbc/MyDB</property>\n" - " <property name=\"dialect\">org.hibernate.dialect.MySQLDialect</property>\n" - " <property name=\"show_sql\">false</property>\n" - " <property name=\"transaction.factory_class\">\n" - " org.hibernate.transaction.JTATransactionFactory\n" - " </property>\n" - " <property name=\"jta.UserTransaction\">java:comp/UserTransaction</property>\n" - "\n" - " <!-- mapping files -->\n" - " <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" - " <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" - "\n" - " <!-- cache settings -->\n" - " <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-write\"/>\n" - " <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-only\"/>\n" - " <collection-cache collection=\"org.hibernate.auction.Item.bids\" usage=\"read-write\"/>\n" - "\n" - " </session-factory>\n" - "\n" - "</hibernate-configuration>]]>" +"<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" +"<!DOCTYPE hibernate-configuration PUBLIC\n" +" \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" +"\n" +"<hibernate-configuration>\n" +"\n" +" <!-- a SessionFactory instance listed as /jndi/name -->\n" +" <session-factory\n" +" name=\"java:hibernate/SessionFactory\">\n" +"\n" +" <!-- properties -->\n" +" <property name=\"connection.datasource\">java:/comp/env/jdbc/MyDB</" +"property>\n" +" <property name=\"dialect\">org.hibernate.dialect.MySQLDialect</" +"property>\n" +" <property name=\"show_sql\">false</property>\n" +" <property name=\"transaction.factory_class\">\n" +" org.hibernate.transaction.JTATransactionFactory\n" +" </property>\n" +" <property name=\"jta.UserTransaction\">java:comp/UserTransaction</" +"property>\n" +"\n" +" <!-- mapping files -->\n" +" <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" +" <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" +"\n" +" <!-- cache settings -->\n" +" <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-write" +"\"/>\n" +" <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-only\"/" +">\n" +" <collection-cache collection=\"org.hibernate.auction.Item.bids\" " +"usage=\"read-write\"/>\n" +"\n" +" </session-factory>\n" +"\n" +"</hibernate-configuration>]]>" msgstr "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" - "<!DOCTYPE hibernate-configuration PUBLIC\n" - " \"-//Hibernate/Hibernate Configuration DTD//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" - "\n" - "<hibernate-configuration>\n" - "\n" - " <!-- a SessionFactory instance listed as /jndi/name -->\n" - " <!-- /jndi/nameのようにリストアップされたSessionFactoryインスタンス -->\n" - " <session-factory\n" - " name=\"java:hibernate/SessionFactory\">\n" - "\n" - " <!-- properties -->\n" - " <property name=\"connection.datasource\">java:/comp/env/jdbc/MyDB</property>\n" - " <property name=\"dialect\">org.hibernate.dialect.MySQLDialect</property>\n" - " <property name=\"show_sql\">false</property>\n" - " <property name=\"transaction.factory_class\">\n" - " org.hibernate.transaction.JTATransactionFactory\n" - " </property>\n" - " <property name=\"jta.UserTransaction\">java:comp/UserTransaction</property>\n" - "\n" - " <!-- mapping files -->\n" - " <mapping resource=\"org/hibernate/auction/Item.hbm.xml\"/>\n" - " <mapping resource=\"org/hibernate/auction/Bid.hbm.xml\"/>\n" - "\n" - " <!-- cache settings -->\n" - " <class-cache class=\"org.hibernate.auction.Item\" usage=\"read-write\"/>\n" - " <class-cache class=\"org.hibernate.auction.Bid\" usage=\"read-only\"/>\n" - " <collection-cache collection=\"org.hibernate.auction.Item.bids\" usage=\"read-write\"/>\n" - "\n" - " </session-factory>\n" - "\n" - "</hibernate-configuration>]]>" -#: index.docbook:1333 -msgid "As you can see, the advantage of this approach is the externalization of the mapping file names to configuration. The <literal>hibernate.cfg.xml</literal> is also more convenient once you have to tune the Hibernate cache. Note that is your choice to use either <literal>hibernate.properties</literal> or <literal>hibernate.cfg.xml</literal>, both are equivalent, except for the above mentioned benefits of using the XML syntax." -msgstr "見てのとおり、この方法の優位性は設定のためのマッピングファイル名を外出しにできることです。 Hibernateキャッシュをチューニングしなければならないのであれば、 <literal>hibernate.cfg.xml</literal> はより便利です。 <literal>hibernate.properties</literal> と <literal>hibernate.cfg.xml</literal> の どちらかを使えることを覚えておいてください。 二つは同じもので、違うところといえばXML構文を使うことの利点だけです。" +#. Tag: para +#: configuration.xml:1333 +#, no-c-format +msgid "" +"As you can see, the advantage of this approach is the externalization of the " +"mapping file names to configuration. The <literal>hibernate.cfg.xml</" +"literal> is also more convenient once you have to tune the Hibernate cache. " +"Note that is your choice to use either <literal>hibernate.properties</" +"literal> or <literal>hibernate.cfg.xml</literal>, both are equivalent, " +"except for the above mentioned benefits of using the XML syntax." +msgstr "" +"見てのとおり、この方法の優位性は設定のためのマッピングファイル名を外出しにで" +"きることです。 Hibernateキャッシュをチューニングしなければならないのであれ" +"ば、 <literal>hibernate.cfg.xml</literal> はより便利です。 " +"<literal>hibernate.properties</literal> と <literal>hibernate.cfg.xml</" +"literal> の どちらかを使えることを覚えておいてください。 二つは同じもので、違" +"うところといえばXML構文を使うことの利点だけです。" -#: index.docbook:1342 +#. Tag: para +#: configuration.xml:1342 +#, no-c-format msgid "With the XML configuration, starting Hibernate is then as simple as" msgstr "XML設定を使うことで、Hibernateは以下のようにシンプルになります。" -#: index.docbook:1346 -msgid "<![CDATA[SessionFactory sf = new Configuration().configure().buildSessionFactory();]]>" -msgstr "<![CDATA[SessionFactory sf = new Configuration().configure().buildSessionFactory();]]>" +#. Tag: programlisting +#: configuration.xml:1346 +#, no-c-format +msgid "" +"<![CDATA[SessionFactory sf = new Configuration().configure()." +"buildSessionFactory();]]>" +msgstr "" -#: index.docbook:1348 +#. Tag: para +#: configuration.xml:1348 +#, no-c-format msgid "You can pick a different XML configuration file using" msgstr "違うXML設定ファイルを使うこともできます。" -#: index.docbook:1352 +#. Tag: programlisting +#: configuration.xml:1352 +#, no-c-format msgid "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .configure(\"catdb.cfg.xml\")\n" - " .buildSessionFactory();]]>" +"<![CDATA[SessionFactory sf = new Configuration()\n" +" .configure(\"catdb.cfg.xml\")\n" +" .buildSessionFactory();]]>" msgstr "" - "<![CDATA[SessionFactory sf = new Configuration()\n" - " .configure(\"catdb.cfg.xml\")\n" - " .buildSessionFactory();]]>" -#: index.docbook:1357 +#. Tag: title +#: configuration.xml:1357 +#, no-c-format msgid "J2EE Application Server integration" msgstr "J2EEアプリケーションサーバとの統合" -#: index.docbook:1359 +#. Tag: para +#: configuration.xml:1359 +#, no-c-format msgid "Hibernate has the following integration points for J2EE infrastructure:" msgstr "HibernateはJ2EE構造と統合するポイントをサポートしています。" -#: index.docbook:1365 -msgid "<emphasis>Container-managed datasources</emphasis>: Hibernate can use JDBC connections managed by the container and provided through JNDI. Usually, a JTA compatible <literal>TransactionManager</literal> and a <literal>ResourceManager</literal> take care of transaction management (CMT), esp. distributed transaction handling across several datasources. You may of course also demarcate transaction boundaries programmatically (BMT) or you might want to use the optional Hibernate <literal>Transaction</literal> API for this to keep your code portable." -msgstr "<emphasis>コンテナ管理データソース</emphasis>：Hibernateは JNDIが提供し、コンテナが管理するJDBCコネクションを使用できます。 通常、JTA準拠の <literal>TransactionManager</literal> と <literal>ResourceManager</literal> がトランザクション管理(CMT)、 特に様々なデータソースにまたがる分散トランザクションを扱います。 当然プログラムでトランザクション境界を指定できます(BMT)。 あるいは、記述したコードのポータビリティを保つために、 オプションのHibernateの <literal>Transaction</literal> APIを使いたくなるかもしれません。" +#. Tag: para +#: configuration.xml:1365 +#, no-c-format +msgid "" +"<emphasis>Container-managed datasources</emphasis>: Hibernate can use JDBC " +"connections managed by the container and provided through JNDI. Usually, a " +"JTA compatible <literal>TransactionManager</literal> and a " +"<literal>ResourceManager</literal> take care of transaction management " +"(CMT), esp. distributed transaction handling across several datasources. You " +"may of course also demarcate transaction boundaries programmatically (BMT) " +"or you might want to use the optional Hibernate <literal>Transaction</" +"literal> API for this to keep your code portable." +msgstr "" +"<emphasis>コンテナ管理データソース</emphasis>：Hibernateは JNDIが提供し、コン" +"テナが管理するJDBCコネクションを使用できます。 通常、JTA準拠の " +"<literal>TransactionManager</literal> と <literal>ResourceManager</literal> " +"がトランザクション管理(CMT)、 特に様々なデータソースにまたがる分散トランザク" +"ションを扱います。 当然プログラムでトランザクション境界を指定できます(BMT)。 " +"あるいは、記述したコードのポータビリティを保つために、 オプションのHibernate" +"の <literal>Transaction</literal> APIを使いたくなるかもしれません。" -#: index.docbook:1380 -msgid "<emphasis>Automatic JNDI binding</emphasis>: Hibernate can bind its <literal>SessionFactory</literal> to JNDI after startup." -msgstr "<emphasis>自動JNDIバインディング</emphasis>：HibernateはJNDIが立ち上がった後に <literal>SessionFactory</literal> を生成します。" +#. Tag: para +#: configuration.xml:1380 +#, no-c-format +msgid "" +"<emphasis>Automatic JNDI binding</emphasis>: Hibernate can bind its " +"<literal>SessionFactory</literal> to JNDI after startup." +msgstr "" +"<emphasis>自動JNDIバインディング</emphasis>：HibernateはJNDIが立ち上がった後" +"に <literal>SessionFactory</literal> を生成します。" -#: index.docbook:1389 -msgid "<emphasis>JTA Session binding:</emphasis> The Hibernate <literal>Session</literal> may be automatically bound to the scope of JTA transactions. Simply lookup the <literal>SessionFactory</literal> from JNDI and get the current <literal>Session</literal>. Let Hibernate take care of flushing and closing the <literal>Session</literal> when your JTA transaction completes. Transaction demarcation is either declarative (CMT) or programmatic (BMT/UserTransaction)." -msgstr "<emphasis>JTAセッションバインディング</emphasis> ： Hibernate <literal>Session</literal> のトランザクション境界はJTAトランザクションと同じになります。 単純に <literal>SessionFactory</literal> をJNDIからlookupして、 現在の <literal>Session</literal> を取得します。 JTAトランザクションが完了したときに、Hibernateが <literal>Session</literal> をフラッシュし、クローズします。 EJBデプロイメントディスクリプタの中に、トランザクション境界を宣言します。" +#. Tag: para +#: configuration.xml:1389 +#, no-c-format +msgid "" +"<emphasis>JTA Session binding:</emphasis> The Hibernate <literal>Session</" +"literal> may be automatically bound to the scope of JTA transactions. Simply " +"lookup the <literal>SessionFactory</literal> from JNDI and get the current " +"<literal>Session</literal>. Let Hibernate take care of flushing and closing " +"the <literal>Session</literal> when your JTA transaction completes. " +"Transaction demarcation is either declarative (CMT) or programmatic (BMT/" +"UserTransaction)." +msgstr "" +"<emphasis>JTAセッションバインディング</emphasis> ： Hibernate " +"<literal>Session</literal> のトランザクション境界はJTAトランザクションと同じ" +"になります。 単純に <literal>SessionFactory</literal> をJNDIからlookupして、 " +"現在の <literal>Session</literal> を取得します。 JTAトランザクションが完了し" +"たときに、Hibernateが <literal>Session</literal> をフラッシュし、クローズしま" +"す。 EJBデプロイメントディスクリプタの中に、トランザクション境界を宣言しま" +"す。" -#: index.docbook:1402 -msgid "<emphasis>JMX deployment:</emphasis> If you have a JMX capable application server (e.g. JBoss AS), you can chose to deploy Hibernate as a managed MBean. This saves you the one line startup code to build your <literal>SessionFactory</literal> from a <literal>Configuration</literal>. The container will startup your <literal>HibernateService</literal>, and ideally also take care of service dependencies (Datasource has to be available before Hibernate starts, etc)." -msgstr "<emphasis>JMXデプロイ:</emphasis> もしJMXが使用可能なアプリケーションサーバ（例えばJBOSS） がある場合、HibernateをMBeanとしてデプロイすることを選べます。 これは <literal>Configuration</literal> から <literal>SessionFactory</literal> を 生成するコードを無くすことができます。 コンテナは <literal>HibernateService</literal> を起動し、 サービスの依存を理想的に管理します（データソースはHibernateやその他が起動する前に 使用できるようにしなければなりません）。" +#. Tag: para +#: configuration.xml:1402 +#, no-c-format +msgid "" +"<emphasis>JMX deployment:</emphasis> If you have a JMX capable application " +"server (e.g. JBoss AS), you can chose to deploy Hibernate as a managed " +"MBean. This saves you the one line startup code to build your " +"<literal>SessionFactory</literal> from a <literal>Configuration</literal>. " +"The container will startup your <literal>HibernateService</literal>, and " +"ideally also take care of service dependencies (Datasource has to be " +"available before Hibernate starts, etc)." +msgstr "" +"<emphasis>JMXデプロイ:</emphasis> もしJMXが使用可能なアプリケーションサーバ" +"（例えばJBOSS） がある場合、HibernateをMBeanとしてデプロイすることを選べま" +"す。 これは <literal>Configuration</literal> から <literal>SessionFactory</" +"literal> を 生成するコードを無くすことができます。 コンテナは " +"<literal>HibernateService</literal> を起動し、 サービスの依存を理想的に管理し" +"ます（データソースはHibernateやその他が起動する前に 使用できるようにしなけれ" +"ばなりません）。" -#: index.docbook:1413 -msgid "Depending on your environment, you might have to set the configuration option <literal>hibernate.connection.aggressive_release</literal> to true if your application server shows \"connection containment\" exceptions." -msgstr "環境に依存しますが、もし、アプリケーションサーバが\"connection containment\"の例外をスローするなら 設定のオプション <literal>hibernate.connection.aggressive_release</literal> をtrueにしてください。" +#. Tag: para +#: configuration.xml:1413 +#, no-c-format +msgid "" +"Depending on your environment, you might have to set the configuration " +"option <literal>hibernate.connection.aggressive_release</literal> to true if " +"your application server shows \"connection containment\" exceptions." +msgstr "" +"環境に依存しますが、もし、アプリケーションサーバが\"connection containment" +"\"の例外をスローするなら 設定のオプション <literal>hibernate.connection." +"aggressive_release</literal> をtrueにしてください。" -#: index.docbook:1420 +#. Tag: title +#: configuration.xml:1420 +#, no-c-format msgid "Transaction strategy configuration" msgstr "トランザクション戦略設定" -#: index.docbook:1422 -msgid "The Hibernate <literal>Session</literal> API is independent of any transaction demarcation system in your architecture. If you let Hibernate use JDBC directly, through a connection pool, you may begin and end your transactions by calling the JDBC API. If you run in a J2EE application server, you might want to use bean-managed transactions and call the JTA API and <literal>UserTransaction</literal> when needed." -msgstr "Hibernate <literal>Session</literal> APIは、アーキテクチャ内のシステムの管轄である あらゆるトランザクションに依存しません。 もしコネクションプールのJDBCを直接使いたい場合、JDBC APIから トランザクションを呼ぶことができます。 もし、J2EEアプリケーションサーバで動作させるなら、Bean管理トランザクションを使い、 必要に応じて <literal>UserTransaction</literal> をJTA APIから呼ぶことになるでしょう。" +#. Tag: para +#: configuration.xml:1422 +#, no-c-format +msgid "" +"The Hibernate <literal>Session</literal> API is independent of any " +"transaction demarcation system in your architecture. If you let Hibernate " +"use JDBC directly, through a connection pool, you may begin and end your " +"transactions by calling the JDBC API. If you run in a J2EE application " +"server, you might want to use bean-managed transactions and call the JTA API " +"and <literal>UserTransaction</literal> when needed." +msgstr "" +"Hibernate <literal>Session</literal> APIは、アーキテクチャ内のシステムの管轄" +"である あらゆるトランザクションに依存しません。 もしコネクションプールのJDBC" +"を直接使いたい場合、JDBC APIから トランザクションを呼ぶことができます。 も" +"し、J2EEアプリケーションサーバで動作させるなら、Bean管理トランザクションを使" +"い、 必要に応じて <literal>UserTransaction</literal> をJTA APIから呼ぶことに" +"なるでしょう。" -#: index.docbook:1430 -msgid "To keep your code portable between these two (and other) environments we recommend the optional Hibernate <literal>Transaction</literal> API, which wraps and hides the underlying system. You have to specify a factory class for <literal>Transaction</literal> instances by setting the Hibernate configuration property <literal>hibernate.transaction.factory_class</literal>." -msgstr "2つ（それ以上）の環境で互換性のあるコードを維持するために、オプションとして根本的なシステムを ラッピングするHibernate <literal>Transaction</literal> APIを推奨します。 Hibernate設定プロパティの <literal>hibernate.transaction.factory_class</literal> を設定することで ある特定の <literal>Transaction</literal> クラスのインスタンスを持つことができます。" +#. Tag: para +#: configuration.xml:1430 +#, no-c-format +msgid "" +"To keep your code portable between these two (and other) environments we " +"recommend the optional Hibernate <literal>Transaction</literal> API, which " +"wraps and hides the underlying system. You have to specify a factory class " +"for <literal>Transaction</literal> instances by setting the Hibernate " +"configuration property <literal>hibernate.transaction.factory_class</" +"literal>." +msgstr "" +"2つ（それ以上）の環境で互換性のあるコードを維持するために、オプションとして根" +"本的なシステムを ラッピングするHibernate <literal>Transaction</literal> APIを" +"推奨します。 Hibernate設定プロパティの <literal>hibernate.transaction." +"factory_class</literal> を設定することで ある特定の <literal>Transaction</" +"literal> クラスのインスタンスを持つことができます。" -#: index.docbook:1437 +#. Tag: para +#: configuration.xml:1437 +#, no-c-format msgid "There are three standard (built-in) choices:" msgstr "3つの基本的な（既にある）選択を挙げます：" -#: index.docbook:1443 +#. Tag: literal +#: configuration.xml:1443 +#, no-c-format msgid "org.hibernate.transaction.JDBCTransactionFactory" msgstr "org.hibernate.transaction.JDBCTransactionFactory" -#: index.docbook:1445 +#. Tag: para +#: configuration.xml:1445 +#, no-c-format msgid "delegates to database (JDBC) transactions (default)" msgstr "データベース(JDBC)トランザクションに委譲します（デフォルト）" -#: index.docbook:1449 +#. Tag: literal +#: configuration.xml:1449 +#, no-c-format msgid "org.hibernate.transaction.JTATransactionFactory" msgstr "org.hibernate.transaction.JTATransactionFactory" -#: index.docbook:1451 -msgid "delegates to container-managed transaction if an existing transaction is underway in this context (e.g. EJB session bean method), otherwise a new transaction is started and bean-managed transaction are used." -msgstr "もし、このコンテキスト（例えば、EJBセッションBeanメソッド）で進行中のトランザクションが存在する、もしくは 新しいトランザクションが開始されており、Bean管理トランザクションが使われている場合、 コンテナ管理トランザクションに委譲します。" +#. Tag: para +#: configuration.xml:1451 +#, no-c-format +msgid "" +"delegates to container-managed transaction if an existing transaction is " +"underway in this context (e.g. EJB session bean method), otherwise a new " +"transaction is started and bean-managed transaction are used." +msgstr "" +"もし、このコンテキスト（例えば、EJBセッションBeanメソッド）で進行中のトランザ" +"クションが存在する、もしくは 新しいトランザクションが開始されており、Bean管理" +"トランザクションが使われている場合、 コンテナ管理トランザクションに委譲しま" +"す。" -#: index.docbook:1459 +#. Tag: literal +#: configuration.xml:1459 +#, no-c-format msgid "org.hibernate.transaction.CMTTransactionFactory" msgstr "org.hibernate.transaction.CMTTransactionFactory" -#: index.docbook:1461 +#. Tag: para +#: configuration.xml:1461 +#, no-c-format msgid "delegates to container-managed JTA transactions" msgstr "コンテナ管理JTAトランザクションに委譲します" -#: index.docbook:1466 -msgid "You may also define your own transaction strategies (for a CORBA transaction service, for example)." -msgstr "自分自身のトランザクション戦略（例えば、CORBAトランザクションサービス）を定義することもできます。" +#. Tag: para +#: configuration.xml:1466 +#, no-c-format +msgid "" +"You may also define your own transaction strategies (for a CORBA transaction " +"service, for example)." +msgstr "" +"自分自身のトランザクション戦略（例えば、CORBAトランザクションサービス）を定義" +"することもできます。" -#: index.docbook:1471 -msgid "Some features in Hibernate (i.e. the second level cache, Contextual Sessions with JTA, etc.) require access to the JTA <literal>TransactionManager</literal> in a managed environment. In an application server you have to specify how Hibernate should obtain a reference to the <literal>TransactionManager</literal>, since J2EE does not standardize a single mechanism:" -msgstr "Hibernateのいくつかの機能（例えば、二次キャッシュ、JTAによるコンテキストセッション 等）は 管理された環境の中のJTA <literal>TransactionManager</literal> へのアクセスを要求します。 J2EEがひとつのメカニズムに規格化されていないので、 アプリケーションサーバにおいて、Hibernateが <literal>TransactionManager</literal> のリファレンス を取得する方法を明確にする必要があります。" +#. Tag: para +#: configuration.xml:1471 +#, no-c-format +msgid "" +"Some features in Hibernate (i.e. the second level cache, Contextual Sessions " +"with JTA, etc.) require access to the JTA <literal>TransactionManager</" +"literal> in a managed environment. In an application server you have to " +"specify how Hibernate should obtain a reference to the " +"<literal>TransactionManager</literal>, since J2EE does not standardize a " +"single mechanism:" +msgstr "" +"Hibernateのいくつかの機能（例えば、二次キャッシュ、JTAによるコンテキストセッ" +"ション 等）は 管理された環境の中のJTA <literal>TransactionManager</literal> " +"へのアクセスを要求します。 J2EEがひとつのメカニズムに規格化されていないの" +"で、 アプリケーションサーバにおいて、Hibernateが " +"<literal>TransactionManager</literal> のリファレンス を取得する方法を明確にす" +"る必要があります。" -#: index.docbook:1479 +#. Tag: title +#: configuration.xml:1479 +#, no-c-format msgid "JTA TransactionManagers" msgstr "JTA トランザクションマネージャ" -#: index.docbook:1485 +#. Tag: entry +#: configuration.xml:1485 +#, no-c-format msgid "Transaction Factory" msgstr "Transaction Factory" -#: index.docbook:1486 +#. Tag: entry +#: configuration.xml:1486 +#, no-c-format msgid "Application Server" msgstr "Application Server" -#: index.docbook:1491 +#. Tag: literal +#: configuration.xml:1491 +#, no-c-format msgid "org.hibernate.transaction.JBossTransactionManagerLookup" msgstr "org.hibernate.transaction.JBossTransactionManagerLookup" -#: index.docbook:1492 +#. Tag: entry +#: configuration.xml:1492 +#, no-c-format msgid "JBoss" msgstr "JBoss" -#: index.docbook:1495 +#. Tag: literal +#: configuration.xml:1495 +#, no-c-format msgid "org.hibernate.transaction.WeblogicTransactionManagerLookup" msgstr "org.hibernate.transaction.WeblogicTransactionManagerLookup" -#: index.docbook:1496 +#. Tag: entry +#: configuration.xml:1496 +#, no-c-format msgid "Weblogic" msgstr "Weblogic" -#: index.docbook:1499 +#. Tag: literal +#: configuration.xml:1499 +#, no-c-format msgid "org.hibernate.transaction.WebSphereTransactionManagerLookup" msgstr "org.hibernate.transaction.WebSphereTransactionManagerLookup" -#: index.docbook:1500 +#. Tag: entry +#: configuration.xml:1500 +#, no-c-format msgid "WebSphere" msgstr "WebSphere" -#: index.docbook:1503 +#. Tag: literal +#: configuration.xml:1503 +#, no-c-format msgid "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup" msgstr "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup" -#: index.docbook:1504 +#. Tag: entry +#: configuration.xml:1504 +#, no-c-format msgid "WebSphere 6" msgstr "WebSphere 6" -#: index.docbook:1507 +#. Tag: literal +#: configuration.xml:1507 +#, no-c-format msgid "org.hibernate.transaction.OrionTransactionManagerLookup" msgstr "org.hibernate.transaction.OrionTransactionManagerLookup" -#: index.docbook:1508 +#. Tag: entry +#: configuration.xml:1508 +#, no-c-format msgid "Orion" msgstr "Orion" -#: index.docbook:1511 +#. Tag: literal +#: configuration.xml:1511 +#, no-c-format msgid "org.hibernate.transaction.ResinTransactionManagerLookup" msgstr "org.hibernate.transaction.ResinTransactionManagerLookup" -#: index.docbook:1512 +#. Tag: entry +#: configuration.xml:1512 +#, no-c-format msgid "Resin" msgstr "Resin" -#: index.docbook:1515 +#. Tag: literal +#: configuration.xml:1515 +#, no-c-format msgid "org.hibernate.transaction.JOTMTransactionManagerLookup" msgstr "org.hibernate.transaction.JOTMTransactionManagerLookup" -#: index.docbook:1516 +#. Tag: entry +#: configuration.xml:1516 +#, no-c-format msgid "JOTM" msgstr "JOTM" -#: index.docbook:1519 +#. Tag: literal +#: configuration.xml:1519 +#, no-c-format msgid "org.hibernate.transaction.JOnASTransactionManagerLookup" msgstr "org.hibernate.transaction.JOnASTransactionManagerLookup" -#: index.docbook:1520 +#. Tag: entry +#: configuration.xml:1520 +#, no-c-format msgid "JOnAS" msgstr "JOnAS" -#: index.docbook:1523 +#. Tag: literal +#: configuration.xml:1523 +#, no-c-format msgid "org.hibernate.transaction.JRun4TransactionManagerLookup" msgstr "org.hibernate.transaction.JRun4TransactionManagerLookup" -#: index.docbook:1524 +#. Tag: entry +#: configuration.xml:1524 +#, no-c-format msgid "JRun4" msgstr "JRun4" -#: index.docbook:1527 +#. Tag: literal +#: configuration.xml:1527 +#, no-c-format msgid "org.hibernate.transaction.BESTransactionManagerLookup" msgstr "org.hibernate.transaction.BESTransactionManagerLookup" -#: index.docbook:1528 +#. Tag: entry +#: configuration.xml:1528 +#, no-c-format msgid "Borland ES" msgstr "Borland ES" -#: index.docbook:1537 +#. Tag: title +#: configuration.xml:1537 +#, no-c-format msgid "JNDI-bound <literal>SessionFactory</literal>" msgstr "<literal>SessionFactory</literal> のJNDIへの登録" -#: index.docbook:1539 -msgid "A JNDI bound Hibernate <literal>SessionFactory</literal> can simplify the lookup of the factory and the creation of new <literal>Session</literal>s. Note that this is not related to a JNDI bound <literal>Datasource</literal>, both simply use the same registry!" -msgstr "JNDIに登録したHibernate <literal>SessionFactory</literal> は単純に ファクトリをルックアップし、新しい <literal>Session</literal> を作ります。 これはJNDIに登録された <literal>Datasource</literal> には関連せず、 お互いにシンプルにこれらの登録を使うことに注意してください。" +#. Tag: para +#: configuration.xml:1539 +#, no-c-format +msgid "" +"A JNDI bound Hibernate <literal>SessionFactory</literal> can simplify the " +"lookup of the factory and the creation of new <literal>Session</literal>s. " +"Note that this is not related to a JNDI bound <literal>Datasource</literal>, " +"both simply use the same registry!" +msgstr "" +"JNDIに登録したHibernate <literal>SessionFactory</literal> は単純に ファクトリ" +"をルックアップし、新しい <literal>Session</literal> を作ります。 これはJNDIに" +"登録された <literal>Datasource</literal> には関連せず、 お互いにシンプルにこ" +"れらの登録を使うことに注意してください。" -#: index.docbook:1546 -msgid "If you wish to have the <literal>SessionFactory</literal> bound to a JNDI namespace, specify a name (eg. <literal>java:hibernate/SessionFactory</literal>) using the property <literal>hibernate.session_factory_name</literal>. If this property is omitted, the <literal>SessionFactory</literal> will not be bound to JNDI. (This is especially useful in environments with a read-only JNDI default implementation, e.g. Tomcat.)" -msgstr "もし <literal>SessionFactory</literal> をJNDIネームスペースに登録したい場合、 特別な名前（例えば、 <literal>java:hibernate/SessionFactory</literal> ）を <literal>hibernate.session_factory_name</literal> プロパティに使ってください もしこのプロパティを省略した場合、 <literal>SessionFactory</literal> は JNDIに登録されません。（これはTomcatのようなデフォルト実装でJNDIが読みより専用の環境の場合特に便利です。）" +#. Tag: para +#: configuration.xml:1546 +#, no-c-format +msgid "" +"If you wish to have the <literal>SessionFactory</literal> bound to a JNDI " +"namespace, specify a name (eg. <literal>java:hibernate/SessionFactory</" +"literal>) using the property <literal>hibernate.session_factory_name</" +"literal>. If this property is omitted, the <literal>SessionFactory</literal> " +"will not be bound to JNDI. (This is especially useful in environments with a " +"read-only JNDI default implementation, e.g. Tomcat.)" +msgstr "" +"もし <literal>SessionFactory</literal> をJNDIネームスペースに登録したい場" +"合、 特別な名前（例えば、 <literal>java:hibernate/SessionFactory</literal> ）" +"を <literal>hibernate.session_factory_name</literal> プロパティに使ってくださ" +"い もしこのプロパティを省略した場合、 <literal>SessionFactory</literal> は " +"JNDIに登録されません。（これはTomcatのようなデフォルト実装でJNDIが読みより専" +"用の環境の場合特に便利です。）" -#: index.docbook:1554 -msgid "When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will use the values of <literal>hibernate.jndi.url</literal>, <literal>hibernate.jndi.class</literal> to instantiate an initial context. If they are not specified, the default <literal>InitialContext</literal> will be used." -msgstr "<literal>SessionFactory</literal> をJNDIに登録するとき、Hibernateは <literal>hibernate.jndi.url</literal> の値を使用し、<literal>hibernate.jndi.class</literal> をイニシャルコンテキストとして具体化します。 もし何も設定しない場合は、デフォルトの <literal>InitialContext</literal> を使用します。" +#. Tag: para +#: configuration.xml:1554 +#, no-c-format +msgid "" +"When binding the <literal>SessionFactory</literal> to JNDI, Hibernate will " +"use the values of <literal>hibernate.jndi.url</literal>, <literal>hibernate." +"jndi.class</literal> to instantiate an initial context. If they are not " +"specified, the default <literal>InitialContext</literal> will be used." +msgstr "" +"<literal>SessionFactory</literal> をJNDIに登録するとき、Hibernateは " +"<literal>hibernate.jndi.url</literal> の値を使用し、<literal>hibernate.jndi." +"class</literal> をイニシャルコンテキストとして具体化します。 もし何も設定しな" +"い場合は、デフォルトの <literal>InitialContext</literal> を使用します。" -#: index.docbook:1561 -msgid "Hibernate will automatically place the <literal>SessionFactory</literal> in JNDI after you call <literal>cfg.buildSessionFactory()</literal>. This means you will at least have this call in some startup code (or utility class) in your application, unless you use JMX deployment with the <literal>HibernateService</literal> (discussed later)." -msgstr "<literal>cfg.buildSessionFactory()</literal> をコール後 Hibernateは自動的に <literal>SessionFactory</literal> をJNDIに配置します。 <literal>HibernateService</literal> と一緒にJMXデプロイメントを使わない限り、 これはこの呼び出しをアプリケーション内の何らかのスタートアップコード（もしくはユーティリティクラス） に配置しなければならないことを意味します。（後で議論します）" +#. Tag: para +#: configuration.xml:1561 +#, no-c-format +msgid "" +"Hibernate will automatically place the <literal>SessionFactory</literal> in " +"JNDI after you call <literal>cfg.buildSessionFactory()</literal>. This means " +"you will at least have this call in some startup code (or utility class) in " +"your application, unless you use JMX deployment with the " +"<literal>HibernateService</literal> (discussed later)." +msgstr "" +"<literal>cfg.buildSessionFactory()</literal> をコール後 Hibernateは自動的に " +"<literal>SessionFactory</literal> をJNDIに配置します。 " +"<literal>HibernateService</literal> と一緒にJMXデプロイメントを使わない限" +"り、 これはこの呼び出しをアプリケーション内の何らかのスタートアップコード（も" +"しくはユーティリティクラス） に配置しなければならないことを意味します。（後で" +"議論します）" -#: index.docbook:1568 -msgid "If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other class may obtain the <literal>SessionFactory</literal> using a JNDI lookup." -msgstr "もしJNDI <literal>SessionFactory</literal> を使う場合、EJBや他のクラスは JNDIルックアップを使って <literal>SessionFactory</literal> を取得します。" +#. Tag: para +#: configuration.xml:1568 +#, no-c-format +msgid "" +"If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other " +"class may obtain the <literal>SessionFactory</literal> using a JNDI lookup." +msgstr "" +"もしJNDI <literal>SessionFactory</literal> を使う場合、EJBや他のクラスは JNDI" +"ルックアップを使って <literal>SessionFactory</literal> を取得します。" -#: index.docbook:1573 -msgid "We recommend that you bind the <literal>SessionFactory</literal> to JNDI in a managed environment and use a <literal>static</literal> singleton otherwise. To shield your application code from these details, we also recommend to hide the actual lookup code for a <literal>SessionFactory</literal> in a helper class, such as <literal>HibernateUtil.getSessionFactory()</literal>. Note that such a class is also a convenient way to startup Hibernate&mdash;see chapter 1." -msgstr "管理された環境では <literal>SessionFactory</literal> をJNDIにバインドし、 そうでなければ <literal>static</literal> シングルトンを使うことを推奨します。 こういった詳細からアプリケーションコードを保護するために、 <literal>HibernateUtil.getSessionFactory()</literal> のようなヘルパークラスの中に、 <literal>SessionFactory</literal> をルックアップするコードを隠すことを推奨します。 このようなヘルパークラスはHibernateを開始する便利な手段でもあります。 &mdash;１章を参照してください。" +#. Tag: para +#: configuration.xml:1573 +#, no-c-format +msgid "" +"We recommend that you bind the <literal>SessionFactory</literal> to JNDI in " +"a managed environment and use a <literal>static</literal> singleton " +"otherwise. To shield your application code from these details, we also " +"recommend to hide the actual lookup code for a <literal>SessionFactory</" +"literal> in a helper class, such as <literal>HibernateUtil.getSessionFactory" +"()</literal>. Note that such a class is also a convenient way to startup " +"Hibernate&mdash;see chapter 1." +msgstr "" +"管理された環境では <literal>SessionFactory</literal> をJNDIにバインドし、 そ" +"うでなければ <literal>static</literal> シングルトンを使うことを推奨します。 " +"こういった詳細からアプリケーションコードを保護するために、 " +"<literal>HibernateUtil.getSessionFactory()</literal> のようなヘルパークラスの" +"中に、 <literal>SessionFactory</literal> をルックアップするコードを隠すことを" +"推奨します。 このようなヘルパークラスはHibernateを開始する便利な手段でもあり" +"ます。 &mdash;１章を参照してください。" -#: index.docbook:1585 +#. Tag: title +#: configuration.xml:1585 +#, no-c-format msgid "Current Session context management with JTA" msgstr "JTAによる現在のセッションコンテキストマネージメント" -#: index.docbook:1587 -msgid "The easiest way to handle <literal>Session</literal>s and transactions is Hibernates automatic \"current\" <literal>Session</literal> management. See the discussion of <xref linkend=\"architecture-current-session\"/>current sessions. Using the <literal>\"jta\"</literal> session context, if there is no Hibernate <literal>Session</literal> associated with the current JTA transaction, one will be started and associated with that JTA transaction the first time you call <literal>sessionFactory.getCurrentSession()</literal>. The <literal>Session</literal>s retrieved via <literal>getCurrentSession()</literal> in <literal>\"jta\"</literal> context will be set to automatically flush before the transaction completes, close after the transaction completes, and aggressively release JDBC connections after each statement. This allows the <literal>Session</literal>s to be managed by the life cycle of the JTA transaction to which it is associated, keeping user code clean of such man! agement concerns. Your code can either use JTA programmatically through <literal>UserTransaction</literal>, or (recommended for portable code) use the Hibernate <literal>Transaction</literal> API to set transaction boundaries. If you run in an EJB container, declarative transaction demarcation with CMT is preferred." -msgstr "もっとも簡単に <literal>Session</literal> とトランザクションを扱う方法は、 Hibernateが自動的に「現在の」 <literal>Session</literal> を管理することです。 <xref linkend=\"architecture-current-session\"/>カレントセッション の説明を参照してください。 もし <literal>「JTA」</literal> セッションコンテキストを使った上で、 現在のJTAトランザクションとHibernate <literal>Session</literal> が関連していない場合は、 最初に <literal>sessionFactory.getCurrentSession()</literal> をコールし、 JTAトランザクションとの関連付けを行ってください。 <literal>「JTA」</literal> コンテキストの <literal>getCurrentSession()</literal> を 通じて取得した <literal>Session</literal> は、トランザクションが完了する前に 自動的にフラッシュし、完了した後には自動的にクローズします。 また、各ステー�! ��メント後にJDBCコネクションを積極的にリリースします。 これによりJTAトランザクションのライフサイクルで <literal>Session</literal> を管理することができ、 ユーザーのコードからそのような管理をするコードを排除できます。 <literal>UserTransaction</literal> を通じてJTAをプログラムで管理することができます。 または、（ポータブルなコードであれば）Hibernate <literal>Transaction</literal> APIを トランザクション境界として使うこともできます。 EJBコンテナを使うときは、CMTによる宣言的トランザクション境界が好ましいです。" +#. Tag: para +#: configuration.xml:1587 +#, no-c-format +msgid "" +"The easiest way to handle <literal>Session</literal>s and transactions is " +"Hibernates automatic \"current\" <literal>Session</literal> management. See " +"the discussion of <link linkend=\"architecture-current-session\">current " +"sessions</link>. Using the <literal>\"jta\"</literal> session context, if " +"there is no Hibernate <literal>Session</literal> associated with the current " +"JTA transaction, one will be started and associated with that JTA " +"transaction the first time you call <literal>sessionFactory.getCurrentSession" +"()</literal>. The <literal>Session</literal>s retrieved via " +"<literal>getCurrentSession()</literal> in <literal>\"jta\"</literal> context " +"will be set to automatically flush before the transaction completes, close " +"after the transaction completes, and aggressively release JDBC connections " +"after each statement. This allows the <literal>Session</literal>s to be " +"managed by the life cycle of the JTA transaction to which it is associated, " +"keeping user code clean of such management concerns. Your code can either " +"use JTA programmatically through <literal>UserTransaction</literal>, or " +"(recommended for portable code) use the Hibernate <literal>Transaction</" +"literal> API to set transaction boundaries. If you run in an EJB container, " +"declarative transaction demarcation with CMT is preferred." +msgstr "" +"もっとも簡単に <literal>Session</literal> とトランザクションを扱う方法は、 " +"Hibernateが自動的に「現在の」 <literal>Session</literal> を管理することで" +"す。 <xref linkend=\"architecture-current-session\">カレントセッション</" +"xref> の説明を参照してください。 もし <literal>「JTA」</literal> セッションコ" +"ンテキストを使った上で、 現在のJTAトランザクションとHibernate " +"<literal>Session</literal> が関連していない場合は、 最初に " +"<literal>sessionFactory.getCurrentSession()</literal> をコールし、 JTAトラン" +"ザクションとの関連付けを行ってください。 <literal>「JTA」</literal> コンテキ" +"ストの <literal>getCurrentSession()</literal> を 通じて取得した " +"<literal>Session</literal> は、トランザクションが完了する前に 自動的にフラッ" +"シュし、完了した後には自動的にクローズします。 また、各ステートメント後にJDBC" +"コネクションを積極的にリリースします。 これによりJTAトランザクションのライフ" +"サイクルで <literal>Session</literal> を管理することができ、 ユーザーのコード" +"からそのような管理をするコードを排除できます。 <literal>UserTransaction</" +"literal> を通じてJTAをプログラムで管理することができます。 または、（ポータブ" +"ルなコードであれば）Hibernate <literal>Transaction</literal> APIを トランザク" +"ション境界として使うこともできます。 EJBコンテナを使うときは、CMTによる宣言的" +"トランザクション境界が好ましいです。" -#: index.docbook:1610 +#. Tag: title +#: configuration.xml:1610 +#, no-c-format msgid "JMX deployment" msgstr "JMXデプロイメント" -#: index.docbook:1612 -msgid "The line <literal>cfg.buildSessionFactory()</literal> still has to be executed somewhere to get a <literal>SessionFactory</literal> into JNDI. You can do this either in a <literal>static</literal> initializer block (like the one in <literal>HibernateUtil</literal>) or you deploy Hibernate as a <emphasis>managed service</emphasis>." -msgstr "<literal>SessionFactory</literal> をJNDIから取得するためには <literal>cfg.buildSessionFactory()</literal> 行をどこかで実行していなければなりません。 あなたはこれを、<literal>static</literal> 初期化ブロック内（ <literal>HibernateUtil</literal> のような）か <emphasis>managed service</emphasis> としてHibernateをデプロイするか、どちらかで実行できます。" +#. Tag: para +#: configuration.xml:1612 +#, no-c-format +msgid "" +"The line <literal>cfg.buildSessionFactory()</literal> still has to be " +"executed somewhere to get a <literal>SessionFactory</literal> into JNDI. You " +"can do this either in a <literal>static</literal> initializer block (like " +"the one in <literal>HibernateUtil</literal>) or you deploy Hibernate as a " +"<emphasis>managed service</emphasis>." +msgstr "" +"<literal>SessionFactory</literal> をJNDIから取得するためには <literal>cfg." +"buildSessionFactory()</literal> 行をどこかで実行していなければなりません。 あ" +"なたはこれを、<literal>static</literal> 初期化ブロック内" +"（ <literal>HibernateUtil</literal> のような）か <emphasis>managed service</" +"emphasis> としてHibernateをデプロイするか、どちらかで実行できます。" -#: index.docbook:1620 -msgid "Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</literal> for deployment on an application server with JMX capabilities, such as JBoss AS. The actual deployment and configuration is vendor specific. Here is an example <literal>jboss-service.xml</literal> for JBoss 4.0.x:" -msgstr "JBOSSのようなJMXの機能でアプリケーションサーバにデプロイするために <literal>org.hibernate.jmx.HibernateService</literal> を使って、配置します。 実際のデプロイメントと設定はベンダー特有です。 ここで例としてJBOSS 4.0.x用の <literal>jboss-service.xml</literal> を示します。" +#. Tag: para +#: configuration.xml:1620 +#, no-c-format +msgid "" +"Hibernate is distributed with <literal>org.hibernate.jmx.HibernateService</" +"literal> for deployment on an application server with JMX capabilities, such " +"as JBoss AS. The actual deployment and configuration is vendor specific. " +"Here is an example <literal>jboss-service.xml</literal> for JBoss 4.0.x:" +msgstr "" +"JBOSSのようなJMXの機能でアプリケーションサーバにデプロイするために " +"<literal>org.hibernate.jmx.HibernateService</literal> を使って、配置します。 " +"実際のデプロイメントと設定はベンダー特有です。 ここで例としてJBOSS 4.0.x用の " +"<literal>jboss-service.xml</literal> を示します。" -#: index.docbook:1627 +#. Tag: programlisting +#: configuration.xml:1627 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<server>\n" - "\n" - "<mbean code=\"org.hibernate.jmx.HibernateService\"\n" - " name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory\">\n" - "\n" - " <!-- Required services -->\n" - " <depends>jboss.jca:service=RARDeployer</depends>\n" - " <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>\n" - "\n" - " <!-- Bind the Hibernate service to JNDI -->\n" - " <attribute name=\"JndiName\">java:/hibernate/SessionFactory</attribute>\n" - "\n" - " <!-- Datasource settings -->\n" - " <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" - " <attribute name=\"Dialect\">org.hibernate.dialect.HSQLDialect</attribute>\n" - "\n" - " <!-- Transaction integration -->\n" - " <attribute name=\"TransactionStrategy\">\n" - " org.hibernate.transaction.JTATransactionFactory</attribute>\n" - " <attribute name=\"TransactionManagerLookupStrategy\">\n" - " org.hibernate.transaction.JBossTransactionManagerLookup</attribute>\n" - " <attribute name=\"FlushBeforeCompletionEnabled\">true</attribute>\n" - " <attribute name=\"AutoCloseSessionEnabled\">true</attribute>\n" - "\n" - " <!-- Fetching options -->\n" - " <attribute name=\"MaximumFetchDepth\">5</attribute>\n" - "\n" - " <!-- Second-level caching -->\n" - " <attribute name=\"SecondLevelCacheEnabled\">true</attribute>\n" - " <attribute name=\"CacheProviderClass\">org.hibernate.cache.EhCacheProvider</attribute>\n" - " <attribute name=\"QueryCacheEnabled\">true</attribute>\n" - "\n" - " <!-- Logging -->\n" - " <attribute name=\"ShowSqlEnabled\">true</attribute>\n" - "\n" - " <!-- Mapping files -->\n" - " <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute>\n" - "\n" - "</mbean>\n" - "\n" - "</server>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<server>\n" +"\n" +"<mbean code=\"org.hibernate.jmx.HibernateService\"\n" +" name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory\">\n" +"\n" +" <!-- Required services -->\n" +" <depends>jboss.jca:service=RARDeployer</depends>\n" +" <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>\n" +"\n" +" <!-- Bind the Hibernate service to JNDI -->\n" +" <attribute name=\"JndiName\">java:/hibernate/SessionFactory</attribute>\n" +"\n" +" <!-- Datasource settings -->\n" +" <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" +" <attribute name=\"Dialect\">org.hibernate.dialect.HSQLDialect</" +"attribute>\n" +"\n" +" <!-- Transaction integration -->\n" +" <attribute name=\"TransactionStrategy\">\n" +" org.hibernate.transaction.JTATransactionFactory</attribute>\n" +" <attribute name=\"TransactionManagerLookupStrategy\">\n" +" org.hibernate.transaction.JBossTransactionManagerLookup</attribute>\n" +" <attribute name=\"FlushBeforeCompletionEnabled\">true</attribute>\n" +" <attribute name=\"AutoCloseSessionEnabled\">true</attribute>\n" +"\n" +" <!-- Fetching options -->\n" +" <attribute name=\"MaximumFetchDepth\">5</attribute>\n" +"\n" +" <!-- Second-level caching -->\n" +" <attribute name=\"SecondLevelCacheEnabled\">true</attribute>\n" +" <attribute name=\"CacheProviderClass\">org.hibernate.cache." +"EhCacheProvider</attribute>\n" +" <attribute name=\"QueryCacheEnabled\">true</attribute>\n" +"\n" +" <!-- Logging -->\n" +" <attribute name=\"ShowSqlEnabled\">true</attribute>\n" +"\n" +" <!-- Mapping files -->\n" +" <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/Category." +"hbm.xml</attribute>\n" +"\n" +"</mbean>\n" +"\n" +"</server>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<server>\n" - "\n" - "<mbean code=\"org.hibernate.jmx.HibernateService\"\n" - " name=\"jboss.jca:service=HibernateFactory,name=HibernateFactory\">\n" - "\n" - " <!-- Required services -->\n" - " <depends>jboss.jca:service=RARDeployer</depends>\n" - " <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>\n" - "\n" - " <!-- Bind the Hibernate service to JNDI -->\n" - " <attribute name=\"JndiName\">java:/hibernate/SessionFactory</attribute>\n" - "\n" - " <!-- Datasource settings -->\n" - " <attribute name=\"Datasource\">java:HsqlDS</attribute>\n" - " <attribute name=\"Dialect\">org.hibernate.dialect.HSQLDialect</attribute>\n" - "\n" - " <!-- Transaction integration -->\n" - " <attribute name=\"TransactionStrategy\">\n" - " org.hibernate.transaction.JTATransactionFactory</attribute>\n" - " <attribute name=\"TransactionManagerLookupStrategy\">\n" - " org.hibernate.transaction.JBossTransactionManagerLookup</attribute>\n" - " <attribute name=\"FlushBeforeCompletionEnabled\">true</attribute>\n" - " <attribute name=\"AutoCloseSessionEnabled\">true</attribute>\n" - "\n" - " <!-- Fetching options -->\n" - " <attribute name=\"MaximumFetchDepth\">5</attribute>\n" - "\n" - " <!-- Second-level caching -->\n" - " <attribute name=\"SecondLevelCacheEnabled\">true</attribute>\n" - " <attribute name=\"CacheProviderClass\">org.hibernate.cache.EhCacheProvider</attribute>\n" - " <attribute name=\"QueryCacheEnabled\">true</attribute>\n" - "\n" - " <!-- Logging -->\n" - " <attribute name=\"ShowSqlEnabled\">true</attribute>\n" - "\n" - " <!-- Mapping files -->\n" - " <attribute name=\"MapResources\">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute>\n" - "\n" - "</mbean>\n" - "\n" - "</server>]]>" -#: index.docbook:1629 -msgid "This file is deployed in a directory called <literal>META-INF</literal> and packaged in a JAR file with the extension <literal>.sar</literal> (service archive). You also need to package Hibernate, its required third-party libraries, your compiled persistent classes, as well as your mapping files in the same archive. Your enterprise beans (usually session beans) may be kept in their own JAR file, but you may include this EJB JAR file in the main service archive to get a single (hot-)deployable unit. Consult the JBoss AS documentation for more information about JMX service and EJB deployment." -msgstr "このファイルは <literal>META-INF</literal> ディレクトリに配置され、 JARファイルを拡張した <literal>.sar</literal> (service archive)でパッケージ化されます。 同様にHibernateパッケージも必要です。また、Hibernateはサードパーティのライブラリも要求します。 コンパイルした永続化クラスとそのマッピングファイルも同様にアーカイブ（.sarファイル）に入れます。 エンタープライズbean（通常はセッションbean）は自身のJARファイルを保持しますが、 1回で（ホット）デプロイ可能なユニットのためにメインサービスアーカイブとしてこのEJB JARファイルをインクルードする ことができます。JBossアプリケーションサーバのドキュメントにJXMサービスと EJBデプロイメントのより多くの情報があります。" +#. Tag: para +#: configuration.xml:1629 +#, no-c-format +msgid "" +"This file is deployed in a directory called <literal>META-INF</literal> and " +"packaged in a JAR file with the extension <literal>.sar</literal> (service " +"archive). You also need to package Hibernate, its required third-party " +"libraries, your compiled persistent classes, as well as your mapping files " +"in the same archive. Your enterprise beans (usually session beans) may be " +"kept in their own JAR file, but you may include this EJB JAR file in the " +"main service archive to get a single (hot-)deployable unit. Consult the " +"JBoss AS documentation for more information about JMX service and EJB " +"deployment." +msgstr "" +"このファイルは <literal>META-INF</literal> ディレクトリに配置され、 JARファイ" +"ルを拡張した <literal>.sar</literal> (service archive)でパッケージ化されま" +"す。 同様にHibernateパッケージも必要です。また、Hibernateはサードパーティのラ" +"イブラリも要求します。 コンパイルした永続化クラスとそのマッピングファイルも同" +"様にアーカイブ（.sarファイル）に入れます。 エンタープライズbean（通常はセッ" +"ションbean）は自身のJARファイルを保持しますが、 1回で（ホット）デプロイ可能な" +"ユニットのためにメインサービスアーカイブとしてこのEJB JARファイルをインクルー" +"ドする ことができます。JBossアプリケーションサーバのドキュメントにJXMサービス" +"と EJBデプロイメントのより多くの情報があります。" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" +#~ msgid "<placeholder-1/> (optional)" +#~ msgstr "<placeholder-1/> (オプション)" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" +#~ msgid "InitialContextFactory" +#~ msgstr "InitialContextFactory" +#~ msgid "class of the JNDI <placeholder-1/>" +#~ msgstr "JNDIクラス <placeholder-1/>" + +#~ msgid "eg." +#~ msgstr "例：" + +#~ msgid "full.classname.of.Dialect" +#~ msgstr "full.classname.of.Dialect" + +#~ msgid "debug" +#~ msgstr "debug" + +#~ msgid "SCHEMA_NAME" +#~ msgstr "SCHEMA_NAME" + +#~ msgid "CATALOG_NAME" +#~ msgstr "CATALOG_NAME" + +#~ msgid "SessionFactory" +#~ msgstr "SessionFactory" + +#~ msgid "jndi/composite/name" +#~ msgstr "jndi/composite/name" + +#~ msgid "0" +#~ msgstr "0" + +#~ msgid "false" +#~ msgstr "false" + +#~ msgid "Statement.setFetchSize()" +#~ msgstr "Statement.setFetchSize()" + +#~ msgid "true" +#~ msgstr "executeBatch()" + +#~ msgid "executeBatch()" +#~ msgstr "true" + +#~ msgid "Batcher" +#~ msgstr "Batcher" + +#~ msgid "classname.of.BatcherFactory" +#~ msgstr "classname.of.BatcherFactory" + +#~ msgid "binary" +#~ msgstr "binary" + +#~ msgid "serializable" +#~ msgstr "serializable" + +#~ msgid "PreparedStatement.getGeneratedKeys()" +#~ msgstr "PreparedStatement.getGeneratedKeys()" + +#~ msgid "true|false" +#~ msgstr "true|false" + +#~ msgid "ConnectionProvider" +#~ msgstr "ConnectionProvider" + +#~ msgid "classname.of.ConnectionProvider" +#~ msgstr "classname.of.ConnectionProvider" + +#~ msgid "java.sql.Connection" +#~ msgstr "java.sql.Connection" + +#~ msgid "1, 2, 4, 8" +#~ msgstr "1, 2, 4, 8" + +#~ msgid "after_statement" +#~ msgstr "after_statement" + +#~ msgid "after_transaction" +#~ msgstr "after_transaction" + +#~ msgid "auto" +#~ msgstr "auto" + +#~ msgid "hibernate.connection." +#~ msgstr "&lt;propertyName&gt;" + +#, fuzzy +#~ msgid "&lt;propertyName&gt;" +#~ msgstr "" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "hibernate.connection.<placeholder-1/>\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "propertyName\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "hibernate.jndi.<placeholder-1/>\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "propertyName" + +#~ msgid "DriverManager.getConnection()" +#~ msgstr "DriverManager.getConnection()" + +#~ msgid "Pass the JDBC property <placeholder-1/> to <placeholder-2/>." +#~ msgstr "" +#~ "JDBCの <placeholder-1/> プロパティを、 <placeholder-2/> に渡します。" + +#~ msgid "hibernate.jndi." +#~ msgstr "&lt;propertyName&gt;" + +#~ msgid "Pass the property <placeholder-1/> to the JNDI <placeholder-2/>." +#~ msgstr "<placeholder-1/> プロパティを、 JNDI <placeholder-2/> に渡します。" + +#~ msgid "CacheProvider" +#~ msgstr "CacheProvider" + +#~ msgid "classname.of.CacheProvider" +#~ msgstr "classname.of.CacheProvider" + +#~ msgid "&lt;cache&gt;" +#~ msgstr "&lt;cache&gt;" + +#~ msgid "QueryCache" +#~ msgstr "QueryCache" + +#~ msgid "StandardQueryCache" +#~ msgstr "StandardQueryCache" + +#~ msgid "classname.of.QueryCache" +#~ msgstr "classname.of.QueryCache" + +#~ msgid "prefix" +#~ msgstr "prefix" + +#~ msgid "TransactionFactory" +#~ msgstr "Transaction" + +#~ msgid "Transaction" +#~ msgstr "TransactionFactory" + +#~ msgid "JDBCTransactionFactory" +#~ msgstr "JDBCTransactionFactory" + +#~ msgid "classname.of.TransactionFactory" +#~ msgstr "classname.of.TransactionFactory" + +#~ msgid "JTATransactionFactory" +#~ msgstr "UserTransaction" + +#~ msgid "UserTransaction" +#~ msgstr "JTATransactionFactory" + +#~ msgid "TransactionManagerLookup" +#~ msgstr "TransactionManagerLookup" + +#~ msgid "classname.of.TransactionManagerLookup" +#~ msgstr "classname.of.TransactionManagerLookup" + +#~ msgid "Session" +#~ msgstr "Session" + +#~ msgid "hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC" +#~ msgstr "hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC" + +#~ msgid "create-drop" +#~ msgstr "create-drop" + +#~ msgid "hibernate.cfg.xml" +#~ msgstr "hibernate.cfg.xml" + +#~ msgid "DB2" +#~ msgstr "DB2" Modified: core/trunk/documentation/manual/translations/ja-JP/content/events.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/events.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/events.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,457 +1,471 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: events.xml:5 +#, no-c-format msgid "Interceptors and events" msgstr "インターセプタとイベント" -#: index.docbook:7 -msgid "It is often useful for the application to react to certain events that occur inside Hibernate. This allows implementation of certain kinds of generic functionality, and extension of Hibernate functionality." -msgstr "アプリケーションがHibernateの内部で発生するイベントに対応できると役に立つことがあります。 ある種の一般的な機能を実装できるようになり、 またHibernateの機能を拡張することもできるようになります。" +#. Tag: para +#: events.xml:7 +#, no-c-format +msgid "" +"It is often useful for the application to react to certain events that occur " +"inside Hibernate. This allows implementation of certain kinds of generic " +"functionality, and extension of Hibernate functionality." +msgstr "" +"アプリケーションがHibernateの内部で発生するイベントに対応できると役に立つこと" +"があります。 ある種の一般的な機能を実装できるようになり、 またHibernateの機能" +"を拡張することもできるようになります。" -#: index.docbook:14 +#. Tag: title +#: events.xml:14 +#, no-c-format msgid "Interceptors" msgstr "インターセプタ" -#: index.docbook:16 -msgid "The <literal>Interceptor</literal> interface provides callbacks from the session to the application allowing the application to inspect and/or manipulate properties of a persistent object before it is saved, updated, deleted or loaded. One possible use for this is to track auditing information. For example, the following <literal>Interceptor</literal> automatically sets the <literal>createTimestamp</literal> when an <literal>Auditable</literal> is created and updates the <literal>lastUpdateTimestamp</literal> property when an <literal>Auditable</literal> is updated." -msgstr "<literal>Interceptor</literal> インターフェイスを使って、 セッションからアプリケーションへコールバックをすることができます。 これにより永続オブジェクトの保存、更新、削除、読み込みの前に、 アプリケーションがプロパティを検査したり操作したりできるようになります。 これは監査情報の追跡に利用できます。 下の例で <literal>Interceptor</literal> は <literal>Auditable</literal> が作成されると自動的に <literal>createTimestamp</literal> を設定し、 <literal>Auditable</literal> が更新されると自動的に <literal>lastUpdateTimestamp</literal> プロパティを更新します。" +#. Tag: para +#: events.xml:16 +#, no-c-format +msgid "" +"The <literal>Interceptor</literal> interface provides callbacks from the " +"session to the application allowing the application to inspect and/or " +"manipulate properties of a persistent object before it is saved, updated, " +"deleted or loaded. One possible use for this is to track auditing " +"information. For example, the following <literal>Interceptor</literal> " +"automatically sets the <literal>createTimestamp</literal> when an " +"<literal>Auditable</literal> is created and updates the " +"<literal>lastUpdateTimestamp</literal> property when an <literal>Auditable</" +"literal> is updated." +msgstr "" +"<literal>Interceptor</literal> インターフェイスを使って、 セッションからアプ" +"リケーションへコールバックをすることができます。 これにより永続オブジェクトの" +"保存、更新、削除、読み込みの前に、 アプリケーションがプロパティを検査したり操" +"作したりできるようになります。 これは監査情報の追跡に利用できます。 下の例で " +"<literal>Interceptor</literal> は <literal>Auditable</literal> が作成されると" +"自動的に <literal>createTimestamp</literal> を設定し、 <literal>Auditable</" +"literal> が更新されると自動的に <literal>lastUpdateTimestamp</literal> プロパ" +"ティを更新します。" -#: index.docbook:27 -msgid "You may either implement <literal>Interceptor</literal> directly or (better) extend <literal>EmptyInterceptor</literal>." -msgstr "<literal>Interceptor</literal> を直接実装したり、 （さらによいのは）<literal>EmptyInterceptor</literal> を拡張したりできます。" +#. Tag: para +#: events.xml:27 +#, no-c-format +msgid "" +"You may either implement <literal>Interceptor</literal> directly or (better) " +"extend <literal>EmptyInterceptor</literal>." +msgstr "" +"<literal>Interceptor</literal> を直接実装したり、 （さらによいのは）" +"<literal>EmptyInterceptor</literal> を拡張したりできます。" -#: index.docbook:32 +#. Tag: programlisting +#: events.xml:32 +#, no-c-format msgid "" - "<![CDATA[package org.hibernate.test;\n" - "\n" - "import java.io.Serializable;\n" - "import java.util.Date;\n" - "import java.util.Iterator;\n" - "\n" - "import org.hibernate.EmptyInterceptor;\n" - "import org.hibernate.Transaction;\n" - "import org.hibernate.type.Type;\n" - "\n" - "public class AuditInterceptor extends EmptyInterceptor {\n" - "\n" - " private int updates;\n" - " private int creates;\n" - " private int loads;\n" - "\n" - " public void onDelete(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - " // do nothing\n" - " }\n" - "\n" - " public boolean onFlushDirty(Object entity,\n" - " Serializable id,\n" - " Object[] currentState,\n" - " Object[] previousState,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - "\n" - " if ( entity instanceof Auditable ) {\n" - " updates++;\n" - " for ( int i=0; i < propertyNames.length; i++ ) {\n" - " if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) {\n" - " currentState[i] = new Date();\n" - " return true;\n" - " }\n" - " }\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public boolean onLoad(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - " if ( entity instanceof Auditable ) {\n" - " loads++;\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public boolean onSave(Object entity,\n" - " Serializable id,\n" - " Object[] state,\n" - " String[] propertyNames,\n" - " Type[] types) {\n" - "\n" - " if ( entity instanceof Auditable ) {\n" - " creates++;\n" - " for ( int i=0; i<propertyNames.length; i++ ) {\n" - " if ( \"createTimestamp\".equals( propertyNames[i] ) ) {\n" - " state[i] = new Date();\n" - " return true;\n" - " }\n" - " }\n" - " }\n" - " return false;\n" - " }\n" - "\n" - " public void afterTransactionCompletion(Transaction tx) {\n" - " if ( tx.wasCommitted() ) {\n" - " System.out.println(\"Creations: \" + creates + \", Updates: \" + updates, \"Loads: \" + loads);\n" - " }\n" - " updates=0;\n" - " creates=0;\n" - " loads=0;\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[package org.hibernate.test;\n" +"\n" +"import java.io.Serializable;\n" +"import java.util.Date;\n" +"import java.util.Iterator;\n" +"\n" +"import org.hibernate.EmptyInterceptor;\n" +"import org.hibernate.Transaction;\n" +"import org.hibernate.type.Type;\n" +"\n" +"public class AuditInterceptor extends EmptyInterceptor {\n" +"\n" +" private int updates;\n" +" private int creates;\n" +" private int loads;\n" +"\n" +" public void onDelete(Object entity,\n" +" Serializable id,\n" +" Object[] state,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +" // do nothing\n" +" }\n" +"\n" +" public boolean onFlushDirty(Object entity,\n" +" Serializable id,\n" +" Object[] currentState,\n" +" Object[] previousState,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +"\n" +" if ( entity instanceof Auditable ) {\n" +" updates++;\n" +" for ( int i=0; i < propertyNames.length; i++ ) {\n" +" if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) {\n" +" currentState[i] = new Date();\n" +" return true;\n" +" }\n" +" }\n" +" }\n" +" return false;\n" +" }\n" +"\n" +" public boolean onLoad(Object entity,\n" +" Serializable id,\n" +" Object[] state,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +" if ( entity instanceof Auditable ) {\n" +" loads++;\n" +" }\n" +" return false;\n" +" }\n" +"\n" +" public boolean onSave(Object entity,\n" +" Serializable id,\n" +" Object[] state,\n" +" String[] propertyNames,\n" +" Type[] types) {\n" +"\n" +" if ( entity instanceof Auditable ) {\n" +" creates++;\n" +" for ( int i=0; i<propertyNames.length; i++ ) {\n" +" if ( \"createTimestamp\".equals( propertyNames[i] ) ) {\n" +" state[i] = new Date();\n" +" return true;\n" +" }\n" +" }\n" +" }\n" +" return false;\n" +" }\n" +"\n" +" public void afterTransactionCompletion(Transaction tx) {\n" +" if ( tx.wasCommitted() ) {\n" +" System.out.println(\"Creations: \" + creates + \", Updates: \" + " +"updates, \"Loads: \" + loads);\n" +" }\n" +" updates=0;\n" +" creates=0;\n" +" loads=0;\n" +" }\n" +"\n" +"}]]>" msgstr "" - "<![CDATA[package org.hibernate.test; -\n" - " -\n" - "import java.io.Serializable; -\n" - "import java.util.Date; -\n" - "import java.util.Iterator; -\n" - " -\n" - "import org.hibernate.EmptyInterceptor; -\n" - "import org.hibernate.Transaction; -\n" - "import org.hibernate.type.Type; -\n" - " -\n" - "public class AuditInterceptor extends EmptyInterceptor { -\n" - " -\n" - " private int updates; -\n" - " private int creates; -\n" - " private int loads; -\n" - " -\n" - " public void onDelete(Object entity, -\n" - " Serializable id, -\n" - " Object[] state, -\n" - " String[] propertyNames, -\n" - " Type[] types) { -\n" - " // do nothing -\n" - " } -\n" - " -\n" - " public boolean onFlushDirty(Object entity, -\n" - " Serializable id, -\n" - " Object[] currentState, -\n" - " Object[] previousState, -\n" - " String[] propertyNames, -\n" - " Type[] types) { -\n" - " -\n" - " if ( entity instanceof Auditable ) { -\n" - " updates++; -\n" - " for ( int i=0; i < propertyNames.length; i++ ) { -\n" - " if ( \"lastUpdateTimestamp\".equals( propertyNames[i] ) ) { -\n" - " currentState[i] = new Date(); -\n" - " return true; -\n" - " } -\n" - " } -\n" - " } -\n" - " return false; -\n" - " } -\n" - " -\n" - " public boolean onLoad(Object entity, -\n" - " Serializable id, -\n" - " Object[] state, -\n" - " String[] propertyNames, -\n" - " Type[] types) { -\n" - " if ( entity instanceof Auditable ) { -\n" - " loads++; -\n" - " } -\n" - " return false; -\n" - " } -\n" - " -\n" - " public boolean onSave(Object entity, -\n" - " Serializable id, -\n" - " Object[] state, -\n" - " String[] propertyNames, -\n" - " Type[] types) { -\n" - " -\n" - " if ( entity instanceof Auditable ) { -\n" - " creates++; -\n" - " for ( int i=0; i<propertyNames.length; i++ ) { -\n" - " if ( \"createTimestamp\".equals( propertyNames[i] ) ) { -\n" - " state[i] = new Date(); -\n" - " return true; -\n" - " } -\n" - " } -\n" - " } -\n" - " return false; -\n" - " } -\n" - " -\n" - " public void afterTransactionCompletion(Transaction tx) { -\n" - " if ( tx.wasCommitted() ) { -\n" - " System.out.println(\"Creations: \" + creates + \", Updates: \" + updates, \"Loads: \" + loads); -\n" - " } -\n" - " updates=0; -\n" - " creates=0; -\n" - " loads=0; -\n" - " } -\n" - " -\n" - "}]]>" -#: index.docbook:34 -msgid "Interceptors come in two flavors: <literal>Session</literal>-scoped and <literal>SessionFactory</literal>-scoped." -msgstr "インターセプタには二種類あります： <literal>Session</literal> スコープのものと <literal>SessionFactory</literal> スコープのものです。" +#. Tag: para +#: events.xml:34 +#, no-c-format +msgid "" +"Interceptors come in two flavors: <literal>Session</literal>-scoped and " +"<literal>SessionFactory</literal>-scoped." +msgstr "" +"インターセプタには二種類あります： <literal>Session</literal> スコープのもの" +"と <literal>SessionFactory</literal> スコープのものです。" -#: index.docbook:39 -msgid "A <literal>Session</literal>-scoped interceptor is specified when a session is opened using one of the overloaded SessionFactory.openSession() methods accepting an <literal>Interceptor</literal>." -msgstr "<literal>Session</literal> スコープのインターセプタは、 セッションをオープンするときに指定します。 <literal>Interceptor</literal> を引数に取るSessionFactory.openSession() のオーバーロードメソッドの一つを使います。" +#. Tag: para +#: events.xml:39 +#, no-c-format +msgid "" +"A <literal>Session</literal>-scoped interceptor is specified when a session " +"is opened using one of the overloaded SessionFactory.openSession() methods " +"accepting an <literal>Interceptor</literal>." +msgstr "" +"<literal>Session</literal> スコープのインターセプタは、 セッションをオープン" +"するときに指定します。 <literal>Interceptor</literal> を引数に取る" +"SessionFactory.openSession() のオーバーロードメソッドの一つを使います。" -#: index.docbook:45 +#. Tag: programlisting +#: events.xml:45 +#, no-c-format msgid "<![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]>" -msgstr "<![CDATA[Session session = sf.openSession( new AuditInterceptor() );]]>" +msgstr "" -#: index.docbook:47 -msgid "A <literal>SessionFactory</literal>-scoped interceptor is registered with the <literal>Configuration</literal> object prior to building the <literal>SessionFactory</literal>. In this case, the supplied interceptor will be applied to all sessions opened from that <literal>SessionFactory</literal>; this is true unless a session is opened explicitly specifying the interceptor to use. <literal>SessionFactory</literal>-scoped interceptors must be thread safe, taking care to not store session-specific state since multiple sessions will use this interceptor (potentially) concurrently." -msgstr "<literal>SessionFactory</literal> スコープのインターセプタは <literal>Configuration</literal> オブジェクトを使って登録します。 これは <literal>SessionFactory</literal> の構築よりも優先されます。 この場合、提供されるインターセプタは <literal>SessionFactory</literal> からオープンされたすべてのセッションに適用されます。 これは使用するインターセプタを明示的に指定してセッションをオープンしない限り、そうなります。 <literal>SessionFactory</literal> スコープのインターセプタはスレッドセーフでなければなりません。 複数のセッションが（潜在的に）このインターセプタを同時並行で使用することになるため、 セッション固有の状態を格納しないように気をつけてください。" +#. Tag: para +#: events.xml:47 +#, no-c-format +msgid "" +"A <literal>SessionFactory</literal>-scoped interceptor is registered with " +"the <literal>Configuration</literal> object prior to building the " +"<literal>SessionFactory</literal>. In this case, the supplied interceptor " +"will be applied to all sessions opened from that <literal>SessionFactory</" +"literal>; this is true unless a session is opened explicitly specifying the " +"interceptor to use. <literal>SessionFactory</literal>-scoped interceptors " +"must be thread safe, taking care to not store session-specific state since " +"multiple sessions will use this interceptor (potentially) concurrently." +msgstr "" +"<literal>SessionFactory</literal> スコープのインターセプタは " +"<literal>Configuration</literal> オブジェクトを使って登録します。 これは " +"<literal>SessionFactory</literal> の構築よりも優先されます。 この場合、提供さ" +"れるインターセプタは <literal>SessionFactory</literal> からオープンされたすべ" +"てのセッションに適用されます。 これは使用するインターセプタを明示的に指定して" +"セッションをオープンしない限り、そうなります。 <literal>SessionFactory</" +"literal> スコープのインターセプタはスレッドセーフでなければなりません。 複数" +"のセッションが（潜在的に）このインターセプタを同時並行で使用することになるた" +"め、 セッション固有の状態を格納しないように気をつけてください。" -#: index.docbook:56 -msgid "<![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]>" -msgstr "<![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]>" +#. Tag: programlisting +#: events.xml:56 +#, no-c-format +msgid "" +"<![CDATA[new Configuration().setInterceptor( new AuditInterceptor() );]]>" +msgstr "" -#: index.docbook:61 +#. Tag: title +#: events.xml:61 +#, no-c-format msgid "Event system" msgstr "イベントシステム" -#: index.docbook:63 -msgid "If you have to react to particular events in your persistence layer, you may also use the Hibernate3 <emphasis>event</emphasis> architecture. The event system can be used in addition or as a replacement for interceptors." -msgstr "永続化層で特定のイベントに対応しなければならない場合、 Hibernate3の <emphasis>イベント</emphasis> アーキテクチャを使うこともできます。 イベントシステムはインターセプタと一緒に使うか、またはインターセプタの代わりとして使うことができます。" +#. Tag: para +#: events.xml:63 +#, no-c-format +msgid "" +"If you have to react to particular events in your persistence layer, you may " +"also use the Hibernate3 <emphasis>event</emphasis> architecture. The event " +"system can be used in addition or as a replacement for interceptors." +msgstr "" +"永続化層で特定のイベントに対応しなければならない場合、 Hibernate3の " +"<emphasis>イベント</emphasis> アーキテクチャを使うこともできます。 イベントシ" +"ステムはインターセプタと一緒に使うか、またはインターセプタの代わりとして使う" +"ことができます。" -#: index.docbook:69 -msgid "Essentially all of the methods of the <literal>Session</literal> interface correlate to an event. You have a <literal>LoadEvent</literal>, a <literal>FlushEvent</literal>, etc (consult the XML configuration-file DTD or the <literal>org.hibernate.event</literal> package for the full list of defined event types). When a request is made of one of these methods, the Hibernate <literal>Session</literal> generates an appropriate event and passes it to the configured event listeners for that type. Out-of-the-box, these listeners implement the same processing in which those methods always resulted. However, you are free to implement a customization of one of the listener interfaces (i.e., the <literal>LoadEvent</literal> is processed by the registered implemenation of the <literal>LoadEventListener</literal> interface), in which case their implementation would be responsible for processing any <literal>load()</literal> requests made of the <literal>Session</literal>." -msgstr "本質的に <literal>Session</literal> インターフェイスのすべてのメソッドは、 1個のイベントと相互に関連します。 例えば <literal>LoadEvent</literal>、<literal>FlushEvent</literal> などがあります （定義済みのイベント型の一覧については、XML設定ファイルのDTDや <literal>org.hibernate.event</literal> パッケージを調べてください）。 リクエストがこれらのメソッドの1つから作られるとき、 Hibernateの <literal>Session</literal> は適切なイベントを生成し、 そのイベント型に設定されたイベントリスナに渡します。 すばらしいことに、これらのリスナはそのメソッドと同じ処理を実装します。 とはいえ、リスナインターフェイスの一つを自由にカスタム実装できます （つまり、<literal>LoadEvent</literal> は登録された <literal>LoadEventListener</literal> インターフェイ! スの実装により処理されます）。 その場合、その実装には <literal>Session</literal> から作られたどのような <literal>load()</literal> リクエストをも処理する責任があります。" +#. Tag: para +#: events.xml:69 +#, no-c-format +msgid "" +"Essentially all of the methods of the <literal>Session</literal> interface " +"correlate to an event. You have a <literal>LoadEvent</literal>, a " +"<literal>FlushEvent</literal>, etc (consult the XML configuration-file DTD " +"or the <literal>org.hibernate.event</literal> package for the full list of " +"defined event types). When a request is made of one of these methods, the " +"Hibernate <literal>Session</literal> generates an appropriate event and " +"passes it to the configured event listeners for that type. Out-of-the-box, " +"these listeners implement the same processing in which those methods always " +"resulted. However, you are free to implement a customization of one of the " +"listener interfaces (i.e., the <literal>LoadEvent</literal> is processed by " +"the registered implemenation of the <literal>LoadEventListener</literal> " +"interface), in which case their implementation would be responsible for " +"processing any <literal>load()</literal> requests made of the " +"<literal>Session</literal>." +msgstr "" +"本質的に <literal>Session</literal> インターフェイスのすべてのメソッドは、 1" +"個のイベントと相互に関連します。 例えば <literal>LoadEvent</literal>、" +"<literal>FlushEvent</literal> などがあります （定義済みのイベント型の一覧につ" +"いては、XML設定ファイルのDTDや <literal>org.hibernate.event</literal> パッ" +"ケージを調べてください）。 リクエストがこれらのメソッドの1つから作られると" +"き、 Hibernateの <literal>Session</literal> は適切なイベントを生成し、 そのイ" +"ベント型に設定されたイベントリスナに渡します。 すばらしいことに、これらのリス" +"ナはそのメソッドと同じ処理を実装します。 とはいえ、リスナインターフェイスの一" +"つを自由にカスタム実装できます （つまり、<literal>LoadEvent</literal> は登録" +"された <literal>LoadEventListener</literal> インターフェイスの実装により処理" +"されます）。 その場合、その実装には <literal>Session</literal> から作られたど" +"のような <literal>load()</literal> リクエストをも処理する責任があります。" -#: index.docbook:84 -msgid "The listeners should be considered effectively singletons; meaning, they are shared between requests, and thus should not save any state as instance variables." -msgstr "リスナは事実上シングルトンであると見なせます。 つまりリスナはリクエスト間で共有されるため、 インスタンス変数として状態を保持するべきではないということです。" +#. Tag: para +#: events.xml:84 +#, no-c-format +msgid "" +"The listeners should be considered effectively singletons; meaning, they are " +"shared between requests, and thus should not save any state as instance " +"variables." +msgstr "" +"リスナは事実上シングルトンであると見なせます。 つまりリスナはリクエスト間で共" +"有されるため、 インスタンス変数として状態を保持するべきではないということで" +"す。" -#: index.docbook:89 -msgid "A custom listener should implement the appropriate interface for the event it wants to process and/or extend one of the convenience base classes (or even the default event listeners used by Hibernate out-of-the-box as these are declared non-final for this purpose). Custom listeners can either be registered programmatically through the <literal>Configuration</literal> object, or specified in the Hibernate configuration XML (declarative configuration through the properties file is not supported). Here's an example of a custom load event listener:" -msgstr "カスタムリスナは処理したいイベントについて適切なインターフェイスを実装するべきです。 便利な基底クラスのうちの一つを継承してもよいです （またはHibernateがデフォルトで使用するイベントリスナを継承してもよいです。 すばらしいことに、この目的のために非finalとして宣言されています）。 カスタムリスナは <literal>Configuration</literal> オブジェクトを使ってプログラムから登録するか、 HibernateのXML設定ファイルで指定できます （プロパティファイルで宣言的に設定する方法はサポートされていません）。 カスタムロードイベントリスナの例を示します。" +#. Tag: para +#: events.xml:89 +#, no-c-format +msgid "" +"A custom listener should implement the appropriate interface for the event " +"it wants to process and/or extend one of the convenience base classes (or " +"even the default event listeners used by Hibernate out-of-the-box as these " +"are declared non-final for this purpose). Custom listeners can either be " +"registered programmatically through the <literal>Configuration</literal> " +"object, or specified in the Hibernate configuration XML (declarative " +"configuration through the properties file is not supported). Here's an " +"example of a custom load event listener:" +msgstr "" +"カスタムリスナは処理したいイベントについて適切なインターフェイスを実装するべ" +"きです。 便利な基底クラスのうちの一つを継承してもよいです （またはHibernateが" +"デフォルトで使用するイベントリスナを継承してもよいです。 すばらしいことに、こ" +"の目的のために非finalとして宣言されています）。 カスタムリスナは " +"<literal>Configuration</literal> オブジェクトを使ってプログラムから登録する" +"か、 HibernateのXML設定ファイルで指定できます （プロパティファイルで宣言的に" +"設定する方法はサポートされていません）。 カスタムロードイベントリスナの例を示" +"します。" -#: index.docbook:99 +#. Tag: programlisting +#: events.xml:99 +#, no-c-format msgid "" - "<![CDATA[public class MyLoadListener implements LoadEventListener {\n" - " // this is the single method defined by the LoadEventListener interface\n" - " public void onLoad(LoadEvent event, LoadEventListener.LoadType loadType)\n" - " throws HibernateException {\n" - " if ( !MySecurity.isAuthorized( event.getEntityClassName(), event.getEntityId() ) ) {\n" - " throw MySecurityException(\"Unauthorized access\");\n" - " }\n" - " }\n" - "}]]>" +"<![CDATA[public class MyLoadListener implements LoadEventListener {\n" +" // this is the single method defined by the LoadEventListener interface\n" +" public void onLoad(LoadEvent event, LoadEventListener.LoadType " +"loadType)\n" +" throws HibernateException {\n" +" if ( !MySecurity.isAuthorized( event.getEntityClassName(), event." +"getEntityId() ) ) {\n" +" throw MySecurityException(\"Unauthorized access\");\n" +" }\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[public class MyLoadListener implements LoadEventListener { -\n" - " // this is the single method defined by the LoadEventListener interface -\n" - " public void onLoad(LoadEvent event, LoadEventListener.LoadType loadType) -\n" - " throws HibernateException { -\n" - " if ( !MySecurity.isAuthorized( event.getEntityClassName(), event.getEntityId() ) ) { -\n" - " throw MySecurityException(\"Unauthorized access\"); -\n" - " } -\n" - " } -\n" - "}]]>" -#: index.docbook:101 -msgid "You also need a configuration entry telling Hibernate to use the listener in addition to the default listener:" +#. Tag: para +#: events.xml:101 +#, no-c-format +msgid "" +"You also need a configuration entry telling Hibernate to use the listener in " +"addition to the default listener:" msgstr "デフォルトリスナ以外のリスナを使うには、Hibernateへの設定も必要です：" -#: index.docbook:106 +#. Tag: programlisting +#: events.xml:106 +#, no-c-format msgid "" - "<![CDATA[<hibernate-configuration>\n" - " <session-factory>\n" - " ...\n" - " <event type=\"load\">\n" - " <listener class=\"com.eg.MyLoadListener\"/>\n" - " <listener class=\"org.hibernate.event.def.DefaultLoadEventListener\"/>\n" - " </event>\n" - " </session-factory>\n" - "</hibernate-configuration>]]>" +"<![CDATA[<hibernate-configuration>\n" +" <session-factory>\n" +" ...\n" +" <event type=\"load\">\n" +" <listener class=\"com.eg.MyLoadListener\"/>\n" +" <listener class=\"org.hibernate.event.def." +"DefaultLoadEventListener\"/>\n" +" </event>\n" +" </session-factory>\n" +"</hibernate-configuration>]]>" msgstr "" - "<![CDATA[<hibernate-configuration> -\n" - " <session-factory> -\n" - " ... -\n" - " <event type=\"load\"> -\n" - " <listener class=\"com.eg.MyLoadListener\"/> -\n" - " <listener class=\"org.hibernate.event.def.DefaultLoadEventListener\"/> -\n" - " </event> -\n" - " </session-factory> -\n" - "</hibernate-configuration>]]>" -#: index.docbook:108 +#. Tag: para +#: events.xml:108 +#, no-c-format msgid "Instead, you may register it programmatically:" msgstr "またその他に、プログラムで登録する方法もあります：" -#: index.docbook:112 +#. Tag: programlisting +#: events.xml:112 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = new Configuration();\n" - "LoadEventListener[] stack = { new MyLoadListener(), new DefaultLoadEventListener() };\n" - "cfg.EventListeners().setLoadEventListeners(stack);]]>" +"<![CDATA[Configuration cfg = new Configuration();\n" +"LoadEventListener[] stack = { new MyLoadListener(), new " +"DefaultLoadEventListener() };\n" +"cfg.EventListeners().setLoadEventListeners(stack);]]>" msgstr "" - "<![CDATA[Configuration cfg = new Configuration(); -\n" - "LoadEventListener[] stack = { new MyLoadListener(), new DefaultLoadEventListener() }; -\n" - "cfg.EventListeners().setLoadEventListeners(stack);]]>" -#: index.docbook:114 -msgid "Listeners registered declaratively cannot share instances. If the same class name is used in multiple <literal>&lt;listener/&gt;</literal> elements, each reference will result in a separate instance of that class. If you need the capability to share listener instances between listener types you must use the programmatic registration approach." -msgstr "リスナを宣言的に登録すると、そのリスナのインスタンスを共有できません。 複数の <literal>&lt;listener/&gt;</literal> 要素で同じクラス名が使われると、 それぞれの参照はそのクラスの別々のインスタンスを指すことになります。 リスナ型の間でリスナインスタンスを共有する必要があれば、 プログラムで登録する方法を採らなければなりません。" +#. Tag: para +#: events.xml:114 +#, no-c-format +msgid "" +"Listeners registered declaratively cannot share instances. If the same class " +"name is used in multiple <literal>&lt;listener/&gt;</literal> elements, each " +"reference will result in a separate instance of that class. If you need the " +"capability to share listener instances between listener types you must use " +"the programmatic registration approach." +msgstr "" +"リスナを宣言的に登録すると、そのリスナのインスタンスを共有できません。 複数" +"の <literal>&lt;listener/&gt;</literal> 要素で同じクラス名が使われると、 それ" +"ぞれの参照はそのクラスの別々のインスタンスを指すことになります。 リスナ型の間" +"でリスナインスタンスを共有する必要があれば、 プログラムで登録する方法を採らな" +"ければなりません。" -#: index.docbook:122 -msgid "Why implement an interface and define the specific type during configuration? Well, a listener implementation could implement multiple event listener interfaces. Having the type additionally defined during registration makes it easier to turn custom listeners on or off during configuration." -msgstr "なぜインターフェイスを実装して、特化した型を設定時に指定するのでしょうか？ リスナの実装クラスに、複数のイベントリスナインターフェイスを実装できるからです。 登録時に追加で型を指定することで、カスタムリスナのon/offを設定時に簡単に切り替えられます。" +#. Tag: para +#: events.xml:122 +#, no-c-format +msgid "" +"Why implement an interface and define the specific type during " +"configuration? Well, a listener implementation could implement multiple " +"event listener interfaces. Having the type additionally defined during " +"registration makes it easier to turn custom listeners on or off during " +"configuration." +msgstr "" +"なぜインターフェイスを実装して、特化した型を設定時に指定するのでしょうか？ リ" +"スナの実装クラスに、複数のイベントリスナインターフェイスを実装できるからで" +"す。 登録時に追加で型を指定することで、カスタムリスナのon/offを設定時に簡単に" +"切り替えられます。" -#: index.docbook:132 +#. Tag: title +#: events.xml:132 +#, no-c-format msgid "Hibernate declarative security" msgstr "Hibernateの宣言的なセキュリティ" -#: index.docbook:133 -msgid "Usually, declarative security in Hibernate applications is managed in a session facade layer. Now, Hibernate3 allows certain actions to be permissioned via JACC, and authorized via JAAS. This is optional functionality built on top of the event architecture." -msgstr "一般的にHibernateアプリケーションの宣言的なセキュリティは、セッションファサード層で管理します。 現在、Hiberenate3はJACCで許可しかつ、JAASで認証したアクションを許しています。 これはイベントアーキテクチャの最上位に組み込まれているオプションの機能です。" +#. Tag: para +#: events.xml:133 +#, no-c-format +msgid "" +"Usually, declarative security in Hibernate applications is managed in a " +"session facade layer. Now, Hibernate3 allows certain actions to be " +"permissioned via JACC, and authorized via JAAS. This is optional " +"functionality built on top of the event architecture." +msgstr "" +"一般的にHibernateアプリケーションの宣言的なセキュリティは、セッションファサー" +"ド層で管理します。 現在、Hiberenate3はJACCで許可しかつ、JAASで認証したアク" +"ションを許しています。 これはイベントアーキテクチャの最上位に組み込まれている" +"オプションの機能です。" -#: index.docbook:139 -msgid "First, you must configure the appropriate event listeners, to enable the use of JAAS authorization." -msgstr "まず最初に、適切なイベントリスナを設定してJAAS認証を使えるようにしなければなりません。" +#. Tag: para +#: events.xml:139 +#, no-c-format +msgid "" +"First, you must configure the appropriate event listeners, to enable the use " +"of JAAS authorization." +msgstr "" +"まず最初に、適切なイベントリスナを設定してJAAS認証を使えるようにしなければな" +"りません。" -#: index.docbook:144 +#. Tag: programlisting +#: events.xml:144 +#, no-c-format msgid "" - "<![CDATA[<listener type=\"pre-delete\" class=\"org.hibernate.secure.JACCPreDeleteEventListener\"/>\n" - "<listener type=\"pre-update\" class=\"org.hibernate.secure.JACCPreUpdateEventListener\"/>\n" - "<listener type=\"pre-insert\" class=\"org.hibernate.secure.JACCPreInsertEventListener\"/>\n" - "<listener type=\"pre-load\" class=\"org.hibernate.secure.JACCPreLoadEventListener\"/>]]>" +"<![CDATA[<listener type=\"pre-delete\" class=\"org.hibernate.secure." +"JACCPreDeleteEventListener\"/>\n" +"<listener type=\"pre-update\" class=\"org.hibernate.secure." +"JACCPreUpdateEventListener\"/>\n" +"<listener type=\"pre-insert\" class=\"org.hibernate.secure." +"JACCPreInsertEventListener\"/>\n" +"<listener type=\"pre-load\" class=\"org.hibernate.secure." +"JACCPreLoadEventListener\"/>]]>" msgstr "" - "<![CDATA[<listener type=\"pre-delete\" class=\"org.hibernate.secure.JACCPreDeleteEventListener\"/> -\n" - "<listener type=\"pre-update\" class=\"org.hibernate.secure.JACCPreUpdateEventListener\"/> -\n" - "<listener type=\"pre-insert\" class=\"org.hibernate.secure.JACCPreInsertEventListener\"/> -\n" - "<listener type=\"pre-load\" class=\"org.hibernate.secure.JACCPreLoadEventListener\"/>]]>" -#: index.docbook:146 -msgid "Note that <literal>&lt;listener type=\"...\" class=\"...\"/&gt;</literal> is just a shorthand for <literal>&lt;event type=\"...\"&gt;&lt;listener class=\"...\"/&gt;&lt;/event&gt;</literal> when there is exactly one listener for a particular event type." -msgstr "特定のイベント型に対してちょうど一つのリスナがあるとき、 <literal>&lt;listener type=\"...\" class=\"...\"/&gt;</literal> は <literal>&lt;event type=\"...\"&gt;&lt;listener class=\"...\"/&gt;&lt;/event&gt;</literal> の簡略形に過ぎないことに注意してください。" +#. Tag: para +#: events.xml:146 +#, no-c-format +msgid "" +"Note that <literal>&lt;listener type=\"...\" class=\"...\"/&gt;</literal> is " +"just a shorthand for <literal>&lt;event type=\"...\"&gt;&lt;listener class=" +"\"...\"/&gt;&lt;/event&gt;</literal> when there is exactly one listener for " +"a particular event type." +msgstr "" +"特定のイベント型に対してちょうど一つのリスナがあるとき、 <literal>&lt;" +"listener type=\"...\" class=\"...\"/&gt;</literal> は <literal>&lt;event " +"type=\"...\"&gt;&lt;listener class=\"...\"/&gt;&lt;/event&gt;</literal> の簡" +"略形に過ぎないことに注意してください。" -#: index.docbook:152 -msgid "Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to roles:" -msgstr "次に、同じく <literal>hibernate.cfg.xml</literal> でロールにパーミッションを与えてください：" +#. Tag: para +#: events.xml:152 +#, no-c-format +msgid "" +"Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to " +"roles:" +msgstr "" +"次に、同じく <literal>hibernate.cfg.xml</literal> でロールにパーミッションを" +"与えてください：" -#: index.docbook:156 +#. Tag: programlisting +#: events.xml:156 +#, no-c-format msgid "" - "<![CDATA[<grant role=\"admin\" entity-name=\"User\" actions=\"insert,update,read\"/>\n" - "<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>]]>" +"<![CDATA[<grant role=\"admin\" entity-name=\"User\" actions=\"insert,update," +"read\"/>\n" +"<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>]]>" msgstr "" - "<![CDATA[<grant role=\"admin\" entity-name=\"User\" actions=\"insert,update,read\"/> -\n" - "<grant role=\"su\" entity-name=\"User\" actions=\"*\"/>]]>" -#: index.docbook:158 +#. Tag: para +#: events.xml:158 +#, no-c-format msgid "The role names are the roles understood by your JACC provider." msgstr "このロール名は使用するJACCプロバイダに理解されるロールです。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - Modified: core/trunk/documentation/manual/translations/ja-JP/content/example_mappings.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/example_mappings.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/example_mappings.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1660 +1,790 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:20 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example_mappings.xml:20 +#, no-c-format msgid "Example: Various Mappings" msgstr "例：いろいろなマッピング" -#: index.docbook:22 +#. Tag: para +#: example_mappings.xml:22 +#, no-c-format msgid "This chapters shows off some more complex association mappings." msgstr "この章では、より複雑な関連のマッピングをいくつか紹介します。" -#: index.docbook:27 +#. Tag: title +#: example_mappings.xml:27 +#, no-c-format msgid "Employer/Employee" msgstr "雇用者/従業員" -#: index.docbook:29 -msgid "The following model of the relationship between <literal>Employer</literal> and <literal>Employee</literal> uses an actual entity class (<literal>Employment</literal>) to represent the association. This is done because there might be more than one period of employment for the same two parties. Components are used to model monetary values and employee names." -msgstr "<literal>Employer</literal> と <literal>Employee</literal> の関係を表す以下のモデルは、 関連の表現に実際のエンティティクラス（ <literal>Employment</literal> ） を使います。 なぜなら、同じ2つのパーティに複数の期間雇用されるということがありえるからです。 お金の値と従業員の名前をモデル化するためにコンポーネントを使っています。" +#. Tag: para +#: example_mappings.xml:29 +#, no-c-format +msgid "" +"The following model of the relationship between <literal>Employer</literal> " +"and <literal>Employee</literal> uses an actual entity class " +"(<literal>Employment</literal>) to represent the association. This is done " +"because there might be more than one period of employment for the same two " +"parties. Components are used to model monetary values and employee names." +msgstr "" +"<literal>Employer</literal> と <literal>Employee</literal> の関係を表す以下の" +"モデルは、 関連の表現に実際のエンティティクラス（ <literal>Employment</" +"literal> ） を使います。 なぜなら、同じ2つのパーティに複数の期間雇用されると" +"いうことがありえるからです。 お金の値と従業員の名前をモデル化するためにコン" +"ポーネントを使っています。" -#: index.docbook:46 +#. Tag: para +#: example_mappings.xml:46 +#, no-c-format msgid "Heres a possible mapping document:" msgstr "マッピングドキュメントの一例です：" -#: index.docbook:50 +#. Tag: programlisting +#: example_mappings.xml:50 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " \n" - " <class name=\"Employer\" table=\"employers\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employer_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - " <class name=\"Employment\" table=\"employment_periods\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employment_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"startDate\" column=\"start_date\"/>\n" - " <property name=\"endDate\" column=\"end_date\"/>\n" - "\n" - " <component name=\"hourlyRate\" class=\"MonetaryAmount\">\n" - " <property name=\"amount\">\n" - " <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)\"/>\n" - " </property>\n" - " <property name=\"currency\" length=\"12\"/>\n" - " </component>\n" - "\n" - " <many-to-one name=\"employer\" column=\"employer_id\" not-null=\"true\"/>\n" - " <many-to-one name=\"employee\" column=\"employee_id\" not-null=\"true\"/>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Employee\" table=\"employees\">\n" - " <id name=\"id\">\n" - " <generator class=\"sequence\">\n" - " <param name=\"sequence\">employee_id_seq</param>\n" - " </generator>\n" - " </id>\n" - " <property name=\"taxfileNumber\"/>\n" - " <component name=\"name\" class=\"Name\">\n" - " <property name=\"firstName\"/>\n" - " <property name=\"initial\"/>\n" - " <property name=\"lastName\"/>\n" - " </component>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +" \n" +" <class name=\"Employer\" table=\"employers\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">employer_id_seq</param>\n" +" </generator>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +" <class name=\"Employment\" table=\"employment_periods\">\n" +"\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">employment_id_seq</param>\n" +" </generator>\n" +" </id>\n" +" <property name=\"startDate\" column=\"start_date\"/>\n" +" <property name=\"endDate\" column=\"end_date\"/>\n" +"\n" +" <component name=\"hourlyRate\" class=\"MonetaryAmount\">\n" +" <property name=\"amount\">\n" +" <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)\"/>\n" +" </property>\n" +" <property name=\"currency\" length=\"12\"/>\n" +" </component>\n" +"\n" +" <many-to-one name=\"employer\" column=\"employer_id\" not-null=\"true" +"\"/>\n" +" <many-to-one name=\"employee\" column=\"employee_id\" not-null=\"true" +"\"/>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Employee\" table=\"employees\">\n" +" <id name=\"id\">\n" +" <generator class=\"sequence\">\n" +" <param name=\"sequence\">employee_id_seq</param>\n" +" </generator>\n" +" </id>\n" +" <property name=\"taxfileNumber\"/>\n" +" <component name=\"name\" class=\"Name\">\n" +" <property name=\"firstName\"/>\n" +" <property name=\"initial\"/>\n" +" <property name=\"lastName\"/>\n" +" </component>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " -\n" - " <class name=\"Employer\" table=\"employers\"> -\n" - " <id name=\"id\"> -\n" - " <generator class=\"sequence\"> -\n" - " <param name=\"sequence\">employer_id_seq</param> -\n" - " </generator> -\n" - " </id> -\n" - " <property name=\"name\"/> -\n" - " </class> -\n" - " -\n" - " <class name=\"Employment\" table=\"employment_periods\"> -\n" - " -\n" - " <id name=\"id\"> -\n" - " <generator class=\"sequence\"> -\n" - " <param name=\"sequence\">employment_id_seq</param> -\n" - " </generator> -\n" - " </id> -\n" - " <property name=\"startDate\" column=\"start_date\"/> -\n" - " <property name=\"endDate\" column=\"end_date\"/> -\n" - " -\n" - " <component name=\"hourlyRate\" class=\"MonetaryAmount\"> -\n" - " <property name=\"amount\"> -\n" - " <column name=\"hourly_rate\" sql-type=\"NUMERIC(12, 2)\"/> -\n" - " </property> -\n" - " <property name=\"currency\" length=\"12\"/> -\n" - " </component> -\n" - " -\n" - " <many-to-one name=\"employer\" column=\"employer_id\" not-null=\"true\"/> -\n" - " <many-to-one name=\"employee\" column=\"employee_id\" not-null=\"true\"/> -\n" - " -\n" - " </class> -\n" - " -\n" - " <class name=\"Employee\" table=\"employees\"> -\n" - " <id name=\"id\"> -\n" - " <generator class=\"sequence\"> -\n" - " <param name=\"sequence\">employee_id_seq</param> -\n" - " </generator> -\n" - " </id> -\n" - " <property name=\"taxfileNumber\"/> -\n" - " <component name=\"name\" class=\"Name\"> -\n" - " <property name=\"firstName\"/> -\n" - " <property name=\"initial\"/> -\n" - " <property name=\"lastName\"/> -\n" - " </component> -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:52 -msgid "And heres the table schema generated by <literal>SchemaExport</literal>." +#. Tag: para +#: example_mappings.xml:52 +#, no-c-format +msgid "" +"And heres the table schema generated by <literal>SchemaExport</literal>." msgstr "<literal>SchemaExport</literal> で生成したテーブルスキーマです。" -#: index.docbook:56 +#. Tag: programlisting +#: example_mappings.xml:56 +#, no-c-format msgid "" - "<![CDATA[create table employers (\n" - " id BIGINT not null, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table employment_periods (\n" - " id BIGINT not null,\n" - " hourly_rate NUMERIC(12, 2),\n" - " currency VARCHAR(12), \n" - " employee_id BIGINT not null, \n" - " employer_id BIGINT not null, \n" - " end_date TIMESTAMP, \n" - " start_date TIMESTAMP, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table employees (\n" - " id BIGINT not null, \n" - " firstName VARCHAR(255), \n" - " initial CHAR(1), \n" - " lastName VARCHAR(255), \n" - " taxfileNumber VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table employment_periods \n" - " add constraint employment_periodsFK0 foreign key (employer_id) references employers\n" - "alter table employment_periods \n" - " add constraint employment_periodsFK1 foreign key (employee_id) references employees\n" - "create sequence employee_id_seq\n" - "create sequence employment_id_seq\n" - "create sequence employer_id_seq]]>" +"<![CDATA[create table employers (\n" +" id BIGINT not null, \n" +" name VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"create table employment_periods (\n" +" id BIGINT not null,\n" +" hourly_rate NUMERIC(12, 2),\n" +" currency VARCHAR(12), \n" +" employee_id BIGINT not null, \n" +" employer_id BIGINT not null, \n" +" end_date TIMESTAMP, \n" +" start_date TIMESTAMP, \n" +" primary key (id)\n" +")\n" +"\n" +"create table employees (\n" +" id BIGINT not null, \n" +" firstName VARCHAR(255), \n" +" initial CHAR(1), \n" +" lastName VARCHAR(255), \n" +" taxfileNumber VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"alter table employment_periods \n" +" add constraint employment_periodsFK0 foreign key (employer_id) " +"references employers\n" +"alter table employment_periods \n" +" add constraint employment_periodsFK1 foreign key (employee_id) " +"references employees\n" +"create sequence employee_id_seq\n" +"create sequence employment_id_seq\n" +"create sequence employer_id_seq]]>" msgstr "" - "<![CDATA[create table employers ( -\n" - " id BIGINT not null, -\n" - " name VARCHAR(255), -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "create table employment_periods ( -\n" - " id BIGINT not null, -\n" - " hourly_rate NUMERIC(12, 2), -\n" - " currency VARCHAR(12), -\n" - " employee_id BIGINT not null, -\n" - " employer_id BIGINT not null, -\n" - " end_date TIMESTAMP, -\n" - " start_date TIMESTAMP, -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "create table employees ( -\n" - " id BIGINT not null, -\n" - " firstName VARCHAR(255), -\n" - " initial CHAR(1), -\n" - " lastName VARCHAR(255), -\n" - " taxfileNumber VARCHAR(255), -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "alter table employment_periods -\n" - " add constraint employment_periodsFK0 foreign key (employer_id) references employers -\n" - "alter table employment_periods -\n" - " add constraint employment_periodsFK1 foreign key (employee_id) references employees -\n" - "create sequence employee_id_seq -\n" - "create sequence employment_id_seq -\n" - "create sequence employer_id_seq]]>" -#: index.docbook:61 +#. Tag: title +#: example_mappings.xml:61 +#, no-c-format msgid "Author/Work" msgstr "作者/作品" -#: index.docbook:63 -msgid "Consider the following model of the relationships between <literal>Work</literal>, <literal>Author</literal> and <literal>Person</literal>. We represent the relationship between <literal>Work</literal> and <literal>Author</literal> as a many-to-many association. We choose to represent the relationship between <literal>Author</literal> and <literal>Person</literal> as one-to-one association. Another possibility would be to have <literal>Author</literal> extend <literal>Person</literal>." -msgstr "<literal>Work</literal> , <literal>Author</literal> そして <literal>Person</literal> の関係を表す以下のモデルを考えてみてください。 <literal>Work</literal> と <literal>Author</literal> の関係を多対多関連で表しています。 <literal>Author</literal> と <literal>Person</literal> の関係は一対一関連として表しています。 他には <literal>Author</literal> が <literal>Person</literal> を拡張するという方法もあります。" +#. Tag: para +#: example_mappings.xml:63 +#, no-c-format +msgid "" +"Consider the following model of the relationships between <literal>Work</" +"literal>, <literal>Author</literal> and <literal>Person</literal>. We " +"represent the relationship between <literal>Work</literal> and " +"<literal>Author</literal> as a many-to-many association. We choose to " +"represent the relationship between <literal>Author</literal> and " +"<literal>Person</literal> as one-to-one association. Another possibility " +"would be to have <literal>Author</literal> extend <literal>Person</literal>." +msgstr "" +"<literal>Work</literal> , <literal>Author</literal> そして <literal>Person</" +"literal> の関係を表す以下のモデルを考えてみてください。 <literal>Work</" +"literal> と <literal>Author</literal> の関係を多対多関連で表しています。 " +"<literal>Author</literal> と <literal>Person</literal> の関係は一対一関連とし" +"て表しています。 他には <literal>Author</literal> が <literal>Person</" +"literal> を拡張するという方法もあります。" -#: index.docbook:81 -msgid "The following mapping document correctly represents these relationships:" +#. Tag: para +#: example_mappings.xml:81 +#, no-c-format +msgid "" +"The following mapping document correctly represents these relationships:" msgstr "以下のマッピングドキュメントはこのような関係を正確に表現しています。" -#: index.docbook:85 +#. Tag: programlisting +#: example_mappings.xml:85 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Work\" table=\"works\" discriminator-value=\"W\">\n" - "\n" - " <id name=\"id\" column=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"type\" type=\"character\"/>\n" - "\n" - " <property name=\"title\"/>\n" - " <set name=\"authors\" table=\"author_work\">\n" - " <key column name=\"work_id\"/>\n" - " <many-to-many class=\"Author\" column name=\"author_id\"/>\n" - " </set>\n" - "\n" - " <subclass name=\"Book\" discriminator-value=\"B\">\n" - " <property name=\"text\"/>\n" - " </subclass>\n" - "\n" - " <subclass name=\"Song\" discriminator-value=\"S\">\n" - " <property name=\"tempo\"/>\n" - " <property name=\"genre\"/>\n" - " </subclass>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Author\" table=\"authors\">\n" - "\n" - " <id name=\"id\" column=\"id\">\n" - " <!-- The Author must have the same identifier as the Person -->\n" - " <generator class=\"assigned\"/> \n" - " </id>\n" - "\n" - " <property name=\"alias\"/>\n" - " <one-to-one name=\"person\" constrained=\"true\"/>\n" - "\n" - " <set name=\"works\" table=\"author_work\" inverse=\"true\">\n" - " <key column=\"author_id\"/>\n" - " <many-to-many class=\"Work\" column=\"work_id\"/>\n" - " </set>\n" - "\n" - " </class>\n" - "\n" - " <class name=\"Person\" table=\"persons\">\n" - " <id name=\"id\" column=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Work\" table=\"works\" discriminator-value=\"W\">\n" +"\n" +" <id name=\"id\" column=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"type\" type=\"character\"/>\n" +"\n" +" <property name=\"title\"/>\n" +" <set name=\"authors\" table=\"author_work\">\n" +" <key column name=\"work_id\"/>\n" +" <many-to-many class=\"Author\" column name=\"author_id\"/>\n" +" </set>\n" +"\n" +" <subclass name=\"Book\" discriminator-value=\"B\">\n" +" <property name=\"text\"/>\n" +" </subclass>\n" +"\n" +" <subclass name=\"Song\" discriminator-value=\"S\">\n" +" <property name=\"tempo\"/>\n" +" <property name=\"genre\"/>\n" +" </subclass>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Author\" table=\"authors\">\n" +"\n" +" <id name=\"id\" column=\"id\">\n" +" <!-- The Author must have the same identifier as the Person -->\n" +" <generator class=\"assigned\"/> \n" +" </id>\n" +"\n" +" <property name=\"alias\"/>\n" +" <one-to-one name=\"person\" constrained=\"true\"/>\n" +"\n" +" <set name=\"works\" table=\"author_work\" inverse=\"true\">\n" +" <key column=\"author_id\"/>\n" +" <many-to-many class=\"Work\" column=\"work_id\"/>\n" +" </set>\n" +"\n" +" </class>\n" +"\n" +" <class name=\"Person\" table=\"persons\">\n" +" <id name=\"id\" column=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " -\n" - " <class name=\"Work\" table=\"works\" discriminator-value=\"W\"> -\n" - " -\n" - " <id name=\"id\" column=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <discriminator column=\"type\" type=\"character\"/> -\n" - " -\n" - " <property name=\"title\"/> -\n" - " <set name=\"authors\" table=\"author_work\"> -\n" - " <key column name=\"work_id\"/> -\n" - " <many-to-many class=\"Author\" column name=\"author_id\"/> -\n" - " </set> -\n" - " -\n" - " <subclass name=\"Book\" discriminator-value=\"B\"> -\n" - " <property name=\"text\"/> -\n" - " </subclass> -\n" - " -\n" - " <subclass name=\"Song\" discriminator-value=\"S\"> -\n" - " <property name=\"tempo\"/> -\n" - " <property name=\"genre\"/> -\n" - " </subclass> -\n" - " -\n" - " </class> -\n" - " -\n" - " <class name=\"Author\" table=\"authors\"> -\n" - " -\n" - " <id name=\"id\" column=\"id\"> -\n" - " <!-- The Author must have the same identifier as the Person --> -\n" - " <generator class=\"assigned\"/> -\n" - " </id> -\n" - " -\n" - " <property name=\"alias\"/> -\n" - " <one-to-one name=\"person\" constrained=\"true\"/> -\n" - " -\n" - " <set name=\"works\" table=\"author_work\" inverse=\"true\"> -\n" - " <key column=\"author_id\"/> -\n" - " <many-to-many class=\"Work\" column=\"work_id\"/> -\n" - " </set> -\n" - " -\n" - " </class> -\n" - " -\n" - " <class name=\"Person\" table=\"persons\"> -\n" - " <id name=\"id\" column=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"name\"/> -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:87 -msgid "There are four tables in this mapping. <literal>works</literal>, <literal>authors</literal> and <literal>persons</literal> hold work, author and person data respectively. <literal>author_work</literal> is an association table linking authors to works. Heres the table schema, as generated by <literal>SchemaExport</literal>." -msgstr "このマッピングには4つのテーブルがあります。 <literal>works</literal> , <literal>authors</literal> , <literal>persons</literal> はそれぞれ、仕事、作者、人のデータを保持します。 <literal>author_work</literal> は作者と作品をリンクする関連テーブルです。 以下は <literal>SchemaExport</literal> で生成したテーブルスキーマです。" +#. Tag: para +#: example_mappings.xml:87 +#, no-c-format +msgid "" +"There are four tables in this mapping. <literal>works</literal>, " +"<literal>authors</literal> and <literal>persons</literal> hold work, author " +"and person data respectively. <literal>author_work</literal> is an " +"association table linking authors to works. Heres the table schema, as " +"generated by <literal>SchemaExport</literal>." +msgstr "" +"このマッピングには4つのテーブルがあります。 <literal>works</literal> , " +"<literal>authors</literal> , <literal>persons</literal> はそれぞれ、仕事、作" +"者、人のデータを保持します。 <literal>author_work</literal> は作者と作品をリ" +"ンクする関連テーブルです。 以下は <literal>SchemaExport</literal> で生成した" +"テーブルスキーマです。" -#: index.docbook:95 +#. Tag: programlisting +#: example_mappings.xml:95 +#, no-c-format msgid "" - "<![CDATA[create table works (\n" - " id BIGINT not null generated by default as identity, \n" - " tempo FLOAT, \n" - " genre VARCHAR(255), \n" - " text INTEGER, \n" - " title VARCHAR(255), \n" - " type CHAR(1) not null, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table author_work (\n" - " author_id BIGINT not null, \n" - " work_id BIGINT not null, \n" - " primary key (work_id, author_id)\n" - ")\n" - "\n" - "create table authors (\n" - " id BIGINT not null generated by default as identity, \n" - " alias VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table persons (\n" - " id BIGINT not null generated by default as identity, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table authors \n" - " add constraint authorsFK0 foreign key (id) references persons\n" - "alter table author_work \n" - " add constraint author_workFK0 foreign key (author_id) references authors\n" - "alter table author_work\n" - " add constraint author_workFK1 foreign key (work_id) references works]]>" +"<![CDATA[create table works (\n" +" id BIGINT not null generated by default as identity, \n" +" tempo FLOAT, \n" +" genre VARCHAR(255), \n" +" text INTEGER, \n" +" title VARCHAR(255), \n" +" type CHAR(1) not null, \n" +" primary key (id)\n" +")\n" +"\n" +"create table author_work (\n" +" author_id BIGINT not null, \n" +" work_id BIGINT not null, \n" +" primary key (work_id, author_id)\n" +")\n" +"\n" +"create table authors (\n" +" id BIGINT not null generated by default as identity, \n" +" alias VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"create table persons (\n" +" id BIGINT not null generated by default as identity, \n" +" name VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"alter table authors \n" +" add constraint authorsFK0 foreign key (id) references persons\n" +"alter table author_work \n" +" add constraint author_workFK0 foreign key (author_id) references " +"authors\n" +"alter table author_work\n" +" add constraint author_workFK1 foreign key (work_id) references works]]>" msgstr "" - "<![CDATA[create table works ( -\n" - " id BIGINT not null generated by default as identity, -\n" - " tempo FLOAT, -\n" - " genre VARCHAR(255), -\n" - " text INTEGER, -\n" - " title VARCHAR(255), -\n" - " type CHAR(1) not null, -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "create table author_work ( -\n" - " author_id BIGINT not null, -\n" - " work_id BIGINT not null, -\n" - " primary key (work_id, author_id) -\n" - ") -\n" - " -\n" - "create table authors ( -\n" - " id BIGINT not null generated by default as identity, -\n" - " alias VARCHAR(255), -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "create table persons ( -\n" - " id BIGINT not null generated by default as identity, -\n" - " name VARCHAR(255), -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "alter table authors -\n" - " add constraint authorsFK0 foreign key (id) references persons -\n" - "alter table author_work -\n" - " add constraint author_workFK0 foreign key (author_id) references authors -\n" - "alter table author_work -\n" - " add constraint author_workFK1 foreign key (work_id) references works]]>" -#: index.docbook:100 +#. Tag: title +#: example_mappings.xml:100 +#, no-c-format msgid "Customer/Order/Product" msgstr "顧客/注文/製品" -#: index.docbook:102 -msgid "Now consider a model of the relationships between <literal>Customer</literal>, <literal>Order</literal> and <literal>LineItem</literal> and <literal>Product</literal>. There is a one-to-many association between <literal>Customer</literal> and <literal>Order</literal>, but how should we represent <literal>Order</literal> / <literal>LineItem</literal> / <literal>Product</literal>? I've chosen to map <literal>LineItem</literal> as an association class representing the many-to-many association between <literal>Order</literal> and <literal>Product</literal>. In Hibernate, this is called a composite element." -msgstr "さて、 <literal>Customer</literal> , <literal>Order</literal> , <literal>LineItem</literal> <literal>Product</literal> の関係を表すモデルを考えてみましょう。 <literal>Customer</literal> と <literal>Order</literal> は一対多の関連ですが、 <literal>Order</literal> / <literal>LineItem</literal> / <literal>Product</literal> はどのように表現するべきでしょうか？ <literal>LineItem</literal> を、<literal>Order</literal> と <literal>Product</literal> の多対多関連を表現する関連クラスとしてマッピングしました。 Hibernateではこれをコンポジット要素と呼びます。" +#. Tag: para +#: example_mappings.xml:102 +#, no-c-format +msgid "" +"Now consider a model of the relationships between <literal>Customer</" +"literal>, <literal>Order</literal> and <literal>LineItem</literal> and " +"<literal>Product</literal>. There is a one-to-many association between " +"<literal>Customer</literal> and <literal>Order</literal>, but how should we " +"represent <literal>Order</literal> / <literal>LineItem</literal> / " +"<literal>Product</literal>? I've chosen to map <literal>LineItem</literal> " +"as an association class representing the many-to-many association between " +"<literal>Order</literal> and <literal>Product</literal>. In Hibernate, this " +"is called a composite element." +msgstr "" +"さて、 <literal>Customer</literal> , <literal>Order</literal> , " +"<literal>LineItem</literal><literal>Product</literal> の関係を表すモデルを考" +"えてみましょう。 <literal>Customer</literal> と <literal>Order</literal> は一" +"対多の関連ですが、 <literal>Order</literal> / <literal>LineItem</literal> / " +"<literal>Product</literal> はどのように表現するべきでしょうか？ " +"<literal>LineItem</literal> を、<literal>Order</literal> と " +"<literal>Product</literal> の多対多関連を表現する関連クラスとしてマッピングし" +"ました。 Hibernateではこれをコンポジット要素と呼びます。" -#: index.docbook:122 +#. Tag: para +#: example_mappings.xml:122 +#, no-c-format msgid "The mapping document:" msgstr "マッピングドキュメント：" -#: index.docbook:126 +#. Tag: programlisting +#: example_mappings.xml:126 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"Customer\" table=\"customers\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\"/>\n" - " <set name=\"orders\" inverse=\"true\">\n" - " <key column=\"customer_id\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </set>\n" - " </class>\n" - "\n" - " <class name=\"Order\" table=\"orders\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"date\"/>\n" - " <many-to-one name=\"customer\" column=\"customer_id\"/>\n" - " <list name=\"lineItems\" table=\"line_items\">\n" - " <key column=\"order_id\"/>\n" - " <list-index column=\"line_number\"/>\n" - " <composite-element class=\"LineItem\">\n" - " <property name=\"quantity\"/>\n" - " <many-to-one name=\"product\" column=\"product_id\"/>\n" - " </composite-element>\n" - " </list>\n" - " </class>\n" - "\n" - " <class name=\"Product\" table=\"products\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"serialNumber\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"Customer\" table=\"customers\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"name\"/>\n" +" <set name=\"orders\" inverse=\"true\">\n" +" <key column=\"customer_id\"/>\n" +" <one-to-many class=\"Order\"/>\n" +" </set>\n" +" </class>\n" +"\n" +" <class name=\"Order\" table=\"orders\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"date\"/>\n" +" <many-to-one name=\"customer\" column=\"customer_id\"/>\n" +" <list name=\"lineItems\" table=\"line_items\">\n" +" <key column=\"order_id\"/>\n" +" <list-index column=\"line_number\"/>\n" +" <composite-element class=\"LineItem\">\n" +" <property name=\"quantity\"/>\n" +" <many-to-one name=\"product\" column=\"product_id\"/>\n" +" </composite-element>\n" +" </list>\n" +" </class>\n" +"\n" +" <class name=\"Product\" table=\"products\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"serialNumber\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " -\n" - " <class name=\"Customer\" table=\"customers\"> -\n" - " <id name=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"name\"/> -\n" - " <set name=\"orders\" inverse=\"true\"> -\n" - " <key column=\"customer_id\"/> -\n" - " <one-to-many class=\"Order\"/> -\n" - " </set> -\n" - " </class> -\n" - " -\n" - " <class name=\"Order\" table=\"orders\"> -\n" - " <id name=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"date\"/> -\n" - " <many-to-one name=\"customer\" column=\"customer_id\"/> -\n" - " <list name=\"lineItems\" table=\"line_items\"> -\n" - " <key column=\"order_id\"/> -\n" - " <list-index column=\"line_number\"/> -\n" - " <composite-element class=\"LineItem\"> -\n" - " <property name=\"quantity\"/> -\n" - " <many-to-one name=\"product\" column=\"product_id\"/> -\n" - " </composite-element> -\n" - " </list> -\n" - " </class> -\n" - " -\n" - " <class name=\"Product\" table=\"products\"> -\n" - " <id name=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"serialNumber\"/> -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:128 -msgid "<literal>customers</literal>, <literal>orders</literal>, <literal>line_items</literal> and <literal>products</literal> hold customer, order, order line item and product data respectively. <literal>line_items</literal> also acts as an association table linking orders with products." -msgstr "<literal>customers</literal> , <literal>orders</literal> , <literal>line_items</literal> , <literal>products</literal> はそれぞれ、顧客、注文、注文明細、製品のデータを保持します。 <literal>line_items</literal> は注文と製品をリンクする関連テーブルとしても働きます。" +#. Tag: para +#: example_mappings.xml:128 +#, no-c-format +msgid "" +"<literal>customers</literal>, <literal>orders</literal>, " +"<literal>line_items</literal> and <literal>products</literal> hold customer, " +"order, order line item and product data respectively. <literal>line_items</" +"literal> also acts as an association table linking orders with products." +msgstr "" +"<literal>customers</literal> , <literal>orders</literal> , " +"<literal>line_items</literal> , <literal>products</literal> はそれぞれ、顧" +"客、注文、注文明細、製品のデータを保持します。 <literal>line_items</literal> " +"は注文と製品をリンクする関連テーブルとしても働きます。" -#: index.docbook:135 +#. Tag: programlisting +#: example_mappings.xml:135 +#, no-c-format msgid "" - "<![CDATA[create table customers (\n" - " id BIGINT not null generated by default as identity, \n" - " name VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "create table orders (\n" - " id BIGINT not null generated by default as identity, \n" - " customer_id BIGINT, \n" - " date TIMESTAMP, \n" - " primary key (id)\n" - ")\n" - "\n" - "create table line_items (\n" - " line_number INTEGER not null, \n" - " order_id BIGINT not null, \n" - " product_id BIGINT, \n" - " quantity INTEGER, \n" - " primary key (order_id, line_number)\n" - ")\n" - "\n" - "create table products (\n" - " id BIGINT not null generated by default as identity, \n" - " serialNumber VARCHAR(255), \n" - " primary key (id)\n" - ")\n" - "\n" - "alter table orders \n" - " add constraint ordersFK0 foreign key (customer_id) references customers\n" - "alter table line_items\n" - " add constraint line_itemsFK0 foreign key (product_id) references products\n" - "alter table line_items\n" - " add constraint line_itemsFK1 foreign key (order_id) references orders]]>" +"<![CDATA[create table customers (\n" +" id BIGINT not null generated by default as identity, \n" +" name VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"create table orders (\n" +" id BIGINT not null generated by default as identity, \n" +" customer_id BIGINT, \n" +" date TIMESTAMP, \n" +" primary key (id)\n" +")\n" +"\n" +"create table line_items (\n" +" line_number INTEGER not null, \n" +" order_id BIGINT not null, \n" +" product_id BIGINT, \n" +" quantity INTEGER, \n" +" primary key (order_id, line_number)\n" +")\n" +"\n" +"create table products (\n" +" id BIGINT not null generated by default as identity, \n" +" serialNumber VARCHAR(255), \n" +" primary key (id)\n" +")\n" +"\n" +"alter table orders \n" +" add constraint ordersFK0 foreign key (customer_id) references customers\n" +"alter table line_items\n" +" add constraint line_itemsFK0 foreign key (product_id) references " +"products\n" +"alter table line_items\n" +" add constraint line_itemsFK1 foreign key (order_id) references orders]]>" msgstr "" - "<![CDATA[create table customers ( -\n" - " id BIGINT not null generated by default as identity, -\n" - " name VARCHAR(255), -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "create table orders ( -\n" - " id BIGINT not null generated by default as identity, -\n" - " customer_id BIGINT, -\n" - " date TIMESTAMP, -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "create table line_items ( -\n" - " line_number INTEGER not null, -\n" - " order_id BIGINT not null, -\n" - " product_id BIGINT, -\n" - " quantity INTEGER, -\n" - " primary key (order_id, line_number) -\n" - ") -\n" - " -\n" - "create table products ( -\n" - " id BIGINT not null generated by default as identity, -\n" - " serialNumber VARCHAR(255), -\n" - " primary key (id) -\n" - ") -\n" - " -\n" - "alter table orders -\n" - " add constraint ordersFK0 foreign key (customer_id) references customers -\n" - "alter table line_items -\n" - " add constraint line_itemsFK0 foreign key (product_id) references products -\n" - "alter table line_items -\n" - " add constraint line_itemsFK1 foreign key (order_id) references orders]]>" -#: index.docbook:140 +#. Tag: title +#: example_mappings.xml:140 +#, no-c-format msgid "Miscellaneous example mappings" msgstr "種々雑多なマッピング例" -#: index.docbook:142 -msgid "These examples are all taken from the Hibernate test suite. You will find many other useful example mappings there. Look in the <literal>test</literal> folder of the Hibernate distribution." -msgstr "ここにある例はすべてHibernateのテストスイートから取りました。 そこには、他にもたくさんのマッピングの例があります。 Hibernateディストリビューションの <literal>test</literal> フォルダを見てください。" +#. Tag: para +#: example_mappings.xml:142 +#, no-c-format +msgid "" +"These examples are all taken from the Hibernate test suite. You will find " +"many other useful example mappings there. Look in the <literal>test</" +"literal> folder of the Hibernate distribution." +msgstr "" +"ここにある例はすべてHibernateのテストスイートから取りました。 そこには、他に" +"もたくさんのマッピングの例があります。 Hibernateディストリビューションの " +"<literal>test</literal> フォルダを見てください。" -#: index.docbook:148 +#. Tag: para +#: example_mappings.xml:148 +#, no-c-format msgid "TODO: put words around this stuff" msgstr "TODO: ここに文章を埋める" -#: index.docbook:151 +#. Tag: title +#: example_mappings.xml:151 +#, no-c-format msgid "\"Typed\" one-to-one association" msgstr "「型付けされた」一対一関連" -#: index.docbook:152 +#. Tag: programlisting +#: example_mappings.xml:152 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"name\"/>\n" - " <one-to-one name=\"address\" \n" - " cascade=\"all\">\n" - " <formula>name</formula>\n" - " <formula>'HOME'</formula>\n" - " </one-to-one>\n" - " <one-to-one name=\"mailingAddress\" \n" - " cascade=\"all\">\n" - " <formula>name</formula>\n" - " <formula>'MAILING'</formula>\n" - " </one-to-one>\n" - "</class>\n" - "\n" - "<class name=\"Address\" batch-size=\"2\" \n" - " check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\">\n" - " <composite-id>\n" - " <key-many-to-one name=\"person\" \n" - " column=\"personName\"/>\n" - " <key-property name=\"type\" \n" - " column=\"addressType\"/>\n" - " </composite-id>\n" - " <property name=\"street\" type=\"text\"/>\n" - " <property name=\"state\"/>\n" - " <property name=\"zip\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"name\"/>\n" +" <one-to-one name=\"address\" \n" +" cascade=\"all\">\n" +" <formula>name</formula>\n" +" <formula>'HOME'</formula>\n" +" </one-to-one>\n" +" <one-to-one name=\"mailingAddress\" \n" +" cascade=\"all\">\n" +" <formula>name</formula>\n" +" <formula>'MAILING'</formula>\n" +" </one-to-one>\n" +"</class>\n" +"\n" +"<class name=\"Address\" batch-size=\"2\" \n" +" check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\">\n" +" <composite-id>\n" +" <key-many-to-one name=\"person\" \n" +" column=\"personName\"/>\n" +" <key-property name=\"type\" \n" +" column=\"addressType\"/>\n" +" </composite-id>\n" +" <property name=\"street\" type=\"text\"/>\n" +" <property name=\"state\"/>\n" +" <property name=\"zip\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <id name=\"name\"/> -\n" - " <one-to-one name=\"address\" -\n" - " cascade=\"all\"> -\n" - " <formula>name</formula> -\n" - " <formula>'HOME'</formula> -\n" - " </one-to-one> -\n" - " <one-to-one name=\"mailingAddress\" -\n" - " cascade=\"all\"> -\n" - " <formula>name</formula> -\n" - " <formula>'MAILING'</formula> -\n" - " </one-to-one> -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\" batch-size=\"2\" -\n" - " check=\"addressType in ('MAILING', 'HOME', 'BUSINESS')\"> -\n" - " <composite-id> -\n" - " <key-many-to-one name=\"person\" -\n" - " column=\"personName\"/> -\n" - " <key-property name=\"type\" -\n" - " column=\"addressType\"/> -\n" - " </composite-id> -\n" - " <property name=\"street\" type=\"text\"/> -\n" - " <property name=\"state\"/> -\n" - " <property name=\"zip\"/> -\n" - "</class>]]>" -#: index.docbook:156 +#. Tag: title +#: example_mappings.xml:156 +#, no-c-format msgid "Composite key example" msgstr "複合キーの例" -#: index.docbook:157 +#. Tag: programlisting +#: example_mappings.xml:157 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Customer\">\n" - "\n" - " <id name=\"customerId\"\n" - " length=\"10\">\n" - " <generator class=\"assigned\"/>\n" - " </id>\n" - "\n" - " <property name=\"name\" not-null=\"true\" length=\"100\"/>\n" - " <property name=\"address\" not-null=\"true\" length=\"200\"/>\n" - "\n" - " <list name=\"orders\"\n" - " inverse=\"true\"\n" - " cascade=\"save-update\">\n" - " <key column=\"customerId\"/>\n" - " <index column=\"orderNumber\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </list>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\">\n" - " <synchronize table=\"LineItem\"/>\n" - " <synchronize table=\"Product\"/>\n" - " \n" - " <composite-id name=\"id\" \n" - " class=\"Order$Id\">\n" - " <key-property name=\"customerId\" length=\"10\"/>\n" - " <key-property name=\"orderNumber\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"orderDate\" \n" - " type=\"calendar_date\"\n" - " not-null=\"true\"/>\n" - " \n" - " <property name=\"total\">\n" - " <formula>\n" - " ( select sum(li.quantity*p.price) \n" - " from LineItem li, Product p \n" - " where li.productId = p.productId \n" - " and li.customerId = customerId \n" - " and li.orderNumber = orderNumber )\n" - " </formula>\n" - " </property>\n" - " \n" - " <many-to-one name=\"customer\"\n" - " column=\"customerId\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\"/>\n" - " \n" - " <bag name=\"lineItems\"\n" - " fetch=\"join\" \n" - " inverse=\"true\"\n" - " cascade=\"save-update\">\n" - " <key>\n" - " <column name=\"customerId\"/>\n" - " <column name=\"orderNumber\"/>\n" - " </key>\n" - " <one-to-many class=\"LineItem\"/>\n" - " </bag>\n" - " \n" - "</class>\n" - " \n" - "<class name=\"LineItem\">\n" - " \n" - " <composite-id name=\"id\" \n" - " class=\"LineItem$Id\">\n" - " <key-property name=\"customerId\" length=\"10\"/>\n" - " <key-property name=\"orderNumber\"/>\n" - " <key-property name=\"productId\" length=\"10\"/>\n" - " </composite-id>\n" - " \n" - " <property name=\"quantity\"/>\n" - " \n" - " <many-to-one name=\"order\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\">\n" - " <column name=\"customerId\"/>\n" - " <column name=\"orderNumber\"/>\n" - " </many-to-one>\n" - " \n" - " <many-to-one name=\"product\"\n" - " insert=\"false\"\n" - " update=\"false\" \n" - " not-null=\"true\"\n" - " column=\"productId\"/>\n" - " \n" - "</class>\n" - "\n" - "<class name=\"Product\">\n" - " <synchronize table=\"LineItem\"/>\n" - "\n" - " <id name=\"productId\"\n" - " length=\"10\">\n" - " <generator class=\"assigned\"/>\n" - " </id>\n" - " \n" - " <property name=\"description\" \n" - " not-null=\"true\" \n" - " length=\"200\"/>\n" - " <property name=\"price\" length=\"3\"/>\n" - " <property name=\"numberAvailable\"/>\n" - " \n" - " <property name=\"numberOrdered\">\n" - " <formula>\n" - " ( select sum(li.quantity) \n" - " from LineItem li \n" - " where li.productId = productId )\n" - " </formula>\n" - " </property>\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Customer\">\n" +"\n" +" <id name=\"customerId\"\n" +" length=\"10\">\n" +" <generator class=\"assigned\"/>\n" +" </id>\n" +"\n" +" <property name=\"name\" not-null=\"true\" length=\"100\"/>\n" +" <property name=\"address\" not-null=\"true\" length=\"200\"/>\n" +"\n" +" <list name=\"orders\"\n" +" inverse=\"true\"\n" +" cascade=\"save-update\">\n" +" <key column=\"customerId\"/>\n" +" <index column=\"orderNumber\"/>\n" +" <one-to-many class=\"Order\"/>\n" +" </list>\n" +"\n" +"</class>\n" +"\n" +"<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\">\n" +" <synchronize table=\"LineItem\"/>\n" +" <synchronize table=\"Product\"/>\n" +" \n" +" <composite-id name=\"id\" \n" +" class=\"Order$Id\">\n" +" <key-property name=\"customerId\" length=\"10\"/>\n" +" <key-property name=\"orderNumber\"/>\n" +" </composite-id>\n" +" \n" +" <property name=\"orderDate\" \n" +" type=\"calendar_date\"\n" +" not-null=\"true\"/>\n" +" \n" +" <property name=\"total\">\n" +" <formula>\n" +" ( select sum(li.quantity*p.price) \n" +" from LineItem li, Product p \n" +" where li.productId = p.productId \n" +" and li.customerId = customerId \n" +" and li.orderNumber = orderNumber )\n" +" </formula>\n" +" </property>\n" +" \n" +" <many-to-one name=\"customer\"\n" +" column=\"customerId\"\n" +" insert=\"false\"\n" +" update=\"false\" \n" +" not-null=\"true\"/>\n" +" \n" +" <bag name=\"lineItems\"\n" +" fetch=\"join\" \n" +" inverse=\"true\"\n" +" cascade=\"save-update\">\n" +" <key>\n" +" <column name=\"customerId\"/>\n" +" <column name=\"orderNumber\"/>\n" +" </key>\n" +" <one-to-many class=\"LineItem\"/>\n" +" </bag>\n" +" \n" +"</class>\n" +" \n" +"<class name=\"LineItem\">\n" +" \n" +" <composite-id name=\"id\" \n" +" class=\"LineItem$Id\">\n" +" <key-property name=\"customerId\" length=\"10\"/>\n" +" <key-property name=\"orderNumber\"/>\n" +" <key-property name=\"productId\" length=\"10\"/>\n" +" </composite-id>\n" +" \n" +" <property name=\"quantity\"/>\n" +" \n" +" <many-to-one name=\"order\"\n" +" insert=\"false\"\n" +" update=\"false\" \n" +" not-null=\"true\">\n" +" <column name=\"customerId\"/>\n" +" <column name=\"orderNumber\"/>\n" +" </many-to-one>\n" +" \n" +" <many-to-one name=\"product\"\n" +" insert=\"false\"\n" +" update=\"false\" \n" +" not-null=\"true\"\n" +" column=\"productId\"/>\n" +" \n" +"</class>\n" +"\n" +"<class name=\"Product\">\n" +" <synchronize table=\"LineItem\"/>\n" +"\n" +" <id name=\"productId\"\n" +" length=\"10\">\n" +" <generator class=\"assigned\"/>\n" +" </id>\n" +" \n" +" <property name=\"description\" \n" +" not-null=\"true\" \n" +" length=\"200\"/>\n" +" <property name=\"price\" length=\"3\"/>\n" +" <property name=\"numberAvailable\"/>\n" +" \n" +" <property name=\"numberOrdered\">\n" +" <formula>\n" +" ( select sum(li.quantity) \n" +" from LineItem li \n" +" where li.productId = productId )\n" +" </formula>\n" +" </property>\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Customer\"> -\n" - " -\n" - " <id name=\"customerId\" -\n" - " length=\"10\"> -\n" - " <generator class=\"assigned\"/> -\n" - " </id> -\n" - " -\n" - " <property name=\"name\" not-null=\"true\" length=\"100\"/> -\n" - " <property name=\"address\" not-null=\"true\" length=\"200\"/> -\n" - " -\n" - " <list name=\"orders\" -\n" - " inverse=\"true\" -\n" - " cascade=\"save-update\"> -\n" - " <key column=\"customerId\"/> -\n" - " <index column=\"orderNumber\"/> -\n" - " <one-to-many class=\"Order\"/> -\n" - " </list> -\n" - " -\n" - "</class> -\n" - " -\n" - "<class name=\"Order\" table=\"CustomerOrder\" lazy=\"true\"> -\n" - " <synchronize table=\"LineItem\"/> -\n" - " <synchronize table=\"Product\"/> -\n" - " -\n" - " <composite-id name=\"id\" -\n" - " class=\"Order$Id\"> -\n" - " <key-property name=\"customerId\" length=\"10\"/> -\n" - " <key-property name=\"orderNumber\"/> -\n" - " </composite-id> -\n" - " -\n" - " <property name=\"orderDate\" -\n" - " type=\"calendar_date\" -\n" - " not-null=\"true\"/> -\n" - " -\n" - " <property name=\"total\"> -\n" - " <formula> -\n" - " ( select sum(li.quantity*p.price) -\n" - " from LineItem li, Product p -\n" - " where li.productId = p.productId -\n" - " and li.customerId = customerId -\n" - " and li.orderNumber = orderNumber ) -\n" - " </formula> -\n" - " </property> -\n" - " -\n" - " <many-to-one name=\"customer\" -\n" - " column=\"customerId\" -\n" - " insert=\"false\" -\n" - " update=\"false\" -\n" - " not-null=\"true\"/> -\n" - " -\n" - " <bag name=\"lineItems\" -\n" - " fetch=\"join\" -\n" - " inverse=\"true\" -\n" - " cascade=\"save-update\"> -\n" - " <key> -\n" - " <column name=\"customerId\"/> -\n" - " <column name=\"orderNumber\"/> -\n" - " </key> -\n" - " <one-to-many class=\"LineItem\"/> -\n" - " </bag> -\n" - " -\n" - "</class> -\n" - " -\n" - "<class name=\"LineItem\"> -\n" - " -\n" - " <composite-id name=\"id\" -\n" - " class=\"LineItem$Id\"> -\n" - " <key-property name=\"customerId\" length=\"10\"/> -\n" - " <key-property name=\"orderNumber\"/> -\n" - " <key-property name=\"productId\" length=\"10\"/> -\n" - " </composite-id> -\n" - " -\n" - " <property name=\"quantity\"/> -\n" - " -\n" - " <many-to-one name=\"order\" -\n" - " insert=\"false\" -\n" - " update=\"false\" -\n" - " not-null=\"true\"> -\n" - " <column name=\"customerId\"/> -\n" - " <column name=\"orderNumber\"/> -\n" - " </many-to-one> -\n" - " -\n" - " <many-to-one name=\"product\" -\n" - " insert=\"false\" -\n" - " update=\"false\" -\n" - " not-null=\"true\" -\n" - " column=\"productId\"/> -\n" - " -\n" - "</class> -\n" - " -\n" - "<class name=\"Product\"> -\n" - " <synchronize table=\"LineItem\"/> -\n" - " -\n" - " <id name=\"productId\" -\n" - " length=\"10\"> -\n" - " <generator class=\"assigned\"/> -\n" - " </id> -\n" - " -\n" - " <property name=\"description\" -\n" - " not-null=\"true\" -\n" - " length=\"200\"/> -\n" - " <property name=\"price\" length=\"3\"/> -\n" - " <property name=\"numberAvailable\"/> -\n" - " -\n" - " <property name=\"numberOrdered\"> -\n" - " <formula> -\n" - " ( select sum(li.quantity) -\n" - " from LineItem li -\n" - " where li.productId = productId ) -\n" - " </formula> -\n" - " </property> -\n" - " -\n" - "</class>]]>" -#: index.docbook:161 +#. Tag: title +#: example_mappings.xml:161 +#, no-c-format msgid "Many-to-many with shared composite key attribute" msgstr "複合キー属性を共有する多対多" -#: index.docbook:162 +#. Tag: programlisting +#: example_mappings.xml:162 +#, no-c-format msgid "" - "<![CDATA[<class name=\"User\" table=\"`User`\">\n" - " <composite-id>\n" - " <key-property name=\"name\"/>\n" - " <key-property name=\"org\"/>\n" - " </composite-id>\n" - " <set name=\"groups\" table=\"UserGroup\">\n" - " <key>\n" - " <column name=\"userName\"/>\n" - " <column name=\"org\"/>\n" - " </key>\n" - " <many-to-many class=\"Group\">\n" - " <column name=\"groupName\"/>\n" - " <formula>org</formula>\n" - " </many-to-many>\n" - " </set>\n" - "</class>\n" - " \n" - "<class name=\"Group\" table=\"`Group`\">\n" - " <composite-id>\n" - " <key-property name=\"name\"/>\n" - " <key-property name=\"org\"/>\n" - " </composite-id>\n" - " <property name=\"description\"/>\n" - " <set name=\"users\" table=\"UserGroup\" inverse=\"true\">\n" - " <key>\n" - " <column name=\"groupName\"/>\n" - " <column name=\"org\"/>\n" - " </key>\n" - " <many-to-many class=\"User\">\n" - " <column name=\"userName\"/>\n" - " <formula>org</formula>\n" - " </many-to-many>\n" - " </set>\n" - "</class>\n" - "]]>" +"<![CDATA[<class name=\"User\" table=\"`User`\">\n" +" <composite-id>\n" +" <key-property name=\"name\"/>\n" +" <key-property name=\"org\"/>\n" +" </composite-id>\n" +" <set name=\"groups\" table=\"UserGroup\">\n" +" <key>\n" +" <column name=\"userName\"/>\n" +" <column name=\"org\"/>\n" +" </key>\n" +" <many-to-many class=\"Group\">\n" +" <column name=\"groupName\"/>\n" +" <formula>org</formula>\n" +" </many-to-many>\n" +" </set>\n" +"</class>\n" +" \n" +"<class name=\"Group\" table=\"`Group`\">\n" +" <composite-id>\n" +" <key-property name=\"name\"/>\n" +" <key-property name=\"org\"/>\n" +" </composite-id>\n" +" <property name=\"description\"/>\n" +" <set name=\"users\" table=\"UserGroup\" inverse=\"true\">\n" +" <key>\n" +" <column name=\"groupName\"/>\n" +" <column name=\"org\"/>\n" +" </key>\n" +" <many-to-many class=\"User\">\n" +" <column name=\"userName\"/>\n" +" <formula>org</formula>\n" +" </many-to-many>\n" +" </set>\n" +"</class>\n" +"]]>" msgstr "" - "<![CDATA[<class name=\"User\" table=\"`User`\"> -\n" - " <composite-id> -\n" - " <key-property name=\"name\"/> -\n" - " <key-property name=\"org\"/> -\n" - " </composite-id> -\n" - " <set name=\"groups\" table=\"UserGroup\"> -\n" - " <key> -\n" - " <column name=\"userName\"/> -\n" - " <column name=\"org\"/> -\n" - " </key> -\n" - " <many-to-many class=\"Group\"> -\n" - " <column name=\"groupName\"/> -\n" - " <formula>org</formula> -\n" - " </many-to-many> -\n" - " </set> -\n" - "</class> -\n" - " -\n" - "<class name=\"Group\" table=\"`Group`\"> -\n" - " <composite-id> -\n" - " <key-property name=\"name\"/> -\n" - " <key-property name=\"org\"/> -\n" - " </composite-id> -\n" - " <property name=\"description\"/> -\n" - " <set name=\"users\" table=\"UserGroup\" inverse=\"true\"> -\n" - " <key> -\n" - " <column name=\"groupName\"/> -\n" - " <column name=\"org\"/> -\n" - " </key> -\n" - " <many-to-many class=\"User\"> -\n" - " <column name=\"userName\"/> -\n" - " <formula>org</formula> -\n" - " </many-to-many> -\n" - " </set> -\n" - "</class> -\n" - "]]>" -#: index.docbook:166 +#. Tag: title +#: example_mappings.xml:166 +#, no-c-format msgid "Content based discrimination" msgstr "discriminationに基づく内容" -#: index.docbook:167 +#. Tag: programlisting +#: example_mappings.xml:167 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\"\n" - " discriminator-value=\"P\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"person_id\" \n" - " unsaved-value=\"0\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " \n" - " \n" - " <discriminator \n" - " type=\"character\">\n" - " <formula>\n" - " case \n" - " when title is not null then 'E' \n" - " when salesperson is not null then 'C' \n" - " else 'P' \n" - " end\n" - " </formula>\n" - " </discriminator>\n" - "\n" - " <property name=\"name\" \n" - " not-null=\"true\"\n" - " length=\"80\"/>\n" - " \n" - " <property name=\"sex\" \n" - " not-null=\"true\"\n" - " update=\"false\"/>\n" - " \n" - " <component name=\"address\">\n" - " <property name=\"address\"/>\n" - " <property name=\"zip\"/>\n" - " <property name=\"country\"/>\n" - " </component>\n" - " \n" - " <subclass name=\"Employee\" \n" - " discriminator-value=\"E\">\n" - " <property name=\"title\"\n" - " length=\"20\"/>\n" - " <property name=\"salary\"/>\n" - " <many-to-one name=\"manager\"/>\n" - " </subclass>\n" - " \n" - " <subclass name=\"Customer\" \n" - " discriminator-value=\"C\">\n" - " <property name=\"comments\"/>\n" - " <many-to-one name=\"salesperson\"/>\n" - " </subclass>\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Person\"\n" +" discriminator-value=\"P\">\n" +" \n" +" <id name=\"id\" \n" +" column=\"person_id\" \n" +" unsaved-value=\"0\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" \n" +" \n" +" <discriminator \n" +" type=\"character\">\n" +" <formula>\n" +" case \n" +" when title is not null then 'E' \n" +" when salesperson is not null then 'C' \n" +" else 'P' \n" +" end\n" +" </formula>\n" +" </discriminator>\n" +"\n" +" <property name=\"name\" \n" +" not-null=\"true\"\n" +" length=\"80\"/>\n" +" \n" +" <property name=\"sex\" \n" +" not-null=\"true\"\n" +" update=\"false\"/>\n" +" \n" +" <component name=\"address\">\n" +" <property name=\"address\"/>\n" +" <property name=\"zip\"/>\n" +" <property name=\"country\"/>\n" +" </component>\n" +" \n" +" <subclass name=\"Employee\" \n" +" discriminator-value=\"E\">\n" +" <property name=\"title\"\n" +" length=\"20\"/>\n" +" <property name=\"salary\"/>\n" +" <many-to-one name=\"manager\"/>\n" +" </subclass>\n" +" \n" +" <subclass name=\"Customer\" \n" +" discriminator-value=\"C\">\n" +" <property name=\"comments\"/>\n" +" <many-to-one name=\"salesperson\"/>\n" +" </subclass>\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\" -\n" - " discriminator-value=\"P\"> -\n" - " -\n" - " <id name=\"id\" -\n" - " column=\"person_id\" -\n" - " unsaved-value=\"0\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " -\n" - " -\n" - " <discriminator -\n" - " type=\"character\"> -\n" - " <formula> -\n" - " case -\n" - " when title is not null then 'E' -\n" - " when salesperson is not null then 'C' -\n" - " else 'P' -\n" - " end -\n" - " </formula> -\n" - " </discriminator> -\n" - " -\n" - " <property name=\"name\" -\n" - " not-null=\"true\" -\n" - " length=\"80\"/> -\n" - " -\n" - " <property name=\"sex\" -\n" - " not-null=\"true\" -\n" - " update=\"false\"/> -\n" - " -\n" - " <component name=\"address\"> -\n" - " <property name=\"address\"/> -\n" - " <property name=\"zip\"/> -\n" - " <property name=\"country\"/> -\n" - " </component> -\n" - " -\n" - " <subclass name=\"Employee\" -\n" - " discriminator-value=\"E\"> -\n" - " <property name=\"title\" -\n" - " length=\"20\"/> -\n" - " <property name=\"salary\"/> -\n" - " <many-to-one name=\"manager\"/> -\n" - " </subclass> -\n" - " -\n" - " <subclass name=\"Customer\" -\n" - " discriminator-value=\"C\"> -\n" - " <property name=\"comments\"/> -\n" - " <many-to-one name=\"salesperson\"/> -\n" - " </subclass> -\n" - " -\n" - "</class>]]>" -#: index.docbook:171 +#. Tag: title +#: example_mappings.xml:171 +#, no-c-format msgid "Associations on alternate keys" msgstr "代替キーの関連" -#: index.docbook:172 +#. Tag: programlisting +#: example_mappings.xml:172 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " \n" - " <id name=\"id\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - " \n" - " <property name=\"name\" length=\"100\"/>\n" - " \n" - " <one-to-one name=\"address\" \n" - " property-ref=\"person\"\n" - " cascade=\"all\"\n" - " fetch=\"join\"/>\n" - " \n" - " <set name=\"accounts\" \n" - " inverse=\"true\">\n" - " <key column=\"userId\"\n" - " property-ref=\"userId\"/>\n" - " <one-to-many class=\"Account\"/>\n" - " </set>\n" - " \n" - " <property name=\"userId\" length=\"8\"/>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Address\">\n" - "\n" - " <id name=\"id\">\n" - " <generator class=\"hilo\"/>\n" - " </id>\n" - "\n" - " <property name=\"address\" length=\"300\"/>\n" - " <property name=\"zip\" length=\"5\"/>\n" - " <property name=\"country\" length=\"25\"/>\n" - " <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/>\n" - "\n" - "</class>\n" - "\n" - "<class name=\"Account\">\n" - " <id name=\"accountId\" length=\"32\">\n" - " <generator class=\"uuid\"/>\n" - " </id>\n" - " \n" - " <many-to-one name=\"user\"\n" - " column=\"userId\"\n" - " property-ref=\"userId\"/>\n" - " \n" - " <property name=\"type\" not-null=\"true\"/>\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" \n" +" <id name=\"id\">\n" +" <generator class=\"hilo\"/>\n" +" </id>\n" +" \n" +" <property name=\"name\" length=\"100\"/>\n" +" \n" +" <one-to-one name=\"address\" \n" +" property-ref=\"person\"\n" +" cascade=\"all\"\n" +" fetch=\"join\"/>\n" +" \n" +" <set name=\"accounts\" \n" +" inverse=\"true\">\n" +" <key column=\"userId\"\n" +" property-ref=\"userId\"/>\n" +" <one-to-many class=\"Account\"/>\n" +" </set>\n" +" \n" +" <property name=\"userId\" length=\"8\"/>\n" +"\n" +"</class>\n" +"\n" +"<class name=\"Address\">\n" +"\n" +" <id name=\"id\">\n" +" <generator class=\"hilo\"/>\n" +" </id>\n" +"\n" +" <property name=\"address\" length=\"300\"/>\n" +" <property name=\"zip\" length=\"5\"/>\n" +" <property name=\"country\" length=\"25\"/>\n" +" <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/>\n" +"\n" +"</class>\n" +"\n" +"<class name=\"Account\">\n" +" <id name=\"accountId\" length=\"32\">\n" +" <generator class=\"uuid\"/>\n" +" </id>\n" +" \n" +" <many-to-one name=\"user\"\n" +" column=\"userId\"\n" +" property-ref=\"userId\"/>\n" +" \n" +" <property name=\"type\" not-null=\"true\"/>\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " -\n" - " <id name=\"id\"> -\n" - " <generator class=\"hilo\"/> -\n" - " </id> -\n" - " -\n" - " <property name=\"name\" length=\"100\"/> -\n" - " -\n" - " <one-to-one name=\"address\" -\n" - " property-ref=\"person\" -\n" - " cascade=\"all\" -\n" - " fetch=\"join\"/> -\n" - " -\n" - " <set name=\"accounts\" -\n" - " inverse=\"true\"> -\n" - " <key column=\"userId\" -\n" - " property-ref=\"userId\"/> -\n" - " <one-to-many class=\"Account\"/> -\n" - " </set> -\n" - " -\n" - " <property name=\"userId\" length=\"8\"/> -\n" - " -\n" - "</class> -\n" - " -\n" - "<class name=\"Address\"> -\n" - " -\n" - " <id name=\"id\"> -\n" - " <generator class=\"hilo\"/> -\n" - " </id> -\n" - " -\n" - " <property name=\"address\" length=\"300\"/> -\n" - " <property name=\"zip\" length=\"5\"/> -\n" - " <property name=\"country\" length=\"25\"/> -\n" - " <many-to-one name=\"person\" unique=\"true\" not-null=\"true\"/> -\n" - " -\n" - "</class> -\n" - " -\n" - "<class name=\"Account\"> -\n" - " <id name=\"accountId\" length=\"32\"> -\n" - " <generator class=\"uuid\"/> -\n" - " </id> -\n" - " -\n" - " <many-to-one name=\"user\" -\n" - " column=\"userId\" -\n" - " property-ref=\"userId\"/> -\n" - " -\n" - " <property name=\"type\" not-null=\"true\"/> -\n" - " -\n" - "</class>]]>" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - Modified: core/trunk/documentation/manual/translations/ja-JP/content/example_parentchild.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/example_parentchild.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/example_parentchild.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,401 +1,603 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example_parentchild.xml:5 +#, no-c-format msgid "Example: Parent/Child" msgstr "例：親/子供" -#: index.docbook:7 -msgid "One of the very first things that new users try to do with Hibernate is to model a parent / child type relationship. There are two different approaches to this. For various reasons the most convenient approach, especially for new users, is to model both <literal>Parent</literal> and <literal>Child</literal> as entity classes with a <literal>&lt;one-to-many&gt;</literal> association from <literal>Parent</literal> to <literal>Child</literal>. (The alternative approach is to declare the <literal>Child</literal> as a <literal>&lt;composite-element&gt;</literal>.) Now, it turns out that default semantics of a one to many association (in Hibernate) are much less close to the usual semantics of a parent / child relationship than those of a composite element mapping. We will explain how to use a <emphasis>bidirectional one to many association with cascades</emphasis> to model a parent / child relationship efficiently and elegantly. It's not at all difficult!" -msgstr "新規ユーザがHibernateを使ってまず最初に扱うモデルの一つに、親子型のモデル化があります。 このモデル化には二つのアプローチが存在します。とりわけ新規ユーザにとって、 さまざまな理由から最も便利だと思われるアプローチは、<literal>親</literal> から <literal>子供</literal> への <literal>&lt;one-to-many&gt;</literal> 関連により <literal>親</literal> と <literal>子供</literal> の両方をエンティティクラスとしてモデリングする方法です （もう一つの方法は、<literal>子供</literal> を <literal>&lt;composite-element&gt;</literal> として定義するものです）。 これで（Hibernateにおける）一対多関連のデフォルトのセマンティクスが、通常の複合要素のマッピングよりも、 親子関係のセマンティクスから遠いことがわかります。 それでは親子関係を効率的�! �つエレガントにモデリングするために、 <emphasis>カスケード操作を使った双方向一対多関連</emphasis> の扱い方を説明します。これはまったく難しいものではありません。" +#. Tag: para +#: example_parentchild.xml:7 +#, no-c-format +msgid "" +"One of the very first things that new users try to do with Hibernate is to " +"model a parent / child type relationship. There are two different approaches " +"to this. For various reasons the most convenient approach, especially for " +"new users, is to model both <literal>Parent</literal> and <literal>Child</" +"literal> as entity classes with a <literal>&lt;one-to-many&gt;</literal> " +"association from <literal>Parent</literal> to <literal>Child</literal>. (The " +"alternative approach is to declare the <literal>Child</literal> as a " +"<literal>&lt;composite-element&gt;</literal>.) Now, it turns out that " +"default semantics of a one to many association (in Hibernate) are much less " +"close to the usual semantics of a parent / child relationship than those of " +"a composite element mapping. We will explain how to use a " +"<emphasis>bidirectional one to many association with cascades</emphasis> to " +"model a parent / child relationship efficiently and elegantly. It's not at " +"all difficult!" +msgstr "" +"新規ユーザがHibernateを使ってまず最初に扱うモデルの一つに、親子型のモデル化が" +"あります。 このモデル化には二つのアプローチが存在します。とりわけ新規ユーザに" +"とって、 さまざまな理由から最も便利だと思われるアプローチは、<literal>親</" +"literal> から <literal>子供</literal> への <literal>&lt;one-to-many&gt;</" +"literal> 関連により <literal>親</literal> と <literal>子供</literal> の両方を" +"エンティティクラスとしてモデリングする方法です （もう一つの方法は、<literal>" +"子供</literal> を <literal>&lt;composite-element&gt;</literal> として定義する" +"ものです）。 これで（Hibernateにおける）一対多関連のデフォルトのセマンティク" +"スが、通常の複合要素のマッピングよりも、 親子関係のセマンティクスから遠いこと" +"がわかります。 それでは親子関係を効率的かつエレガントにモデリングするため" +"に、 <emphasis>カスケード操作を使った双方向一対多関連</emphasis> の扱い方を説" +"明します。これはまったく難しいものではありません。" -#: index.docbook:21 +#. Tag: title +#: example_parentchild.xml:21 +#, no-c-format msgid "A note about collections" msgstr "コレクションに関する注意" -#: index.docbook:23 -msgid "Hibernate collections are considered to be a logical part of their owning entity; never of the contained entities. This is a crucial distinction! It has the following consequences:" -msgstr "Hibernateのコレクションは自身のエンティティの論理的な部分と考えられ、 決して包含するエンティティのものではありません。これは致命的な違いです！ これは以下のような結果になります：" +#. Tag: para +#: example_parentchild.xml:23 +#, no-c-format +msgid "" +"Hibernate collections are considered to be a logical part of their owning " +"entity; never of the contained entities. This is a crucial distinction! It " +"has the following consequences:" +msgstr "" +"Hibernateのコレクションは自身のエンティティの論理的な部分と考えられ、 決して" +"包含するエンティティのものではありません。これは致命的な違いです！ これは以下" +"のような結果になります：" -#: index.docbook:30 -msgid "When we remove / add an object from / to a collection, the version number of the collection owner is incremented." -msgstr "オブジェクトをコレクションから削除、またはコレクションに追加するとき、 コレクションのオーナーのバージョン番号はインクリメントされます。" +#. Tag: para +#: example_parentchild.xml:30 +#, no-c-format +msgid "" +"When we remove / add an object from / to a collection, the version number of " +"the collection owner is incremented." +msgstr "" +"オブジェクトをコレクションから削除、またはコレクションに追加するとき、 コレク" +"ションのオーナーのバージョン番号はインクリメントされます。" -#: index.docbook:36 -msgid "If an object that was removed from a collection is an instance of a value type (eg, a composite element), that object will cease to be persistent and its state will be completely removed from the database. Likewise, adding a value type instance to the collection will cause its state to be immediately persistent." -msgstr "もしコレクションから削除されたオブジェクトが値型のインスタンス （例えばコンポジットエレメント)だったならば、そのオブジェクトは永続的ではなくなり、 その状態はデータベースから完全に削除されます。 同じように、値型のインスタンスをコレクションに追加すると、その状態はすぐに永続的になります。" +#. Tag: para +#: example_parentchild.xml:36 +#, no-c-format +msgid "" +"If an object that was removed from a collection is an instance of a value " +"type (eg, a composite element), that object will cease to be persistent and " +"its state will be completely removed from the database. Likewise, adding a " +"value type instance to the collection will cause its state to be immediately " +"persistent." +msgstr "" +"もしコレクションから削除されたオブジェクトが値型のインスタンス （例えばコンポ" +"ジットエレメント)だったならば、そのオブジェクトは永続的ではなくなり、 その状" +"態はデータベースから完全に削除されます。 同じように、値型のインスタンスをコレ" +"クションに追加すると、その状態はすぐに永続的になります。" -#: index.docbook:44 -msgid "On the other hand, if an entity is removed from a collection (a one-to-many or many-to-many association), it will not be deleted, by default. This behaviour is completely consistent - a change to the internal state of another entity should not cause the associated entity to vanish! Likewise, adding an entity to a collection does not cause that entity to become persistent, by default." -msgstr "一方、もしエンティティがコレクション（一対多または多対多関連)から削除されても、 デフォルトではそれは削除されません。この動作は完全に一貫しています。 すなわち、他のエンティティの内部状態を変更しても、関連するエンティティが消滅すべきではないということです。 同様に、エンティティがコレクションに追加されても、デフォルトではそのエンティティは永続的にはなりません。" +#. Tag: para +#: example_parentchild.xml:44 +#, no-c-format +msgid "" +"On the other hand, if an entity is removed from a collection (a one-to-many " +"or many-to-many association), it will not be deleted, by default. This " +"behaviour is completely consistent - a change to the internal state of " +"another entity should not cause the associated entity to vanish! Likewise, " +"adding an entity to a collection does not cause that entity to become " +"persistent, by default." +msgstr "" +"一方、もしエンティティがコレクション（一対多または多対多関連)から削除されて" +"も、 デフォルトではそれは削除されません。この動作は完全に一貫しています。 す" +"なわち、他のエンティティの内部状態を変更しても、関連するエンティティが消滅す" +"べきではないということです。 同様に、エンティティがコレクションに追加されて" +"も、デフォルトではそのエンティティは永続的にはなりません。" -#: index.docbook:54 -msgid "Instead, the default behaviour is that adding an entity to a collection merely creates a link between the two entities, while removing it removes the link. This is very appropriate for all sorts of cases. Where it is not appropriate at all is the case of a parent / child relationship, where the life of the child is bound to the life cycle of the parent." -msgstr "その代わりに、デフォルトの動作では、エンティティをコレクションに追加すると単に二つのエンティティ間のリンクを作成し、 一方エンティティを削除するとリンクも削除します。これはすべてのケースにおいて非常に適切です。 これが適切でないのは親/子関係の場合です。この場合子供の生存は親のライフサイクルに制限されるからです。" +#. Tag: para +#: example_parentchild.xml:54 +#, no-c-format +msgid "" +"Instead, the default behaviour is that adding an entity to a collection " +"merely creates a link between the two entities, while removing it removes " +"the link. This is very appropriate for all sorts of cases. Where it is not " +"appropriate at all is the case of a parent / child relationship, where the " +"life of the child is bound to the life cycle of the parent." +msgstr "" +"その代わりに、デフォルトの動作では、エンティティをコレクションに追加すると単" +"に二つのエンティティ間のリンクを作成し、 一方エンティティを削除するとリンクも" +"削除します。これはすべてのケースにおいて非常に適切です。 これが適切でないのは" +"親/子関係の場合です。この場合子供の生存は親のライフサイクルに制限されるからで" +"す。" -#: index.docbook:64 +#. Tag: title +#: example_parentchild.xml:64 +#, no-c-format msgid "Bidirectional one-to-many" msgstr "双方向一対多" -#: index.docbook:66 -msgid "Suppose we start with a simple <literal>&lt;one-to-many&gt;</literal> association from <literal>Parent</literal> to <literal>Child</literal>." -msgstr "<literal>Parent</literal> から <literal>Child</literal> への単純な <literal>&lt;one-to-many&gt;</literal> 関連から始めるとします。" +#. Tag: para +#: example_parentchild.xml:66 +#, no-c-format +msgid "" +"Suppose we start with a simple <literal>&lt;one-to-many&gt;</literal> " +"association from <literal>Parent</literal> to <literal>Child</literal>." +msgstr "" +"<literal>Parent</literal> から <literal>Child</literal> への単純な " +"<literal>&lt;one-to-many&gt;</literal> 関連から始めるとします。" -#: index.docbook:71 +#. Tag: programlisting +#: example_parentchild.xml:71 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"children\"> -\n" - " <key column=\"parent_id\"/> -\n" - " <one-to-many class=\"Child\"/> -\n" - "</set>]]>" -#: index.docbook:73 +#. Tag: para +#: example_parentchild.xml:73 +#, no-c-format msgid "If we were to execute the following code" msgstr "以下のコードを実行すると、" -#: index.docbook:77 +#. Tag: programlisting +#: example_parentchild.xml:77 +#, no-c-format msgid "" - "<![CDATA[Parent p = .....;\n" - "Child c = new Child();\n" - "p.getChildren().add(c);\n" - "session.save(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = .....;\n" +"Child c = new Child();\n" +"p.getChildren().add(c);\n" +"session.save(c);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[Parent p = .....; -\n" - "Child c = new Child(); -\n" - "p.getChildren().add(c); -\n" - "session.save(c); -\n" - "session.flush();]]>" -#: index.docbook:79 +#. Tag: para +#: example_parentchild.xml:79 +#, no-c-format msgid "Hibernate would issue two SQL statements:" msgstr "Hibernateは二つのSQL文を発行します:" -#: index.docbook:85 -msgid "an <literal>INSERT</literal> to create the record for <literal>c</literal>" -msgstr "<literal>c</literal>に対するレコードを生成する<literal>INSERT</literal>" +#. Tag: para +#: example_parentchild.xml:85 +#, no-c-format +msgid "" +"an <literal>INSERT</literal> to create the record for <literal>c</literal>" +msgstr "" +"<literal>c</literal>に対するレコードを生成する<literal>INSERT</literal>" -#: index.docbook:88 -msgid "an <literal>UPDATE</literal> to create the link from <literal>p</literal> to <literal>c</literal>" -msgstr "<literal>p</literal>から<literal>c</literal>へのリンクを作成する<literal>UPDATE</literal>" +#. Tag: para +#: example_parentchild.xml:88 +#, no-c-format +msgid "" +"an <literal>UPDATE</literal> to create the link from <literal>p</literal> to " +"<literal>c</literal>" +msgstr "" +"<literal>p</literal>から<literal>c</literal>へのリンクを作成する" +"<literal>UPDATE</literal>" -#: index.docbook:95 -msgid "This is not only inefficient, but also violates any <literal>NOT NULL</literal> constraint on the <literal>parent_id</literal> column. We can fix the nullability constraint violation by specifying <literal>not-null=\"true\"</literal> in the collection mapping:" -msgstr "これは非効率的なだけではなく、<literal>parent_id</literal> カラムにおいて <literal>NOT NULL</literal> 制約に違反します。 コレクションのマッピングで <literal>not-null=\"true\"</literal> と指定することで、null制約違反を解決することができます:" +#. Tag: para +#: example_parentchild.xml:95 +#, no-c-format +msgid "" +"This is not only inefficient, but also violates any <literal>NOT NULL</" +"literal> constraint on the <literal>parent_id</literal> column. We can fix " +"the nullability constraint violation by specifying <literal>not-null=\"true" +"\"</literal> in the collection mapping:" +msgstr "" +"これは非効率的なだけではなく、<literal>parent_id</literal> カラムにおいて " +"<literal>NOT NULL</literal> 制約に違反します。 コレクションのマッピングで " +"<literal>not-null=\"true\"</literal> と指定することで、null制約違反を解決する" +"ことができます:" -#: index.docbook:101 +#. Tag: programlisting +#: example_parentchild.xml:101 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\">\n" - " <key column=\"parent_id\" not-null=\"true\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\">\n" +" <key column=\"parent_id\" not-null=\"true\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"children\"> -\n" - " <key column=\"parent_id\" not-null=\"true\"/> -\n" - " <one-to-many class=\"Child\"/> -\n" - "</set>]]>" -#: index.docbook:103 +#. Tag: para +#: example_parentchild.xml:103 +#, no-c-format msgid "However, this is not the recommended solution." msgstr "しかしこの解決策は推奨できません。" -#: index.docbook:106 -msgid "The underlying cause of this behaviour is that the link (the foreign key <literal>parent_id</literal>) from <literal>p</literal> to <literal>c</literal> is not considered part of the state of the <literal>Child</literal> object and is therefore not created in the <literal>INSERT</literal>. So the solution is to make the link part of the <literal>Child</literal> mapping." -msgstr "この動作の根本的な原因は、<literal>p</literal> から <literal>c</literal> へのリンク （外部キー <literal>parent_id</literal>)は <literal>Child</literal> オブジェクトの状態の一部とは考えられず、 そのため <literal>INSERT</literal> によってリンクが生成されないことです。 ですから、解決策はリンクをChildマッピングの一部にすることです。" +#. Tag: para +#: example_parentchild.xml:106 +#, no-c-format +msgid "" +"The underlying cause of this behaviour is that the link (the foreign key " +"<literal>parent_id</literal>) from <literal>p</literal> to <literal>c</" +"literal> is not considered part of the state of the <literal>Child</literal> " +"object and is therefore not created in the <literal>INSERT</literal>. So the " +"solution is to make the link part of the <literal>Child</literal> mapping." +msgstr "" +"この動作の根本的な原因は、<literal>p</literal> から <literal>c</literal> への" +"リンク （外部キー <literal>parent_id</literal>)は <literal>Child</literal> オ" +"ブジェクトの状態の一部とは考えられず、 そのため <literal>INSERT</literal> に" +"よってリンクが生成されないことです。 ですから、解決策はリンクをChildマッピン" +"グの一部にすることです。" -#: index.docbook:113 -msgid "<![CDATA[<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true\"/>]]>" -msgstr "<![CDATA[<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true\"/>]]>" +#. Tag: programlisting +#: example_parentchild.xml:113 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"parent\" column=\"parent_id\" not-null=\"true\"/" +">]]>" +msgstr "" -#: index.docbook:115 -msgid "(We also need to add the <literal>parent</literal> property to the <literal>Child</literal> class.)" -msgstr "(また <literal>Child</literal> クラスに <literal>parent</literal> プロパティを追加する必要があります。)" +#. Tag: para +#: example_parentchild.xml:115 +#, no-c-format +msgid "" +"(We also need to add the <literal>parent</literal> property to the " +"<literal>Child</literal> class.)" +msgstr "" +"(また <literal>Child</literal> クラスに <literal>parent</literal> プロパティ" +"を追加する必要があります。)" -#: index.docbook:119 -msgid "Now that the <literal>Child</literal> entity is managing the state of the link, we tell the collection not to update the link. We use the <literal>inverse</literal> attribute." -msgstr "それでは <literal>Child</literal> エンティティがリンクの状態を制御するようになったので、 コレクションがリンクを更新しないようにしましょう。それには <literal>inverse</literal> 属性を使います。" +#. Tag: para +#: example_parentchild.xml:119 +#, no-c-format +msgid "" +"Now that the <literal>Child</literal> entity is managing the state of the " +"link, we tell the collection not to update the link. We use the " +"<literal>inverse</literal> attribute." +msgstr "" +"それでは <literal>Child</literal> エンティティがリンクの状態を制御するように" +"なったので、 コレクションがリンクを更新しないようにしましょう。それには " +"<literal>inverse</literal> 属性を使います。" -#: index.docbook:124 +#. Tag: programlisting +#: example_parentchild.xml:124 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\" inverse=\"true\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"children\" inverse=\"true\"> -\n" - " <key column=\"parent_id\"/> -\n" - " <one-to-many class=\"Child\"/> -\n" - "</set>]]>" -#: index.docbook:126 +#. Tag: para +#: example_parentchild.xml:126 +#, no-c-format msgid "The following code would be used to add a new <literal>Child</literal>" -msgstr "以下のコードを使えば、新しい <literal>Child</literal> を追加することができます。" +msgstr "" +"以下のコードを使えば、新しい <literal>Child</literal> を追加することができま" +"す。" -#: index.docbook:130 +#. Tag: programlisting +#: example_parentchild.xml:130 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "c.setParent(p);\n" - "p.getChildren().add(c);\n" - "session.save(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = new Child();\n" +"c.setParent(p);\n" +"p.getChildren().add(c);\n" +"session.save(c);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid); -\n" - "Child c = new Child(); -\n" - "c.setParent(p); -\n" - "p.getChildren().add(c); -\n" - "session.save(c); -\n" - "session.flush();]]>" -#: index.docbook:132 +#. Tag: para +#: example_parentchild.xml:132 +#, no-c-format msgid "And now, only one SQL <literal>INSERT</literal> would be issued!" -msgstr "これにより、SQLの <literal>INSERT</literal> 文が一つだけが発行されるようになりました！" +msgstr "" +"これにより、SQLの <literal>INSERT</literal> 文が一つだけが発行されるようにな" +"りました！" -#: index.docbook:136 -msgid "To tighten things up a bit, we could create an <literal>addChild()</literal> method of <literal>Parent</literal>." -msgstr "もう少し強化するには、<literal>Parent</literal> の <literal>addChild()</literal> メソッドを作成します。" +#. Tag: para +#: example_parentchild.xml:136 +#, no-c-format +msgid "" +"To tighten things up a bit, we could create an <literal>addChild()</literal> " +"method of <literal>Parent</literal>." +msgstr "" +"もう少し強化するには、<literal>Parent</literal> の <literal>addChild()</" +"literal> メソッドを作成します。" -#: index.docbook:141 +#. Tag: programlisting +#: example_parentchild.xml:141 +#, no-c-format msgid "" - "<![CDATA[public void addChild(Child c) {\n" - " c.setParent(this);\n" - " children.add(c);\n" - "}]]>" +"<![CDATA[public void addChild(Child c) {\n" +" c.setParent(this);\n" +" children.add(c);\n" +"}]]>" msgstr "" - "<![CDATA[public void addChild(Child c) { -\n" - " c.setParent(this); -\n" - " children.add(c); -\n" - "}]]>" -#: index.docbook:143 +#. Tag: para +#: example_parentchild.xml:143 +#, no-c-format msgid "Now, the code to add a <literal>Child</literal> looks like" msgstr "<literal>Child</literal> を追加するコードはこのようになります。" -#: index.docbook:147 +#. Tag: programlisting +#: example_parentchild.xml:147 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "p.addChild(c);\n" - "session.save(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = new Child();\n" +"p.addChild(c);\n" +"session.save(c);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid); -\n" - "Child c = new Child(); -\n" - "p.addChild(c); -\n" - "session.save(c); -\n" - "session.flush();]]>" -#: index.docbook:152 +#. Tag: title +#: example_parentchild.xml:152 +#, no-c-format msgid "Cascading life cycle" msgstr "ライフサイクルのカスケード" -#: index.docbook:154 -msgid "The explicit call to <literal>save()</literal> is still annoying. We will address this by using cascades." -msgstr "明示的に <literal>save()</literal> をコールするのはまだ煩わしいものです。これをカスケードを使って対処します。" +#. Tag: para +#: example_parentchild.xml:154 +#, no-c-format +msgid "" +"The explicit call to <literal>save()</literal> is still annoying. We will " +"address this by using cascades." +msgstr "" +"明示的に <literal>save()</literal> をコールするのはまだ煩わしいものです。これ" +"をカスケードを使って対処します。" -#: index.docbook:159 +#. Tag: programlisting +#: example_parentchild.xml:159 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all\"> -\n" - " <key column=\"parent_id\"/> -\n" - " <one-to-many class=\"Child\"/> -\n" - "</set>]]>" -#: index.docbook:161 +#. Tag: para +#: example_parentchild.xml:161 +#, no-c-format msgid "This simplifies the code above to" msgstr "これにより先ほどのコードをこのように単純化します" -#: index.docbook:165 +#. Tag: programlisting +#: example_parentchild.xml:165 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = new Child();\n" - "p.addChild(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = new Child();\n" +"p.addChild(c);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid); -\n" - "Child c = new Child(); -\n" - "p.addChild(c); -\n" - "session.flush();]]>" -#: index.docbook:167 -msgid "Similarly, we don't need to iterate over the children when saving or deleting a <literal>Parent</literal>. The following removes <literal>p</literal> and all its children from the database." -msgstr "同様に <literal>Parent</literal> を保存または削除するときに、子供を一つ一つ取り出して扱う必要はありません。 以下のコードは <literal>p</literal> を削除し、そしてデータベースからその子供をすべて削除します。" +#. Tag: para +#: example_parentchild.xml:167 +#, no-c-format +msgid "" +"Similarly, we don't need to iterate over the children when saving or " +"deleting a <literal>Parent</literal>. The following removes <literal>p</" +"literal> and all its children from the database." +msgstr "" +"同様に <literal>Parent</literal> を保存または削除するときに、子供を一つ一つ取" +"り出して扱う必要はありません。 以下のコードは <literal>p</literal> を削除し、" +"そしてデータベースからその子供をすべて削除します。" -#: index.docbook:172 +#. Tag: programlisting +#: example_parentchild.xml:172 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "session.delete(p);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"session.delete(p);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid); -\n" - "session.delete(p); -\n" - "session.flush();]]>" -#: index.docbook:174 +#. Tag: para +#: example_parentchild.xml:174 +#, no-c-format msgid "However, this code" msgstr "しかしこのコードは" -#: index.docbook:178 +#. Tag: programlisting +#: example_parentchild.xml:178 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = (Child) p.getChildren().iterator().next();\n" - "p.getChildren().remove(c);\n" - "c.setParent(null);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = (Child) p.getChildren().iterator().next();\n" +"p.getChildren().remove(c);\n" +"c.setParent(null);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid); -\n" - "Child c = (Child) p.getChildren().iterator().next(); -\n" - "p.getChildren().remove(c); -\n" - "c.setParent(null); -\n" - "session.flush();]]>" -#: index.docbook:180 -msgid "will not remove <literal>c</literal> from the database; it will ony remove the link to <literal>p</literal> (and cause a <literal>NOT NULL</literal> constraint violation, in this case). You need to explicitly <literal>delete()</literal> the <literal>Child</literal>." -msgstr "データベースから <literal>c</literal> を削除しません。<literal>p</literal> へのリンクを削除する （そしてこのケースでは <literal>NOT NULL</literal> 制約違反を引き起こす）だけです。 <literal>Child</literal> の <literal>delete()</literal> を明示する必要があります。" +#. Tag: para +#: example_parentchild.xml:180 +#, no-c-format +msgid "" +"will not remove <literal>c</literal> from the database; it will ony remove " +"the link to <literal>p</literal> (and cause a <literal>NOT NULL</literal> " +"constraint violation, in this case). You need to explicitly <literal>delete()" +"</literal> the <literal>Child</literal>." +msgstr "" +"データベースから <literal>c</literal> を削除しません。<literal>p</literal> へ" +"のリンクを削除する （そしてこのケースでは <literal>NOT NULL</literal> 制約違" +"反を引き起こす）だけです。 <literal>Child</literal> の <literal>delete()</" +"literal> を明示する必要があります。" -#: index.docbook:186 +#. Tag: programlisting +#: example_parentchild.xml:186 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" - "Child c = (Child) p.getChildren().iterator().next();\n" - "p.getChildren().remove(c);\n" - "session.delete(c);\n" - "session.flush();]]>" +"<![CDATA[Parent p = (Parent) session.load(Parent.class, pid);\n" +"Child c = (Child) p.getChildren().iterator().next();\n" +"p.getChildren().remove(c);\n" +"session.delete(c);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[Parent p = (Parent) session.load(Parent.class, pid); -\n" - "Child c = (Child) p.getChildren().iterator().next(); -\n" - "p.getChildren().remove(c); -\n" - "session.delete(c); -\n" - "session.flush();]]>" -#: index.docbook:188 -msgid "Now, in our case, a <literal>Child</literal> can't really exist without its parent. So if we remove a <literal>Child</literal> from the collection, we really do want it to be deleted. For this, we must use <literal>cascade=\"all-delete-orphan\"</literal>." -msgstr "今このケースでは実際に <literal>Child</literal> が親なしでは存在できないようになりました。 そのため、もしコレクションから <literal>Child</literal> を取り除く場合、これも削除したいです。 そのためには <literal>cascade=\"all-delete-orphan\"</literal> を使わなければなりません。" +#. Tag: para +#: example_parentchild.xml:188 +#, no-c-format +msgid "" +"Now, in our case, a <literal>Child</literal> can't really exist without its " +"parent. So if we remove a <literal>Child</literal> from the collection, we " +"really do want it to be deleted. For this, we must use <literal>cascade=" +"\"all-delete-orphan\"</literal>." +msgstr "" +"今このケースでは実際に <literal>Child</literal> が親なしでは存在できないよう" +"になりました。 そのため、もしコレクションから <literal>Child</literal> を取り" +"除く場合、これも削除したいです。 そのためには <literal>cascade=\"all-delete-" +"orphan\"</literal> を使わなければなりません。" -#: index.docbook:194 +#. Tag: programlisting +#: example_parentchild.xml:194 +#, no-c-format msgid "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all-delete-orphan\">\n" - " <key column=\"parent_id\"/>\n" - " <one-to-many class=\"Child\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all-delete-orphan" +"\">\n" +" <key column=\"parent_id\"/>\n" +" <one-to-many class=\"Child\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"children\" inverse=\"true\" cascade=\"all-delete-orphan\"> -\n" - " <key column=\"parent_id\"/> -\n" - " <one-to-many class=\"Child\"/> -\n" - "</set>]]>" -#: index.docbook:196 -msgid "Note: even though the collection mapping specifies <literal>inverse=\"true\"</literal>, cascades are still processed by iterating the collection elements. So if you require that an object be saved, deleted or updated by cascade, you must add it to the collection. It is not enough to simply call <literal>setParent()</literal>." -msgstr "注意：コレクションのマッピングで <literal>inverse=\"true\"</literal> と指定しても、 コレクションの要素のイテレーションによって、依然カスケードが実行されます。 そのためもしカスケードでオブジェクトをセーブ、削除、更新する必要があるなら、 それをコレクションに追加しなければなりません。単に <literal>setParent()</literal> を呼ぶだけでは不十分です。" +#. Tag: para +#: example_parentchild.xml:196 +#, no-c-format +msgid "" +"Note: even though the collection mapping specifies <literal>inverse=\"true" +"\"</literal>, cascades are still processed by iterating the collection " +"elements. So if you require that an object be saved, deleted or updated by " +"cascade, you must add it to the collection. It is not enough to simply call " +"<literal>setParent()</literal>." +msgstr "" +"注意：コレクションのマッピングで <literal>inverse=\"true\"</literal> と指定し" +"ても、 コレクションの要素のイテレーションによって、依然カスケードが実行されま" +"す。 そのためもしカスケードでオブジェクトをセーブ、削除、更新する必要があるな" +"ら、 それをコレクションに追加しなければなりません。単に <literal>setParent()" +"</literal> を呼ぶだけでは不十分です。" -#: index.docbook:206 +#. Tag: title +#: example_parentchild.xml:206 +#, no-c-format msgid "Cascades and <literal>unsaved-value</literal>" msgstr "カスケードと <literal>unsaved-value</literal>" -#: index.docbook:208 -msgid "Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</literal>, made some changes in a UI action and wish to persist these changes in a new session by calling <literal>update()</literal>. The <literal>Parent</literal> will contain a collection of childen and, since cascading update is enabled, Hibernate needs to know which children are newly instantiated and which represent existing rows in the database. Lets assume that both <literal>Parent</literal> and <literal>Child</literal> have genenerated identifier properties of type <literal>Long</literal>. Hibernate will use the identifier and version/timestamp property value to determine which of the children are new. (See <xref linkend=\"objectstate-saveorupdate\"/>.) <emphasis>In Hibernate3, it is no longer necessary to specify an <literal>unsaved-value</literal> explicitly.</emphasis>" -msgstr "<literal>Parent</literal> が、ある <literal>Session</literal> でロードされ、UIのアクションで変更が加えられ、 <literal>update()</literal> を呼んでこの変更を新しいセッションで永続化したいとします。 <literal>Parent</literal> が子供のコレクションを持ち、カスケード更新が有効になっているため、 Hibernateはどの子供が新しくインスタンス化されたか、どれがデータベースの既存の行に相当するのかを知る必要があります。 <literal>Parent</literal> と <literal>Child</literal> の両方が <literal>java.lang.Long</literal> 型の識別プロパティを生成したとしましょう。 Hibernateはどの子供が新しいものかを決定するために識別プロパティの値を使います(versionやtimestampプロパティも使えます。 <xref linkend=\"manipulatingdata-updating-detached\"/> 参照)。Hibernate3になって、 明示的に! <literal>unsaved-value</literal> を指定する必要はなくなりました。" +#. Tag: para +#: example_parentchild.xml:208 +#, no-c-format +msgid "" +"Suppose we loaded up a <literal>Parent</literal> in one <literal>Session</" +"literal>, made some changes in a UI action and wish to persist these changes " +"in a new session by calling <literal>update()</literal>. The " +"<literal>Parent</literal> will contain a collection of childen and, since " +"cascading update is enabled, Hibernate needs to know which children are " +"newly instantiated and which represent existing rows in the database. Lets " +"assume that both <literal>Parent</literal> and <literal>Child</literal> have " +"genenerated identifier properties of type <literal>Long</literal>. Hibernate " +"will use the identifier and version/timestamp property value to determine " +"which of the children are new. (See <xref linkend=\"objectstate-saveorupdate" +"\"/>.) <emphasis>In Hibernate3, it is no longer necessary to specify an " +"<literal>unsaved-value</literal> explicitly.</emphasis>" +msgstr "" +"<literal>Parent</literal> が、ある <literal>Session</literal> でロードされ、" +"UIのアクションで変更が加えられ、 <literal>update()</literal> を呼んでこの変更" +"を新しいセッションで永続化したいとします。 <literal>Parent</literal> が子供の" +"コレクションを持ち、カスケード更新が有効になっているため、 Hibernateはどの子" +"供が新しくインスタンス化されたか、どれがデータベースの既存の行に相当するのか" +"を知る必要があります。 <literal>Parent</literal> と <literal>Child</literal> " +"の両方が <literal>java.lang.Long</literal> 型の識別プロパティを生成したとしま" +"しょう。 Hibernateはどの子供が新しいものかを決定するために識別プロパティの値" +"を使います(versionやtimestampプロパティも使えます。 <xref linkend=" +"\"manipulatingdata-updating-detached\"/> 参照)。Hibernate3になって、 明示的" +"に <literal>unsaved-value</literal> を指定する必要はなくなりました。" -#: index.docbook:220 -msgid "The following code will update <literal>parent</literal> and <literal>child</literal> and insert <literal>newChild</literal>." -msgstr "以下のコードは <literal>parent</literal> と <literal>child</literal> を更新し、<literal>newChild</literal> を挿入します。" +#. Tag: para +#: example_parentchild.xml:220 +#, no-c-format +msgid "" +"The following code will update <literal>parent</literal> and <literal>child</" +"literal> and insert <literal>newChild</literal>." +msgstr "" +"以下のコードは <literal>parent</literal> と <literal>child</literal> を更新" +"し、<literal>newChild</literal> を挿入します。" -#: index.docbook:225 +#. Tag: programlisting +#: example_parentchild.xml:225 +#, no-c-format msgid "" - "<![CDATA[//parent and child were both loaded in a previous session\n" - "parent.addChild(child);\n" - "Child newChild = new Child();\n" - "parent.addChild(newChild);\n" - "session.update(parent);\n" - "session.flush();]]>" +"<![CDATA[//parent and child were both loaded in a previous session\n" +"parent.addChild(child);\n" +"Child newChild = new Child();\n" +"parent.addChild(newChild);\n" +"session.update(parent);\n" +"session.flush();]]>" msgstr "" - "<![CDATA[//parent and child were both loaded in a previous session -\n" - "//parentとchildは両方とも、以前のSessionでロードされています -\n" - "parent.addChild(child); -\n" - "Child newChild = new Child(); -\n" - "parent.addChild(newChild); -\n" - "session.update(parent); -\n" - "session.flush();]]>" -#: index.docbook:227 -msgid "Well, that's all very well for the case of a generated identifier, but what about assigned identifiers and composite identifiers? This is more difficult, since Hibernate can't use the identifier property to distinguish between a newly instantiated object (with an identifier assigned by the user) and an object loaded in a previous session. In this case, Hibernate will either use the timestamp or version property, or will actually query the second-level cache or, worst case, the database, to see if the row exists." -msgstr "これらは生成された識別子の場合には非常に良いのですが、割り当てられた識別子と複合識別子の場合はどうでしょうか？ これはHibernateが、（ユーザにより割り当てられた識別子を持つ）新しくインスタンス化されたオブジェクトと、 以前のSessionでロードされたオブジェクトを区別できないため、より難しいです。 この場合、Hibernateはタイムスタンプかバージョンのプロパティのどちらかを使うか、二次キャッシュに問い合わせます。 最悪の場合、行が存在するかどうかデータベースを見ます。" +#. Tag: para +#: example_parentchild.xml:227 +#, no-c-format +msgid "" +"Well, that's all very well for the case of a generated identifier, but what " +"about assigned identifiers and composite identifiers? This is more " +"difficult, since Hibernate can't use the identifier property to distinguish " +"between a newly instantiated object (with an identifier assigned by the " +"user) and an object loaded in a previous session. In this case, Hibernate " +"will either use the timestamp or version property, or will actually query " +"the second-level cache or, worst case, the database, to see if the row " +"exists." +msgstr "" +"これらは生成された識別子の場合には非常に良いのですが、割り当てられた識別子と" +"複合識別子の場合はどうでしょうか？ これはHibernateが、（ユーザにより割り当て" +"られた識別子を持つ）新しくインスタンス化されたオブジェクトと、 以前のSession" +"でロードされたオブジェクトを区別できないため、より難しいです。 この場合、" +"Hibernateはタイムスタンプかバージョンのプロパティのどちらかを使うか、二次" +"キャッシュに問い合わせます。 最悪の場合、行が存在するかどうかデータベースを見" +"ます。" -#: index.docbook:260 +#. Tag: title +#: example_parentchild.xml:260 +#, no-c-format msgid "Conclusion" -msgstr "<title>結論</title>" +msgstr "結論" -#: index.docbook:262 -msgid "There is quite a bit to digest here and it might look confusing first time around. However, in practice, it all works out very nicely. Most Hibernate applications use the parent / child pattern in many places." -msgstr "ここではかなりの量を要約したので、最初の頃は混乱しているように思われるかもしれません。 しかし実際は、すべて非常に良く動作します。ほとんどのHibernateアプリケーションでは、多くの場面で親子パターンを使用します。" +#. Tag: para +#: example_parentchild.xml:262 +#, no-c-format +msgid "" +"There is quite a bit to digest here and it might look confusing first time " +"around. However, in practice, it all works out very nicely. Most Hibernate " +"applications use the parent / child pattern in many places." +msgstr "" +"ここではかなりの量を要約したので、最初の頃は混乱しているように思われるかもし" +"れません。 しかし実際は、すべて非常に良く動作します。ほとんどのHibernateアプ" +"リケーションでは、多くの場面で親子パターンを使用します。" -#: index.docbook:267 -msgid "We mentioned an alternative in the first paragraph. None of the above issues exist in the case of <literal>&lt;composite-element&gt;</literal> mappings, which have exactly the semantics of a parent / child relationship. Unfortunately, there are two big limitations to composite element classes: composite elements may not own collections, and they should not be the child of any entity other than the unique parent." -msgstr "最初の段落で代替方法について触れました。上記のような問題は <literal>&lt;composite-element&gt;</literal> マッピングの場合は存在せず、 にもかかわらずそれは確かに親子関係のセマンティクスを持ちます。 しかし残念ながら、複合要素クラスには二つの大きな制限があります： 1つは複合要素はコレクションを持つことができないことです。もうひとつは、 ユニークな親ではないエンティティの子供となるべきではないということです" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: example_parentchild.xml:267 +#, no-c-format +msgid "" +"We mentioned an alternative in the first paragraph. None of the above issues " +"exist in the case of <literal>&lt;composite-element&gt;</literal> mappings, " +"which have exactly the semantics of a parent / child relationship. " +"Unfortunately, there are two big limitations to composite element classes: " +"composite elements may not own collections, and they should not be the child " +"of any entity other than the unique parent." +msgstr "" +"最初の段落で代替方法について触れました。上記のような問題は <literal>&lt;" +"composite-element&gt;</literal> マッピングの場合は存在せず、 にもかかわらずそ" +"れは確かに親子関係のセマンティクスを持ちます。 しかし残念ながら、複合要素クラ" +"スには二つの大きな制限があります： 1つは複合要素はコレクションを持つことがで" +"きないことです。もうひとつは、 ユニークな親ではないエンティティの子供となるべ" +"きではないということです" Modified: core/trunk/documentation/manual/translations/ja-JP/content/example_weblog.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/example_weblog.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/example_weblog.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1225 +1,484 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: example_weblog.xml:5 +#, no-c-format msgid "Example: Weblog Application" msgstr "例: Weblogアプリケーション" -#: index.docbook:8 +#. Tag: title +#: example_weblog.xml:8 +#, no-c-format msgid "Persistent Classes" msgstr "永続クラス" -#: index.docbook:10 -msgid "The persistent classes represent a weblog, and an item posted in a weblog. They are to be modelled as a standard parent/child relationship, but we will use an ordered bag, instead of a set." -msgstr "永続クラスがウェブログと、ウェブログに掲示された項目を表しています。 それらは通常の親子関係としてモデリングされますが、 setではなく順序を持ったbagを使用することにします。" +#. Tag: para +#: example_weblog.xml:10 +#, no-c-format +msgid "" +"The persistent classes represent a weblog, and an item posted in a weblog. " +"They are to be modelled as a standard parent/child relationship, but we will " +"use an ordered bag, instead of a set." +msgstr "" +"永続クラスがウェブログと、ウェブログに掲示された項目を表しています。 それらは" +"通常の親子関係としてモデリングされますが、 setではなく順序を持ったbagを使用す" +"ることにします。" -#: index.docbook:16 +#. Tag: programlisting +#: example_weblog.xml:16 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.util.List;\n" - "\n" - "public class Blog {\n" - " private Long _id;\n" - " private String _name;\n" - " private List _items;\n" - "\n" - " public Long getId() {\n" - " return _id;\n" - " }\n" - " public List getItems() {\n" - " return _items;\n" - " }\n" - " public String getName() {\n" - " return _name;\n" - " }\n" - " public void setId(Long long1) {\n" - " _id = long1;\n" - " }\n" - " public void setItems(List list) {\n" - " _items = list;\n" - " }\n" - " public void setName(String string) {\n" - " _name = string;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"\n" +"import java.util.List;\n" +"\n" +"public class Blog {\n" +" private Long _id;\n" +" private String _name;\n" +" private List _items;\n" +"\n" +" public Long getId() {\n" +" return _id;\n" +" }\n" +" public List getItems() {\n" +" return _items;\n" +" }\n" +" public String getName() {\n" +" return _name;\n" +" }\n" +" public void setId(Long long1) {\n" +" _id = long1;\n" +" }\n" +" public void setItems(List list) {\n" +" _items = list;\n" +" }\n" +" public void setName(String string) {\n" +" _name = string;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[package eg; -\n" - " -\n" - "import java.util.List; -\n" - " -\n" - "public class Blog { -\n" - " private Long _id; -\n" - " private String _name; -\n" - " private List _items; -\n" - " -\n" - " public Long getId() { -\n" - " return _id; -\n" - " } -\n" - " public List getItems() { -\n" - " return _items; -\n" - " } -\n" - " public String getName() { -\n" - " return _name; -\n" - " } -\n" - " public void setId(Long long1) { -\n" - " _id = long1; -\n" - " } -\n" - " public void setItems(List list) { -\n" - " _items = list; -\n" - " } -\n" - " public void setName(String string) { -\n" - " _name = string; -\n" - " } -\n" - "}]]>" -#: index.docbook:18 +#. Tag: programlisting +#: example_weblog.xml:18 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.text.DateFormat;\n" - "import java.util.Calendar;\n" - "\n" - "public class BlogItem {\n" - " private Long _id;\n" - " private Calendar _datetime;\n" - " private String _text;\n" - " private String _title;\n" - " private Blog _blog;\n" - "\n" - " public Blog getBlog() {\n" - " return _blog;\n" - " }\n" - " public Calendar getDatetime() {\n" - " return _datetime;\n" - " }\n" - " public Long getId() {\n" - " return _id;\n" - " }\n" - " public String getText() {\n" - " return _text;\n" - " }\n" - " public String getTitle() {\n" - " return _title;\n" - " }\n" - " public void setBlog(Blog blog) {\n" - " _blog = blog;\n" - " }\n" - " public void setDatetime(Calendar calendar) {\n" - " _datetime = calendar;\n" - " }\n" - " public void setId(Long long1) {\n" - " _id = long1;\n" - " }\n" - " public void setText(String string) {\n" - " _text = string;\n" - " }\n" - " public void setTitle(String string) {\n" - " _title = string;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"\n" +"import java.text.DateFormat;\n" +"import java.util.Calendar;\n" +"\n" +"public class BlogItem {\n" +" private Long _id;\n" +" private Calendar _datetime;\n" +" private String _text;\n" +" private String _title;\n" +" private Blog _blog;\n" +"\n" +" public Blog getBlog() {\n" +" return _blog;\n" +" }\n" +" public Calendar getDatetime() {\n" +" return _datetime;\n" +" }\n" +" public Long getId() {\n" +" return _id;\n" +" }\n" +" public String getText() {\n" +" return _text;\n" +" }\n" +" public String getTitle() {\n" +" return _title;\n" +" }\n" +" public void setBlog(Blog blog) {\n" +" _blog = blog;\n" +" }\n" +" public void setDatetime(Calendar calendar) {\n" +" _datetime = calendar;\n" +" }\n" +" public void setId(Long long1) {\n" +" _id = long1;\n" +" }\n" +" public void setText(String string) {\n" +" _text = string;\n" +" }\n" +" public void setTitle(String string) {\n" +" _title = string;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[package eg; -\n" - " -\n" - "import java.text.DateFormat; -\n" - "import java.util.Calendar; -\n" - " -\n" - "public class BlogItem { -\n" - " private Long _id; -\n" - " private Calendar _datetime; -\n" - " private String _text; -\n" - " private String _title; -\n" - " private Blog _blog; -\n" - " -\n" - " public Blog getBlog() { -\n" - " return _blog; -\n" - " } -\n" - " public Calendar getDatetime() { -\n" - " return _datetime; -\n" - " } -\n" - " public Long getId() { -\n" - " return _id; -\n" - " } -\n" - " public String getText() { -\n" - " return _text; -\n" - " } -\n" - " public String getTitle() { -\n" - " return _title; -\n" - " } -\n" - " public void setBlog(Blog blog) { -\n" - " _blog = blog; -\n" - " } -\n" - " public void setDatetime(Calendar calendar) { -\n" - " _datetime = calendar; -\n" - " } -\n" - " public void setId(Long long1) { -\n" - " _id = long1; -\n" - " } -\n" - " public void setText(String string) { -\n" - " _text = string; -\n" - " } -\n" - " public void setTitle(String string) { -\n" - " _title = string; -\n" - " } -\n" - "}]]>" -#: index.docbook:23 +#. Tag: title +#: example_weblog.xml:23 +#, no-c-format msgid "Hibernate Mappings" msgstr "Hibernateのマッピング" -#: index.docbook:25 +#. Tag: para +#: example_weblog.xml:25 +#, no-c-format msgid "The XML mappings should now be quite straightforward." msgstr "XMLマッピングは、今ではとても簡単なはずです。" -#: index.docbook:29 +#. Tag: programlisting +#: example_weblog.xml:29 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class\n" - " name=\"Blog\"\n" - " table=\"BLOGS\">\n" - "\n" - " <id\n" - " name=\"id\"\n" - " column=\"BLOG_ID\">\n" - "\n" - " <generator class=\"native\"/>\n" - "\n" - " </id>\n" - "\n" - " <property\n" - " name=\"name\"\n" - " column=\"NAME\"\n" - " not-null=\"true\"\n" - " unique=\"true\"/>\n" - "\n" - " <bag\n" - " name=\"items\"\n" - " inverse=\"true\"\n" - " order-by=\"DATE_TIME\"\n" - " cascade=\"all\">\n" - "\n" - " <key column=\"BLOG_ID\"/>\n" - " <one-to-many class=\"BlogItem\"/>\n" - "\n" - " </bag>\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class\n" +" name=\"Blog\"\n" +" table=\"BLOGS\">\n" +"\n" +" <id\n" +" name=\"id\"\n" +" column=\"BLOG_ID\">\n" +"\n" +" <generator class=\"native\"/>\n" +"\n" +" </id>\n" +"\n" +" <property\n" +" name=\"name\"\n" +" column=\"NAME\"\n" +" not-null=\"true\"\n" +" unique=\"true\"/>\n" +"\n" +" <bag\n" +" name=\"items\"\n" +" inverse=\"true\"\n" +" order-by=\"DATE_TIME\"\n" +" cascade=\"all\">\n" +"\n" +" <key column=\"BLOG_ID\"/>\n" +" <one-to-many class=\"BlogItem\"/>\n" +"\n" +" </bag>\n" +"\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?> -\n" - "<!DOCTYPE hibernate-mapping PUBLIC -\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\"> -\n" - " -\n" - "<hibernate-mapping package=\"eg\"> -\n" - " -\n" - " <class -\n" - " name=\"Blog\" -\n" - " table=\"BLOGS\"> -\n" - " -\n" - " <id -\n" - " name=\"id\" -\n" - " column=\"BLOG_ID\"> -\n" - " -\n" - " <generator class=\"native\"/> -\n" - " -\n" - " </id> -\n" - " -\n" - " <property -\n" - " name=\"name\" -\n" - " column=\"NAME\" -\n" - " not-null=\"true\" -\n" - " unique=\"true\"/> -\n" - " -\n" - " <bag -\n" - " name=\"items\" -\n" - " inverse=\"true\" -\n" - " order-by=\"DATE_TIME\" -\n" - " cascade=\"all\"> -\n" - " -\n" - " <key column=\"BLOG_ID\"/> -\n" - " <one-to-many class=\"BlogItem\"/> -\n" - " -\n" - " </bag> -\n" - " -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:31 +#. Tag: programlisting +#: example_weblog.xml:31 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping package=\"eg\">\n" - "\n" - " <class\n" - " name=\"BlogItem\"\n" - " table=\"BLOG_ITEMS\"\n" - " dynamic-update=\"true\">\n" - "\n" - " <id\n" - " name=\"id\"\n" - " column=\"BLOG_ITEM_ID\">\n" - "\n" - " <generator class=\"native\"/>\n" - "\n" - " </id>\n" - "\n" - " <property\n" - " name=\"title\"\n" - " column=\"TITLE\"\n" - " not-null=\"true\"/>\n" - "\n" - " <property\n" - " name=\"text\"\n" - " column=\"TEXT\"\n" - " not-null=\"true\"/>\n" - "\n" - " <property\n" - " name=\"datetime\"\n" - " column=\"DATE_TIME\"\n" - " not-null=\"true\"/>\n" - "\n" - " <many-to-one\n" - " name=\"blog\"\n" - " column=\"BLOG_ID\"\n" - " not-null=\"true\"/>\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping package=\"eg\">\n" +"\n" +" <class\n" +" name=\"BlogItem\"\n" +" table=\"BLOG_ITEMS\"\n" +" dynamic-update=\"true\">\n" +"\n" +" <id\n" +" name=\"id\"\n" +" column=\"BLOG_ITEM_ID\">\n" +"\n" +" <generator class=\"native\"/>\n" +"\n" +" </id>\n" +"\n" +" <property\n" +" name=\"title\"\n" +" column=\"TITLE\"\n" +" not-null=\"true\"/>\n" +"\n" +" <property\n" +" name=\"text\"\n" +" column=\"TEXT\"\n" +" not-null=\"true\"/>\n" +"\n" +" <property\n" +" name=\"datetime\"\n" +" column=\"DATE_TIME\"\n" +" not-null=\"true\"/>\n" +"\n" +" <many-to-one\n" +" name=\"blog\"\n" +" column=\"BLOG_ID\"\n" +" not-null=\"true\"/>\n" +"\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?> -\n" - "<!DOCTYPE hibernate-mapping PUBLIC -\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\"> -\n" - " -\n" - "<hibernate-mapping package=\"eg\"> -\n" - " -\n" - " <class -\n" - " name=\"BlogItem\" -\n" - " table=\"BLOG_ITEMS\" -\n" - " dynamic-update=\"true\"> -\n" - " -\n" - " <id -\n" - " name=\"id\" -\n" - " column=\"BLOG_ITEM_ID\"> -\n" - " -\n" - " <generator class=\"native\"/> -\n" - " -\n" - " </id> -\n" - " -\n" - " <property -\n" - " name=\"title\" -\n" - " column=\"TITLE\" -\n" - " not-null=\"true\"/> -\n" - " -\n" - " <property -\n" - " name=\"text\" -\n" - " column=\"TEXT\" -\n" - " not-null=\"true\"/> -\n" - " -\n" - " <property -\n" - " name=\"datetime\" -\n" - " column=\"DATE_TIME\" -\n" - " not-null=\"true\"/> -\n" - " -\n" - " <many-to-one -\n" - " name=\"blog\" -\n" - " column=\"BLOG_ID\" -\n" - " not-null=\"true\"/> -\n" - " -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:36 +#. Tag: title +#: example_weblog.xml:36 +#, no-c-format msgid "Hibernate Code" msgstr "Hibernateのコード" -#: index.docbook:38 -msgid "The following class demonstrates some of the kinds of things we can do with these classes, using Hibernate." -msgstr "以下のクラスは、 Hibernateでこれらのクラスを使ってできることをいくつか示しています。" - -#: index.docbook:43 +#. Tag: para +#: example_weblog.xml:38 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "import java.util.ArrayList;\n" - "import java.util.Calendar;\n" - "import java.util.Iterator;\n" - "import java.util.List;\n" - "\n" - "import org.hibernate.HibernateException;\n" - "import org.hibernate.Query;\n" - "import org.hibernate.Session;\n" - "import org.hibernate.SessionFactory;\n" - "import org.hibernate.Transaction;\n" - "import org.hibernate.cfg.Configuration;\n" - "import org.hibernate.tool.hbm2ddl.SchemaExport;\n" - "\n" - "public class BlogMain {\n" - " \n" - " private SessionFactory _sessions;\n" - " \n" - " public void configure() throws HibernateException {\n" - " _sessions = new Configuration()\n" - " .addClass(Blog.class)\n" - " .addClass(BlogItem.class)\n" - " .buildSessionFactory();\n" - " }\n" - " \n" - " public void exportTables() throws HibernateException {\n" - " Configuration cfg = new Configuration()\n" - " .addClass(Blog.class)\n" - " .addClass(BlogItem.class);\n" - " new SchemaExport(cfg).create(true, true);\n" - " }\n" - " \n" - " public Blog createBlog(String name) throws HibernateException {\n" - " \n" - " Blog blog = new Blog();\n" - " blog.setName(name);\n" - " blog.setItems( new ArrayList() );\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.persist(blog);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return blog;\n" - " }\n" - " \n" - " public BlogItem createBlogItem(Blog blog, String title, String text)\n" - " throws HibernateException {\n" - " \n" - " BlogItem item = new BlogItem();\n" - " item.setTitle(title);\n" - " item.setText(text);\n" - " item.setBlog(blog);\n" - " item.setDatetime( Calendar.getInstance() );\n" - " blog.getItems().add(item);\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.update(blog);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return item;\n" - " }\n" - " \n" - " public BlogItem createBlogItem(Long blogid, String title, String text)\n" - " throws HibernateException {\n" - " \n" - " BlogItem item = new BlogItem();\n" - " item.setTitle(title);\n" - " item.setText(text);\n" - " item.setDatetime( Calendar.getInstance() );\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Blog blog = (Blog) session.load(Blog.class, blogid);\n" - " item.setBlog(blog);\n" - " blog.getItems().add(item);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return item;\n" - " }\n" - " \n" - " public void updateBlogItem(BlogItem item, String text)\n" - " throws HibernateException {\n" - " \n" - " item.setText(text);\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " session.update(item);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " }\n" - " \n" - " public void updateBlogItem(Long itemid, String text)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " BlogItem item = (BlogItem) session.load(BlogItem.class, itemid);\n" - " item.setText(text);\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " }\n" - " \n" - " public List listAllBlogNamesAndItemCounts(int max)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " List result = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"select blog.id, blog.name, count(blogItem) \" +\n" - " \"from Blog as blog \" +\n" - " \"left outer join blog.items as blogItem \" +\n" - " \"group by blog.name, blog.id \" +\n" - " \"order by max(blogItem.datetime)\"\n" - " );\n" - " q.setMaxResults(max);\n" - " result = q.list();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return result;\n" - " }\n" - " \n" - " public Blog getBlogAndAllItems(Long blogid)\n" - " throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " Blog blog = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"from Blog as blog \" +\n" - " \"left outer join fetch blog.items \" +\n" - " \"where blog.id = :blogid\"\n" - " );\n" - " q.setParameter(\"blogid\", blogid);\n" - " blog = (Blog) q.uniqueResult();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return blog;\n" - " }\n" - " \n" - " public List listBlogsAndRecentItems() throws HibernateException {\n" - " \n" - " Session session = _sessions.openSession();\n" - " Transaction tx = null;\n" - " List result = null;\n" - " try {\n" - " tx = session.beginTransaction();\n" - " Query q = session.createQuery(\n" - " \"from Blog as blog \" +\n" - " \"inner join blog.items as blogItem \" +\n" - " \"where blogItem.datetime > :minDate\"\n" - " );\n" - "\n" - " Calendar cal = Calendar.getInstance();\n" - " cal.roll(Calendar.MONTH, false);\n" - " q.setCalendar(\"minDate\", cal);\n" - " \n" - " result = q.list();\n" - " tx.commit();\n" - " }\n" - " catch (HibernateException he) {\n" - " if (tx!=null) tx.rollback();\n" - " throw he;\n" - " }\n" - " finally {\n" - " session.close();\n" - " }\n" - " return result;\n" - " }\n" - "}]]>" +"The following class demonstrates some of the kinds of things we can do with " +"these classes, using Hibernate." msgstr "" - "<![CDATA[package eg; -\n" - " -\n" - "import java.util.ArrayList; -\n" - "import java.util.Calendar; -\n" - "import java.util.Iterator; -\n" - "import java.util.List; -\n" - " -\n" - "import org.hibernate.HibernateException; -\n" - "import org.hibernate.Query; -\n" - "import org.hibernate.Session; -\n" - "import org.hibernate.SessionFactory; -\n" - "import org.hibernate.Transaction; -\n" - "import org.hibernate.cfg.Configuration; -\n" - "import org.hibernate.tool.hbm2ddl.SchemaExport; -\n" - " -\n" - "public class BlogMain { -\n" - " -\n" - " private SessionFactory _sessions; -\n" - " -\n" - " public void configure() throws HibernateException { -\n" - " _sessions = new Configuration() -\n" - " .addClass(Blog.class) -\n" - " .addClass(BlogItem.class) -\n" - " .buildSessionFactory(); -\n" - " } -\n" - " -\n" - " public void exportTables() throws HibernateException { -\n" - " Configuration cfg = new Configuration() -\n" - " .addClass(Blog.class) -\n" - " .addClass(BlogItem.class); -\n" - " new SchemaExport(cfg).create(true, true); -\n" - " } -\n" - " -\n" - " public Blog createBlog(String name) throws HibernateException { -\n" - " -\n" - " Blog blog = new Blog(); -\n" - " blog.setName(name); -\n" - " blog.setItems( new ArrayList() ); -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " session.persist(blog); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " return blog; -\n" - " } -\n" - " -\n" - " public BlogItem createBlogItem(Blog blog, String title, String text) -\n" - " throws HibernateException { -\n" - " -\n" - " BlogItem item = new BlogItem(); -\n" - " item.setTitle(title); -\n" - " item.setText(text); -\n" - " item.setBlog(blog); -\n" - " item.setDatetime( Calendar.getInstance() ); -\n" - " blog.getItems().add(item); -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " session.update(blog); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " return item; -\n" - " } -\n" - " -\n" - " public BlogItem createBlogItem(Long blogid, String title, String text) -\n" - " throws HibernateException { -\n" - " -\n" - " BlogItem item = new BlogItem(); -\n" - " item.setTitle(title); -\n" - " item.setText(text); -\n" - " item.setDatetime( Calendar.getInstance() ); -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " Blog blog = (Blog) session.load(Blog.class, blogid); -\n" - " item.setBlog(blog); -\n" - " blog.getItems().add(item); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " return item; -\n" - " } -\n" - " -\n" - " public void updateBlogItem(BlogItem item, String text) -\n" - " throws HibernateException { -\n" - " -\n" - " item.setText(text); -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " session.update(item); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " } -\n" - " -\n" - " public void updateBlogItem(Long itemid, String text) -\n" - " throws HibernateException { -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " BlogItem item = (BlogItem) session.load(BlogItem.class, itemid); -\n" - " item.setText(text); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " } -\n" - " -\n" - " public List listAllBlogNamesAndItemCounts(int max) -\n" - " throws HibernateException { -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " List result = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " Query q = session.createQuery( -\n" - " \"select blog.id, blog.name, count(blogItem) \" + -\n" - " \"from Blog as blog \" + -\n" - " \"left outer join blog.items as blogItem \" + -\n" - " \"group by blog.name, blog.id \" + -\n" - " \"order by max(blogItem.datetime)\" -\n" - " ); -\n" - " q.setMaxResults(max); -\n" - " result = q.list(); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " return result; -\n" - " } -\n" - " -\n" - " public Blog getBlogAndAllItems(Long blogid) -\n" - " throws HibernateException { -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " Blog blog = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " Query q = session.createQuery( -\n" - " \"from Blog as blog \" + -\n" - " \"left outer join fetch blog.items \" + -\n" - " \"where blog.id = :blogid\" -\n" - " ); -\n" - " q.setParameter(\"blogid\", blogid); -\n" - " blog = (Blog) q.uniqueResult(); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " return blog; -\n" - " } -\n" - " -\n" - " public List listBlogsAndRecentItems() throws HibernateException { -\n" - " -\n" - " Session session = _sessions.openSession(); -\n" - " Transaction tx = null; -\n" - " List result = null; -\n" - " try { -\n" - " tx = session.beginTransaction(); -\n" - " Query q = session.createQuery( -\n" - " \"from Blog as blog \" + -\n" - " \"inner join blog.items as blogItem \" + -\n" - " \"where blogItem.datetime > :minDate\" -\n" - " ); -\n" - " -\n" - " Calendar cal = Calendar.getInstance(); -\n" - " cal.roll(Calendar.MONTH, false); -\n" - " q.setCalendar(\"minDate\", cal); -\n" - " -\n" - " result = q.list(); -\n" - " tx.commit(); -\n" - " } -\n" - " catch (HibernateException he) { -\n" - " if (tx!=null) tx.rollback(); -\n" - " throw he; -\n" - " } -\n" - " finally { -\n" - " session.close(); -\n" - " } -\n" - " return result; -\n" - " } -\n" - "}]]>" +"以下のクラスは、 Hibernateでこれらのクラスを使ってできることをいくつか示して" +"います。" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: programlisting +#: example_weblog.xml:43 +#, no-c-format +msgid "" +"<![CDATA[package eg;\n" +"\n" +"import java.util.ArrayList;\n" +"import java.util.Calendar;\n" +"import java.util.Iterator;\n" +"import java.util.List;\n" +"\n" +"import org.hibernate.HibernateException;\n" +"import org.hibernate.Query;\n" +"import org.hibernate.Session;\n" +"import org.hibernate.SessionFactory;\n" +"import org.hibernate.Transaction;\n" +"import org.hibernate.cfg.Configuration;\n" +"import org.hibernate.tool.hbm2ddl.SchemaExport;\n" +"\n" +"public class BlogMain {\n" +" \n" +" private SessionFactory _sessions;\n" +" \n" +" public void configure() throws HibernateException {\n" +" _sessions = new Configuration()\n" +" .addClass(Blog.class)\n" +" .addClass(BlogItem.class)\n" +" .buildSessionFactory();\n" +" }\n" +" \n" +" public void exportTables() throws HibernateException {\n" +" Configuration cfg = new Configuration()\n" +" .addClass(Blog.class)\n" +" .addClass(BlogItem.class);\n" +" new SchemaExport(cfg).create(true, true);\n" +" }\n" +" \n" +" public Blog createBlog(String name) throws HibernateException {\n" +" \n" +" Blog blog = new Blog();\n" +" blog.setName(name);\n" +" blog.setItems( new ArrayList() );\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" session.persist(blog);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return blog;\n" +" }\n" +" \n" +" public BlogItem createBlogItem(Blog blog, String title, String text)\n" +" throws HibernateException {\n" +" \n" +" BlogItem item = new BlogItem();\n" +" item.setTitle(title);\n" +" item.setText(text);\n" +" item.setBlog(blog);\n" +" item.setDatetime( Calendar.getInstance() );\n" +" blog.getItems().add(item);\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" session.update(blog);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return item;\n" +" }\n" +" \n" +" public BlogItem createBlogItem(Long blogid, String title, String text)\n" +" throws HibernateException {\n" +" \n" +" BlogItem item = new BlogItem();\n" +" item.setTitle(title);\n" +" item.setText(text);\n" +" item.setDatetime( Calendar.getInstance() );\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Blog blog = (Blog) session.load(Blog.class, blogid);\n" +" item.setBlog(blog);\n" +" blog.getItems().add(item);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return item;\n" +" }\n" +" \n" +" public void updateBlogItem(BlogItem item, String text)\n" +" throws HibernateException {\n" +" \n" +" item.setText(text);\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" session.update(item);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" }\n" +" \n" +" public void updateBlogItem(Long itemid, String text)\n" +" throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" BlogItem item = (BlogItem) session.load(BlogItem.class, " +"itemid);\n" +" item.setText(text);\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" }\n" +" \n" +" public List listAllBlogNamesAndItemCounts(int max)\n" +" throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" List result = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Query q = session.createQuery(\n" +" \"select blog.id, blog.name, count(blogItem) \" +\n" +" \"from Blog as blog \" +\n" +" \"left outer join blog.items as blogItem \" +\n" +" \"group by blog.name, blog.id \" +\n" +" \"order by max(blogItem.datetime)\"\n" +" );\n" +" q.setMaxResults(max);\n" +" result = q.list();\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return result;\n" +" }\n" +" \n" +" public Blog getBlogAndAllItems(Long blogid)\n" +" throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" Blog blog = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Query q = session.createQuery(\n" +" \"from Blog as blog \" +\n" +" \"left outer join fetch blog.items \" +\n" +" \"where blog.id = :blogid\"\n" +" );\n" +" q.setParameter(\"blogid\", blogid);\n" +" blog = (Blog) q.uniqueResult();\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return blog;\n" +" }\n" +" \n" +" public List listBlogsAndRecentItems() throws HibernateException {\n" +" \n" +" Session session = _sessions.openSession();\n" +" Transaction tx = null;\n" +" List result = null;\n" +" try {\n" +" tx = session.beginTransaction();\n" +" Query q = session.createQuery(\n" +" \"from Blog as blog \" +\n" +" \"inner join blog.items as blogItem \" +\n" +" \"where blogItem.datetime > :minDate\"\n" +" );\n" +"\n" +" Calendar cal = Calendar.getInstance();\n" +" cal.roll(Calendar.MONTH, false);\n" +" q.setCalendar(\"minDate\", cal);\n" +" \n" +" result = q.list();\n" +" tx.commit();\n" +" }\n" +" catch (HibernateException he) {\n" +" if (tx!=null) tx.rollback();\n" +" throw he;\n" +" }\n" +" finally {\n" +" session.close();\n" +" }\n" +" return result;\n" +" }\n" +"}]]>" +msgstr "" Modified: core/trunk/documentation/manual/translations/ja-JP/content/filters.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/filters.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/filters.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,234 +1,286 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: filters.xml:5 +#, no-c-format msgid "Filtering data" msgstr "データのフィルタリング" -#: index.docbook:7 -msgid "Hibernate3 provides an innovative new approach to handling data with \"visibility\" rules. A <emphasis>Hibernate filter</emphasis> is a global, named, parameterized filter that may be enabled or disabled for a particular Hibernate session." -msgstr "Hibernate3では「可視性」ルールに基づいてデータを扱うための画期的な方法を用意しています。 <emphasis>Hibernate filter</emphasis> はグローバルで、名前付きで、パラメータ化されたフィルタです。 これはHibernateセッションごとに有効無効を切り替えられます。" +#. Tag: para +#: filters.xml:7 +#, no-c-format +msgid "" +"Hibernate3 provides an innovative new approach to handling data with " +"\"visibility\" rules. A <emphasis>Hibernate filter</emphasis> is a global, " +"named, parameterized filter that may be enabled or disabled for a particular " +"Hibernate session." +msgstr "" +"Hibernate3では「可視性」ルールに基づいてデータを扱うための画期的な方法を用意" +"しています。 <emphasis>Hibernate filter</emphasis> はグローバルで、名前付き" +"で、パラメータ化されたフィルタです。 これはHibernateセッションごとに有効無効" +"を切り替えられます。" -#: index.docbook:14 +#. Tag: title +#: filters.xml:14 +#, no-c-format msgid "Hibernate filters" msgstr "Hibernateのフィルタ" -#: index.docbook:16 -msgid "Hibernate3 adds the ability to pre-define filter criteria and attach those filters at both a class and a collection level. A filter criteria is the ability to define a restriction clause very similiar to the existing \"where\" attribute available on the class and various collection elements. Except these filter conditions can be parameterized. The application can then make the decision at runtime whether given filters should be enabled and what their parameter values should be. Filters can be used like database views, but parameterized inside the application." -msgstr "Hibernate3はフィルタクライテリアをあらかじめ定義し、 これらのフィルタをクラスやコレクションレベルに加える機能を加えました。 フィルタクライテリアは制約節を定義する機能です。 これらのフィルタ条件はパラメータ化できるということを除き、 クラスやさまざまなコレクション要素で利用可能な｢where｣句に非常によく似ています。 アプリケーションは、与えられたフィルタを可能にすべきか、 そしてそのパラメータ値を何にすべきかを実行時に決定することができます。 フィルタはデータベースビューのように使用されますが、アプリケーション内ではパラメータ化されます。" +#. Tag: para +#: filters.xml:16 +#, no-c-format +msgid "" +"Hibernate3 adds the ability to pre-define filter criteria and attach those " +"filters at both a class and a collection level. A filter criteria is the " +"ability to define a restriction clause very similiar to the existing \"where" +"\" attribute available on the class and various collection elements. Except " +"these filter conditions can be parameterized. The application can then make " +"the decision at runtime whether given filters should be enabled and what " +"their parameter values should be. Filters can be used like database views, " +"but parameterized inside the application." +msgstr "" +"Hibernate3はフィルタクライテリアをあらかじめ定義し、 これらのフィルタをクラス" +"やコレクションレベルに加える機能を加えました。 フィルタクライテリアは制約節を" +"定義する機能です。 これらのフィルタ条件はパラメータ化できるということを除" +"き、 クラスやさまざまなコレクション要素で利用可能な｢where｣句に非常によく似て" +"います。 アプリケーションは、与えられたフィルタを可能にすべきか、 そしてその" +"パラメータ値を何にすべきかを実行時に決定することができます。 フィルタはデータ" +"ベースビューのように使用されますが、アプリケーション内ではパラメータ化されま" +"す。" -#: index.docbook:26 -msgid "In order to use filters, they must first be defined and then attached to the appropriate mapping elements. To define a filter, use the <literal>&lt;filter-def/&gt;</literal> element within a <literal>&lt;hibernate-mapping/&gt;</literal> element:" -msgstr "フィルタを使うためにはまず、適切なマッピング要素に定義、追加しなくてはなりません。 フィルタを定義するためには、 <literal>&lt;hibernate-mapping/&gt;</literal> 要素内で <literal>&lt;filter-def/&gt;</literal> 要素を使用します。：" +#. Tag: para +#: filters.xml:26 +#, no-c-format +msgid "" +"In order to use filters, they must first be defined and then attached to the " +"appropriate mapping elements. To define a filter, use the <literal>&lt;" +"filter-def/&gt;</literal> element within a <literal>&lt;hibernate-mapping/" +"&gt;</literal> element:" +msgstr "" +"フィルタを使うためにはまず、適切なマッピング要素に定義、追加しなくてはなりま" +"せん。 フィルタを定義するためには、 <literal>&lt;hibernate-mapping/&gt;</" +"literal> 要素内で <literal>&lt;filter-def/&gt;</literal> 要素を使用します。：" -#: index.docbook:32 +#. Tag: programlisting +#: filters.xml:32 +#, no-c-format msgid "" - "<![CDATA[<filter-def name=\"myFilter\">\n" - " <filter-param name=\"myFilterParam\" type=\"string\"/>\n" - "</filter-def>]]>" +"<![CDATA[<filter-def name=\"myFilter\">\n" +" <filter-param name=\"myFilterParam\" type=\"string\"/>\n" +"</filter-def>]]>" msgstr "" - "<![CDATA[<filter-def name=\"myFilter\"> -\n" - " <filter-param name=\"myFilterParam\" type=\"string\"/> -\n" - "</filter-def>]]>" -#: index.docbook:34 +#. Tag: para +#: filters.xml:34 +#, no-c-format msgid "Then, this filter can be attached to a class:" msgstr "そうしてフィルタはクラスへと結び付けられます。：" -#: index.docbook:38 +#. Tag: programlisting +#: filters.xml:38 +#, no-c-format msgid "" - "<![CDATA[<class name=\"myClass\" ...>\n" - " ...\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"myClass\" ...>\n" +" ...\n" +" <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN" +"\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"myClass\" ...> -\n" - " ... -\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/> -\n" - "</class>]]>" -#: index.docbook:40 +#. Tag: para +#: filters.xml:40 +#, no-c-format msgid "or, to a collection:" msgstr "また、コレクションに対しては次のようになります。：" -#: index.docbook:44 +#. Tag: programlisting +#: filters.xml:44 +#, no-c-format msgid "" - "<![CDATA[<set ...>\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/>\n" - "</set>]]>" +"<![CDATA[<set ...>\n" +" <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN" +"\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set ...> -\n" - " <filter name=\"myFilter\" condition=\":myFilterParam = MY_FILTERED_COLUMN\"/> -\n" - "</set>]]>" -#: index.docbook:46 +#. Tag: para +#: filters.xml:46 +#, no-c-format msgid "or, even to both (or multiples of each) at the same time." msgstr "どちらに対しても(また、それぞれを複数)同時に設定することもできます。" -#: index.docbook:50 -msgid "The methods on <literal>Session</literal> are: <literal>enableFilter(String filterName)</literal>, <literal>getEnabledFilter(String filterName)</literal>, and <literal>disableFilter(String filterName)</literal>. By default, filters are <emphasis>not</emphasis> enabled for a given session; they must be explcitly enabled through use of the <literal>Session.enabledFilter()</literal> method, which returns an instance of the <literal>Filter</literal> interface. Using the simple filter defined above, this would look like:" -msgstr "<literal>Session</literal> 上のメソッドは <literal>enableFilter(String filterName)</literal>, <literal>getEnabledFilter(String filterName)</literal>, <literal>disableFilter(String filterName)</literal> です。 デフォルトでは、フィルタは与えられたセッションに対して使用 <emphasis>できません</emphasis> 。 <literal>Filter</literal> インスタンスを返り値とする <literal>Session.enabledFilter()</literal> メソッドを使うことで、 フィルタは明示的に使用可能となります。 上で定義した単純なフィルタの使用は、このようになります。：" +#. Tag: para +#: filters.xml:50 +#, no-c-format +msgid "" +"The methods on <literal>Session</literal> are: <literal>enableFilter(String " +"filterName)</literal>, <literal>getEnabledFilter(String filterName)</" +"literal>, and <literal>disableFilter(String filterName)</literal>. By " +"default, filters are <emphasis>not</emphasis> enabled for a given session; " +"they must be explcitly enabled through use of the <literal>Session." +"enabledFilter()</literal> method, which returns an instance of the " +"<literal>Filter</literal> interface. Using the simple filter defined above, " +"this would look like:" +msgstr "" +"<literal>Session</literal> 上のメソッドは <literal>enableFilter(String " +"filterName)</literal>, <literal>getEnabledFilter(String filterName)</" +"literal>, <literal>disableFilter(String filterName)</literal> です。 デフォル" +"トでは、フィルタは与えられたセッションに対して使用 <emphasis>できません</" +"emphasis> 。 <literal>Filter</literal> インスタンスを返り値とする " +"<literal>Session.enabledFilter()</literal> メソッドを使うことで、 フィルタは" +"明示的に使用可能となります。 上で定義した単純なフィルタの使用は、このようにな" +"ります。：" -#: index.docbook:59 -msgid "<![CDATA[session.enableFilter(\"myFilter\").setParameter(\"myFilterParam\", \"some-value\");]]>" -msgstr "<![CDATA[session.enableFilter(\"myFilter\").setParameter(\"myFilterParam\", \"some-value\");]]>" +#. Tag: programlisting +#: filters.xml:59 +#, no-c-format +msgid "" +"<![CDATA[session.enableFilter(\"myFilter\").setParameter(\"myFilterParam\", " +"\"some-value\");]]>" +msgstr "" -#: index.docbook:61 -msgid "Note that methods on the org.hibernate.Filter interface do allow the method-chaining common to much of Hibernate." -msgstr "org.hibernate.Filterインターフェイスのメソッドは、 Hibernateの多くに共通しているメソッド連鎖を許していることに注意してください。" +#. Tag: para +#: filters.xml:61 +#, no-c-format +msgid "" +"Note that methods on the org.hibernate.Filter interface do allow the method-" +"chaining common to much of Hibernate." +msgstr "" +"org.hibernate.Filterインターフェイスのメソッドは、 Hibernateの多くに共通して" +"いるメソッド連鎖を許していることに注意してください。" -#: index.docbook:65 -msgid "A full example, using temporal data with an effective record date pattern:" +#. Tag: para +#: filters.xml:65 +#, no-c-format +msgid "" +"A full example, using temporal data with an effective record date pattern:" msgstr "有効なレコードデータパターンを持つ一時データを使った完全な例です：" -#: index.docbook:69 +#. Tag: programlisting +#: filters.xml:69 +#, no-c-format msgid "" - "<![CDATA[<filter-def name=\"effectiveDate\">\n" - " <filter-param name=\"asOfDate\" type=\"date\"/>\n" - "</filter-def>\n" - "\n" - "<class name=\"Employee\" ...>\n" - "...\n" - " <many-to-one name=\"department\" column=\"dept_id\" class=\"Department\"/>\n" - " <property name=\"effectiveStartDate\" type=\"date\" column=\"eff_start_dt\"/>\n" - " <property name=\"effectiveEndDate\" type=\"date\" column=\"eff_end_dt\"/>\n" - "...\n" - " <!--\n" - " Note that this assumes non-terminal records have an eff_end_dt set to\n" - " a max db date for simplicity-sake\n" - " -->\n" - " <filter name=\"effectiveDate\"\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" - "</class>\n" - "\n" - "<class name=\"Department\" ...>\n" - "...\n" - " <set name=\"employees\" lazy=\"true\">\n" - " <key column=\"dept_id\"/>\n" - " <one-to-many class=\"Employee\"/>\n" - " <filter name=\"effectiveDate\"\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<filter-def name=\"effectiveDate\">\n" +" <filter-param name=\"asOfDate\" type=\"date\"/>\n" +"</filter-def>\n" +"\n" +"<class name=\"Employee\" ...>\n" +"...\n" +" <many-to-one name=\"department\" column=\"dept_id\" class=\"Department\"/" +">\n" +" <property name=\"effectiveStartDate\" type=\"date\" column=\"eff_start_dt" +"\"/>\n" +" <property name=\"effectiveEndDate\" type=\"date\" column=\"eff_end_dt\"/" +">\n" +"...\n" +" <!--\n" +" Note that this assumes non-terminal records have an eff_end_dt set " +"to\n" +" a max db date for simplicity-sake\n" +" -->\n" +" <filter name=\"effectiveDate\"\n" +" condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/>\n" +"</class>\n" +"\n" +"<class name=\"Department\" ...>\n" +"...\n" +" <set name=\"employees\" lazy=\"true\">\n" +" <key column=\"dept_id\"/>\n" +" <one-to-many class=\"Employee\"/>\n" +" <filter name=\"effectiveDate\"\n" +" condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/" +">\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<filter-def name=\"effectiveDate\"> -\n" - " <filter-param name=\"asOfDate\" type=\"date\"/> -\n" - "</filter-def> -\n" - " -\n" - "<class name=\"Employee\" ...> -\n" - "... -\n" - " <many-to-one name=\"department\" column=\"dept_id\" class=\"Department\"/> -\n" - " <property name=\"effectiveStartDate\" type=\"date\" column=\"eff_start_dt\"/> -\n" - " <property name=\"effectiveEndDate\" type=\"date\" column=\"eff_end_dt\"/> -\n" - "... -\n" - " <!-- -\n" - " Note that this assumes non-terminal records have an eff_end_dt set to -\n" - " a max db date for simplicity-sake -\n" - " -\n" - " -\n" - " --> -\n" - " <filter name=\"effectiveDate\" -\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/> -\n" - "</class> -\n" - " -\n" - "<class name=\"Department\" ...> -\n" - "... -\n" - " <set name=\"employees\" lazy=\"true\"> -\n" - " <key column=\"dept_id\"/> -\n" - " <one-to-many class=\"Employee\"/> -\n" - " <filter name=\"effectiveDate\" -\n" - " condition=\":asOfDate BETWEEN eff_start_dt and eff_end_dt\"/> -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:71 -msgid "Then, in order to ensure that you always get back currently effective records, simply enable the filter on the session prior to retrieving employee data:" -msgstr "常に現在の有効レコードを返却することを保証するために、 単純に、社員データの検索より前にセッション上のフィルタを有効にします。" - -#: index.docbook:76 +#. Tag: para +#: filters.xml:71 +#, no-c-format msgid "" - "<![CDATA[Session session = ...;\n" - "session.enabledFilter(\"effectiveDate\").setParameter(\"asOfDate\", new Date());\n" - "List results = session.createQuery(\"from Employee as e where e.salary > :targetSalary\")\n" - " .setLong(\"targetSalary\", new Long(1000000))\n" - " .list();\n" - "]]>" +"Then, in order to ensure that you always get back currently effective " +"records, simply enable the filter on the session prior to retrieving " +"employee data:" msgstr "" - "<![CDATA[Session session = ...; -\n" - "session.enabledFilter(\"effectiveDate\").setParameter(\"asOfDate\", new Date()); -\n" - "List results = session.createQuery(\"from Employee as e where e.salary > :targetSalary\") -\n" - " .setLong(\"targetSalary\", new Long(1000000)) -\n" - " .list(); -\n" - "]]>" +"常に現在の有効レコードを返却することを保証するために、 単純に、社員データの検" +"索より前にセッション上のフィルタを有効にします。" -#: index.docbook:78 -msgid "In the HQL above, even though we only explicitly mentioned a salary constraint on the results, because of the enabled filter the query will return only currently active employees who have a salary greater than a million dollars." -msgstr "上記のHQLでは、結果の給料の制約について明示的に触れただけですが、 有効になっているフィルタのおかげで、このクエリは給料が100万ドル以上の現役の社員だけを返します。" - -#: index.docbook:84 -msgid "Note: if you plan on using filters with outer joining (either through HQL or load fetching) be careful of the direction of the condition expression. Its safest to set this up for left outer joining; in general, place the parameter first followed by the column name(s) after the operator." -msgstr "(HQLかロードフェッチで）外部結合を持つフィルタを使うつもりなら、 条件式の方向に注意してください。 これは左外部結合のために設定するのが最も安全です。 一般的に、演算子の後カラム名に続けて最初のパラメータを配置してください。" - -#: index.docbook:91 -msgid "After being defined a filter might be attached to multiple entities and/or collections each with its own condition. That can be tedious when the conditions are the same each time. Thus <literal>&lt;filter-def/&gt;</literal> allows defining a default condition, either as an attribute or CDATA:" +#. Tag: programlisting +#: filters.xml:76 +#, no-c-format +msgid "" +"<![CDATA[Session session = ...;\n" +"session.enabledFilter(\"effectiveDate\").setParameter(\"asOfDate\", new Date" +"());\n" +"List results = session.createQuery(\"from Employee as e where e.salary > :" +"targetSalary\")\n" +" .setLong(\"targetSalary\", new Long(1000000))\n" +" .list();\n" +"]]>" msgstr "" -#: index.docbook:98 +#. Tag: para +#: filters.xml:78 +#, no-c-format msgid "" - "<![CDATA[<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</filter-def>\n" - "<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>]]>" +"In the HQL above, even though we only explicitly mentioned a salary " +"constraint on the results, because of the enabled filter the query will " +"return only currently active employees who have a salary greater than a " +"million dollars." msgstr "" +"上記のHQLでは、結果の給料の制約について明示的に触れただけですが、 有効になっ" +"ているフィルタのおかげで、このクエリは給料が100万ドル以上の現役の社員だけを返" +"します。" -#: index.docbook:100 -msgid "This default condition will then be used whenever the filter is attached to something without specifying a condition. Note that this means you can give a specific condition as part of the attachment of the filter which overrides the default condition in that particular case." +#. Tag: para +#: filters.xml:84 +#, no-c-format +msgid "" +"Note: if you plan on using filters with outer joining (either through HQL or " +"load fetching) be careful of the direction of the condition expression. Its " +"safest to set this up for left outer joining; in general, place the " +"parameter first followed by the column name(s) after the operator." msgstr "" +"(HQLかロードフェッチで）外部結合を持つフィルタを使うつもりなら、 条件式の方向" +"に注意してください。 これは左外部結合のために設定するのが最も安全です。 一般" +"的に、演算子の後カラム名に続けて最初のパラメータを配置してください。" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" +#. Tag: para +#: filters.xml:91 +#, no-c-format +msgid "" +"After being defined a filter might be attached to multiple entities and/or " +"collections each with its own condition. That can be tedious when the " +"conditions are the same each time. Thus <literal>&lt;filter-def/&gt;</" +"literal> allows defining a default condition, either as an attribute or " +"CDATA:" +msgstr "translator-credits" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" +#. Tag: programlisting +#: filters.xml:98 +#, no-c-format +msgid "" +"<![CDATA[<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</filter-" +"def>\n" +"<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>]]>" +msgstr "" +#. Tag: para +#: filters.xml:100 +#, no-c-format +msgid "" +"This default condition will then be used whenever the filter is attached to " +"something without specifying a condition. Note that this means you can give " +"a specific condition as part of the attachment of the filter which overrides " +"the default condition in that particular case." +msgstr "" Modified: core/trunk/documentation/manual/translations/ja-JP/content/inheritance_mapping.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/inheritance_mapping.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/inheritance_mapping.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,642 +1,842 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: inheritance_mapping.xml:5 +#, no-c-format msgid "Inheritance Mapping" msgstr "継承マッピング" -#: index.docbook:8 +#. Tag: title +#: inheritance_mapping.xml:8 +#, no-c-format msgid "The Three Strategies" msgstr "3つの戦略" -#: index.docbook:10 +#. Tag: para +#: inheritance_mapping.xml:10 +#, no-c-format msgid "Hibernate supports the three basic inheritance mapping strategies:" msgstr "Hibernateは3つの基本的な継承のマッピング戦略をサポートします。" -#: index.docbook:16 +#. Tag: para +#: inheritance_mapping.xml:16 +#, no-c-format msgid "table per class hierarchy" -msgstr "<para>クラス階層ごとのテーブル（table-per-class-hierarchy）</para>" +msgstr "クラス階層ごとのテーブル（table-per-class-hierarchy）" -#: index.docbook:21 +#. Tag: para +#: inheritance_mapping.xml:21 +#, fuzzy, no-c-format msgid "<para>table per subclass</para>" -msgstr "<para>サブクラスごとのテーブル（table-per-subclass）</para>" +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"サブクラスごとのテーブル（table-per-subclass）\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"table per subclass" -#: index.docbook:26 +#. Tag: para +#: inheritance_mapping.xml:26 +#, no-c-format msgid "table per concrete class" -msgstr "<para>具象クラスごとのテーブル（table-per-concrete-class）</para>" +msgstr "具象クラスごとのテーブル（table-per-concrete-class）" -#: index.docbook:32 -msgid "In addition, Hibernate supports a fourth, slightly different kind of polymorphism:" -msgstr "加えて4つ目に、Hibernateはわずかに異なる性質を持ったポリモーフィズムをサポートします。" +#. Tag: para +#: inheritance_mapping.xml:32 +#, no-c-format +msgid "" +"In addition, Hibernate supports a fourth, slightly different kind of " +"polymorphism:" +msgstr "" +"加えて4つ目に、Hibernateはわずかに異なる性質を持ったポリモーフィズムをサポー" +"トします。" -#: index.docbook:39 +#. Tag: para +#: inheritance_mapping.xml:39 +#, no-c-format msgid "implicit polymorphism" msgstr "暗黙的ポリモーフィズム" -#: index.docbook:45 -msgid "It is possible to use different mapping strategies for different branches of the same inheritance hierarchy, and then make use of implicit polymorphism to achieve polymorphism across the whole hierarchy. However, Hibernate does not support mixing <literal>&lt;subclass&gt;</literal>, and <literal>&lt;joined-subclass&gt;</literal> and <literal>&lt;union-subclass&gt;</literal> mappings under the same root <literal>&lt;class&gt;</literal> element. It is possible to mix together the table per hierarchy and table per subclass strategies, under the the same <literal>&lt;class&gt;</literal> element, by combining the <literal>&lt;subclass&gt;</literal> and <literal>&lt;join&gt;</literal> elements (see below)." -msgstr "同一の継承階層の異なるブランチに対して異なるマッピング戦略を使うことができます。 その場合には全体の階層に渡るポリモーフィズムを実現するために暗黙的ポリモーフィズムを使用します。 しかし、Hibernateは同じルート <literal>&lt;class&gt;</literal> 要素内で <literal>&lt;subclass&gt;</literal> マッピング、<literal>&lt;joined-subclass&gt;</literal> マッピング、 <literal>&lt;union-subclass&gt;</literal> マッピングの同時使用をサポートしていません。 <literal>&lt;subclass&gt;</literal> 要素と <literal>&lt;join&gt;</literal> 要素を組み合わせることで、 同一 <literal>&lt;class&gt;</literal> 要素内での table-per-hierarchy 戦略と table-per-subclass 戦略の同時使用は可能です。次の例を見てください。" +#. Tag: para +#: inheritance_mapping.xml:45 +#, no-c-format +msgid "" +"It is possible to use different mapping strategies for different branches of " +"the same inheritance hierarchy, and then make use of implicit polymorphism " +"to achieve polymorphism across the whole hierarchy. However, Hibernate does " +"not support mixing <literal>&lt;subclass&gt;</literal>, and <literal>&lt;" +"joined-subclass&gt;</literal> and <literal>&lt;union-subclass&gt;</literal> " +"mappings under the same root <literal>&lt;class&gt;</literal> element. It is " +"possible to mix together the table per hierarchy and table per subclass " +"strategies, under the the same <literal>&lt;class&gt;</literal> element, by " +"combining the <literal>&lt;subclass&gt;</literal> and <literal>&lt;join&gt;</" +"literal> elements (see below)." +msgstr "" +"同一の継承階層の異なるブランチに対して異なるマッピング戦略を使うことができま" +"す。 その場合には全体の階層に渡るポリモーフィズムを実現するために暗黙的ポリ" +"モーフィズムを使用します。 しかし、Hibernateは同じルート <literal>&lt;" +"class&gt;</literal> 要素内で <literal>&lt;subclass&gt;</literal> マッピング、" +"<literal>&lt;joined-subclass&gt;</literal> マッピング、 <literal>&lt;union-" +"subclass&gt;</literal> マッピングの同時使用をサポートしていません。 " +"<literal>&lt;subclass&gt;</literal> 要素と <literal>&lt;join&gt;</literal> 要" +"素を組み合わせることで、 同一 <literal>&lt;class&gt;</literal> 要素内での " +"table-per-hierarchy 戦略と table-per-subclass 戦略の同時使用は可能です。次の" +"例を見てください。" -#: index.docbook:59 -msgid "It is possible to define <literal>subclass</literal>, <literal>union-subclass</literal>, and <literal>joined-subclass</literal> mappings in separate mapping documents, directly beneath <literal>hibernate-mapping</literal>. This allows you to extend a class hierachy just by adding a new mapping file. You must specify an <literal>extends</literal> attribute in the subclass mapping, naming a previously mapped superclass. Note: Previously this feature made the ordering of the mapping documents important. Since Hibernate3, the ordering of mapping files does not matter when using the extends keyword. The ordering inside a single mapping file still needs to be defined as superclasses before subclasses." -msgstr "<literal>subclass</literal>, <literal>union-subclass</literal> と <literal>joined-subclass</literal> マッピングを複数のマッピングドキュメントに定義することが出来、 <literal>hibernate-mapping</literal> の直下に配置します。 これは新しいマッピングファイルを追加するだけで、クラス階層を拡張できるということです。 あらかじめマップしたスーパークラスを指定して、サブクラスマッピングに <literal>extends</literal> 属性を記述しなければなりません。 注意：この特徴により、以前はマッピング・ドキュメントの順番が重要でした。 Hibernate3からは、extendsキーワードを使う場合、マッピングドキュメントの順番は問題になりません。 １つのマッピングファイル内で順番付けを行うときは、 依然として、サブクラスを定義する前にスーパークラスを定義す! る必要があります。)" +#. Tag: para +#: inheritance_mapping.xml:59 +#, no-c-format +msgid "" +"It is possible to define <literal>subclass</literal>, <literal>union-" +"subclass</literal>, and <literal>joined-subclass</literal> mappings in " +"separate mapping documents, directly beneath <literal>hibernate-mapping</" +"literal>. This allows you to extend a class hierachy just by adding a new " +"mapping file. You must specify an <literal>extends</literal> attribute in " +"the subclass mapping, naming a previously mapped superclass. Note: " +"Previously this feature made the ordering of the mapping documents " +"important. Since Hibernate3, the ordering of mapping files does not matter " +"when using the extends keyword. The ordering inside a single mapping file " +"still needs to be defined as superclasses before subclasses." +msgstr "" +"<literal>subclass</literal>, <literal>union-subclass</literal> と " +"<literal>joined-subclass</literal> マッピングを複数のマッピングドキュメントに" +"定義することが出来、 <literal>hibernate-mapping</literal> の直下に配置しま" +"す。 これは新しいマッピングファイルを追加するだけで、クラス階層を拡張できると" +"いうことです。 あらかじめマップしたスーパークラスを指定して、サブクラスマッピ" +"ングに <literal>extends</literal> 属性を記述しなければなりません。 注意：この" +"特徴により、以前はマッピング・ドキュメントの順番が重要でした。 Hibernate3から" +"は、extendsキーワードを使う場合、マッピングドキュメントの順番は問題になりませ" +"ん。 １つのマッピングファイル内で順番付けを行うときは、 依然として、サブクラ" +"スを定義する前にスーパークラスを定義する必要があります。)" -#: index.docbook:70 +#. Tag: programlisting +#: inheritance_mapping.xml:70 +#, no-c-format msgid "" - "<![CDATA[\n" - " <hibernate-mapping>\n" - " <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-value=\"D\">\n" - " <property name=\"name\" type=\"string\"/>\n" - " </subclass>\n" - " </hibernate-mapping>]]>" +"<![CDATA[\n" +" <hibernate-mapping>\n" +" <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-value=\"D" +"\">\n" +" <property name=\"name\" type=\"string\"/>\n" +" </subclass>\n" +" </hibernate-mapping>]]>" msgstr "" - "<![CDATA[\n" - " <hibernate-mapping>\n" - " <subclass name=\"DomesticCat\" extends=\"Cat\" discriminator-value=\"D\">\n" - " <property name=\"name\" type=\"string\"/>\n" - " </subclass>\n" - " </hibernate-mapping>]]>" -#: index.docbook:74 +#. Tag: title +#: inheritance_mapping.xml:74 +#, no-c-format msgid "Table per class hierarchy" -msgstr "<title>クラス階層ごとのテーブル（table-per-class-hierarchy）</title>" +msgstr "クラス階層ごとのテーブル（table-per-class-hierarchy）" -#: index.docbook:76 -msgid "Suppose we have an interface <literal>Payment</literal>, with implementors <literal>CreditCardPayment</literal>, <literal>CashPayment</literal>, <literal>ChequePayment</literal>. The table per hierarchy mapping would look like:" -msgstr "例えば、インターフェイス <literal>Payment</literal> と、それを実装した <literal>CreditCardPayment</literal>、<literal>CashPayment</literal>、 <literal>ChequePayment</literal> があるとします。階層ごとのテーブルマッピングは 以下のようになります。" +#. Tag: para +#: inheritance_mapping.xml:76 +#, no-c-format +msgid "" +"Suppose we have an interface <literal>Payment</literal>, with implementors " +"<literal>CreditCardPayment</literal>, <literal>CashPayment</literal>, " +"<literal>ChequePayment</literal>. The table per hierarchy mapping would look " +"like:" +msgstr "" +"例えば、インターフェイス <literal>Payment</literal> と、それを実装した " +"<literal>CreditCardPayment</literal>、<literal>CashPayment</literal>、 " +"<literal>ChequePayment</literal> があるとします。階層ごとのテーブルマッピング" +"は 以下のようになります。" -#: index.docbook:83 +#. Tag: programlisting +#: inheritance_mapping.xml:83 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </subclass>\n" +" <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +" ...\n" +" </subclass>\n" +" <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +" ...\n" +" </subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" -#: index.docbook:85 -msgid "Exactly one table is required. There is one big limitation of this mapping strategy: columns declared by the subclasses, such as <literal>CCTYPE</literal>, may not have <literal>NOT NULL</literal> constraints." -msgstr "ちょうど一つのテーブルが必要です。 このマッピング戦略には一つ大きな制限があります。 <literal>CCTYPE</literal> のような、サブクラスで宣言されたカラムは <literal>NOT NULL</literal> 制約を持てません。" +#. Tag: para +#: inheritance_mapping.xml:85 +#, no-c-format +msgid "" +"Exactly one table is required. There is one big limitation of this mapping " +"strategy: columns declared by the subclasses, such as <literal>CCTYPE</" +"literal>, may not have <literal>NOT NULL</literal> constraints." +msgstr "" +"ちょうど一つのテーブルが必要です。 このマッピング戦略には一つ大きな制限があり" +"ます。 <literal>CCTYPE</literal> のような、サブクラスで宣言されたカラムは " +"<literal>NOT NULL</literal> 制約を持てません。" -#: index.docbook:94 +#. Tag: title +#: inheritance_mapping.xml:94 +#, no-c-format msgid "Table per subclass" -msgstr "<title>サブクラスごとのテーブル（table-per-subclass）</title>" +msgstr "サブクラスごとのテーブル（table-per-subclass）" -#: index.docbook:96 +#. Tag: para +#: inheritance_mapping.xml:96 +#, no-c-format msgid "A table per subclass mapping would look like:" msgstr "table-per-subclass マッピングは以下のようになります。" -#: index.docbook:100 +#. Tag: programlisting +#: inheritance_mapping.xml:100 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </joined-subclass>\n" +" <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </joined-subclass>\n" +" <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </joined-subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <joined-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" -#: index.docbook:102 -msgid "Four tables are required. The three subclass tables have primary key associations to the superclass table (so the relational model is actually a one-to-one association)." -msgstr "このマッピングには4つのテーブルが必要です。3つのサブクラステーブルは スーパークラステーブルとの関連を示す主キーを持っています （実際、関係モデル上は一対一関連です）。" +#. Tag: para +#: inheritance_mapping.xml:102 +#, no-c-format +msgid "" +"Four tables are required. The three subclass tables have primary key " +"associations to the superclass table (so the relational model is actually a " +"one-to-one association)." +msgstr "" +"このマッピングには4つのテーブルが必要です。3つのサブクラステーブルは スーパー" +"クラステーブルとの関連を示す主キーを持っています （実際、関係モデル上は一対一" +"関連です）。" -#: index.docbook:111 +#. Tag: title +#: inheritance_mapping.xml:111 +#, no-c-format msgid "Table per subclass, using a discriminator" msgstr "弁別子を用いた table-per-subclass" -#: index.docbook:113 -msgid "Note that Hibernate's implementation of table per subclass requires no discriminator column. Other object/relational mappers use a different implementation of table per subclass which requires a type discriminator column in the superclass table. The approach taken by Hibernate is much more difficult to implement but arguably more correct from a relational point of view. If you would like to use a discriminator column with the table per subclass strategy, you may combine the use of <literal>&lt;subclass&gt;</literal> and <literal>&lt;join&gt;</literal>, as follow:" -msgstr "Hibernateの table-per-subclass 実装は、discriminatorカラムを必要としないことを覚えておいてください。 Hibernate以外のO/Rマッパーは、table-per-subclass に異なる実装を用います。 それは、スーパークラスのテーブルにタイプdiscriminatorカラムを必要とします。 このアプローチは実装が困難になりますが、関係の視点から見ると、より正確なものです。 table-per-subclass 戦略でdiscriminatorカラムを使いたければ、 <literal>&lt;subclass&gt;</literal> と <literal>&lt;join&gt;</literal> を以下のように組み合わせて使ってください。" +#. Tag: para +#: inheritance_mapping.xml:113 +#, no-c-format +msgid "" +"Note that Hibernate's implementation of table per subclass requires no " +"discriminator column. Other object/relational mappers use a different " +"implementation of table per subclass which requires a type discriminator " +"column in the superclass table. The approach taken by Hibernate is much more " +"difficult to implement but arguably more correct from a relational point of " +"view. If you would like to use a discriminator column with the table per " +"subclass strategy, you may combine the use of <literal>&lt;subclass&gt;</" +"literal> and <literal>&lt;join&gt;</literal>, as follow:" +msgstr "" +"Hibernateの table-per-subclass 実装は、discriminatorカラムを必要としないこと" +"を覚えておいてください。 Hibernate以外のO/Rマッパーは、table-per-subclass に" +"異なる実装を用います。 それは、スーパークラスのテーブルにタイプdiscriminator" +"カラムを必要とします。 このアプローチは実装が困難になりますが、関係の視点から" +"見ると、より正確なものです。 table-per-subclass 戦略でdiscriminatorカラムを使" +"いたければ、 <literal>&lt;subclass&gt;</literal> と <literal>&lt;join&gt;</" +"literal> を以下のように組み合わせて使ってください。" -#: index.docbook:125 +#. Tag: programlisting +#: inheritance_mapping.xml:125 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " <join table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +" <join table=\"CREDIT_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +" <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +" <join table=\"CASH_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +" <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +" <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " <join table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " <join table=\"CHEQUE_PAYMENT\" fetch=\"select\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - "</class>]]>" -#: index.docbook:127 -msgid "The optional <literal>fetch=\"select\"</literal> declaration tells Hibernate not to fetch the <literal>ChequePayment</literal> subclass data using an outer join when querying the superclass." -msgstr "オプションの <literal>fetch=\"select\"</literal> 宣言は、 スーパークラスのクエリ実行時に外部結合を使って、 サブクラスの <literal>ChequePayment</literal> データを取得しないように指定するためのものです。" +#. Tag: para +#: inheritance_mapping.xml:127 +#, no-c-format +msgid "" +"The optional <literal>fetch=\"select\"</literal> declaration tells Hibernate " +"not to fetch the <literal>ChequePayment</literal> subclass data using an " +"outer join when querying the superclass." +msgstr "" +"オプションの <literal>fetch=\"select\"</literal> 宣言は、 スーパークラスのク" +"エリ実行時に外部結合を使って、 サブクラスの <literal>ChequePayment</literal> " +"データを取得しないように指定するためのものです。" -#: index.docbook:136 +#. Tag: title +#: inheritance_mapping.xml:136 +#, no-c-format msgid "Mixing table per class hierarchy with table per subclass" msgstr "table-per-subclass と table-per-class-hierarchy の混合" -#: index.docbook:138 -msgid "You may even mix the table per hierarchy and table per subclass strategies using this approach:" -msgstr "このアプローチを使用すると、table-per-hierarchy と table-per-subclass 戦略を 組み合わせる事も可能です。" +#. Tag: para +#: inheritance_mapping.xml:138 +#, no-c-format +msgid "" +"You may even mix the table per hierarchy and table per subclass strategies " +"using this approach:" +msgstr "" +"このアプローチを使用すると、table-per-hierarchy と table-per-subclass 戦略を " +"組み合わせる事も可能です。" -#: index.docbook:143 +#. Tag: programlisting +#: inheritance_mapping.xml:143 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" +" <join table=\"CREDIT_PAYMENT\">\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </join>\n" +" </subclass>\n" +" <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" +" ...\n" +" </subclass>\n" +" <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" +" ...\n" +" </subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Payment\" table=\"PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"PAYMENT_TYPE\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"CreditCardPayment\" discriminator-value=\"CREDIT\">\n" - " <join table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </join>\n" - " </subclass>\n" - " <subclass name=\"CashPayment\" discriminator-value=\"CASH\">\n" - " ...\n" - " </subclass>\n" - " <subclass name=\"ChequePayment\" discriminator-value=\"CHEQUE\">\n" - " ...\n" - " </subclass>\n" - "</class>]]>" -#: index.docbook:145 -msgid "For any of these mapping strategies, a polymorphic association to the root <literal>Payment</literal> class is mapped using <literal>&lt;many-to-one&gt;</literal>." -msgstr "いずれのマッピング戦略であっても、ルートである <literal>Payment</literal> クラスへの ポリモーフィックな関連は <literal>&lt;many-to-one&gt;</literal> を使ってマッピングします。" +#. Tag: para +#: inheritance_mapping.xml:145 +#, no-c-format +msgid "" +"For any of these mapping strategies, a polymorphic association to the root " +"<literal>Payment</literal> class is mapped using <literal>&lt;many-to-one&gt;" +"</literal>." +msgstr "" +"いずれのマッピング戦略であっても、ルートである <literal>Payment</literal> ク" +"ラスへの ポリモーフィックな関連は <literal>&lt;many-to-one&gt;</literal> を" +"使ってマッピングします。" -#: index.docbook:151 -msgid "<![CDATA[<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=\"Payment\"/>]]>" -msgstr "<![CDATA[<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=\"Payment\"/>]]>" +#. Tag: programlisting +#: inheritance_mapping.xml:151 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"payment\" column=\"PAYMENT_ID\" class=\"Payment" +"\"/>]]>" +msgstr "" -#: index.docbook:156 +#. Tag: title +#: inheritance_mapping.xml:156 +#, no-c-format msgid "Table per concrete class" -msgstr "<title>具象クラスごとのテーブル（table-per-concrete-class）</title>" +msgstr "具象クラスごとのテーブル（table-per-concrete-class）" -#: index.docbook:158 -msgid "There are two ways we could go about mapping the table per concrete class strategy. The first is to use <literal>&lt;union-subclass&gt;</literal>." -msgstr "table-per-concrete-class 戦略のマッピングに対するアプローチは、2つあります。 1つ目は <literal>&lt;union-subclass&gt;</literal> を利用する方法です。" +#. Tag: para +#: inheritance_mapping.xml:158 +#, no-c-format +msgid "" +"There are two ways we could go about mapping the table per concrete class " +"strategy. The first is to use <literal>&lt;union-subclass&gt;</literal>." +msgstr "" +"table-per-concrete-class 戦略のマッピングに対するアプローチは、2つあります。 " +"1つ目は <literal>&lt;union-subclass&gt;</literal> を利用する方法です。" -#: index.docbook:163 +#. Tag: programlisting +#: inheritance_mapping.xml:163 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Payment\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Payment\">\n" +" <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"AMOUNT\"/>\n" +" ...\n" +" <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" +" ...\n" +" </union-subclass>\n" +" <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" ...\n" +" </union-subclass>\n" +" <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" ...\n" +" </union-subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Payment\">\n" - " <id name=\"id\" type=\"long\" column=\"PAYMENT_ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"AMOUNT\"/>\n" - " ...\n" - " <union-subclass name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <property name=\"creditCardType\" column=\"CCTYPE\"/>\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - " <union-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " ...\n" - " </union-subclass>\n" - "</class>]]>" -#: index.docbook:165 -msgid "Three tables are involved for the subclasses. Each table defines columns for all properties of the class, including inherited properties." -msgstr "サブクラスごとに3つのテーブルが必要です。それぞれのテーブルは、継承プロパティを含んだ、 クラスの全てのプロパティに対するカラムを定義します。" +#. Tag: para +#: inheritance_mapping.xml:165 +#, no-c-format +msgid "" +"Three tables are involved for the subclasses. Each table defines columns for " +"all properties of the class, including inherited properties." +msgstr "" +"サブクラスごとに3つのテーブルが必要です。それぞれのテーブルは、継承プロパティ" +"を含んだ、 クラスの全てのプロパティに対するカラムを定義します。" -#: index.docbook:170 -msgid "The limitation of this approach is that if a property is mapped on the superclass, the column name must be the same on all subclass tables. (We might relax this in a future release of Hibernate.) The identity generator strategy is not allowed in union subclass inheritance, indeed the primary key seed has to be shared accross all unioned subclasses of a hierarchy." -msgstr "このアプローチには制限があります。 それは、プロパティがスーパークラスにマッピングされていた場合、 全てのサブクラスにおいてカラム名が同じでなければならないというものです。 （Hibernateの今後のリリースで緩和されるかもしれません）。 &lt;union-subclass&gt; を使った table-per-concrete-class 戦略では識別子生成戦略を使用できません。 主キーを生成するためのシードは、全ての union subclass の階層内で共有する必要があるからです。" +#. Tag: para +#: inheritance_mapping.xml:170 +#, no-c-format +msgid "" +"The limitation of this approach is that if a property is mapped on the " +"superclass, the column name must be the same on all subclass tables. (We " +"might relax this in a future release of Hibernate.) The identity generator " +"strategy is not allowed in union subclass inheritance, indeed the primary " +"key seed has to be shared accross all unioned subclasses of a hierarchy." +msgstr "" +"このアプローチには制限があります。 それは、プロパティがスーパークラスにマッピ" +"ングされていた場合、 全てのサブクラスにおいてカラム名が同じでなければならない" +"というものです。 （Hibernateの今後のリリースで緩和されるかもしれません）。 " +"&lt;union-subclass&gt; を使った table-per-concrete-class 戦略では識別子生成戦" +"略を使用できません。 主キーを生成するためのシードは、全ての union subclass の" +"階層内で共有する必要があるからです。" -#: index.docbook:179 -msgid "If your superclass is abstract, map it with <literal>abstract=\"true\"</literal>. Of course, if it is not abstract, an additional table (defaults to <literal>PAYMENT</literal> in the example above) is needed to hold instances of the superclass." -msgstr "もしスーパークラスが抽象クラスなら、<literal>abstract=\"true\"</literal>とマッピングします。 もちろん、スーパークラスが抽象クラスでないなら、スーパークラスのインスタンスを 保持するためのテーブルの追加が必要となります(上の例でのデフォルトは <literal>PAYMENT</literal> )。" +#. Tag: para +#: inheritance_mapping.xml:179 +#, no-c-format +msgid "" +"If your superclass is abstract, map it with <literal>abstract=\"true\"</" +"literal>. Of course, if it is not abstract, an additional table (defaults to " +"<literal>PAYMENT</literal> in the example above) is needed to hold instances " +"of the superclass." +msgstr "" +"もしスーパークラスが抽象クラスなら、<literal>abstract=\"true\"</literal>と" +"マッピングします。 もちろん、スーパークラスが抽象クラスでないなら、スーパーク" +"ラスのインスタンスを 保持するためのテーブルの追加が必要となります(上の例での" +"デフォルトは <literal>PAYMENT</literal> )。" -#: index.docbook:189 +#. Tag: title +#: inheritance_mapping.xml:189 +#, no-c-format msgid "Table per concrete class, using implicit polymorphism" msgstr "暗黙的ポリモーフィズムを用いた table-per-concrete-class" -#: index.docbook:191 +#. Tag: para +#: inheritance_mapping.xml:191 +#, no-c-format msgid "An alternative approach is to make use of implicit polymorphism:" msgstr "もう一つのアプローチは暗黙的ポリモーフィズムの使用です。" -#: index.docbook:195 +#. Tag: programlisting +#: inheritance_mapping.xml:195 +#, no-c-format msgid "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - "</class>]]>" +"<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +" ...\n" +"</class>\n" +"\n" +"<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +" ...\n" +"</class>\n" +"\n" +"<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +" ...\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CASH_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - "</class>\n" - "\n" - "<class name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CHEQUE_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - "</class>]]>" -#: index.docbook:197 -msgid "Notice that nowhere do we mention the <literal>Payment</literal> interface explicitly. Also notice that properties of <literal>Payment</literal> are mapped in each of the subclasses. If you want to avoid duplication, consider using XML entities (e.g. <literal>[ &lt;!ENTITY allproperties SYSTEM \"allproperties.xml\"&gt; ]</literal> in the <literal>DOCTYPE</literal> declartion and <literal>&amp;allproperties;</literal> in the mapping)." -msgstr "<literal>Payment</literal> インターフェイスがどこにも明示的に示されていないことに注意してください。 そして、<literal>Payment</literal> プロパティがそれぞれのサブクラスにマッピングされていることにも注意してください。 もし重複を避けたいのであれば、XMLエンティティの利用を考えてください。 （例： <literal>DOCTYPE</literal> 宣言における <literal>[ &lt;!ENTITY allproperties SYSTEM \"allproperties.xml\"&gt; ]</literal> と、マッピングにおける <literal>&amp;allproperties;</literal>）" +#. Tag: para +#: inheritance_mapping.xml:197 +#, no-c-format +msgid "" +"Notice that nowhere do we mention the <literal>Payment</literal> interface " +"explicitly. Also notice that properties of <literal>Payment</literal> are " +"mapped in each of the subclasses. If you want to avoid duplication, consider " +"using XML entities (e.g. <literal>[ &lt;!ENTITY allproperties SYSTEM " +"\"allproperties.xml\"&gt; ]</literal> in the <literal>DOCTYPE</literal> " +"declartion and <literal>&amp;allproperties;</literal> in the mapping)." +msgstr "" +"<literal>Payment</literal> インターフェイスがどこにも明示的に示されていないこ" +"とに注意してください。 そして、<literal>Payment</literal> プロパティがそれぞ" +"れのサブクラスにマッピングされていることにも注意してください。 もし重複を避け" +"たいのであれば、XMLエンティティの利用を考えてください。 （例： " +"<literal>DOCTYPE</literal> 宣言における <literal>[ &lt;!ENTITY allproperties " +"SYSTEM \"allproperties.xml\"&gt; ]</literal> と、マッピングにおける " +"<literal>&amp;allproperties;</literal>）" -#: index.docbook:207 -msgid "The disadvantage of this approach is that Hibernate does not generate SQL <literal>UNION</literal>s when performing polymorphic queries." -msgstr "このアプローチの欠点は、Hibernateがポリモーフィックなクエリの実行時にSQL <literal>UNION</literal> を生成しない点です。" +#. Tag: para +#: inheritance_mapping.xml:207 +#, no-c-format +msgid "" +"The disadvantage of this approach is that Hibernate does not generate SQL " +"<literal>UNION</literal>s when performing polymorphic queries." +msgstr "" +"このアプローチの欠点は、Hibernateがポリモーフィックなクエリの実行時にSQL " +"<literal>UNION</literal> を生成しない点です。" -#: index.docbook:212 -msgid "For this mapping strategy, a polymorphic association to <literal>Payment</literal> is usually mapped using <literal>&lt;any&gt;</literal>." -msgstr "このマッピング戦略に対しては、<literal>Payment</literal> へのポリモーフィックな関連は 通常、<literal>&lt;any&gt;</literal> を使ってマッピングされます。" +#. Tag: para +#: inheritance_mapping.xml:212 +#, no-c-format +msgid "" +"For this mapping strategy, a polymorphic association to <literal>Payment</" +"literal> is usually mapped using <literal>&lt;any&gt;</literal>." +msgstr "" +"このマッピング戦略に対しては、<literal>Payment</literal> へのポリモーフィック" +"な関連は 通常、<literal>&lt;any&gt;</literal> を使ってマッピングされます。" -#: index.docbook:217 +#. Tag: programlisting +#: inheritance_mapping.xml:217 +#, no-c-format msgid "" - "<![CDATA[<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" - " <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" - " <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" - " <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" - " <column name=\"PAYMENT_CLASS\"/>\n" - " <column name=\"PAYMENT_ID\"/>\n" - "</any>]]>" +"<![CDATA[<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" +" <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" +" <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" +" <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" +" <column name=\"PAYMENT_CLASS\"/>\n" +" <column name=\"PAYMENT_ID\"/>\n" +"</any>]]>" msgstr "" - "<![CDATA[<any name=\"payment\" meta-type=\"string\" id-type=\"long\">\n" - " <meta-value value=\"CREDIT\" class=\"CreditCardPayment\"/>\n" - " <meta-value value=\"CASH\" class=\"CashPayment\"/>\n" - " <meta-value value=\"CHEQUE\" class=\"ChequePayment\"/>\n" - " <column name=\"PAYMENT_CLASS\"/>\n" - " <column name=\"PAYMENT_ID\"/>\n" - "</any>]]>" -#: index.docbook:222 +#. Tag: title +#: inheritance_mapping.xml:222 +#, no-c-format msgid "Mixing implicit polymorphism with other inheritance mappings" msgstr "他の継承マッピングと暗黙的ポリモーフィズムの組み合わせ" -#: index.docbook:224 -msgid "There is one further thing to notice about this mapping. Since the subclasses are each mapped in their own <literal>&lt;class&gt;</literal> element (and since <literal>Payment</literal> is just an interface), each of the subclasses could easily be part of another inheritance hierarchy! (And you can still use polymorphic queries against the <literal>Payment</literal> interface.)" -msgstr "このマッピングについての更なる注意点があります。 サブクラスが自身を <literal>&lt;class&gt;</literal> 要素としてマッピングしているので、 （かつ <literal>Payment</literal> は単なるインターフェイスなので）、 それぞれのサブクラスは簡単にその他の継承階層の一部となります。 （しかも、今までどおり <literal>Payment</literal> インターフェイスに対するポリモーフィックなクエリ を使用することができます）" +#. Tag: para +#: inheritance_mapping.xml:224 +#, no-c-format +msgid "" +"There is one further thing to notice about this mapping. Since the " +"subclasses are each mapped in their own <literal>&lt;class&gt;</literal> " +"element (and since <literal>Payment</literal> is just an interface), each of " +"the subclasses could easily be part of another inheritance hierarchy! (And " +"you can still use polymorphic queries against the <literal>Payment</literal> " +"interface.)" +msgstr "" +"このマッピングについての更なる注意点があります。 サブクラスが自身を " +"<literal>&lt;class&gt;</literal> 要素としてマッピングしているので、 （かつ " +"<literal>Payment</literal> は単なるインターフェイスなので）、 それぞれのサブ" +"クラスは簡単にその他の継承階層の一部となります。 （しかも、今までどおり " +"<literal>Payment</literal> インターフェイスに対するポリモーフィックなクエリ " +"を使用することができます）" -#: index.docbook:232 +#. Tag: programlisting +#: inheritance_mapping.xml:232 +#, no-c-format msgid "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/>\n" - " <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" - "</class>\n" - "\n" - "<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN\">\n" - " <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " ...\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" +" <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" +" <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" +" ...\n" +" <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/>\n" +" <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" +"</class>\n" +"\n" +"<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN\">\n" +" <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" ...\n" +" <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" +" ...\n" +" </joined-subclass>\n" +" <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" +" <key column=\"PAYMENT_ID\"/>\n" +" <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" +" ...\n" +" </joined-subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"CreditCardPayment\" table=\"CREDIT_PAYMENT\">\n" - " <id name=\"id\" type=\"long\" column=\"CREDIT_PAYMENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <discriminator column=\"CREDIT_CARD\" type=\"string\"/>\n" - " <property name=\"amount\" column=\"CREDIT_AMOUNT\"/>\n" - " ...\n" - " <subclass name=\"MasterCardPayment\" discriminator-value=\"MDC\"/>\n" - " <subclass name=\"VisaPayment\" discriminator-value=\"VISA\"/>\n" - "</class>\n" - "\n" - "<class name=\"NonelectronicTransaction\" table=\"NONELECTRONIC_TXN\">\n" - " <id name=\"id\" type=\"long\" column=\"TXN_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " ...\n" - " <joined-subclass name=\"CashPayment\" table=\"CASH_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CASH_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - " <joined-subclass name=\"ChequePayment\" table=\"CHEQUE_PAYMENT\">\n" - " <key column=\"PAYMENT_ID\"/>\n" - " <property name=\"amount\" column=\"CHEQUE_AMOUNT\"/>\n" - " ...\n" - " </joined-subclass>\n" - "</class>]]>" -#: index.docbook:234 -msgid "Once again, we don't mention <literal>Payment</literal> explicitly. If we execute a query against the <literal>Payment</literal> interface - for example, <literal>from Payment</literal> - Hibernate automatically returns instances of <literal>CreditCardPayment</literal> (and its subclasses, since they also implement <literal>Payment</literal>), <literal>CashPayment</literal> and <literal>ChequePayment</literal> but not instances of <literal>NonelectronicTransaction</literal>." -msgstr "もう一度述べますが、<literal>Payment</literal> は明示的に定義されません。 もし、<literal>Payment</literal> インターフェイスに対してクエリを実行するなら （例えば <literal>from Payment</literal> 節を使って）、 Hibernateは自動的に <literal>CreditCardPayment</literal> （とCreditCardPaymentのサブクラス、<literal>Payment</literal> の実装であるため）、 および、<literal>CashPayment</literal> 、<literal>ChequePayment</literal> のインスタンスを返します。 <literal>NonelectronicTransaction</literal> インスタンスは返しません。" +#. Tag: para +#: inheritance_mapping.xml:234 +#, no-c-format +msgid "" +"Once again, we don't mention <literal>Payment</literal> explicitly. If we " +"execute a query against the <literal>Payment</literal> interface - for " +"example, <literal>from Payment</literal> - Hibernate automatically returns " +"instances of <literal>CreditCardPayment</literal> (and its subclasses, since " +"they also implement <literal>Payment</literal>), <literal>CashPayment</" +"literal> and <literal>ChequePayment</literal> but not instances of " +"<literal>NonelectronicTransaction</literal>." +msgstr "" +"もう一度述べますが、<literal>Payment</literal> は明示的に定義されません。 も" +"し、<literal>Payment</literal> インターフェイスに対してクエリを実行するなら " +"（例えば <literal>from Payment</literal> 節を使って）、 Hibernateは自動的に " +"<literal>CreditCardPayment</literal> （とCreditCardPaymentのサブクラス、" +"<literal>Payment</literal> の実装であるため）、 および、" +"<literal>CashPayment</literal> 、<literal>ChequePayment</literal> のインスタ" +"ンスを返します。 <literal>NonelectronicTransaction</literal> インスタンスは返" +"しません。" -#: index.docbook:249 +#. Tag: title +#: inheritance_mapping.xml:249 +#, no-c-format msgid "Limitations" -msgstr "<title>制限</title>" +msgstr "制限" -#: index.docbook:251 -msgid "There are certain limitations to the \"implicit polymorphism\" approach to the table per concrete-class mapping strategy. There are somewhat less restrictive limitations to <literal>&lt;union-subclass&gt;</literal> mappings." -msgstr "table-per-concrete-class マッピング戦略への「暗黙的ポリモーフィズム」アプローチには いくつかの制限があります。<literal>&lt;union-subclass&gt;</literal> マッピングに対しても 少し弱めの制限があります。" +#. Tag: para +#: inheritance_mapping.xml:251 +#, no-c-format +msgid "" +"There are certain limitations to the \"implicit polymorphism\" approach to " +"the table per concrete-class mapping strategy. There are somewhat less " +"restrictive limitations to <literal>&lt;union-subclass&gt;</literal> " +"mappings." +msgstr "" +"table-per-concrete-class マッピング戦略への「暗黙的ポリモーフィズム」アプロー" +"チには いくつかの制限があります。<literal>&lt;union-subclass&gt;</literal> " +"マッピングに対しても 少し弱めの制限があります。" -#: index.docbook:258 -msgid "The following table shows the limitations of table per concrete-class mappings, and of implicit polymorphism, in Hibernate." -msgstr "次のテーブルに、Hibernateにおけるtable-per-concrete-classマッピングの 制限や暗黙的ポリモーフィズムの制限を示します。" +#. Tag: para +#: inheritance_mapping.xml:258 +#, no-c-format +msgid "" +"The following table shows the limitations of table per concrete-class " +"mappings, and of implicit polymorphism, in Hibernate." +msgstr "" +"次のテーブルに、Hibernateにおけるtable-per-concrete-classマッピングの 制限や" +"暗黙的ポリモーフィズムの制限を示します。" -#: index.docbook:264 +#. Tag: title +#: inheritance_mapping.xml:264 +#, no-c-format msgid "Features of inheritance mappings" msgstr "継承マッピングの機能" -#: index.docbook:276 +#. Tag: entry +#: inheritance_mapping.xml:276 +#, no-c-format msgid "Inheritance strategy" msgstr "継承戦略" -#: index.docbook:277 +#. Tag: entry +#: inheritance_mapping.xml:277 +#, no-c-format msgid "Polymorphic many-to-one" msgstr "多対一のポリモーフィズム" -#: index.docbook:278 +#. Tag: entry +#: inheritance_mapping.xml:278 +#, no-c-format msgid "Polymorphic one-to-one" msgstr "一対一のポリモーフィズム" -#: index.docbook:279 +#. Tag: entry +#: inheritance_mapping.xml:279 +#, no-c-format msgid "Polymorphic one-to-many" msgstr "一対多のポリモーフィズム" -#: index.docbook:280 +#. Tag: entry +#: inheritance_mapping.xml:280 +#, no-c-format msgid "Polymorphic many-to-many" msgstr "多対多のポリモーフィズム" -#: index.docbook:281 +#. Tag: entry +#: inheritance_mapping.xml:281 +#, no-c-format msgid "Polymorphic <literal>load()/get()</literal>" -msgstr "ポリモーフィズムを使った<literal>load()/get()</literal>" +msgstr "" -#: index.docbook:282 +#. Tag: entry +#: inheritance_mapping.xml:282 +#, no-c-format msgid "Polymorphic queries" msgstr "ポリモーフィズムを使ったクエリ" -#: index.docbook:283 +#. Tag: entry +#: inheritance_mapping.xml:283 +#, no-c-format msgid "Polymorphic joins" msgstr "ポリモーフィズムを使った結合" -#: index.docbook:284 +#. Tag: entry +#: inheritance_mapping.xml:284 +#, no-c-format msgid "Outer join fetching" msgstr "外部結合によるフェッチ" -#: index.docbook:289 +#. Tag: entry +#: inheritance_mapping.xml:289 +#, no-c-format msgid "table per class-hierarchy" msgstr "table per class-hierarchy" -#: index.docbook:290, index.docbook:301, index.docbook:312 +#. Tag: literal +#: inheritance_mapping.xml:290 inheritance_mapping.xml:301 +#: inheritance_mapping.xml:312 +#, no-c-format msgid "&lt;many-to-one&gt;" msgstr "&lt;many-to-one&gt;" -#: index.docbook:291, index.docbook:302, index.docbook:313 +#. Tag: literal +#: inheritance_mapping.xml:291 inheritance_mapping.xml:302 +#: inheritance_mapping.xml:313 +#, no-c-format msgid "&lt;one-to-one&gt;" msgstr "&lt;one-to-one&gt;" -#: index.docbook:292, index.docbook:303 +#. Tag: literal +#: inheritance_mapping.xml:292 inheritance_mapping.xml:303 +#, no-c-format msgid "&lt;one-to-many&gt;" msgstr "&lt;one-to-many&gt;" -#: index.docbook:293, index.docbook:304, index.docbook:315 +#. Tag: literal +#: inheritance_mapping.xml:293 inheritance_mapping.xml:304 +#: inheritance_mapping.xml:315 +#, no-c-format msgid "&lt;many-to-many&gt;" msgstr "&lt;many-to-many&gt;" -#: index.docbook:294, index.docbook:305, index.docbook:316 +#. Tag: literal +#: inheritance_mapping.xml:294 inheritance_mapping.xml:305 +#: inheritance_mapping.xml:316 +#, no-c-format msgid "s.get(Payment.class, id)" msgstr "s.get(Payment.class, id)" -#: index.docbook:295, index.docbook:306, index.docbook:317, index.docbook:328 +#. Tag: literal +#: inheritance_mapping.xml:295 inheritance_mapping.xml:306 +#: inheritance_mapping.xml:317 inheritance_mapping.xml:328 +#, no-c-format msgid "from Payment p" msgstr "from Payment p" -#: index.docbook:296, index.docbook:307, index.docbook:318 +#. Tag: literal +#: inheritance_mapping.xml:296 inheritance_mapping.xml:307 +#: inheritance_mapping.xml:318 +#, no-c-format msgid "from Order o join o.payment p" msgstr "from Order o join o.payment p" -#: index.docbook:297, index.docbook:308, index.docbook:319 +#. Tag: emphasis +#: inheritance_mapping.xml:297 inheritance_mapping.xml:308 +#: inheritance_mapping.xml:319 +#, no-c-format msgid "supported" msgstr "サポート" -#: index.docbook:300 +#. Tag: entry +#: inheritance_mapping.xml:300 +#, fuzzy, no-c-format msgid "<entry>table per subclass</entry>" -msgstr "table per subclass" +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"サブクラスごとのテーブル（table-per-subclass）\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"table per subclass" -#: index.docbook:311 +#. Tag: entry +#: inheritance_mapping.xml:311 +#, no-c-format msgid "table per concrete-class (union-subclass)" msgstr "table per concrete-class (union-subclass)" -#: index.docbook:314 -msgid "<literal>&lt;one-to-many&gt;</literal> (for <literal>inverse=\"true\"</literal> only)" -msgstr "<literal>&lt;one-to-many&gt;</literal> (for <literal>inverse=\"true\"</literal> only)" +#. Tag: entry +#: inheritance_mapping.xml:314 +#, no-c-format +msgid "" +"<literal>&lt;one-to-many&gt;</literal> (for <literal>inverse=\"true\"</" +"literal> only)" +msgstr "" -#: index.docbook:322 +#. Tag: entry +#: inheritance_mapping.xml:322 +#, no-c-format msgid "table per concrete class (implicit polymorphism)" msgstr "table per concrete class (implicit polymorphism)" -#: index.docbook:323 +#. Tag: literal +#: inheritance_mapping.xml:323 +#, no-c-format msgid "&lt;any&gt;" msgstr "&lt;any&gt;" -#: index.docbook:324, index.docbook:325, index.docbook:329, index.docbook:330 +#. Tag: emphasis +#: inheritance_mapping.xml:324 inheritance_mapping.xml:325 +#: inheritance_mapping.xml:329 inheritance_mapping.xml:330 +#, no-c-format msgid "not supported" msgstr "サポートしていません" -#: index.docbook:326 +#. Tag: literal +#: inheritance_mapping.xml:326 +#, no-c-format msgid "&lt;many-to-any&gt;" msgstr "&lt;many-to-any&gt;" -#: index.docbook:327 -msgid "s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" -msgstr "s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" +#. Tag: literal +#: inheritance_mapping.xml:327 +#, no-c-format +msgid "" +"s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" +msgstr "" +"s.createCriteria(Payment.class).add( Restrictions.idEq(id) ).uniqueResult()" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" +#~ msgid "load()/get()" +#~ msgstr "load()/get()" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" +#~ msgid "Polymorphic <placeholder-1/>" +#~ msgstr "ポリモーフィズムを使った<placeholder-1/>" +#~ msgid "inverse=\"true\"" +#~ msgstr "inverse=\"true\"" + +#~ msgid "<placeholder-1/> (for <placeholder-2/> only)" +#~ msgstr "<placeholder-1/> (for <placeholder-2/> only)" Modified: core/trunk/documentation/manual/translations/ja-JP/content/performance.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/performance.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/performance.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1348 +1,2553 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: performance.xml:5 +#, no-c-format msgid "Improving performance" msgstr "パフォーマンスの改善" -#: index.docbook:8 +#. Tag: title +#: performance.xml:8 +#, no-c-format msgid "Fetching strategies" msgstr "フェッチ戦略" -#: index.docbook:10 -msgid "A <emphasis>fetching strategy</emphasis> is the strategy Hibernate will use for retrieving associated objects if the application needs to navigate the association. Fetch strategies may be declared in the O/R mapping metadata, or over-ridden by a particular HQL or <literal>Criteria</literal> query." -msgstr "<emphasis>フェッチ戦略</emphasis> は、アプリケーションが関連をナビゲートする必要がある ときに、Hibernateが関連オブジェクトを復元するために使用する戦略です。フェッチ戦略はO/Rマッピングの メタデータに宣言するか、特定のHQL、 <literal>Criteria</literal> クエリでオーバーライドします。" +#. Tag: para +#: performance.xml:10 +#, no-c-format +msgid "" +"A <emphasis>fetching strategy</emphasis> is the strategy Hibernate will use " +"for retrieving associated objects if the application needs to navigate the " +"association. Fetch strategies may be declared in the O/R mapping metadata, " +"or over-ridden by a particular HQL or <literal>Criteria</literal> query." +msgstr "" +"<emphasis>フェッチ戦略</emphasis> は、アプリケーションが関連をナビゲートする" +"必要がある ときに、Hibernateが関連オブジェクトを復元するために使用する戦略で" +"す。フェッチ戦略はO/Rマッピングの メタデータに宣言するか、特定のHQL、 " +"<literal>Criteria</literal> クエリでオーバーライドします。" -#: index.docbook:17 +#. Tag: para +#: performance.xml:17 +#, no-c-format msgid "Hibernate3 defines the following fetching strategies:" msgstr "Hibernate3は次に示すフェッチ戦略を定義しています。" -#: index.docbook:23 -msgid "<emphasis>Join fetching</emphasis> - Hibernate retrieves the associated instance or collection in the same <literal>SELECT</literal>, using an <literal>OUTER JOIN</literal>." -msgstr "<emphasis>結合フェッチ</emphasis> - Hibernateは <literal>OUTER JOIN</literal> を使って、 関連するインスタンスやコレクションを１つの <literal>SELECT</literal> で復元します。" +#. Tag: para +#: performance.xml:23 +#, no-c-format +msgid "" +"<emphasis>Join fetching</emphasis> - Hibernate retrieves the associated " +"instance or collection in the same <literal>SELECT</literal>, using an " +"<literal>OUTER JOIN</literal>." +msgstr "" +"<emphasis>結合フェッチ</emphasis> - Hibernateは <literal>OUTER JOIN</" +"literal> を使って、 関連するインスタンスやコレクションを１つの " +"<literal>SELECT</literal> で復元します。" -#: index.docbook:30 -msgid "<emphasis>Select fetching</emphasis> - a second <literal>SELECT</literal> is used to retrieve the associated entity or collection. Unless you explicitly disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this second select will only be executed when you actually access the association." -msgstr "<emphasis>セレクトフェッチ</emphasis> - 2回目の <literal>SELECT</literal> で関連するエンティティやコレクションを復元します。 <literal>lazy=\"false\"</literal> で明示的に遅延フェッチを無効にしなければ、この2回目のselectは実際に 関連にアクセスしたときのみ実行されるでしょう。" +#. Tag: para +#: performance.xml:30 +#, no-c-format +msgid "" +"<emphasis>Select fetching</emphasis> - a second <literal>SELECT</literal> is " +"used to retrieve the associated entity or collection. Unless you explicitly " +"disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this " +"second select will only be executed when you actually access the association." +msgstr "" +"<emphasis>セレクトフェッチ</emphasis> - 2回目の <literal>SELECT</literal> で" +"関連するエンティティやコレクションを復元します。 <literal>lazy=\"false\"</" +"literal> で明示的に遅延フェッチを無効にしなければ、この2回目のselectは実際に " +"関連にアクセスしたときのみ実行されるでしょう。" -#: index.docbook:39 -msgid "<emphasis>Subselect fetching</emphasis> - a second <literal>SELECT</literal> is used to retrieve the associated collections for all entities retrieved in a previous query or fetch. Unless you explicitly disable lazy fetching by specifying <literal>lazy=\"false\"</literal>, this second select will only be executed when you actually access the association." -msgstr "<emphasis>サブセレクトフェッチ</emphasis> - 2回目の <literal>SELECT</literal> で、直前のクエリやフェッチで復元したすべての要素に関連するコレクションを 復元します。 <literal>lazy=\"false\"</literal> で明示的に遅延フェッチを無効にしなければ、この2回目のselectは実際に 関連にアクセスしたときのみ実行されるでしょう。" +#. Tag: para +#: performance.xml:39 +#, no-c-format +msgid "" +"<emphasis>Subselect fetching</emphasis> - a second <literal>SELECT</literal> " +"is used to retrieve the associated collections for all entities retrieved in " +"a previous query or fetch. Unless you explicitly disable lazy fetching by " +"specifying <literal>lazy=\"false\"</literal>, this second select will only " +"be executed when you actually access the association." +msgstr "" +"<emphasis>サブセレクトフェッチ</emphasis> - 2回目の <literal>SELECT</" +"literal> で、直前のクエリやフェッチで復元したすべての要素に関連するコレクショ" +"ンを 復元します。 <literal>lazy=\"false\"</literal> で明示的に遅延フェッチを" +"無効にしなければ、この2回目のselectは実際に 関連にアクセスしたときのみ実行さ" +"れるでしょう。" -#: index.docbook:48 -msgid "<emphasis>Batch fetching</emphasis> - an optimization strategy for select fetching - Hibernate retrieves a batch of entity instances or collections in a single <literal>SELECT</literal>, by specifying a list of primary keys or foreign keys." -msgstr "<emphasis>バッチフェッチ</emphasis> - セレクトフェッチのための最適化された戦略 - Hibernateはエンティティのインスタンスやコレクションの一群を1回の <literal>SELECT</literal> で復元します。これは主キーや外部キーのリストを指定することに により行います。" +#. Tag: para +#: performance.xml:48 +#, no-c-format +msgid "" +"<emphasis>Batch fetching</emphasis> - an optimization strategy for select " +"fetching - Hibernate retrieves a batch of entity instances or collections in " +"a single <literal>SELECT</literal>, by specifying a list of primary keys or " +"foreign keys." +msgstr "" +"<emphasis>バッチフェッチ</emphasis> - セレクトフェッチのための最適化された戦" +"略 - Hibernateはエンティティのインスタンスやコレクションの一群を1回の " +"<literal>SELECT</literal> で復元します。これは主キーや外部キーのリストを指定" +"することに により行います。" -#: index.docbook:57 +#. Tag: para +#: performance.xml:57 +#, no-c-format msgid "Hibernate also distinguishes between:" msgstr "Hibernateは次に示す戦略とも区別をします。" -#: index.docbook:63 -msgid "<emphasis>Immediate fetching</emphasis> - an association, collection or attribute is fetched immediately, when the owner is loaded." -msgstr "<emphasis>即時フェッチ</emphasis> - 所有者のオブジェクトがロードされたときに、 関連、コレクションは即時にフェッチされます。" +#. Tag: para +#: performance.xml:63 +#, no-c-format +msgid "" +"<emphasis>Immediate fetching</emphasis> - an association, collection or " +"attribute is fetched immediately, when the owner is loaded." +msgstr "" +"<emphasis>即時フェッチ</emphasis> - 所有者のオブジェクトがロードされたとき" +"に、 関連、コレクションは即時にフェッチされます。" -#: index.docbook:69 -msgid "<emphasis>Lazy collection fetching</emphasis> - a collection is fetched when the application invokes an operation upon that collection. (This is the default for collections.)" -msgstr "<emphasis>遅延コレクションフェッチ</emphasis> - アプリケーションがコレクションに 対して操作を行ったときにコレクションをフェッチします。 (これはコレクションに対するデフォルトの動作です)" +#. Tag: para +#: performance.xml:69 +#, no-c-format +msgid "" +"<emphasis>Lazy collection fetching</emphasis> - a collection is fetched when " +"the application invokes an operation upon that collection. (This is the " +"default for collections.)" +msgstr "" +"<emphasis>遅延コレクションフェッチ</emphasis> - アプリケーションがコレクショ" +"ンに 対して操作を行ったときにコレクションをフェッチします。 (これはコレクショ" +"ンに対するデフォルトの動作です)" -#: index.docbook:76 -msgid "<emphasis>\"Extra-lazy\" collection fetching</emphasis> - individual elements of the collection are accessed from the database as needed. Hibernate tries not to fetch the whole collection into memory unless absolutely needed (suitable for very large collections)" -msgstr "<emphasis>\"特別な遅延\"コレクションフェッチ</emphasis> - コレクションの要素 １つ１つが独立して、必要なときにデータベースから取得されます。 Hibernateは必要ないならば、コレクション全体をメモリにフェッチすることは 避けます（とても大きなコレクションに適しています）。" +#. Tag: para +#: performance.xml:76 +#, no-c-format +msgid "" +"<emphasis>\"Extra-lazy\" collection fetching</emphasis> - individual " +"elements of the collection are accessed from the database as needed. " +"Hibernate tries not to fetch the whole collection into memory unless " +"absolutely needed (suitable for very large collections)" +msgstr "" +"<emphasis>\"特別な遅延\"コレクションフェッチ</emphasis> - コレクションの要素 " +"１つ１つが独立して、必要なときにデータベースから取得されます。 Hibernateは必" +"要ないならば、コレクション全体をメモリにフェッチすることは 避けます（とても大" +"きなコレクションに適しています）。" -#: index.docbook:84 -msgid "<emphasis>Proxy fetching</emphasis> - a single-valued association is fetched when a method other than the identifier getter is invoked upon the associated object." -msgstr "<emphasis>プロキシフェッチ</emphasis> - 単一値関連は、識別子のgetter以外の メソッドが関連オブジェクトで呼び出されるときにフェッチされます。" +#. Tag: para +#: performance.xml:84 +#, no-c-format +msgid "" +"<emphasis>Proxy fetching</emphasis> - a single-valued association is fetched " +"when a method other than the identifier getter is invoked upon the " +"associated object." +msgstr "" +"<emphasis>プロキシフェッチ</emphasis> - 単一値関連は、識別子のgetter以外の メ" +"ソッドが関連オブジェクトで呼び出されるときにフェッチされます。" -#: index.docbook:91 -msgid "<emphasis>\"No-proxy\" fetching</emphasis> - a single-valued association is fetched when the instance variable is accessed. Compared to proxy fetching, this approach is less lazy (the association is fetched even when only the identifier is accessed) but more transparent, since no proxy is visible to the application. This approach requires buildtime bytecode instrumentation and is rarely necessary." -msgstr "<emphasis>\"プロキシなし\"フェッチ</emphasis> - 単一値関連は、インスタンス変数に アクセスされたときにフェッチされます。プロキシフェッチと比較すると、この方法は 遅延の度合いが少ない（関連は識別子にアクセスしただけでもフェッチされます） ですが、より透過的で、アプリケーションにプロキシが存在しないように見せます。 この方法はビルド時のバイトコード組み込みが必要になり、使う場面はまれです。" +#. Tag: para +#: performance.xml:91 +#, no-c-format +msgid "" +"<emphasis>\"No-proxy\" fetching</emphasis> - a single-valued association is " +"fetched when the instance variable is accessed. Compared to proxy fetching, " +"this approach is less lazy (the association is fetched even when only the " +"identifier is accessed) but more transparent, since no proxy is visible to " +"the application. This approach requires buildtime bytecode instrumentation " +"and is rarely necessary." +msgstr "" +"<emphasis>\"プロキシなし\"フェッチ</emphasis> - 単一値関連は、インスタンス変" +"数に アクセスされたときにフェッチされます。プロキシフェッチと比較すると、この" +"方法は 遅延の度合いが少ない（関連は識別子にアクセスしただけでもフェッチされま" +"す） ですが、より透過的で、アプリケーションにプロキシが存在しないように見せま" +"す。 この方法はビルド時のバイトコード組み込みが必要になり、使う場面はまれで" +"す。" -#: index.docbook:101 -msgid "<emphasis>Lazy attribute fetching</emphasis> - an attribute or single valued association is fetched when the instance variable is accessed. This approach requires buildtime bytecode instrumentation and is rarely necessary." -msgstr "<emphasis>遅延属性フェッチ</emphasis> - 属性や単一値関連は、インスタンス変数にアクセスした ときにフェッチされます。この方法はビルド時のバイトコード組み込みが必要になり、 使う場面はまれです。" +#. Tag: para +#: performance.xml:101 +#, no-c-format +msgid "" +"<emphasis>Lazy attribute fetching</emphasis> - an attribute or single valued " +"association is fetched when the instance variable is accessed. This approach " +"requires buildtime bytecode instrumentation and is rarely necessary." +msgstr "" +"<emphasis>遅延属性フェッチ</emphasis> - 属性や単一値関連は、インスタンス変数" +"にアクセスした ときにフェッチされます。この方法はビルド時のバイトコード組み込" +"みが必要になり、 使う場面はまれです。" -#: index.docbook:110 -msgid "We have two orthogonal notions here: <emphasis>when</emphasis> is the association fetched, and <emphasis>how</emphasis> is it fetched (what SQL is used). Don't confuse them! We use <literal>fetch</literal> to tune performance. We may use <literal>lazy</literal> to define a contract for what data is always available in any detached instance of a particular class." -msgstr "二つの直行する概念があります: <emphasis>いつ</emphasis> 関連をフェッチするか、 そして、 <emphasis>どうやって</emphasis> フェッチするか（どんなSQLを使って）。 これらを混同しないでください！ <literal>fetch</literal> はパフォーマンスチューニングに使います。 <literal>lazy</literal> はあるクラスの分離されたインスタンスのうち、どのデータを常に 使用可能にするかの取り決めを定義します。" +#. Tag: para +#: performance.xml:110 +#, no-c-format +msgid "" +"We have two orthogonal notions here: <emphasis>when</emphasis> is the " +"association fetched, and <emphasis>how</emphasis> is it fetched (what SQL is " +"used). Don't confuse them! We use <literal>fetch</literal> to tune " +"performance. We may use <literal>lazy</literal> to define a contract for " +"what data is always available in any detached instance of a particular class." +msgstr "" +"二つの直行する概念があります: <emphasis>いつ</emphasis> 関連をフェッチする" +"か、 そして、 <emphasis>どうやって</emphasis> フェッチするか（どんなSQLを使っ" +"て）。 これらを混同しないでください！ <literal>fetch</literal> はパフォーマン" +"スチューニングに使います。 <literal>lazy</literal> はあるクラスの分離されたイ" +"ンスタンスのうち、どのデータを常に 使用可能にするかの取り決めを定義します。" -#: index.docbook:119 +#. Tag: title +#: performance.xml:119 +#, no-c-format msgid "Working with lazy associations" msgstr "遅延関連の働き" -#: index.docbook:121 -msgid "By default, Hibernate3 uses lazy select fetching for collections and lazy proxy fetching for single-valued associations. These defaults make sense for almost all associations in almost all applications." -msgstr "デフォルトでは、Hibernate3はコレクションに対しては遅延セレクトフェッチを使い、 単一値関連には遅延プロキシフェッチを使います。これらのデフォルト動作はほぼすべての アプリケーションのほぼすべての関連で意味があります。" +#. Tag: para +#: performance.xml:121 +#, no-c-format +msgid "" +"By default, Hibernate3 uses lazy select fetching for collections and lazy " +"proxy fetching for single-valued associations. These defaults make sense for " +"almost all associations in almost all applications." +msgstr "" +"デフォルトでは、Hibernate3はコレクションに対しては遅延セレクトフェッチを使" +"い、 単一値関連には遅延プロキシフェッチを使います。これらのデフォルト動作はほ" +"ぼすべての アプリケーションのほぼすべての関連で意味があります。" -#: index.docbook:127 -msgid "<emphasis>Note:</emphasis> if you set <literal>hibernate.default_batch_fetch_size</literal>, Hibernate will use the batch fetch optimization for lazy fetching (this optimization may also be enabled at a more granular level)." -msgstr "<emphasis>注:</emphasis> <literal>hibernate.default_batch_fetch_size</literal> をセットしたときは、Hibernateは 遅延フェッチのためのバッチフェッチ最適化を使うでしょう （この最適化はより細かいレベルで有効にすることも出来ます）。" +#. Tag: para +#: performance.xml:127 +#, no-c-format +msgid "" +"<emphasis>Note:</emphasis> if you set <literal>hibernate." +"default_batch_fetch_size</literal>, Hibernate will use the batch fetch " +"optimization for lazy fetching (this optimization may also be enabled at a " +"more granular level)." +msgstr "" +"<emphasis>注:</emphasis><literal>hibernate.default_batch_fetch_size</" +"literal> をセットしたときは、Hibernateは 遅延フェッチのためのバッチフェッチ最" +"適化を使うでしょう （この最適化はより細かいレベルで有効にすることも出来ま" +"す）。" -#: index.docbook:134 -msgid "However, lazy fetching poses one problem that you must be aware of. Access to a lazy association outside of the context of an open Hibernate session will result in an exception. For example:" -msgstr "しかし、遅延フェッチは知っておかなければならない一つの問題があります。 Hibernateのsessionをオープンしているコンテキストの外から遅延関連にアクセスすると、 例外が発生します。例：" +#. Tag: para +#: performance.xml:134 +#, no-c-format +msgid "" +"However, lazy fetching poses one problem that you must be aware of. Access " +"to a lazy association outside of the context of an open Hibernate session " +"will result in an exception. For example:" +msgstr "" +"しかし、遅延フェッチは知っておかなければならない一つの問題があります。 " +"Hibernateのsessionをオープンしているコンテキストの外から遅延関連にアクセスす" +"ると、 例外が発生します。例：" -#: index.docbook:140 +#. Tag: programlisting +#: performance.xml:140 +#, no-c-format msgid "" - "<![CDATA[s = sessions.openSession();\n" - "Transaction tx = s.beginTransaction();\n" - " \n" - "User u = (User) s.createQuery(\"from User u where u.name=:userName\")\n" - " .setString(\"userName\", userName).uniqueResult();\n" - "Map permissions = u.getPermissions();\n" - "\n" - "tx.commit();\n" - "s.close();\n" - "\n" - "Integer accessLevel = (Integer) permissions.get(\"accounts\"); // Error!]]>" +"<![CDATA[s = sessions.openSession();\n" +"Transaction tx = s.beginTransaction();\n" +" \n" +"User u = (User) s.createQuery(\"from User u where u.name=:userName\")\n" +" .setString(\"userName\", userName).uniqueResult();\n" +"Map permissions = u.getPermissions();\n" +"\n" +"tx.commit();\n" +"s.close();\n" +"\n" +"Integer accessLevel = (Integer) permissions.get(\"accounts\"); // Error!]]>" msgstr "" - "<![CDATA[s = sessions.openSession(); -\n" - "Transaction tx = s.beginTransaction(); -\n" - " -\n" - "User u = (User) s.createQuery(\"from User u where u.name=:userName\") -\n" - " .setString(\"userName\", userName).uniqueResult(); -\n" - "Map permissions = u.getPermissions(); -\n" - " -\n" - "tx.commit(); -\n" - "s.close(); -\n" - " -\n" - "Integer accessLevel = (Integer) permissions.get(\"accounts\"); // Error!]]>" -#: index.docbook:142 -msgid "Since the permissions collection was not initialized when the <literal>Session</literal> was closed, the collection will not be able to load its state. <emphasis>Hibernate does not support lazy initialization for detached objects</emphasis>. The fix is to move the code that reads from the collection to just before the transaction is committed." -msgstr "<literal>Session</literal> がクローズされたとき、permissionsコレクションは 初期化されていないため、このコレクションは自身の状態をロードできません。 <emphasis>Hibernateは切り離されたオブジェクトの遅延初期化はサポート していません</emphasis> 。修正方法として、コレクションから読み込みを行うコードを トランザクションをコミットする直前に移動させます。" +#. Tag: para +#: performance.xml:142 +#, no-c-format +msgid "" +"Since the permissions collection was not initialized when the " +"<literal>Session</literal> was closed, the collection will not be able to " +"load its state. <emphasis>Hibernate does not support lazy initialization for " +"detached objects</emphasis>. The fix is to move the code that reads from the " +"collection to just before the transaction is committed." +msgstr "" +"<literal>Session</literal> がクローズされたとき、permissionsコレクションは 初" +"期化されていないため、このコレクションは自身の状態をロードできません。 " +"<emphasis>Hibernateは切り離されたオブジェクトの遅延初期化はサポート していま" +"せん</emphasis> 。修正方法として、コレクションから読み込みを行うコードを トラ" +"ンザクションをコミットする直前に移動させます。" -#: index.docbook:150 -msgid "Alternatively, we could use a non-lazy collection or association, by specifying <literal>lazy=\"false\"</literal> for the association mapping. However, it is intended that lazy initialization be used for almost all collections and associations. If you define too many non-lazy associations in your object model, Hibernate will end up needing to fetch the entire database into memory in every transaction!" -msgstr "一方で、 <literal>lazy=\"false\"</literal> を関連マッピングに指定することで、 遅延処理をしないコレクションや関連を使うことが出来ます。 しかしながら、遅延初期化はほぼすべてのコレクションや関連で使われることを 意図しています。もしあなたのオブジェクトモデルの中に遅延処理をしない関連を 多く定義してしまうと、Hibernateは最終的にはトランザクション毎に ほぼ完全なデータベースをメモリの中にフェッチすることになるでしょう！" +#. Tag: para +#: performance.xml:150 +#, no-c-format +msgid "" +"Alternatively, we could use a non-lazy collection or association, by " +"specifying <literal>lazy=\"false\"</literal> for the association mapping. " +"However, it is intended that lazy initialization be used for almost all " +"collections and associations. If you define too many non-lazy associations " +"in your object model, Hibernate will end up needing to fetch the entire " +"database into memory in every transaction!" +msgstr "" +"一方で、 <literal>lazy=\"false\"</literal> を関連マッピングに指定すること" +"で、 遅延処理をしないコレクションや関連を使うことが出来ます。 しかしながら、" +"遅延初期化はほぼすべてのコレクションや関連で使われることを 意図しています。も" +"しあなたのオブジェクトモデルの中に遅延処理をしない関連を 多く定義してしまう" +"と、Hibernateは最終的にはトランザクション毎に ほぼ完全なデータベースをメモリ" +"の中にフェッチすることになるでしょう！" -#: index.docbook:159 -msgid "On the other hand, we often want to choose join fetching (which is non-lazy by nature) instead of select fetching in a particular transaction. We'll now see how to customize the fetching strategy. In Hibernate3, the mechanisms for choosing a fetch strategy are identical for single-valued associations and collections." -msgstr "他方では、特定のトランザクションにおいてセレクトフェッチの代わりに 結合フェッチ（当然これは遅延処理ではなくなります）を選択したいことが 時々あります。これからフェッチ戦略をカスタマイズする方法をお見せします。 Hibernate3では、フェッチ戦略を選択する仕組みは単一値関連とコレクションで 変わりはありません。" +#. Tag: para +#: performance.xml:159 +#, no-c-format +msgid "" +"On the other hand, we often want to choose join fetching (which is non-lazy " +"by nature) instead of select fetching in a particular transaction. We'll now " +"see how to customize the fetching strategy. In Hibernate3, the mechanisms " +"for choosing a fetch strategy are identical for single-valued associations " +"and collections." +msgstr "" +"他方では、特定のトランザクションにおいてセレクトフェッチの代わりに 結合フェッ" +"チ（当然これは遅延処理ではなくなります）を選択したいことが 時々あります。これ" +"からフェッチ戦略をカスタマイズする方法をお見せします。 Hibernate3では、フェッ" +"チ戦略を選択する仕組みは単一値関連とコレクションで 変わりはありません。" -#: index.docbook:170 +#. Tag: title +#: performance.xml:170 +#, no-c-format msgid "Tuning fetch strategies" msgstr "フェッチ戦略のチューニング" -#: index.docbook:172 -msgid "Select fetching (the default) is extremely vulnerable to N+1 selects problems, so we might want to enable join fetching in the mapping document:" -msgstr "セレクトフェッチ（デフォルト）はN+1セレクト問題という大きな弱点があるため、 マッピング定義で結合フェッチを有効にすることができます。" +#. Tag: para +#: performance.xml:172 +#, no-c-format +msgid "" +"Select fetching (the default) is extremely vulnerable to N+1 selects " +"problems, so we might want to enable join fetching in the mapping document:" +msgstr "" +"セレクトフェッチ（デフォルト）はN+1セレクト問題という大きな弱点があるため、 " +"マッピング定義で結合フェッチを有効にすることができます。" -#: index.docbook:177 +#. Tag: programlisting +#: performance.xml:177 +#, no-c-format msgid "" - "<![CDATA[<set name=\"permissions\" \n" - " fetch=\"join\">\n" - " <key column=\"userId\"/>\n" - " <one-to-many class=\"Permission\"/>\n" - "</set]]>" +"<![CDATA[<set name=\"permissions\" \n" +" fetch=\"join\">\n" +" <key column=\"userId\"/>\n" +" <one-to-many class=\"Permission\"/>\n" +"</set]]>" msgstr "" - "<![CDATA[<set name=\"permissions\" -\n" - " fetch=\"join\"> -\n" - " <key column=\"userId\"/> -\n" - " <one-to-many class=\"Permission\"/> -\n" - "</set]]>" -#: index.docbook:179 +#. Tag: programlisting +#: performance.xml:179 +#, no-c-format msgid "<![CDATA[<many-to-one name=\"mother\" class=\"Cat\" fetch=\"join\"/>]]>" -msgstr "<![CDATA[<many-to-one name=\"mother\" class=\"Cat\" fetch=\"join\"/>]]>" +msgstr "" -#: index.docbook:181 -msgid "The <literal>fetch</literal> strategy defined in the mapping document affects:" -msgstr "マッピング定義で定義した <literal>フェッチ</literal> 戦略は次のものに影響します。" +#. Tag: para +#: performance.xml:181 +#, no-c-format +msgid "" +"The <literal>fetch</literal> strategy defined in the mapping document " +"affects:" +msgstr "" +"マッピング定義で定義した <literal>フェッチ</literal> 戦略は次のものに影響しま" +"す。" -#: index.docbook:187 +#. Tag: para +#: performance.xml:187 +#, no-c-format msgid "retrieval via <literal>get()</literal> or <literal>load()</literal>" msgstr "<literal>get()</literal> や <literal>load()</literal> による復元" -#: index.docbook:192 +#. Tag: para +#: performance.xml:192 +#, no-c-format msgid "retrieval that happens implicitly when an association is navigated" msgstr "関連にナビゲートしたときに発生する暗黙的な復元" -#: index.docbook:197 +#. Tag: para +#: performance.xml:197 +#, no-c-format msgid "<literal>Criteria</literal> queries" msgstr "<literal>Criteria</literal> クエリ" -#: index.docbook:202 +#. Tag: para +#: performance.xml:202 +#, no-c-format msgid "HQL queries if <literal>subselect</literal> fetching is used" msgstr "<literal>サブセレクト</literal> フェッチを使うHQLクエリ" -#: index.docbook:208 -msgid "No matter what fetching strategy you use, the defined non-lazy graph is guaranteed to be loaded into memory. Note that this might result in several immediate selects being used to execute a particular HQL query." -msgstr "たとえどんなフェッチ戦略を使ったとしても、遅延ではないグラフはメモリに読み込まれることが 保証されます。つまり、特定のHQLクエリを実行するためにいくつかのSELECT文が即時実行される ことがあるので注意してください。" +#. Tag: para +#: performance.xml:208 +#, no-c-format +msgid "" +"No matter what fetching strategy you use, the defined non-lazy graph is " +"guaranteed to be loaded into memory. Note that this might result in several " +"immediate selects being used to execute a particular HQL query." +msgstr "" +"たとえどんなフェッチ戦略を使ったとしても、遅延ではないグラフはメモリに読み込" +"まれることが 保証されます。つまり、特定のHQLクエリを実行するためにいくつかの" +"SELECT文が即時実行される ことがあるので注意してください。" -#: index.docbook:214 -msgid "Usually, we don't use the mapping document to customize fetching. Instead, we keep the default behavior, and override it for a particular transaction, using <literal>left join fetch</literal> in HQL. This tells Hibernate to fetch the association eagerly in the first select, using an outer join. In the <literal>Criteria</literal> query API, you would use <literal>setFetchMode(FetchMode.JOIN)</literal>." -msgstr "通常は、マッピング定義でフェッチのカスタマイズは行いません。 代わりに、デフォルトの動作のままにしておいて、HQLで <literal>left join fetch</literal> を 指定することで特定のトランザクションで動作をオーバーライドします。 これはHibernateに初回のセレクトで外部結合を使って関連を先にフェッチするように指定しています。 <literal>Criteria</literal> クエリのAPIでは、 <literal>setFetchMode(FetchMode.JOIN)</literal> を使うことが出来ます。" +#. Tag: para +#: performance.xml:214 +#, no-c-format +msgid "" +"Usually, we don't use the mapping document to customize fetching. Instead, " +"we keep the default behavior, and override it for a particular transaction, " +"using <literal>left join fetch</literal> in HQL. This tells Hibernate to " +"fetch the association eagerly in the first select, using an outer join. In " +"the <literal>Criteria</literal> query API, you would use " +"<literal>setFetchMode(FetchMode.JOIN)</literal>." +msgstr "" +"通常は、マッピング定義でフェッチのカスタマイズは行いません。 代わりに、デフォ" +"ルトの動作のままにしておいて、HQLで <literal>left join fetch</literal> を 指" +"定することで特定のトランザクションで動作をオーバーライドします。 これは" +"Hibernateに初回のセレクトで外部結合を使って関連を先にフェッチするように指定し" +"ています。 <literal>Criteria</literal> クエリのAPIでは、 " +"<literal>setFetchMode(FetchMode.JOIN)</literal> を使うことが出来ます。" -#: index.docbook:223 -msgid "If you ever feel like you wish you could change the fetching strategy used by <literal>get()</literal> or <literal>load()</literal>, simply use a <literal>Criteria</literal> query, for example:" -msgstr "もし <literal>get()</literal> や <literal>load()</literal> で使われる フェッチ戦略を変えたいと感じたときには、単純に <literal>Criteria</literal> クエリを使ってください。例：" +#. Tag: para +#: performance.xml:223 +#, no-c-format +msgid "" +"If you ever feel like you wish you could change the fetching strategy used " +"by <literal>get()</literal> or <literal>load()</literal>, simply use a " +"<literal>Criteria</literal> query, for example:" +msgstr "" +"もし <literal>get()</literal> や <literal>load()</literal> で使われる フェッ" +"チ戦略を変えたいと感じたときには、単純に <literal>Criteria</literal> クエリを" +"使ってください。例：" -#: index.docbook:229 +#. Tag: programlisting +#: performance.xml:229 +#, no-c-format msgid "" - "<![CDATA[User user = (User) session.createCriteria(User.class)\n" - " .setFetchMode(\"permissions\", FetchMode.JOIN)\n" - " .add( Restrictions.idEq(userId) )\n" - " .uniqueResult();]]>" +"<![CDATA[User user = (User) session.createCriteria(User.class)\n" +" .setFetchMode(\"permissions\", FetchMode.JOIN)\n" +" .add( Restrictions.idEq(userId) )\n" +" .uniqueResult();]]>" msgstr "" - "<![CDATA[User user = (User) session.createCriteria(User.class) -\n" - " .setFetchMode(\"permissions\", FetchMode.JOIN) -\n" - " .add( Restrictions.idEq(userId) ) -\n" - " .uniqueResult();]]>" -#: index.docbook:231 -msgid "(This is Hibernate's equivalent of what some ORM solutions call a \"fetch plan\".)" -msgstr "（これはいくつかのORMソリューションが\"fetch plan\"と呼んでいるものと同じです。）" +#. Tag: para +#: performance.xml:231 +#, no-c-format +msgid "" +"(This is Hibernate's equivalent of what some ORM solutions call a \"fetch " +"plan\".)" +msgstr "" +"（これはいくつかのORMソリューションが\"fetch plan\"と呼んでいるものと同じで" +"す。）" -#: index.docbook:235 -msgid "A completely different way to avoid problems with N+1 selects is to use the second-level cache." -msgstr "N+1セレクト問題を避けるためのまったく違う方法は、第2レベルキャッシュを使うことです。" +#. Tag: para +#: performance.xml:235 +#, no-c-format +msgid "" +"A completely different way to avoid problems with N+1 selects is to use the " +"second-level cache." +msgstr "" +"N+1セレクト問題を避けるためのまったく違う方法は、第2レベルキャッシュを使うこ" +"とです。" -#: index.docbook:243 +#. Tag: title +#: performance.xml:243 +#, no-c-format msgid "Single-ended association proxies" msgstr "単一端関連プロキシ" -#: index.docbook:245 -msgid "Lazy fetching for collections is implemented using Hibernate's own implementation of persistent collections. However, a different mechanism is needed for lazy behavior in single-ended associations. The target entity of the association must be proxied. Hibernate implements lazy initializing proxies for persistent objects using runtime bytecode enhancement (via the excellent CGLIB library)." -msgstr "コレクションの遅延フェッチは、Hibernate自身の実装による永続コレクションを使って 実現しています。しかし、単一端関連における遅延処理では、違う仕組みが 必要です。対象の関連エンティティはプロキシでなければなりません。Hibernateは （すばらしいCGLIBライブラリによる）実行時のバイトコード拡張を 使って永続オブジェクトの遅延初期化プロキシを実現しています。" +#. Tag: para +#: performance.xml:245 +#, no-c-format +msgid "" +"Lazy fetching for collections is implemented using Hibernate's own " +"implementation of persistent collections. However, a different mechanism is " +"needed for lazy behavior in single-ended associations. The target entity of " +"the association must be proxied. Hibernate implements lazy initializing " +"proxies for persistent objects using runtime bytecode enhancement (via the " +"excellent CGLIB library)." +msgstr "" +"コレクションの遅延フェッチは、Hibernate自身の実装による永続コレクションを使っ" +"て 実現しています。しかし、単一端関連における遅延処理では、違う仕組みが 必要" +"です。対象の関連エンティティはプロキシでなければなりません。Hibernateは （す" +"ばらしいCGLIBライブラリによる）実行時のバイトコード拡張を 使って永続オブジェ" +"クトの遅延初期化プロキシを実現しています。" -#: index.docbook:253 -msgid "By default, Hibernate3 generates proxies (at startup) for all persistent classes and uses them to enable lazy fetching of <literal>many-to-one</literal> and <literal>one-to-one</literal> associations." -msgstr "デフォルトでは、Hibernate3は（開始時に）すべての永続クラスのプロキシを生成し、 それらを使って、 <literal>many-to-one</literal> や <literal>one-to-one</literal> 関連の 遅延フェッチを可能にしています。" +#. Tag: para +#: performance.xml:253 +#, no-c-format +msgid "" +"By default, Hibernate3 generates proxies (at startup) for all persistent " +"classes and uses them to enable lazy fetching of <literal>many-to-one</" +"literal> and <literal>one-to-one</literal> associations." +msgstr "" +"デフォルトでは、Hibernate3は（開始時に）すべての永続クラスのプロキシを生成" +"し、 それらを使って、 <literal>many-to-one</literal> や <literal>one-to-one</" +"literal> 関連の 遅延フェッチを可能にしています。" -#: index.docbook:259 -msgid "The mapping file may declare an interface to use as the proxy interface for that class, with the <literal>proxy</literal> attribute. By default, Hibernate uses a subclass of the class. <emphasis>Note that the proxied class must implement a default constructor with at least package visibility. We recommend this constructor for all persistent classes!</emphasis>" -msgstr "マッピングファイルで <literal>proxy</literal> 属性によって、クラスのプロキシインターフェイスとして 使うインターフェイスを宣言できます。デフォルトでは、Hibernateはそのクラスのサブクラスを使います。 <emphasis>プロキシクラスは少なくともパッケージ可視でデフォルトコンストラクタを実装しなければ ならないことに注意してください。すべての永続クラスにこのコンストラクタを推奨します！</emphasis>" +#. Tag: para +#: performance.xml:259 +#, no-c-format +msgid "" +"The mapping file may declare an interface to use as the proxy interface for " +"that class, with the <literal>proxy</literal> attribute. By default, " +"Hibernate uses a subclass of the class. <emphasis>Note that the proxied " +"class must implement a default constructor with at least package visibility. " +"We recommend this constructor for all persistent classes!</emphasis>" +msgstr "" +"マッピングファイルで <literal>proxy</literal> 属性によって、クラスのプロキシ" +"インターフェイスとして 使うインターフェイスを宣言できます。デフォルトでは、" +"Hibernateはそのクラスのサブクラスを使います。 <emphasis>プロキシクラスは少な" +"くともパッケージ可視でデフォルトコンストラクタを実装しなければ ならないことに" +"注意してください。すべての永続クラスにこのコンストラクタを推奨します！</" +"emphasis>" -#: index.docbook:266 -msgid "There are some gotchas to be aware of when extending this approach to polymorphic classes, eg." -msgstr "ポリモーフィズムのクラスに対してこの方法を適用するときにいくつか考慮することがあります。 例：" +#. Tag: para +#: performance.xml:266 +#, no-c-format +msgid "" +"There are some gotchas to be aware of when extending this approach to " +"polymorphic classes, eg." +msgstr "" +"ポリモーフィズムのクラスに対してこの方法を適用するときにいくつか考慮すること" +"があります。 例：" -#: index.docbook:271 +#. Tag: programlisting +#: performance.xml:271 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Cat\" proxy=\"Cat\">\n" - " ......\n" - " <subclass name=\"DomesticCat\">\n" - " .....\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"Cat\" proxy=\"Cat\">\n" +" ......\n" +" <subclass name=\"DomesticCat\">\n" +" .....\n" +" </subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Cat\" proxy=\"Cat\"> -\n" - " ...... -\n" - " <subclass name=\"DomesticCat\"> -\n" - " ..... -\n" - " </subclass> -\n" - "</class>]]>" -#: index.docbook:273 -msgid "Firstly, instances of <literal>Cat</literal> will never be castable to <literal>DomesticCat</literal>, even if the underlying instance is an instance of <literal>DomesticCat</literal>:" -msgstr "第一に、 <literal>Cat</literal> のインスタンスは <literal>DomesticCat</literal> にキャストできません。たとえ基となるインスタンスが <literal>DomesticCat</literal> であったとしてもです。" +#. Tag: para +#: performance.xml:273 +#, no-c-format +msgid "" +"Firstly, instances of <literal>Cat</literal> will never be castable to " +"<literal>DomesticCat</literal>, even if the underlying instance is an " +"instance of <literal>DomesticCat</literal>:" +msgstr "" +"第一に、 <literal>Cat</literal> のインスタンスは <literal>DomesticCat</" +"literal> にキャストできません。たとえ基となるインスタンスが " +"<literal>DomesticCat</literal> であったとしてもです。" -#: index.docbook:279 +#. Tag: programlisting +#: performance.xml:279 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a proxy (does not hit the db)\n" - "if ( cat.isDomesticCat() ) { // hit the db to initialize the proxy\n" - " DomesticCat dc = (DomesticCat) cat; // Error!\n" - " ....\n" - "}]]>" +"<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a " +"proxy (does not hit the db)\n" +"if ( cat.isDomesticCat() ) { // hit the db to initialize " +"the proxy\n" +" DomesticCat dc = (DomesticCat) cat; // Error!\n" +" ....\n" +"}]]>" msgstr "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a proxy (does not hit the db) -\n" - "if ( cat.isDomesticCat() ) { // hit the db to initialize the proxy -\n" - " DomesticCat dc = (DomesticCat) cat; // Error! -\n" - " .... -\n" - "}]]>" -#: index.docbook:281 +#. Tag: para +#: performance.xml:281 +#, no-c-format msgid "Secondly, it is possible to break proxy <literal>==</literal>." msgstr "第二に、プロキシの <literal>==</literal> は成立しないことがあります。" -#: index.docbook:285 +#. Tag: programlisting +#: performance.xml:285 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a Cat proxy\n" - "DomesticCat dc = \n" - " (DomesticCat) session.load(DomesticCat.class, id); // acquire new DomesticCat proxy!\n" - "System.out.println(cat==dc); // false]]>" +"<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // " +"instantiate a Cat proxy\n" +"DomesticCat dc = \n" +" (DomesticCat) session.load(DomesticCat.class, id); // acquire new " +"DomesticCat proxy!\n" +"System.out.println(cat==dc); // false]]>" msgstr "" - "<![CDATA[Cat cat = (Cat) session.load(Cat.class, id); // instantiate a Cat proxy -\n" - "DomesticCat dc = -\n" - " (DomesticCat) session.load(DomesticCat.class, id); // acquire new DomesticCat proxy! -\n" - "System.out.println(cat==dc); // false]]>" -#: index.docbook:287 -msgid "However, the situation is not quite as bad as it looks. Even though we now have two references to different proxy objects, the underlying instance will still be the same object:" -msgstr "しかし、これは見かけほど悪い状況というわけではありません。たとえ異なったプロキシオブジェクトへの 二つの参照があったとしても、基となるインスタンスは同じオブジェクトです。" +#. Tag: para +#: performance.xml:287 +#, no-c-format +msgid "" +"However, the situation is not quite as bad as it looks. Even though we now " +"have two references to different proxy objects, the underlying instance will " +"still be the same object:" +msgstr "" +"しかし、これは見かけほど悪い状況というわけではありません。たとえ異なったプロ" +"キシオブジェクトへの 二つの参照があったとしても、基となるインスタンスは同じオ" +"ブジェクトです。" -#: index.docbook:292 +#. Tag: programlisting +#: performance.xml:292 +#, no-c-format msgid "" - "<![CDATA[cat.setWeight(11.0); // hit the db to initialize the proxy\n" - "System.out.println( dc.getWeight() ); // 11.0]]>" +"<![CDATA[cat.setWeight(11.0); // hit the db to initialize the proxy\n" +"System.out.println( dc.getWeight() ); // 11.0]]>" msgstr "" - "<![CDATA[cat.setWeight(11.0); // hit the db to initialize the proxy -\n" - "System.out.println( dc.getWeight() ); // 11.0]]>" -#: index.docbook:294 -msgid "Third, you may not use a CGLIB proxy for a <literal>final</literal> class or a class with any <literal>final</literal> methods." -msgstr "第三に、 <literal>final</literal> クラスや <literal>final</literal> メソッドを持つクラスに CGLIBプロキシを使えません。" +#. Tag: para +#: performance.xml:294 +#, no-c-format +msgid "" +"Third, you may not use a CGLIB proxy for a <literal>final</literal> class or " +"a class with any <literal>final</literal> methods." +msgstr "" +"第三に、 <literal>final</literal> クラスや <literal>final</literal> メソッド" +"を持つクラスに CGLIBプロキシを使えません。" -#: index.docbook:299 -msgid "Finally, if your persistent object acquires any resources upon instantiation (eg. in initializers or default constructor), then those resources will also be acquired by the proxy. The proxy class is an actual subclass of the persistent class." -msgstr "最後に、もし永続オブジェクトのインスタンス化時(例えば、初期化処理やデフォルトコンストラクタの中で) になんらかのリソースが必要となるなら、そのリソースもまたプロキシを通して取得されます。 実際には、プロキシクラスは永続クラスのサブクラスです。" +#. Tag: para +#: performance.xml:299 +#, no-c-format +msgid "" +"Finally, if your persistent object acquires any resources upon instantiation " +"(eg. in initializers or default constructor), then those resources will also " +"be acquired by the proxy. The proxy class is an actual subclass of the " +"persistent class." +msgstr "" +"最後に、もし永続オブジェクトのインスタンス化時(例えば、初期化処理やデフォルト" +"コンストラクタの中で) になんらかのリソースが必要となるなら、そのリソースもま" +"たプロキシを通して取得されます。 実際には、プロキシクラスは永続クラスのサブク" +"ラスです。" -#: index.docbook:305 -msgid "These problems are all due to fundamental limitations in Java's single inheritance model. If you wish to avoid these problems your persistent classes must each implement an interface that declares its business methods. You should specify these interfaces in the mapping file. eg." -msgstr "これらの問題はJavaの単一継承モデルの原理上の制限のためです。もしこれらの問題を避けたいのなら、 ビジネスメソッドを宣言したインターフェイスをそれぞれ永続クラスで実装しなければなりません。 マッピングファイルでこれらのインターフェイスを指定する必要があります。例：" +#. Tag: para +#: performance.xml:305 +#, no-c-format +msgid "" +"These problems are all due to fundamental limitations in Java's single " +"inheritance model. If you wish to avoid these problems your persistent " +"classes must each implement an interface that declares its business methods. " +"You should specify these interfaces in the mapping file. eg." +msgstr "" +"これらの問題はJavaの単一継承モデルの原理上の制限のためです。もしこれらの問題" +"を避けたいのなら、 ビジネスメソッドを宣言したインターフェイスをそれぞれ永続ク" +"ラスで実装しなければなりません。 マッピングファイルでこれらのインターフェイス" +"を指定する必要があります。例：" -#: index.docbook:311 +#. Tag: programlisting +#: performance.xml:311 +#, no-c-format msgid "" - "<![CDATA[<class name=\"CatImpl\" proxy=\"Cat\">\n" - " ......\n" - " <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\">\n" - " .....\n" - " </subclass>\n" - "</class>]]>" +"<![CDATA[<class name=\"CatImpl\" proxy=\"Cat\">\n" +" ......\n" +" <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\">\n" +" .....\n" +" </subclass>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"CatImpl\" proxy=\"Cat\"> -\n" - " ...... -\n" - " <subclass name=\"DomesticCatImpl\" proxy=\"DomesticCat\"> -\n" - " ..... -\n" - " </subclass> -\n" - "</class>]]>" -#: index.docbook:313 -msgid "where <literal>CatImpl</literal> implements the interface <literal>Cat</literal> and <literal>DomesticCatImpl</literal> implements the interface <literal>DomesticCat</literal>. Then proxies for instances of <literal>Cat</literal> and <literal>DomesticCat</literal> may be returned by <literal>load()</literal> or <literal>iterate()</literal>. (Note that <literal>list()</literal> does not usually return proxies.)" -msgstr "<literal>CatImpl</literal> は <literal>Cat</literal> インターフェイスを実装するのに対し、 <literal>DomesticCatImpl</literal> は <literal>DomesticCat</literal> を実装します。 すると、 <literal>load()</literal> や <literal>iterate()</literal> は、 <literal>Cat</literal> や <literal>DomesticCat</literal> のインスタンスのプロキシを 返します。（ <literal>list()</literal> は通常はプロキシを返さないことに注意してください。）" +#. Tag: para +#: performance.xml:313 +#, no-c-format +msgid "" +"where <literal>CatImpl</literal> implements the interface <literal>Cat</" +"literal> and <literal>DomesticCatImpl</literal> implements the interface " +"<literal>DomesticCat</literal>. Then proxies for instances of <literal>Cat</" +"literal> and <literal>DomesticCat</literal> may be returned by <literal>load" +"()</literal> or <literal>iterate()</literal>. (Note that <literal>list()</" +"literal> does not usually return proxies.)" +msgstr "" +"<literal>CatImpl</literal> は <literal>Cat</literal> インターフェイスを実装す" +"るのに対し、 <literal>DomesticCatImpl</literal> は <literal>DomesticCat</" +"literal> を実装します。 すると、 <literal>load()</literal> や " +"<literal>iterate()</literal> は、 <literal>Cat</literal> や " +"<literal>DomesticCat</literal> のインスタンスのプロキシを 返します。" +"（ <literal>list()</literal> は通常はプロキシを返さないことに注意してくださ" +"い。）" -#: index.docbook:321 +#. Tag: programlisting +#: performance.xml:321 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid);\n" - "Iterator iter = session.createQuery(\"from CatImpl as cat where cat.name='fritz'\").iterate();\n" - "Cat fritz = (Cat) iter.next();]]>" +"<![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid);\n" +"Iterator iter = session.createQuery(\"from CatImpl as cat where cat." +"name='fritz'\").iterate();\n" +"Cat fritz = (Cat) iter.next();]]>" msgstr "" - "<![CDATA[Cat cat = (Cat) session.load(CatImpl.class, catid); -\n" - "Iterator iter = session.createQuery(\"from CatImpl as cat where cat.name='fritz'\").iterate(); -\n" - "Cat fritz = (Cat) iter.next();]]>" -#: index.docbook:323 -msgid "Relationships are also lazily initialized. This means you must declare any properties to be of type <literal>Cat</literal>, not <literal>CatImpl</literal>." -msgstr "関連も遅延初期化されます。これはプロパティを <literal>Cat</literal> 型で宣言しなければ ならないことを意味します。 <literal>CatImpl</literal> ではありません。" +#. Tag: para +#: performance.xml:323 +#, no-c-format +msgid "" +"Relationships are also lazily initialized. This means you must declare any " +"properties to be of type <literal>Cat</literal>, not <literal>CatImpl</" +"literal>." +msgstr "" +"関連も遅延初期化されます。これはプロパティを <literal>Cat</literal> 型で宣言" +"しなければ ならないことを意味します。 <literal>CatImpl</literal> ではありませ" +"ん。" -#: index.docbook:328 -msgid "Certain operations do <emphasis>not</emphasis> require proxy initialization" -msgstr "プロキシの初期化を <emphasis>必要としない</emphasis> 操作も存在します。" +#. Tag: para +#: performance.xml:328 +#, no-c-format +msgid "" +"Certain operations do <emphasis>not</emphasis> require proxy initialization" +msgstr "" +"プロキシの初期化を <emphasis>必要としない</emphasis> 操作も存在します。" -#: index.docbook:334 -msgid "<literal>equals()</literal>, if the persistent class does not override <literal>equals()</literal>" -msgstr "<literal>equals()</literal> （永続クラスが <literal>equals()</literal> を オーバーライドしないとき）" +#. Tag: para +#: performance.xml:334 +#, no-c-format +msgid "" +"<literal>equals()</literal>, if the persistent class does not override " +"<literal>equals()</literal>" +msgstr "" +"<literal>equals()</literal> （永続クラスが <literal>equals()</literal> を " +"オーバーライドしないとき）" -#: index.docbook:340 -msgid "<literal>hashCode()</literal>, if the persistent class does not override <literal>hashCode()</literal>" -msgstr "<literal>hashCode()</literal> （永続クラスが <literal>hashCode()</literal> を オーバーライドしないとき）" +#. Tag: para +#: performance.xml:340 +#, no-c-format +msgid "" +"<literal>hashCode()</literal>, if the persistent class does not override " +"<literal>hashCode()</literal>" +msgstr "" +"<literal>hashCode()</literal> （永続クラスが <literal>hashCode()</literal> " +"を オーバーライドしないとき）" -#: index.docbook:346 +#. Tag: para +#: performance.xml:346 +#, no-c-format msgid "The identifier getter method" msgstr "識別子のgetterメソッド" -#: index.docbook:352 -msgid "Hibernate will detect persistent classes that override <literal>equals()</literal> or <literal>hashCode()</literal>." -msgstr "Hibernateは <literal>equals()</literal> や <literal>hashCode()</literal> をオーバーライドした 永続クラスを検出します。" +#. Tag: para +#: performance.xml:352 +#, no-c-format +msgid "" +"Hibernate will detect persistent classes that override <literal>equals()</" +"literal> or <literal>hashCode()</literal>." +msgstr "" +"Hibernateは <literal>equals()</literal> や <literal>hashCode()</literal> を" +"オーバーライドした 永続クラスを検出します。" -#: index.docbook:357 -msgid "By choosing <literal>lazy=\"no-proxy\"</literal> instead of the default <literal>lazy=\"proxy\"</literal>, we can avoid the problems associated with typecasting. However, we will require buildtime bytecode instrumentation, and all operations will result in immediate proxy initialization." -msgstr "デフォルトの <literal>lazy=\"proxy\"</literal> の代わりに、 <literal>lazy=\"no-proxy\"</literal> を 選んだことで、型変換に関連する問題を回避することが出来ます。 しかし、ビルド時のバイトコード組み込みが必要になり、どのような操作であっても、 ただちにプロキシの初期化を行うことになるでしょう。" +#. Tag: para +#: performance.xml:357 +#, no-c-format +msgid "" +"By choosing <literal>lazy=\"no-proxy\"</literal> instead of the default " +"<literal>lazy=\"proxy\"</literal>, we can avoid the problems associated with " +"typecasting. However, we will require buildtime bytecode instrumentation, " +"and all operations will result in immediate proxy initialization." +msgstr "" +"デフォルトの <literal>lazy=\"proxy\"</literal> の代わりに、 <literal>lazy=" +"\"no-proxy\"</literal> を 選んだことで、型変換に関連する問題を回避することが" +"出来ます。 しかし、ビルド時のバイトコード組み込みが必要になり、どのような操作" +"であっても、 ただちにプロキシの初期化を行うことになるでしょう。" -#: index.docbook:367 +#. Tag: title +#: performance.xml:367 +#, no-c-format msgid "Initializing collections and proxies" msgstr "コレクションとプロキシの初期化" -#: index.docbook:369 -msgid "A <literal>LazyInitializationException</literal> will be thrown by Hibernate if an uninitialized collection or proxy is accessed outside of the scope of the <literal>Session</literal>, ie. when the entity owning the collection or having the reference to the proxy is in the detached state." -msgstr "<literal>LazyInitializationException</literal> は、 <literal>Session</literal> のスコープ外から 初期化していないコレクションやプロキシにアクセスされたときに、Hibernateによってスローされます。 すなわち、コレクションやプロキシへの参照を持つエンティティが分離された状態の時です。" +#. Tag: para +#: performance.xml:369 +#, no-c-format +msgid "" +"A <literal>LazyInitializationException</literal> will be thrown by Hibernate " +"if an uninitialized collection or proxy is accessed outside of the scope of " +"the <literal>Session</literal>, ie. when the entity owning the collection or " +"having the reference to the proxy is in the detached state." +msgstr "" +"<literal>LazyInitializationException</literal> は、 <literal>Session</" +"literal> のスコープ外から 初期化していないコレクションやプロキシにアクセスさ" +"れたときに、Hibernateによってスローされます。 すなわち、コレクションやプロキ" +"シへの参照を持つエンティティが分離された状態の時です。" -#: index.docbook:375 -msgid "Sometimes we need to ensure that a proxy or collection is initialized before closing the <literal>Session</literal>. Of course, we can alway force initialization by calling <literal>cat.getSex()</literal> or <literal>cat.getKittens().size()</literal>, for example. But that is confusing to readers of the code and is not convenient for generic code." -msgstr "<literal>Session</literal> をクローズする前にプロキシやコレクションの初期化を確実に 行いたいときがあります。もちろん、 <literal>cat.getSex()</literal> や <literal>cat.getKittens().size()</literal> などを常に呼び出すことで初期化を強制することはできます。 しかしこれはコードを読む人を混乱させ、汎用的なコードという点からも不便です。" +#. Tag: para +#: performance.xml:375 +#, no-c-format +msgid "" +"Sometimes we need to ensure that a proxy or collection is initialized before " +"closing the <literal>Session</literal>. Of course, we can alway force " +"initialization by calling <literal>cat.getSex()</literal> or <literal>cat." +"getKittens().size()</literal>, for example. But that is confusing to readers " +"of the code and is not convenient for generic code." +msgstr "" +"<literal>Session</literal> をクローズする前にプロキシやコレクションの初期化を" +"確実に 行いたいときがあります。もちろん、 <literal>cat.getSex()</literal> や " +"<literal>cat.getKittens().size()</literal> などを常に呼び出すことで初期化を強" +"制することはできます。 しかしこれはコードを読む人を混乱させ、汎用的なコードと" +"いう点からも不便です。" -#: index.docbook:382 -msgid "The static methods <literal>Hibernate.initialize()</literal> and <literal>Hibernate.isInitialized()</literal> provide the application with a convenient way of working with lazily initialized collections or proxies. <literal>Hibernate.initialize(cat)</literal> will force the initialization of a proxy, <literal>cat</literal>, as long as its <literal>Session</literal> is still open. <literal>Hibernate.initialize( cat.getKittens() )</literal> has a similar effect for the collection of kittens." -msgstr "staticメソッドの <literal>Hibernate.initialize()</literal> や <literal>Hibernate.isInitialized()</literal> は遅延初期化のコレクションやプロキシを扱うときに便利な方法をアプリケーションに提供します。 <literal>Hibernate.initialize(cat)</literal> は、 <literal>Session</literal> がオープンしている限りは <literal>cat</literal> プロキシを強制的に初期化します。 <literal>Hibernate.initialize( cat.getKittens() )</literal> はkittensコレクションに対して同様の 効果があります。" +#. Tag: para +#: performance.xml:382 +#, no-c-format +msgid "" +"The static methods <literal>Hibernate.initialize()</literal> and " +"<literal>Hibernate.isInitialized()</literal> provide the application with a " +"convenient way of working with lazily initialized collections or proxies. " +"<literal>Hibernate.initialize(cat)</literal> will force the initialization " +"of a proxy, <literal>cat</literal>, as long as its <literal>Session</" +"literal> is still open. <literal>Hibernate.initialize( cat.getKittens() )</" +"literal> has a similar effect for the collection of kittens." +msgstr "" +"staticメソッドの <literal>Hibernate.initialize()</literal> や " +"<literal>Hibernate.isInitialized()</literal> は遅延初期化のコレクションやプロ" +"キシを扱うときに便利な方法をアプリケーションに提供します。 " +"<literal>Hibernate.initialize(cat)</literal> は、 <literal>Session</literal> " +"がオープンしている限りは <literal>cat</literal> プロキシを強制的に初期化しま" +"す。 <literal>Hibernate.initialize( cat.getKittens() )</literal> はkittensコ" +"レクションに対して同様の 効果があります。" -#: index.docbook:391 -msgid "Another option is to keep the <literal>Session</literal> open until all needed collections and proxies have been loaded. In some application architectures, particularly where the code that accesses data using Hibernate, and the code that uses it are in different application layers or different physical processes, it can be a problem to ensure that the <literal>Session</literal> is open when a collection is initialized. There are two basic ways to deal with this issue:" -msgstr "別の選択肢として、必要なすべてのコレクションやプロキシがロードされるまで <literal>Session</literal> をオープンにしておく方法があります。いくつかのアプリケーションの アーキテクチャでは、特にHibernateによるデータアクセスを行うコードと、それを使う コードが異なるアプリケーションのレイヤーや、物理的に異なるプロセッサのときには、 コレクションが初期化されるときに <literal>Session</literal> がオープンしていることを 保証する問題があります。この問題に対しては2つの基本的な方法があります。" +#. Tag: para +#: performance.xml:391 +#, no-c-format +msgid "" +"Another option is to keep the <literal>Session</literal> open until all " +"needed collections and proxies have been loaded. In some application " +"architectures, particularly where the code that accesses data using " +"Hibernate, and the code that uses it are in different application layers or " +"different physical processes, it can be a problem to ensure that the " +"<literal>Session</literal> is open when a collection is initialized. There " +"are two basic ways to deal with this issue:" +msgstr "" +"別の選択肢として、必要なすべてのコレクションやプロキシがロードされるまで " +"<literal>Session</literal> をオープンにしておく方法があります。いくつかのアプ" +"リケーションの アーキテクチャでは、特にHibernateによるデータアクセスを行う" +"コードと、それを使う コードが異なるアプリケーションのレイヤーや、物理的に異な" +"るプロセッサのときには、 コレクションが初期化されるときに <literal>Session</" +"literal> がオープンしていることを 保証する問題があります。この問題に対しては2" +"つの基本的な方法があります。" -#: index.docbook:402 -msgid "In a web-based application, a servlet filter can be used to close the <literal>Session</literal> only at the very end of a user request, once the rendering of the view is complete (the <emphasis>Open Session in View</emphasis> pattern). Of course, this places heavy demands on the correctness of the exception handling of your application infrastructure. It is vitally important that the <literal>Session</literal> is closed and the transaction ended before returning to the user, even when an exception occurs during rendering of the view. See the Hibernate Wiki for examples of this \"Open Session in View\" pattern." -msgstr "Webベースのアプリケーションでは、 ビューのレンダリングが完了し、リクエストが終わる一番最後で <literal>Session</literal> をクローズするために、サーブレットフィルタを使うことができます（ <emphasis>Open Session in View</emphasis> パターンです）。もちろん、アプリケーション基盤の例外処理の正確性が非常に重要になります。 ビューのレンダリング中に例外が発生したときでさえ、ユーザに処理が戻る前に <literal>Session</literal> のクローズとトランザクションの終了を行う ことが不可欠になります。 HibernateのWikiに載っている\"Open Session in View\"パターンの例を参照してください。" +#. Tag: para +#: performance.xml:402 +#, no-c-format +msgid "" +"In a web-based application, a servlet filter can be used to close the " +"<literal>Session</literal> only at the very end of a user request, once the " +"rendering of the view is complete (the <emphasis>Open Session in View</" +"emphasis> pattern). Of course, this places heavy demands on the correctness " +"of the exception handling of your application infrastructure. It is vitally " +"important that the <literal>Session</literal> is closed and the transaction " +"ended before returning to the user, even when an exception occurs during " +"rendering of the view. See the Hibernate Wiki for examples of this \"Open " +"Session in View\" pattern." +msgstr "" +"Webベースのアプリケーションでは、 ビューのレンダリングが完了し、リクエストが" +"終わる一番最後で <literal>Session</literal> をクローズするために、サーブレッ" +"トフィルタを使うことができます（ <emphasis>Open Session in View</emphasis> パ" +"ターンです）。もちろん、アプリケーション基盤の例外処理の正確性が非常に重要に" +"なります。 ビューのレンダリング中に例外が発生したときでさえ、ユーザに処理が戻" +"る前に <literal>Session</literal> のクローズとトランザクションの終了を行う こ" +"とが不可欠になります。 HibernateのWikiに載っている\"Open Session in View\"パ" +"ターンの例を参照してください。" -#: index.docbook:415 -msgid "In an application with a separate business tier, the business logic must \"prepare\" all collections that will be needed by the web tier before returning. This means that the business tier should load all the data and return all the data already initialized to the presentation/web tier that is required for a particular use case. Usually, the application calls <literal>Hibernate.initialize()</literal> for each collection that will be needed in the web tier (this call must occur before the session is closed) or retrieves the collection eagerly using a Hibernate query with a <literal>FETCH</literal> clause or a <literal>FetchMode.JOIN</literal> in <literal>Criteria</literal>. This is usually easier if you adopt the <emphasis>Command</emphasis> pattern instead of a <emphasis>Session Facade</emphasis>." -msgstr "ビジネス層が分離しているアプリケーションでは、ビジネスロジックは Web層で必要になるすべてのコレクションを事前に\"準備\"する必要があります。 これは特定のユースケースで必要となるプレゼンテーション/Web層に対し、 ビジネス層がすべてのデータをロードし、すべてのデータを初期化して返すべきと いうことを意味しています。通常は、アプリケーションはWeb層で必要なコレクション それぞれに対して <literal>Hibernate.initialize()</literal> を呼び出すか （この呼び出しはセッションをクローズする前に行う必要があります）、 Hibernateクエリの <literal>FETCH</literal> 節や <literal>Criteria</literal> の <literal>FetchMode.JOIN</literal> を使ってコレクションを先に復元します。 普通は <emphasis>Session Facade</emphasis> パターンの代わりに <emphasis>! Command</emphasis> パターンを採用するほうがより簡単です。" +#. Tag: para +#: performance.xml:415 +#, no-c-format +msgid "" +"In an application with a separate business tier, the business logic must " +"\"prepare\" all collections that will be needed by the web tier before " +"returning. This means that the business tier should load all the data and " +"return all the data already initialized to the presentation/web tier that is " +"required for a particular use case. Usually, the application calls " +"<literal>Hibernate.initialize()</literal> for each collection that will be " +"needed in the web tier (this call must occur before the session is closed) " +"or retrieves the collection eagerly using a Hibernate query with a " +"<literal>FETCH</literal> clause or a <literal>FetchMode.JOIN</literal> in " +"<literal>Criteria</literal>. This is usually easier if you adopt the " +"<emphasis>Command</emphasis> pattern instead of a <emphasis>Session Facade</" +"emphasis>." +msgstr "" +"ビジネス層が分離しているアプリケーションでは、ビジネスロジックは Web層で必要" +"になるすべてのコレクションを事前に\"準備\"する必要があります。 これは特定の" +"ユースケースで必要となるプレゼンテーション/Web層に対し、 ビジネス層がすべての" +"データをロードし、すべてのデータを初期化して返すべきと いうことを意味していま" +"す。通常は、アプリケーションはWeb層で必要なコレクション それぞれに対して " +"<literal>Hibernate.initialize()</literal> を呼び出すか （この呼び出しはセッ" +"ションをクローズする前に行う必要があります）、 Hibernateクエリの " +"<literal>FETCH</literal> 節や <literal>Criteria</literal> の " +"<literal>FetchMode.JOIN</literal> を使ってコレクションを先に復元します。 普通" +"は <emphasis>Session Facade</emphasis> パターンの代わりに <emphasis>Command</" +"emphasis> パターンを採用するほうがより簡単です。" -#: index.docbook:430 -msgid "You may also attach a previously loaded object to a new <literal>Session</literal> with <literal>merge()</literal> or <literal>lock()</literal> before accessing uninitialized collections (or other proxies). No, Hibernate does not, and certainly <emphasis>should</emphasis> not do this automatically, since it would introduce ad hoc transaction semantics!" -msgstr "初期化されていないコレクション（もしくは他のプロキシ）にアクセスする前に、 <literal>merge()</literal> や <literal>lock()</literal> を使って新しい <literal>Session</literal> に以前にロードされたオブジェクトを追加することも出来ます。 アドホックなトランザクションのセマンティクスを導入したので、Hibernateは これを自動的に行わず、 <emphasis>行うべきでもありません</emphasis> ！" +#. Tag: para +#: performance.xml:430 +#, no-c-format +msgid "" +"You may also attach a previously loaded object to a new <literal>Session</" +"literal> with <literal>merge()</literal> or <literal>lock()</literal> before " +"accessing uninitialized collections (or other proxies). No, Hibernate does " +"not, and certainly <emphasis>should</emphasis> not do this automatically, " +"since it would introduce ad hoc transaction semantics!" +msgstr "" +"初期化されていないコレクション（もしくは他のプロキシ）にアクセスする前に、 " +"<literal>merge()</literal> や <literal>lock()</literal> を使って新しい " +"<literal>Session</literal> に以前にロードされたオブジェクトを追加することも出" +"来ます。 アドホックなトランザクションのセマンティクスを導入したので、" +"Hibernateは これを自動的に行わず、 <emphasis>行うべきでもありません</" +"emphasis> ！" -#: index.docbook:440 -msgid "Sometimes you don't want to initialize a large collection, but still need some information about it (like its size) or a subset of the data." -msgstr "大きなコレクションを初期化したくはないが、コレクションについてのなんらかの情報（サイズのような） やデータのサブセットを必要とすることがあります。" +#. Tag: para +#: performance.xml:440 +#, no-c-format +msgid "" +"Sometimes you don't want to initialize a large collection, but still need " +"some information about it (like its size) or a subset of the data." +msgstr "" +"大きなコレクションを初期化したくはないが、コレクションについてのなんらかの情" +"報（サイズのような） やデータのサブセットを必要とすることがあります。" -#: index.docbook:445 -msgid "You can use a collection filter to get the size of a collection without initializing it:" -msgstr "コレクションフィルタを使うことで、初期化せずにコレクションのサイズを取得することが出来ます。" +#. Tag: para +#: performance.xml:445 +#, no-c-format +msgid "" +"You can use a collection filter to get the size of a collection without " +"initializing it:" +msgstr "" +"コレクションフィルタを使うことで、初期化せずにコレクションのサイズを取得する" +"ことが出来ます。" -#: index.docbook:449 -msgid "<![CDATA[( (Integer) s.createFilter( collection, \"select count(*)\" ).list().get(0) ).intValue()]]>" -msgstr "<![CDATA[( (Integer) s.createFilter( collection, \"select count(*)\" ).list().get(0) ).intValue()]]>" +#. Tag: programlisting +#: performance.xml:449 +#, no-c-format +msgid "" +"<![CDATA[( (Integer) s.createFilter( collection, \"select count(*)\" ).list" +"().get(0) ).intValue()]]>" +msgstr "" -#: index.docbook:451 -msgid "The <literal>createFilter()</literal> method is also used to efficiently retrieve subsets of a collection without needing to initialize the whole collection:" -msgstr "<literal>createFilter()</literal> メソッドは、コレクション全体を初期化する必要なしに、コレクションの サブセットを復元するために効果的に使えます。" +#. Tag: para +#: performance.xml:451 +#, no-c-format +msgid "" +"The <literal>createFilter()</literal> method is also used to efficiently " +"retrieve subsets of a collection without needing to initialize the whole " +"collection:" +msgstr "" +"<literal>createFilter()</literal> メソッドは、コレクション全体を初期化する必" +"要なしに、コレクションの サブセットを復元するために効果的に使えます。" -#: index.docbook:456 -msgid "<![CDATA[s.createFilter( lazyCollection, \"\").setFirstResult(0).setMaxResults(10).list();]]>" -msgstr "<![CDATA[s.createFilter( lazyCollection, \"\").setFirstResult(0).setMaxResults(10).list();]]>" +#. Tag: programlisting +#: performance.xml:456 +#, no-c-format +msgid "" +"<![CDATA[s.createFilter( lazyCollection, \"\").setFirstResult(0)." +"setMaxResults(10).list();]]>" +msgstr "" -#: index.docbook:461 +#. Tag: title +#: performance.xml:461 +#, no-c-format msgid "Using batch fetching" msgstr "バッチフェッチの使用" -#: index.docbook:463 -msgid "Hibernate can make efficient use of batch fetching, that is, Hibernate can load several uninitialized proxies if one proxy is accessed (or collections. Batch fetching is an optimization of the lazy select fetching strategy. There are two ways you can tune batch fetching: on the class and the collection level." -msgstr "Hibernateはバッチフェッチを効率的に使用できます。一つのプロキシ（もしくはコレクション）がアクセス されると、Hibernateはいくつかの初期化していないプロキシをロードすることができます。バッチフェッチは 遅延セレクトフェッチ戦略に対する最適化です。バッチフェッチの調整には２つの方法があります。 クラスレベルとコレクションレベルです。" +#. Tag: para +#: performance.xml:463 +#, no-c-format +msgid "" +"Hibernate can make efficient use of batch fetching, that is, Hibernate can " +"load several uninitialized proxies if one proxy is accessed (or collections. " +"Batch fetching is an optimization of the lazy select fetching strategy. " +"There are two ways you can tune batch fetching: on the class and the " +"collection level." +msgstr "" +"Hibernateはバッチフェッチを効率的に使用できます。一つのプロキシ（もしくはコレ" +"クション）がアクセス されると、Hibernateはいくつかの初期化していないプロキシ" +"をロードすることができます。バッチフェッチは 遅延セレクトフェッチ戦略に対する" +"最適化です。バッチフェッチの調整には２つの方法があります。 クラスレベルとコレ" +"クションレベルです。" -#: index.docbook:469 -msgid "Batch fetching for classes/entities is easier to understand. Imagine you have the following situation at runtime: You have 25 <literal>Cat</literal> instances loaded in a <literal>Session</literal>, each <literal>Cat</literal> has a reference to its <literal>owner</literal>, a <literal>Person</literal>. The <literal>Person</literal> class is mapped with a proxy, <literal>lazy=\"true\"</literal>. If you now iterate through all cats and call <literal>getOwner()</literal> on each, Hibernate will by default execute 25 <literal>SELECT</literal> statements, to retrieve the proxied owners. You can tune this behavior by specifying a <literal>batch-size</literal> in the mapping of <literal>Person</literal>:" -msgstr "クラス、要素のバッチフェッチは理解が簡単です。実行時の次の場面を想像してください。 <literal>Session</literal> にロードされた25個の <literal>Cat</literal> インスタンスが存在し、 それぞれの <literal>Cat</literal> は <literal>owner</literal> である <literal>Person</literal> への関連を持ちます。 <literal>Person</literal> クラスは <literal>lazy=\"true\"</literal> のプロキシでマッピングされています。 もし今すべてのCatに対して繰り返し <literal>getOwner()</literal> を呼び出すと、Hibernateは デフォルトでは25回の <literal>SELECT</literal> を実行し、ownerプロキシの復元をします。 この振る舞いを <literal>Person</literal> のマッピングの <literal>batch-size</literal> の指定で調整できます。" +#. Tag: para +#: performance.xml:469 +#, no-c-format +msgid "" +"Batch fetching for classes/entities is easier to understand. Imagine you " +"have the following situation at runtime: You have 25 <literal>Cat</literal> " +"instances loaded in a <literal>Session</literal>, each <literal>Cat</" +"literal> has a reference to its <literal>owner</literal>, a <literal>Person</" +"literal>. The <literal>Person</literal> class is mapped with a proxy, " +"<literal>lazy=\"true\"</literal>. If you now iterate through all cats and " +"call <literal>getOwner()</literal> on each, Hibernate will by default " +"execute 25 <literal>SELECT</literal> statements, to retrieve the proxied " +"owners. You can tune this behavior by specifying a <literal>batch-size</" +"literal> in the mapping of <literal>Person</literal>:" +msgstr "" +"クラス、要素のバッチフェッチは理解が簡単です。実行時の次の場面を想像してくだ" +"さい。 <literal>Session</literal> にロードされた25個の <literal>Cat</" +"literal> インスタンスが存在し、 それぞれの <literal>Cat</literal> は " +"<literal>owner</literal> である <literal>Person</literal> への関連を持ちま" +"す。 <literal>Person</literal> クラスは <literal>lazy=\"true\"</literal> のプ" +"ロキシでマッピングされています。 もし今すべてのCatに対して繰り返し " +"<literal>getOwner()</literal> を呼び出すと、Hibernateは デフォルトでは25回の " +"<literal>SELECT</literal> を実行し、ownerプロキシの復元をします。 この振る舞" +"いを <literal>Person</literal> のマッピングの <literal>batch-size</literal> " +"の指定で調整できます。" -#: index.docbook:479 +#. Tag: programlisting +#: performance.xml:479 +#, no-c-format msgid "<![CDATA[<class name=\"Person\" batch-size=\"10\">...</class>]]>" -msgstr "<![CDATA[<class name=\"Person\" batch-size=\"10\">...</class>]]>" +msgstr "" -#: index.docbook:481 -msgid "Hibernate will now execute only three queries, the pattern is 10, 10, 5." -msgstr "Hibernateはクエリを３回だけを実行するようになります。パターンは10, 10, 5です。" +#. Tag: para +#: performance.xml:481 +#, no-c-format +msgid "" +"Hibernate will now execute only three queries, the pattern is 10, 10, 5." +msgstr "" +"Hibernateはクエリを３回だけを実行するようになります。パターンは10, 10, 5で" +"す。" -#: index.docbook:485 -msgid "You may also enable batch fetching of collections. For example, if each <literal>Person</literal> has a lazy collection of <literal>Cat</literal>s, and 10 persons are currently loaded in the <literal>Sesssion</literal>, iterating through all persons will generate 10 <literal>SELECT</literal>s, one for every call to <literal>getCats()</literal>. If you enable batch fetching for the <literal>cats</literal> collection in the mapping of <literal>Person</literal>, Hibernate can pre-fetch collections:" -msgstr "コレクションのバッチフェッチも有効にすることが出来ます。例として、それぞれの <literal>Person</literal> が <literal>Cat</literal> の遅延コレクションを持っており、 10個のPersonが <literal>Sesssion</literal> にロードされたとすると、すべてのPersonに 対して繰り返し <literal>getCats()</literal> を呼び出すことで、計10回の <literal>SELECT</literal> が発生します。もし <literal>Person</literal> のマッピングで <literal>cats</literal> コレクションのバッチフェッチを有効にすれば、Hibernateはコレクションの事前フェッチが出来ます。" +#. Tag: para +#: performance.xml:485 +#, no-c-format +msgid "" +"You may also enable batch fetching of collections. For example, if each " +"<literal>Person</literal> has a lazy collection of <literal>Cat</literal>s, " +"and 10 persons are currently loaded in the <literal>Sesssion</literal>, " +"iterating through all persons will generate 10 <literal>SELECT</literal>s, " +"one for every call to <literal>getCats()</literal>. If you enable batch " +"fetching for the <literal>cats</literal> collection in the mapping of " +"<literal>Person</literal>, Hibernate can pre-fetch collections:" +msgstr "" +"コレクションのバッチフェッチも有効にすることが出来ます。例として、それぞれの " +"<literal>Person</literal> が <literal>Cat</literal> の遅延コレクションを持っ" +"ており、 10個のPersonが <literal>Sesssion</literal> にロードされたとすると、" +"すべてのPersonに 対して繰り返し <literal>getCats()</literal> を呼び出すこと" +"で、計10回の <literal>SELECT</literal> が発生します。もし <literal>Person</" +"literal> のマッピングで <literal>cats</literal> コレクションのバッチフェッチ" +"を有効にすれば、Hibernateはコレクションの事前フェッチが出来ます。" -#: index.docbook:494 +#. Tag: programlisting +#: performance.xml:494 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <set name=\"cats\" batch-size=\"3\">\n" - " ...\n" - " </set>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <set name=\"cats\" batch-size=\"3\">\n" +" ...\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\"> -\n" - " <set name=\"cats\" batch-size=\"3\"> -\n" - " ... -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:496 -msgid "With a <literal>batch-size</literal> of 3, Hibernate will load 3, 3, 3, 1 collections in four <literal>SELECT</literal>s. Again, the value of the attribute depends on the expected number of uninitialized collections in a particular <literal>Session</literal>." -msgstr "<literal>batch-size</literal> が3なので、Hibernateは4回の <literal>SELECT</literal> で3個、3個、3個、1個をロードします。繰り返すと、属性の値は特定の <literal>Session</literal> の中の初期化されていないコレクションの期待数に依存します。" +#. Tag: para +#: performance.xml:496 +#, no-c-format +msgid "" +"With a <literal>batch-size</literal> of 3, Hibernate will load 3, 3, 3, 1 " +"collections in four <literal>SELECT</literal>s. Again, the value of the " +"attribute depends on the expected number of uninitialized collections in a " +"particular <literal>Session</literal>." +msgstr "" +"<literal>batch-size</literal> が3なので、Hibernateは4回の <literal>SELECT</" +"literal> で3個、3個、3個、1個をロードします。繰り返すと、属性の値は特定の " +"<literal>Session</literal> の中の初期化されていないコレクションの期待数に依存" +"します。" -#: index.docbook:502 -msgid "Batch fetching of collections is particularly useful if you have a nested tree of items, ie. the typical bill-of-materials pattern. (Although a <emphasis>nested set</emphasis> or a <emphasis>materialized path</emphasis> might be a better option for read-mostly trees.)" -msgstr "コレクションのバッチフェッチはアイテムのネストしたツリー、 すなわち、代表的な部品表のパターンが ある場合に特に有用です。（しかし、読み込みが多いツリーでは <emphasis>ネストしたset</emphasis> や <emphasis>具体化したパス</emphasis> がよりよい選択になります。）" +#. Tag: para +#: performance.xml:502 +#, no-c-format +msgid "" +"Batch fetching of collections is particularly useful if you have a nested " +"tree of items, ie. the typical bill-of-materials pattern. (Although a " +"<emphasis>nested set</emphasis> or a <emphasis>materialized path</emphasis> " +"might be a better option for read-mostly trees.)" +msgstr "" +"コレクションのバッチフェッチはアイテムのネストしたツリー、 すなわち、代表的な" +"部品表のパターンが ある場合に特に有用です。（しかし、読み込みが多いツリーで" +"は <emphasis>ネストしたset</emphasis> や <emphasis>具体化したパス</emphasis> " +"がよりよい選択になります。）" -#: index.docbook:511 +#. Tag: title +#: performance.xml:511 +#, no-c-format msgid "Using subselect fetching" msgstr "サブセレクトフェッチの使用" -#: index.docbook:513 -msgid "If one lazy collection or single-valued proxy has to be fetched, Hibernate loads all of them, re-running the original query in a subselect. This works in the same way as batch-fetching, without the piecemeal loading." -msgstr "一つの遅延コレクションや単一値プロキシがフェッチされなければいけないとき、Hibernateは それらすべてをロードし、サブセレクトのオリジナルクエリが再度実行されます。これは バッチフェッチと同じ方法で動き、少しずつのロードは行いません。" +#. Tag: para +#: performance.xml:513 +#, no-c-format +msgid "" +"If one lazy collection or single-valued proxy has to be fetched, Hibernate " +"loads all of them, re-running the original query in a subselect. This works " +"in the same way as batch-fetching, without the piecemeal loading." +msgstr "" +"一つの遅延コレクションや単一値プロキシがフェッチされなければいけないとき、" +"Hibernateは それらすべてをロードし、サブセレクトのオリジナルクエリが再度実行" +"されます。これは バッチフェッチと同じ方法で動き、少しずつのロードは行いませ" +"ん。" -#: index.docbook:524 +#. Tag: title +#: performance.xml:524 +#, no-c-format msgid "Using lazy property fetching" msgstr "遅延プロパティフェッチの使用" -#: index.docbook:526 -msgid "Hibernate3 supports the lazy fetching of individual properties. This optimization technique is also known as <emphasis>fetch groups</emphasis>. Please note that this is mostly a marketing feature, as in practice, optimizing row reads is much more important than optimization of column reads. However, only loading some properties of a class might be useful in extreme cases, when legacy tables have hundreds of columns and the data model can not be improved." -msgstr "Hibernate3はプロパティごとの遅延フェッチをサポートしています。この最適化手法は <emphasis>グループのフェッチ</emphasis> としても知られています。これはほとんど 要望から出た機能であることに注意してください。実際には列読み込みの最適化よりも、 行読み込みの最適化が非常に重要です。 しかし、クラスのいくつかのプロパティだけを読み込むことは、既存のテーブルが何百もの列を持ち、 データモデルを改善できないなどの極端な場合には有用です。" +#. Tag: para +#: performance.xml:526 +#, no-c-format +msgid "" +"Hibernate3 supports the lazy fetching of individual properties. This " +"optimization technique is also known as <emphasis>fetch groups</emphasis>. " +"Please note that this is mostly a marketing feature, as in practice, " +"optimizing row reads is much more important than optimization of column " +"reads. However, only loading some properties of a class might be useful in " +"extreme cases, when legacy tables have hundreds of columns and the data " +"model can not be improved." +msgstr "" +"Hibernate3はプロパティごとの遅延フェッチをサポートしています。この最適化手法" +"は <emphasis>グループのフェッチ</emphasis> としても知られています。これはほと" +"んど 要望から出た機能であることに注意してください。実際には列読み込みの最適化" +"よりも、 行読み込みの最適化が非常に重要です。 しかし、クラスのいくつかのプロ" +"パティだけを読み込むことは、既存のテーブルが何百もの列を持ち、 データモデルを" +"改善できないなどの極端な場合には有用です。" -#: index.docbook:535 -msgid "To enable lazy property loading, set the <literal>lazy</literal> attribute on your particular property mappings:" -msgstr "遅延プロパティ読み込みを有効にするには、対象のプロパティのマッピングで <literal>lazy</literal> 属性をセットしてください。" +#. Tag: para +#: performance.xml:535 +#, no-c-format +msgid "" +"To enable lazy property loading, set the <literal>lazy</literal> attribute " +"on your particular property mappings:" +msgstr "" +"遅延プロパティ読み込みを有効にするには、対象のプロパティのマッピングで " +"<literal>lazy</literal> 属性をセットしてください。" -#: index.docbook:540 +#. Tag: programlisting +#: performance.xml:540 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Document\">\n" - " <id name=\"id\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\" length=\"50\"/>\n" - " <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=\"true\"/>\n" - " <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=\"true\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"Document\">\n" +" <id name=\"id\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"name\" not-null=\"true\" length=\"50\"/>\n" +" <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=\"true" +"\"/>\n" +" <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=\"true\"/" +">\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Document\"> -\n" - " <id name=\"id\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"name\" not-null=\"true\" length=\"50\"/> -\n" - " <property name=\"summary\" not-null=\"true\" length=\"200\" lazy=\"true\"/> -\n" - " <property name=\"text\" not-null=\"true\" length=\"2000\" lazy=\"true\"/> -\n" - "</class>]]>" -#: index.docbook:542 -msgid "Lazy property loading requires buildtime bytecode instrumentation! If your persistent classes are not enhanced, Hibernate will silently ignore lazy property settings and fall back to immediate fetching." -msgstr "遅延プロパティ読み込みはビルド時のバイトコード組み込みを必要とします！もし 永続クラスに組み込みがされていないなら、Hibernateは黙って遅延プロパティの設定を無視して、 即時フェッチに戻します。" +#. Tag: para +#: performance.xml:542 +#, no-c-format +msgid "" +"Lazy property loading requires buildtime bytecode instrumentation! If your " +"persistent classes are not enhanced, Hibernate will silently ignore lazy " +"property settings and fall back to immediate fetching." +msgstr "" +"遅延プロパティ読み込みはビルド時のバイトコード組み込みを必要とします！もし 永" +"続クラスに組み込みがされていないなら、Hibernateは黙って遅延プロパティの設定を" +"無視して、 即時フェッチに戻します。" -#: index.docbook:548 +#. Tag: para +#: performance.xml:548 +#, no-c-format msgid "For bytecode instrumentation, use the following Ant task:" msgstr "バイトコード組み込みは以下のAntタスクを使ってください。" -#: index.docbook:552 +#. Tag: programlisting +#: performance.xml:552 +#, no-c-format msgid "" - "<![CDATA[<target name=\"instrument\" depends=\"compile\">\n" - " <taskdef name=\"instrument\" classname=\"org.hibernate.tool.instrument.InstrumentTask\">\n" - " <classpath path=\"${jar.path}\"/>\n" - " <classpath path=\"${classes.dir}\"/>\n" - " <classpath refid=\"lib.class.path\"/>\n" - " </taskdef>\n" - "\n" - " <instrument verbose=\"true\">\n" - " <fileset dir=\"${testclasses.dir}/org/hibernate/auction/model\">\n" - " <include name=\"*.class\"/>\n" - " </fileset>\n" - " </instrument>\n" - "</target>]]>" +"<![CDATA[<target name=\"instrument\" depends=\"compile\">\n" +" <taskdef name=\"instrument\" classname=\"org.hibernate.tool.instrument." +"InstrumentTask\">\n" +" <classpath path=\"${jar.path}\"/>\n" +" <classpath path=\"${classes.dir}\"/>\n" +" <classpath refid=\"lib.class.path\"/>\n" +" </taskdef>\n" +"\n" +" <instrument verbose=\"true\">\n" +" <fileset dir=\"${testclasses.dir}/org/hibernate/auction/model\">\n" +" <include name=\"*.class\"/>\n" +" </fileset>\n" +" </instrument>\n" +"</target>]]>" msgstr "" - "<![CDATA[<target name=\"instrument\" depends=\"compile\"> -\n" - " <taskdef name=\"instrument\" classname=\"org.hibernate.tool.instrument.InstrumentTask\"> -\n" - " <classpath path=\"${jar.path}\"/> -\n" - " <classpath path=\"${classes.dir}\"/> -\n" - " <classpath refid=\"lib.class.path\"/> -\n" - " </taskdef> -\n" - " -\n" - " <instrument verbose=\"true\"> -\n" - " <fileset dir=\"${testclasses.dir}/org/hibernate/auction/model\"> -\n" - " <include name=\"*.class\"/> -\n" - " </fileset> -\n" - " </instrument> -\n" - "</target>]]>" -#: index.docbook:554 -msgid "A different (better?) way to avoid unnecessary column reads, at least for read-only transactions is to use the projection features of HQL or Criteria queries. This avoids the need for buildtime bytecode processing and is certainly a prefered solution." -msgstr "不要な列を読み込まないための、別の（よりよい？）方法は、少なくとも 読み込みのみのトランザクションにおいては、HQLやCriteriaクエリの射影 機能を使うことです。この方法はビルド時のバイトコード組み込みが不要になり、 より良い解決方法です。" +#. Tag: para +#: performance.xml:554 +#, no-c-format +msgid "" +"A different (better?) way to avoid unnecessary column reads, at least for " +"read-only transactions is to use the projection features of HQL or Criteria " +"queries. This avoids the need for buildtime bytecode processing and is " +"certainly a prefered solution." +msgstr "" +"不要な列を読み込まないための、別の（よりよい？）方法は、少なくとも 読み込みの" +"みのトランザクションにおいては、HQLやCriteriaクエリの射影 機能を使うことで" +"す。この方法はビルド時のバイトコード組み込みが不要になり、 より良い解決方法で" +"す。" -#: index.docbook:561 -msgid "You may force the usual eager fetching of properties using <literal>fetch all properties</literal> in HQL." -msgstr "HQLで <literal>fetch all properties</literal> を使うことで、普通どおりの プロパティの即時フェッチングを強制することが出来ます。" +#. Tag: para +#: performance.xml:561 +#, no-c-format +msgid "" +"You may force the usual eager fetching of properties using <literal>fetch " +"all properties</literal> in HQL." +msgstr "" +"HQLで <literal>fetch all properties</literal> を使うことで、普通どおりの プロ" +"パティの即時フェッチングを強制することが出来ます。" -#: index.docbook:571 +#. Tag: title +#: performance.xml:571 +#, no-c-format msgid "The Second Level Cache" msgstr "第2レベルキャッシュ" -#: index.docbook:573 -msgid "A Hibernate <literal>Session</literal> is a transaction-level cache of persistent data. It is possible to configure a cluster or JVM-level (<literal>SessionFactory</literal>-level) cache on a class-by-class and collection-by-collection basis. You may even plug in a clustered cache. Be careful. Caches are never aware of changes made to the persistent store by another application (though they may be configured to regularly expire cached data)." -msgstr "Hibernateの <literal>Session</literal> は永続データのトランザクションレベルのキャッシュです。 class-by-classとcollection-by-collectionごとの、クラスタレベルやJVMレベル （ <literal>SessionFactory</literal> レベル）のキャッシュを設定することが出来ます。 クラスタ化されたキャッシュにつなぐことさえ出来ます。しかし注意してください。 キャッシュは他のアプリケーションによる永続層の変更を 考慮しません（キャッシュデータを定期的に期限切れにする設定は出来ます）。" +#. Tag: para +#: performance.xml:573 +#, no-c-format +msgid "" +"A Hibernate <literal>Session</literal> is a transaction-level cache of " +"persistent data. It is possible to configure a cluster or JVM-level " +"(<literal>SessionFactory</literal>-level) cache on a class-by-class and " +"collection-by-collection basis. You may even plug in a clustered cache. Be " +"careful. Caches are never aware of changes made to the persistent store by " +"another application (though they may be configured to regularly expire " +"cached data)." +msgstr "" +"Hibernateの <literal>Session</literal> は永続データのトランザクションレベルの" +"キャッシュです。 class-by-classとcollection-by-collectionごとの、クラスタレベ" +"ルやJVMレベル （ <literal>SessionFactory</literal> レベル）のキャッシュを設定" +"することが出来ます。 クラスタ化されたキャッシュにつなぐことさえ出来ます。しか" +"し注意してください。 キャッシュは他のアプリケーションによる永続層の変更を 考" +"慮しません（キャッシュデータを定期的に期限切れにする設定は出来ます）。" -#: index.docbook:581 -msgid "You have the option to tell Hibernate which caching implementation to use by specifying the name of a class that implements <literal>org.hibernate.cache.CacheProvider</literal> using the property <literal>hibernate.cache.provider_class</literal>. Hibernate comes bundled with a number of built-in integrations with open-source cache providers (listed below); additionally, you could implement your own and plug it in as outlined above. Note that versions prior to 3.2 defaulted to use EhCache as the default cache provider; that is no longer the case as of 3.2." -msgstr "Hibernateが使用するキャッシュ実装は、<literal>hibernate.cache.provider_class</literal> プロパティに <literal>org.hibernate.cache.CacheProvider</literal> を実装したクラス名を指定することで変更できます。 Hibernateは多くのオープンソースのキャッシュプロバイダをビルトイン実装で持っています（後にリストがあります）。 加えて、前に説明したように、あなた自身が独自の実装をして、それを組み込むことも出来ます。 バージョン3.2より前ではEhCacheがデフォルトのキャッシュプロバイダであることに注意してください。 バージョン3.2ではこれは当てはまりません。" +#. Tag: para +#: performance.xml:581 +#, no-c-format +msgid "" +"You have the option to tell Hibernate which caching implementation to use by " +"specifying the name of a class that implements <literal>org.hibernate.cache." +"CacheProvider</literal> using the property <literal>hibernate.cache." +"provider_class</literal>. Hibernate comes bundled with a number of built-in " +"integrations with open-source cache providers (listed below); additionally, " +"you could implement your own and plug it in as outlined above. Note that " +"versions prior to 3.2 defaulted to use EhCache as the default cache " +"provider; that is no longer the case as of 3.2." +msgstr "" +"Hibernateが使用するキャッシュ実装は、<literal>hibernate.cache." +"provider_class</literal> プロパティに <literal>org.hibernate.cache." +"CacheProvider</literal> を実装したクラス名を指定することで変更できます。 " +"Hibernateは多くのオープンソースのキャッシュプロバイダをビルトイン実装で持って" +"います（後にリストがあります）。 加えて、前に説明したように、あなた自身が独自" +"の実装をして、それを組み込むことも出来ます。 バージョン3.2より前ではEhCacheが" +"デフォルトのキャッシュプロバイダであることに注意してください。 バージョン3.2" +"ではこれは当てはまりません。" -#: index.docbook:592 +#. Tag: title +#: performance.xml:592 +#, no-c-format msgid "Cache Providers" msgstr "キャッシュプロバイダ" -#: index.docbook:601, index.docbook:774 +#. Tag: entry +#: performance.xml:601 performance.xml:774 +#, no-c-format msgid "Cache" msgstr "キャッシュ" -#: index.docbook:602 +#. Tag: entry +#: performance.xml:602 +#, no-c-format msgid "Provider class" msgstr "プロバイダクラス" -#: index.docbook:603 +#. Tag: entry +#: performance.xml:603 +#, no-c-format msgid "Type" -msgstr "<entry>タイプ</entry>" +msgstr "タイプ" -#: index.docbook:604 +#. Tag: entry +#: performance.xml:604 +#, no-c-format msgid "Cluster Safe" msgstr "クラスタセーフ" -#: index.docbook:605 +#. Tag: entry +#: performance.xml:605 +#, no-c-format msgid "Query Cache Supported" msgstr "クエリキャッシュのサポート" -#: index.docbook:610, index.docbook:783 +#. Tag: entry +#: performance.xml:610 performance.xml:783 +#, no-c-format msgid "Hashtable (not intended for production use)" msgstr "Hashtable（製品用として意図していません）" -#: index.docbook:611 +#. Tag: literal +#: performance.xml:611 +#, no-c-format msgid "org.hibernate.cache.HashtableCacheProvider" msgstr "org.hibernate.cache.HashtableCacheProvider" -#: index.docbook:612 +#. Tag: entry +#: performance.xml:612 +#, no-c-format msgid "memory" -msgstr "<entry>メモリ</entry>" +msgstr "メモリ" -#: index.docbook:614, index.docbook:621, index.docbook:628, index.docbook:784, index.docbook:785, index.docbook:786, index.docbook:791, index.docbook:792, index.docbook:793, index.docbook:798, index.docbook:799, index.docbook:800, index.docbook:805, index.docbook:806, index.docbook:812, index.docbook:815 +#. Tag: entry +#: performance.xml:614 performance.xml:621 performance.xml:628 +#: performance.xml:784 performance.xml:785 performance.xml:786 +#: performance.xml:791 performance.xml:792 performance.xml:793 +#: performance.xml:798 performance.xml:799 performance.xml:800 +#: performance.xml:805 performance.xml:806 performance.xml:812 +#: performance.xml:815 +#, no-c-format msgid "<entry>yes</entry>" -msgstr "<entry>yes</entry>" +msgstr "" -#: index.docbook:617, index.docbook:790 +#. Tag: entry +#: performance.xml:617 performance.xml:790 +#, no-c-format msgid "EHCache" msgstr "EHCache" -#: index.docbook:618 +#. Tag: literal +#: performance.xml:618 +#, no-c-format msgid "org.hibernate.cache.EhCacheProvider" msgstr "org.hibernate.cache.EhCacheProvider" -#: index.docbook:619, index.docbook:626 +#. Tag: entry +#: performance.xml:619 performance.xml:626 +#, no-c-format msgid "memory, disk" msgstr "メモリ、ディスク" -#: index.docbook:624, index.docbook:797 +#. Tag: entry +#: performance.xml:624 performance.xml:797 +#, no-c-format msgid "OSCache" msgstr "OSCache" -#: index.docbook:625 +#. Tag: literal +#: performance.xml:625 +#, no-c-format msgid "org.hibernate.cache.OSCacheProvider" msgstr "org.hibernate.cache.OSCacheProvider" -#: index.docbook:631, index.docbook:804 +#. Tag: entry +#: performance.xml:631 performance.xml:804 +#, no-c-format msgid "SwarmCache" -msgstr "<entry>yes</entry>" +msgstr "SwarmCache" -#: index.docbook:632 +#. Tag: literal +#: performance.xml:632 +#, no-c-format msgid "org.hibernate.cache.SwarmCacheProvider" -msgstr "SwarmCache" +msgstr "org.hibernate.cache.SwarmCacheProvider" -#: index.docbook:633 +#. Tag: entry +#: performance.xml:633 +#, no-c-format msgid "clustered (ip multicast)" -msgstr "org.hibernate.cache.SwarmCacheProvider" +msgstr "クラスタ（ipマルチキャスト）" -#: index.docbook:634 +#. Tag: entry +#: performance.xml:634 +#, no-c-format msgid "yes (clustered invalidation)" -msgstr "クラスタ（ipマルチキャスト）" +msgstr "yes（クラスタ無効化）" -#: index.docbook:638, index.docbook:811 +#. Tag: entry +#: performance.xml:638 performance.xml:811 +#, no-c-format msgid "JBoss TreeCache" -msgstr "yes（クラスタ無効化）" +msgstr "JBoss TreeCache" -#: index.docbook:639 +#. Tag: literal +#: performance.xml:639 +#, no-c-format msgid "org.hibernate.cache.TreeCacheProvider" -msgstr "JBoss TreeCache" +msgstr "org.hibernate.cache.TreeCacheProvider" -#: index.docbook:640 +#. Tag: entry +#: performance.xml:640 +#, no-c-format msgid "clustered (ip multicast), transactional" -msgstr "org.hibernate.cache.TreeCacheProvider" +msgstr "クラスタ（ipマルチキャスト）、トランザクショナル" -#: index.docbook:641 +#. Tag: entry +#: performance.xml:641 +#, no-c-format msgid "yes (replication)" -msgstr "クラスタ（ipマルチキャスト）、トランザクショナル" +msgstr "yes（複製）" -#: index.docbook:642 +#. Tag: entry +#: performance.xml:642 +#, no-c-format msgid "yes (clock sync req.)" -msgstr "yes（複製）" +msgstr "yes（時刻同期が必要）" -#: index.docbook:649 +#. Tag: title +#: performance.xml:649 +#, no-c-format msgid "Cache mappings" -msgstr "yes（時刻同期が必要）" - -#: index.docbook:651 -msgid "The <literal>&lt;cache&gt;</literal> element of a class or collection mapping has the following form:" msgstr "キャッシュのマッピング" -#: index.docbook:662 +#. Tag: para +#: performance.xml:651 +#, no-c-format msgid "" - "<![CDATA[<cache \n" - " usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n" - " region=\"RegionName\"\n" - " include=\"all|non-lazy\"\n" - "/>]]>" -msgstr "クラスやコレクションのマッピングの <literal>&lt;cache&gt;</literal> 要素は以下の形式です。" +"The <literal>&lt;cache&gt;</literal> element of a class or collection " +"mapping has the following form:" +msgstr "" +"クラスやコレクションのマッピングの <literal>&lt;cache&gt;</literal> 要素は以" +"下の形式です。" -#: index.docbook:665 -msgid "<literal>usage</literal> (required) specifies the caching strategy: <literal>transactional</literal>, <literal>read-write</literal>, <literal>nonstrict-read-write</literal> or <literal>read-only</literal>" +#. Tag: programlisting +#: performance.xml:662 +#, no-c-format +msgid "" +"<![CDATA[<cache \n" +" usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n" +" region=\"RegionName\"\n" +" include=\"all|non-lazy\"\n" +"/>]]>" msgstr "" - "<![CDATA[<cache -\n" - " usage=\"transactional|read-write|nonstrict-read-write|read-only\" -\n" - " region=\"RegionName\" -\n" - " include=\"all|non-lazy\" -\n" - "/>]]>" -#: index.docbook:674 -msgid "<literal>region</literal> (optional, defaults to the class or collection role name) specifies the name of the second level cache region" -msgstr "<literal>usage</literal> (required) specifies the caching strategy: <literal>transactional</literal>, <literal>read-write</literal>, <literal>nonstrict-read-write</literal> or <literal>read-only</literal>" +#. Tag: para +#: performance.xml:665 +#, no-c-format +msgid "" +"<literal>usage</literal> (required) specifies the caching strategy: " +"<literal>transactional</literal>, <literal>read-write</literal>, " +"<literal>nonstrict-read-write</literal> or <literal>read-only</literal>" +msgstr "" +"<literal>usage</literal> (required) specifies the caching strategy: " +"<literal>transactional</literal>, <literal>read-write</literal>, " +"<literal>nonstrict-read-write</literal> or <literal>read-only</literal>" -#: index.docbook:681 -msgid "<literal>include</literal> (optional, defaults to <literal>all</literal>) <literal>non-lazy</literal> specifies that properties of the entity mapped with <literal>lazy=\"true\"</literal> may not be cached when attribute-level lazy fetching is enabled" -msgstr "<literal>region</literal> (optional, defaults to the class or collection role name) specifies the name of the second level cache region" +#. Tag: para +#: performance.xml:674 +#, no-c-format +msgid "" +"<literal>region</literal> (optional, defaults to the class or collection " +"role name) specifies the name of the second level cache region" +msgstr "" +"<literal>region</literal> (optional, defaults to the class or collection " +"role name) specifies the name of the second level cache region" -#: index.docbook:691 -msgid "Alternatively (preferrably?), you may specify <literal>&lt;class-cache&gt;</literal> and <literal>&lt;collection-cache&gt;</literal> elements in <literal>hibernate.cfg.xml</literal>." -msgstr "<literal>include</literal> (optional, defaults to <literal>all</literal>) <literal>non-lazy</literal> specifies that properties of the entity mapped with <literal>lazy=\"true\"</literal> may not be cached when attribute-level lazy fetching is enabled" +#. Tag: para +#: performance.xml:681 +#, no-c-format +msgid "" +"<literal>include</literal> (optional, defaults to <literal>all</literal>) " +"<literal>non-lazy</literal> specifies that properties of the entity mapped " +"with <literal>lazy=\"true\"</literal> may not be cached when attribute-level " +"lazy fetching is enabled" +msgstr "" +"<literal>include</literal> (optional, defaults to <literal>all</literal>) " +"<literal>non-lazy</literal> specifies that properties of the entity mapped " +"with <literal>lazy=\"true\"</literal> may not be cached when attribute-level " +"lazy fetching is enabled" -#: index.docbook:696 -msgid "The <literal>usage</literal> attribute specifies a <emphasis>cache concurrency strategy</emphasis>." -msgstr "または（よりよい方法として？）、 <literal>hibernate.cfg.xml</literal> に <literal>&lt;class-cache&gt;</literal> と <literal>&lt;collection-cache&gt;</literal> 要素を指定することも出来ます。" +#. Tag: para +#: performance.xml:691 +#, no-c-format +msgid "" +"Alternatively (preferrably?), you may specify <literal>&lt;class-cache&gt;</" +"literal> and <literal>&lt;collection-cache&gt;</literal> elements in " +"<literal>hibernate.cfg.xml</literal>." +msgstr "" +"または（よりよい方法として？）、 <literal>hibernate.cfg.xml</literal> に " +"<literal>&lt;class-cache&gt;</literal> と <literal>&lt;collection-cache&gt;</" +"literal> 要素を指定することも出来ます。" -#: index.docbook:703 +#. Tag: para +#: performance.xml:696 +#, no-c-format +msgid "" +"The <literal>usage</literal> attribute specifies a <emphasis>cache " +"concurrency strategy</emphasis>." +msgstr "" +"<literal>usage</literal> 属性は <emphasis>キャッシュの並列性戦略</emphasis> " +"を指定します。" + +#. Tag: title +#: performance.xml:703 +#, no-c-format msgid "Strategy: read only" -msgstr "<literal>usage</literal> 属性は <emphasis>キャッシュの並列性戦略</emphasis> を指定します。" - -#: index.docbook:705 -msgid "If your application needs to read but never modify instances of a persistent class, a <literal>read-only</literal> cache may be used. This is the simplest and best performing strategy. It's even perfectly safe for use in a cluster." msgstr "read only戦略" -#: index.docbook:711 +#. Tag: para +#: performance.xml:705 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n" - " <cache usage=\"read-only\"/>\n" - " ....\n" - "</class>]]>" -msgstr "もしアプリケーションが読み込みのみ必要で、永続クラスのインスタンスを変更しないなら、 <literal>read-only</literal> キャッシュを使うことが出来ます。これはもっとも単純で もっともパフォーマンスの良い戦略です。クラスタでの使用も完全に安全です。" +"If your application needs to read but never modify instances of a persistent " +"class, a <literal>read-only</literal> cache may be used. This is the " +"simplest and best performing strategy. It's even perfectly safe for use in a " +"cluster." +msgstr "" +"もしアプリケーションが読み込みのみ必要で、永続クラスのインスタンスを変更しな" +"いなら、 <literal>read-only</literal> キャッシュを使うことが出来ます。これは" +"もっとも単純で もっともパフォーマンスの良い戦略です。クラスタでの使用も完全に" +"安全です。" -#: index.docbook:717 -msgid "Strategy: read/write" +#. Tag: programlisting +#: performance.xml:711 +#, no-c-format +msgid "" +"<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n" +" <cache usage=\"read-only\"/>\n" +" ....\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\"> -\n" - " <cache usage=\"read-only\"/> -\n" - " .... -\n" - "</class>]]>" -#: index.docbook:719 -msgid "If the application needs to update data, a <literal>read-write</literal> cache might be appropriate. This cache strategy should never be used if serializable transaction isolation level is required. If the cache is used in a JTA environment, you must specify the property <literal>hibernate.transaction.manager_lookup_class</literal>, naming a strategy for obtaining the JTA <literal>TransactionManager</literal>. In other environments, you should ensure that the transaction is completed when <literal>Session.close()</literal> or <literal>Session.disconnect()</literal> is called. If you wish to use this strategy in a cluster, you should ensure that the underlying cache implementation supports locking. The built-in cache providers do <emphasis>not</emphasis>." +#. Tag: title +#: performance.xml:717 +#, no-c-format +msgid "Strategy: read/write" msgstr "read/write戦略" -#: index.docbook:730 +#. Tag: para +#: performance.xml:719 +#, no-c-format msgid "" - "<![CDATA[<class name=\"eg.Cat\" .... >\n" - " <cache usage=\"read-write\"/>\n" - " ....\n" - " <set name=\"kittens\" ... >\n" - " <cache usage=\"read-write\"/>\n" - " ....\n" - " </set>\n" - "</class>]]>" -msgstr "アプリケーションがデータを更新する必要があるなら、 <literal>read-write</literal> キャッシュが適当かも しれません。このキャッシュ戦略は、シリアライザブルなトランザクション分離レベルが要求されるなら、 決して使うべきではありません。もしキャッシュがJTA環境で使われるなら、JTA <literal>TransactionManager</literal> を取得するための方法を示す <literal>hibernate.transaction.manager_lookup_class</literal> プロパティを指定しなければなりません。他の環境では、 <literal>Session.close()</literal> や <literal>Session.disconnect()</literal> が呼ばれたときに、確実にトランザクションが完了 していなければなりません。 もしクラスタでこの戦略を使いたいなら、基となるキャッシュの実装がロックをサポート していることを保証しなければなりません。 �! �み込みのキャッシュプロバイダは <emphasis>サポートしていません</emphasis> 。" +"If the application needs to update data, a <literal>read-write</literal> " +"cache might be appropriate. This cache strategy should never be used if " +"serializable transaction isolation level is required. If the cache is used " +"in a JTA environment, you must specify the property <literal>hibernate." +"transaction.manager_lookup_class</literal>, naming a strategy for obtaining " +"the JTA <literal>TransactionManager</literal>. In other environments, you " +"should ensure that the transaction is completed when <literal>Session.close()" +"</literal> or <literal>Session.disconnect()</literal> is called. If you wish " +"to use this strategy in a cluster, you should ensure that the underlying " +"cache implementation supports locking. The built-in cache providers do " +"<emphasis>not</emphasis>." +msgstr "" +"アプリケーションがデータを更新する必要があるなら、 <literal>read-write</" +"literal> キャッシュが適当かも しれません。このキャッシュ戦略は、シリアライザ" +"ブルなトランザクション分離レベルが要求されるなら、 決して使うべきではありませ" +"ん。もしキャッシュがJTA環境で使われるなら、JTA <literal>TransactionManager</" +"literal> を取得するための方法を示す <literal>hibernate.transaction." +"manager_lookup_class</literal> プロパティを指定しなければなりません。他の環境" +"では、 <literal>Session.close()</literal> や <literal>Session.disconnect()</" +"literal> が呼ばれたときに、確実にトランザクションが完了 していなければなりま" +"せん。 もしクラスタでこの戦略を使いたいなら、基となるキャッシュの実装がロック" +"をサポート していることを保証しなければなりません。 組み込みのキャッシュプロ" +"バイダは <emphasis>サポートしていません</emphasis> 。" -#: index.docbook:735 -msgid "Strategy: nonstrict read/write" +#. Tag: programlisting +#: performance.xml:730 +#, no-c-format +msgid "" +"<![CDATA[<class name=\"eg.Cat\" .... >\n" +" <cache usage=\"read-write\"/>\n" +" ....\n" +" <set name=\"kittens\" ... >\n" +" <cache usage=\"read-write\"/>\n" +" ....\n" +" </set>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"eg.Cat\" .... > -\n" - " <cache usage=\"read-write\"/> -\n" - " .... -\n" - " <set name=\"kittens\" ... > -\n" - " <cache usage=\"read-write\"/> -\n" - " .... -\n" - " </set> -\n" - "</class>]]>" -#: index.docbook:737 -msgid "If the application only occasionally needs to update data (ie. if it is extremely unlikely that two transactions would try to update the same item simultaneously) and strict transaction isolation is not required, a <literal>nonstrict-read-write</literal> cache might be appropriate. If the cache is used in a JTA environment, you must specify <literal>hibernate.transaction.manager_lookup_class</literal>. In other environments, you should ensure that the transaction is completed when <literal>Session.close()</literal> or <literal>Session.disconnect()</literal> is called." +#. Tag: title +#: performance.xml:735 +#, no-c-format +msgid "Strategy: nonstrict read/write" msgstr "厳密ではないread/write戦略" -#: index.docbook:749 +#. Tag: para +#: performance.xml:737 +#, no-c-format +msgid "" +"If the application only occasionally needs to update data (ie. if it is " +"extremely unlikely that two transactions would try to update the same item " +"simultaneously) and strict transaction isolation is not required, a " +"<literal>nonstrict-read-write</literal> cache might be appropriate. If the " +"cache is used in a JTA environment, you must specify <literal>hibernate." +"transaction.manager_lookup_class</literal>. In other environments, you " +"should ensure that the transaction is completed when <literal>Session.close()" +"</literal> or <literal>Session.disconnect()</literal> is called." +msgstr "" +"アプリケーションがたまにしかデータを更新する必要はなく（すなわち二つのトラン" +"ザクションが 同時に同じアイテムを更新しようとすることはほとんど起こらない）、" +"厳密なトランザクション分離が 要求されないなら、 <literal>nonstrict-read-" +"write</literal> キャッシュが適当かもしれません。 もしキャッシュがJTA環境で使" +"われるなら、 <literal>hibernate.transaction.manager_lookup_class</literal> を" +"指定しなければなりません。他の環境では、 <literal>Session.close()</literal> " +"や <literal>Session.disconnect()</literal> が呼ばれたときに、確実にトランザク" +"ションが完了 していなければなりません。" + +#. Tag: title +#: performance.xml:749 +#, no-c-format msgid "Strategy: transactional" -msgstr "アプリケーションがたまにしかデータを更新する必要はなく（すなわち二つのトランザクションが 同時に同じアイテムを更新しようとすることはほとんど起こらない）、厳密なトランザクション分離が 要求されないなら、 <literal>nonstrict-read-write</literal> キャッシュが適当かもしれません。 もしキャッシュがJTA環境で使われるなら、 <literal>hibernate.transaction.manager_lookup_class</literal> を指定しなければなりません。他の環境では、 <literal>Session.close()</literal> や <literal>Session.disconnect()</literal> が呼ばれたときに、確実にトランザクションが完了 していなければなりません。" - -#: index.docbook:751 -msgid "The <literal>transactional</literal> cache strategy provides support for fully transactional cache providers such as JBoss TreeCache. Such a cache may only be used in a JTA environment and you must specify <literal>hibernate.transaction.manager_lookup_class</literal>." msgstr "transactional戦略" -#: index.docbook:759 -msgid "None of the cache providers support all of the cache concurrency strategies. The following table shows which providers are compatible with which concurrency strategies." -msgstr "<literal>transactional</literal> キャッシュ戦略はJBoss TreeCacheのような完全なトランザクショナル キャッシュプロバイダのサポートを提供します。 このようなキャッシュはJTA環境でのみ使用可能で、 <literal>hibernate.transaction.manager_lookup_class</literal> を指定しなければなりません。" +#. Tag: para +#: performance.xml:751 +#, no-c-format +msgid "" +"The <literal>transactional</literal> cache strategy provides support for " +"fully transactional cache providers such as JBoss TreeCache. Such a cache " +"may only be used in a JTA environment and you must specify " +"<literal>hibernate.transaction.manager_lookup_class</literal>." +msgstr "" +"<literal>transactional</literal> キャッシュ戦略はJBoss TreeCacheのような完全" +"なトランザクショナル キャッシュプロバイダのサポートを提供します。 このような" +"キャッシュはJTA環境でのみ使用可能で、 <literal>hibernate.transaction." +"manager_lookup_class</literal> を指定しなければなりません。" -#: index.docbook:765 +#. Tag: para +#: performance.xml:759 +#, no-c-format +msgid "" +"None of the cache providers support all of the cache concurrency strategies. " +"The following table shows which providers are compatible with which " +"concurrency strategies." +msgstr "" +"すべての同時並行性キャッシュ戦略をサポートしているキャッシュプロバイダはあり" +"ません。 以下の表はどのプロバイダがどの同時並列性戦略に対応するかを表していま" +"す。" + +#. Tag: title +#: performance.xml:765 +#, no-c-format msgid "Cache Concurrency Strategy Support" -msgstr "すべての同時並行性キャッシュ戦略をサポートしているキャッシュプロバイダはありません。 以下の表はどのプロバイダがどの同時並列性戦略に対応するかを表しています。" +msgstr "同時並行性キャッシュ戦略のサポート" -#: index.docbook:775 +#. Tag: entry +#: performance.xml:775 +#, no-c-format msgid "read-only" -msgstr "キャッシュ" +msgstr "read-only" -#: index.docbook:776 +#. Tag: entry +#: performance.xml:776 +#, no-c-format msgid "nonstrict-read-write" -msgstr "read-only" +msgstr "厳密ではないread-write" -#: index.docbook:777 +#. Tag: entry +#: performance.xml:777 +#, no-c-format msgid "read-write" -msgstr "厳密ではないread-write" +msgstr "read-write" -#: index.docbook:778 +#. Tag: entry +#: performance.xml:778 +#, no-c-format msgid "transactional" -msgstr "read-write" +msgstr "transactional" -#: index.docbook:824 +#. Tag: title +#: performance.xml:824 +#, no-c-format msgid "Managing the caches" -msgstr "<entry>yes</entry>" - -#: index.docbook:826 -msgid "Whenever you pass an object to <literal>save()</literal>, <literal>update()</literal> or <literal>saveOrUpdate()</literal> and whenever you retrieve an object using <literal>load()</literal>, <literal>get()</literal>, <literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()</literal>, that object is added to the internal cache of the <literal>Session</literal>." msgstr "キャッシュの管理" -#: index.docbook:833 -msgid "When <literal>flush()</literal> is subsequently called, the state of that object will be synchronized with the database. If you do not want this synchronization to occur or if you are processing a huge number of objects and need to manage memory efficiently, the <literal>evict()</literal> method may be used to remove the object and its collections from the first-level cache." -msgstr "オブジェクトを <literal>save()</literal> 、 <literal>update()</literal> 、 <literal>saveOrUpdate()</literal> に渡すとき、そして <literal>load()</literal> 、 <literal>get()</literal> 、 <literal>list()</literal> 、 <literal>iterate()</literal> 、 <literal>scroll()</literal> を使ってオブジェクトを復元するときには常に、 そのオブジェクトは <literal>Session</literal> の内部キャッシュに追加されます。" +#. Tag: para +#: performance.xml:826 +#, no-c-format +msgid "" +"Whenever you pass an object to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal> and whenever you retrieve an " +"object using <literal>load()</literal>, <literal>get()</literal>, " +"<literal>list()</literal>, <literal>iterate()</literal> or <literal>scroll()" +"</literal>, that object is added to the internal cache of the " +"<literal>Session</literal>." +msgstr "" +"オブジェクトを <literal>save()</literal> 、 <literal>update()</literal> 、 " +"<literal>saveOrUpdate()</literal> に渡すとき、そして <literal>load()</" +"literal> 、 <literal>get()</literal> 、 <literal>list()</literal> 、 " +"<literal>iterate()</literal> 、 <literal>scroll()</literal> を使ってオブジェ" +"クトを復元するときには常に、 そのオブジェクトは <literal>Session</literal> の" +"内部キャッシュに追加されます。" -#: index.docbook:841 +#. Tag: para +#: performance.xml:833 +#, no-c-format msgid "" - "<![CDATA[ScrollableResult cats = sess.createQuery(\"from Cat as cat\").scroll(); //a huge result set\n" - "while ( cats.next() ) {\n" - " Cat cat = (Cat) cats.get(0);\n" - " doSomethingWithACat(cat);\n" - " sess.evict(cat);\n" - "}]]>" -msgstr "次に <literal>flush()</literal> が呼ばれると、オブジェクトの状態はデータベースと同期化されます。 もしこの同期が起こることを望まないときや、膨大な数のオブジェクトを処理していてメモリを効率的に 扱う必要があるときは、 <literal>evict()</literal> メソッドを使って一次キャッシュから オブジェクトやコレクションを削除することが出来ます。" +"When <literal>flush()</literal> is subsequently called, the state of that " +"object will be synchronized with the database. If you do not want this " +"synchronization to occur or if you are processing a huge number of objects " +"and need to manage memory efficiently, the <literal>evict()</literal> method " +"may be used to remove the object and its collections from the first-level " +"cache." +msgstr "" +"次に <literal>flush()</literal> が呼ばれると、オブジェクトの状態はデータベー" +"スと同期化されます。 もしこの同期が起こることを望まないときや、膨大な数のオブ" +"ジェクトを処理していてメモリを効率的に 扱う必要があるときは、 <literal>evict" +"()</literal> メソッドを使って一次キャッシュから オブジェクトやコレクションを" +"削除することが出来ます。" -#: index.docbook:843 -msgid "The <literal>Session</literal> also provides a <literal>contains()</literal> method to determine if an instance belongs to the session cache." +#. Tag: programlisting +#: performance.xml:841 +#, no-c-format +msgid "" +"<![CDATA[ScrollableResult cats = sess.createQuery(\"from Cat as cat\").scroll" +"(); //a huge result set\n" +"while ( cats.next() ) {\n" +" Cat cat = (Cat) cats.get(0);\n" +" doSomethingWithACat(cat);\n" +" sess.evict(cat);\n" +"}]]>" msgstr "" - "<![CDATA[ScrollableResult cats = sess.createQuery(\"from Cat as cat\").scroll(); //a huge result set -\n" - "while ( cats.next() ) { -\n" - " Cat cat = (Cat) cats.get(0); -\n" - " doSomethingWithACat(cat); -\n" - " sess.evict(cat); -\n" - "}]]>" -#: index.docbook:848 -msgid "To completely evict all objects from the session cache, call <literal>Session.clear()</literal>" -msgstr "<literal>Session</literal> はインスタンスがセッションキャッシュに含まれるかどうかを判断するための <literal>contains()</literal> メソッドも提供します。" +#. Tag: para +#: performance.xml:843 +#, no-c-format +msgid "" +"The <literal>Session</literal> also provides a <literal>contains()</literal> " +"method to determine if an instance belongs to the session cache." +msgstr "" +"<literal>Session</literal> はインスタンスがセッションキャッシュに含まれるかど" +"うかを判断するための <literal>contains()</literal> メソッドも提供します。" -#: index.docbook:852 -msgid "For the second-level cache, there are methods defined on <literal>SessionFactory</literal> for evicting the cached state of an instance, entire class, collection instance or entire collection role." -msgstr "すべてのオブジェクトをセッションキャッシュから完全に取り除くには、<literal>Session.clear()</literal> を呼び出してください。" +#. Tag: para +#: performance.xml:848 +#, no-c-format +msgid "" +"To completely evict all objects from the session cache, call " +"<literal>Session.clear()</literal>" +msgstr "" +"すべてのオブジェクトをセッションキャッシュから完全に取り除くには、" +"<literal>Session.clear()</literal> を呼び出してください。" -#: index.docbook:858 +#. Tag: para +#: performance.xml:852 +#, no-c-format msgid "" - "<![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular Cat\n" - "sessionFactory.evict(Cat.class); //evict all Cats\n" - "sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a particular collection of kittens\n" - "sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten collections]]>" -msgstr "二次キャッシュのために、 <literal>SessionFactory</literal> には インスタンス、クラス全体、コレクションのインスタンス、コレクション全体をキャッシュから 削除するためのメソッドがそれぞれ定義されています。" +"For the second-level cache, there are methods defined on " +"<literal>SessionFactory</literal> for evicting the cached state of an " +"instance, entire class, collection instance or entire collection role." +msgstr "" +"二次キャッシュのために、 <literal>SessionFactory</literal> には インスタン" +"ス、クラス全体、コレクションのインスタンス、コレクション全体をキャッシュから " +"削除するためのメソッドがそれぞれ定義されています。" -#: index.docbook:860 -msgid "The <literal>CacheMode</literal> controls how a particular session interacts with the second-level cache." +#. Tag: programlisting +#: performance.xml:858 +#, no-c-format +msgid "" +"<![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular Cat\n" +"sessionFactory.evict(Cat.class); //evict all Cats\n" +"sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a particular " +"collection of kittens\n" +"sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten " +"collections]]>" msgstr "" - "<![CDATA[sessionFactory.evict(Cat.class, catId); //evict a particular Cat -\n" - "sessionFactory.evict(Cat.class); //evict all Cats -\n" - "sessionFactory.evictCollection(\"Cat.kittens\", catId); //evict a particular collection of kittens -\n" - "sessionFactory.evictCollection(\"Cat.kittens\"); //evict all kitten collections]]>" -#: index.docbook:867 -msgid "<literal>CacheMode.NORMAL</literal> - read items from and write items to the second-level cache" -msgstr "<literal>CacheMode</literal> は特定のセッションが二次キャッシュとどのように相互作用するかを 指定します。" +#. Tag: para +#: performance.xml:860 +#, no-c-format +msgid "" +"The <literal>CacheMode</literal> controls how a particular session interacts " +"with the second-level cache." +msgstr "" +"<literal>CacheMode</literal> は特定のセッションが二次キャッシュとどのように相" +"互作用するかを 指定します。" -#: index.docbook:872 -msgid "<literal>CacheMode.GET</literal> - read items from the second-level cache, but don't write to the second-level cache except when updating data" -msgstr "<literal>CacheMode.NORMAL</literal> - アイテムの読み込みと書き込みで二次キャッシュを使います" +#. Tag: para +#: performance.xml:867 +#, no-c-format +msgid "" +"<literal>CacheMode.NORMAL</literal> - read items from and write items to the " +"second-level cache" +msgstr "" +"<literal>CacheMode.NORMAL</literal> - アイテムの読み込みと書き込みで二次" +"キャッシュを使います" -#: index.docbook:878 -msgid "<literal>CacheMode.PUT</literal> - write items to the second-level cache, but don't read from the second-level cache" -msgstr "<literal>CacheMode.GET</literal> - 読み込みは二次キャッシュから行いますが、データを 更新した場合を除いて二次キャッシュに書き込みをしません。" +#. Tag: para +#: performance.xml:872 +#, no-c-format +msgid "" +"<literal>CacheMode.GET</literal> - read items from the second-level cache, " +"but don't write to the second-level cache except when updating data" +msgstr "" +"<literal>CacheMode.GET</literal> - 読み込みは二次キャッシュから行いますが、" +"データを 更新した場合を除いて二次キャッシュに書き込みをしません。" -#: index.docbook:884 -msgid "<literal>CacheMode.REFRESH</literal> - write items to the second-level cache, but don't read from the second-level cache, bypass the effect of <literal>hibernate.cache.use_minimal_puts</literal>, forcing a refresh of the second-level cache for all items read from the database" -msgstr "<literal>CacheMode.PUT</literal> - 二次キャッシュにアイテムを書き込みますが、読み込みには 二次キャッシュを使いません。" +#. Tag: para +#: performance.xml:878 +#, no-c-format +msgid "" +"<literal>CacheMode.PUT</literal> - write items to the second-level cache, " +"but don't read from the second-level cache" +msgstr "" +"<literal>CacheMode.PUT</literal> - 二次キャッシュにアイテムを書き込みますが、" +"読み込みには 二次キャッシュを使いません。" -#: index.docbook:892 -msgid "To browse the contents of a second-level or query cache region, use the <literal>Statistics</literal> API:" -msgstr "<literal>CacheMode.REFRESH</literal> - 二次キャッシュにアイテムを書き込みますが、読み込みには 二次キャッシュを使わず、 <literal>hibernate.cache.use_minimal_puts</literal> の影響を受けずに、データベースから読み込むすべてのアイテムの二次キャッシュを強制的にリフレッシュします。" +#. Tag: para +#: performance.xml:884 +#, no-c-format +msgid "" +"<literal>CacheMode.REFRESH</literal> - write items to the second-level " +"cache, but don't read from the second-level cache, bypass the effect of " +"<literal>hibernate.cache.use_minimal_puts</literal>, forcing a refresh of " +"the second-level cache for all items read from the database" +msgstr "" +"<literal>CacheMode.REFRESH</literal> - 二次キャッシュにアイテムを書き込みます" +"が、読み込みには 二次キャッシュを使わず、 <literal>hibernate.cache." +"use_minimal_puts</literal> の影響を受けずに、データベースから読み込むすべての" +"アイテムの二次キャッシュを強制的にリフレッシュします。" -#: index.docbook:897 +#. Tag: para +#: performance.xml:892 +#, no-c-format msgid "" - "<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n" - " .getSecondLevelCacheStatistics(regionName)\n" - " .getEntries();]]>" -msgstr "二次キャッシュの内容やクエリキャッシュ領域を見るために、 <literal>Statistics</literal> APIを 使ってください。" +"To browse the contents of a second-level or query cache region, use the " +"<literal>Statistics</literal> API:" +msgstr "" +"二次キャッシュの内容やクエリキャッシュ領域を見るために、 " +"<literal>Statistics</literal> APIを 使ってください。" -#: index.docbook:899 -msgid "You'll need to enable statistics, and, optionally, force Hibernate to keep the cache entries in a more human-understandable format:" +#. Tag: programlisting +#: performance.xml:897 +#, no-c-format +msgid "" +"<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n" +" .getSecondLevelCacheStatistics(regionName)\n" +" .getEntries();]]>" msgstr "" - "<![CDATA[Map cacheEntries = sessionFactory.getStatistics() -\n" - " .getSecondLevelCacheStatistics(regionName) -\n" - " .getEntries();]]>" -#: index.docbook:904 +#. Tag: para +#: performance.xml:899 +#, no-c-format msgid "" - "<![CDATA[hibernate.generate_statistics true\n" - "hibernate.cache.use_structured_entries true]]>" -msgstr "統計情報を有効にして、さらにオプションとして、キャッシュエントリを 人がより理解可能な形式で保持することをHibernateに強制します。" +"You'll need to enable statistics, and, optionally, force Hibernate to keep " +"the cache entries in a more human-understandable format:" +msgstr "" +"統計情報を有効にして、さらにオプションとして、キャッシュエントリを 人がより理" +"解可能な形式で保持することをHibernateに強制します。" -#: index.docbook:909 -msgid "The Query Cache" +#. Tag: programlisting +#: performance.xml:904 +#, no-c-format +msgid "" +"<![CDATA[hibernate.generate_statistics true\n" +"hibernate.cache.use_structured_entries true]]>" msgstr "" - "<![CDATA[hibernate.generate_statistics true -\n" - "hibernate.cache.use_structured_entries true]]>" -#: index.docbook:911 -msgid "Query result sets may also be cached. This is only useful for queries that are run frequently with the same parameters. To use the query cache you must first enable it:" +#. Tag: title +#: performance.xml:909 +#, no-c-format +msgid "The Query Cache" msgstr "クエリキャッシュ" -#: index.docbook:916 +#. Tag: para +#: performance.xml:911 +#, no-c-format +msgid "" +"Query result sets may also be cached. This is only useful for queries that " +"are run frequently with the same parameters. To use the query cache you must " +"first enable it:" +msgstr "" +"クエリのリザルトセットもキャッシュ出来ます。これは同じパラメータで何度も実行" +"される クエリに対してのみ有用です。クエリキャッシュを使うには、まず設定で有効" +"にしなくてはなりません。" + +#. Tag: programlisting +#: performance.xml:916 +#, no-c-format msgid "<![CDATA[hibernate.cache.use_query_cache true]]>" -msgstr "クエリのリザルトセットもキャッシュ出来ます。これは同じパラメータで何度も実行される クエリに対してのみ有用です。クエリキャッシュを使うには、まず設定で有効にしなくてはなりません。" +msgstr "" -#: index.docbook:918 -msgid "This setting causes the creation of two new cache regions - one holding cached query result sets (<literal>org.hibernate.cache.StandardQueryCache</literal>), the other holding timestamps of the most recent updates to queryable tables (<literal>org.hibernate.cache.UpdateTimestampsCache</literal>). Note that the query cache does not cache the state of the actual entities in the result set; it caches only identifier values and results of value type. So the query cache should always be used in conjunction with the second-level cache." -msgstr "<![CDATA[hibernate.cache.use_query_cache true]]>" +#. Tag: para +#: performance.xml:918 +#, no-c-format +msgid "" +"This setting causes the creation of two new cache regions - one holding " +"cached query result sets (<literal>org.hibernate.cache.StandardQueryCache</" +"literal>), the other holding timestamps of the most recent updates to " +"queryable tables (<literal>org.hibernate.cache.UpdateTimestampsCache</" +"literal>). Note that the query cache does not cache the state of the actual " +"entities in the result set; it caches only identifier values and results of " +"value type. So the query cache should always be used in conjunction with the " +"second-level cache." +msgstr "" +"この設定は新たに二つのキャッシュ領域の作成を行います。一つはクエリのリザルト" +"セットの キャッシュ（ <literal>org.hibernate.cache.StandardQueryCache</" +"literal> ）を保持し、 もう1つはクエリ可能なテーブルへの最新の更新タイムスタン" +"プ （ <literal>org.hibernate.cache.UpdateTimestampsCache</literal> ）を保持し" +"ます。 クエリキャッシュはリザルトセットの実際の要素の状態はキャッシュしないこ" +"とに 注意してください。キャッシュするのは識別子の値と、値型の結果のみです。 " +"そのため、クエリキャッシュは常に二次キャッシュと一緒に使うべきです。" -#: index.docbook:928 -msgid "Most queries do not benefit from caching, so by default queries are not cached. To enable caching, call <literal>Query.setCacheable(true)</literal>. This call allows the query to look for existing cache results or add its results to the cache when it is executed." -msgstr "この設定は新たに二つのキャッシュ領域の作成を行います。一つはクエリのリザルトセットの キャッシュ（ <literal>org.hibernate.cache.StandardQueryCache</literal> ）を保持し、 もう1つはクエリ可能なテーブルへの最新の更新タイムスタンプ （ <literal>org.hibernate.cache.UpdateTimestampsCache</literal> ）を保持します。 クエリキャッシュはリザルトセットの実際の要素の状態はキャッシュしないことに 注意してください。キャッシュするのは識別子の値と、値型の結果のみです。 そのため、クエリキャッシュは常に二次キャッシュと一緒に使うべきです。" +#. Tag: para +#: performance.xml:928 +#, no-c-format +msgid "" +"Most queries do not benefit from caching, so by default queries are not " +"cached. To enable caching, call <literal>Query.setCacheable(true)</literal>. " +"This call allows the query to look for existing cache results or add its " +"results to the cache when it is executed." +msgstr "" +"ほとんどのクエリはキャッシュの恩恵を受けないので、デフォルトではクエリは" +"キャッシュされません。 キャッシュを有効にするには、 <literal>Query." +"setCacheable(true)</literal> を呼び出してください。 そうすればクエリが既存の" +"キャッシュ結果を探し、クエリ実行時にその結果をキャッシュに追加する ようになり" +"ます。" -#: index.docbook:935 -msgid "If you require fine-grained control over query cache expiration policies, you may specify a named cache region for a particular query by calling <literal>Query.setCacheRegion()</literal>." -msgstr "ほとんどのクエリはキャッシュの恩恵を受けないので、デフォルトではクエリはキャッシュされません。 キャッシュを有効にするには、 <literal>Query.setCacheable(true)</literal> を呼び出してください。 そうすればクエリが既存のキャッシュ結果を探し、クエリ実行時にその結果をキャッシュに追加する ようになります。" +#. Tag: para +#: performance.xml:935 +#, no-c-format +msgid "" +"If you require fine-grained control over query cache expiration policies, " +"you may specify a named cache region for a particular query by calling " +"<literal>Query.setCacheRegion()</literal>." +msgstr "" +"クエリキャッシュの破棄ポリシーを細かく制御したいときは、 <literal>Query." +"setCacheRegion()</literal> を呼び出して特定のクエリに対するキャッシュ領域を指" +"定することが出来ます。" -#: index.docbook:941 +#. Tag: programlisting +#: performance.xml:941 +#, no-c-format msgid "" - "<![CDATA[List blogs = sess.createQuery(\"from Blog blog where blog.blogger = :blogger\")\n" - " .setEntity(\"blogger\", blogger)\n" - " .setMaxResults(15)\n" - " .setCacheable(true)\n" - " .setCacheRegion(\"frontpages\")\n" - " .list();]]>" -msgstr "クエリキャッシュの破棄ポリシーを細かく制御したいときは、 <literal>Query.setCacheRegion()</literal> を呼び出して特定のクエリに対するキャッシュ領域を指定することが出来ます。" +"<![CDATA[List blogs = sess.createQuery(\"from Blog blog where blog.blogger " +"= :blogger\")\n" +" .setEntity(\"blogger\", blogger)\n" +" .setMaxResults(15)\n" +" .setCacheable(true)\n" +" .setCacheRegion(\"frontpages\")\n" +" .list();]]>" +msgstr "" -#: index.docbook:943 -msgid "If the query should force a refresh of its query cache region, you should call <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is particularly useful in cases where underlying data may have been updated via a separate process (i.e., not modified through Hibernate) and allows the application to selectively refresh particular query result sets. This is a more efficient alternative to eviction of a query cache region via <literal>SessionFactory.evictQueries()</literal>." +#. Tag: para +#: performance.xml:943 +#, no-c-format +msgid "" +"If the query should force a refresh of its query cache region, you should " +"call <literal>Query.setCacheMode(CacheMode.REFRESH)</literal>. This is " +"particularly useful in cases where underlying data may have been updated via " +"a separate process (i.e., not modified through Hibernate) and allows the " +"application to selectively refresh particular query result sets. This is a " +"more efficient alternative to eviction of a query cache region via " +"<literal>SessionFactory.evictQueries()</literal>." msgstr "" - "<![CDATA[List blogs = sess.createQuery(\"from Blog blog where blog.blogger = :blogger\") -\n" - " .setEntity(\"blogger\", blogger) -\n" - " .setMaxResults(15) -\n" - " .setCacheable(true) -\n" - " .setCacheRegion(\"frontpages\") -\n" - " .list();]]>" +"クエリが自身のクエリキャッシュ領域のリフレッシュを強制しなければならないな" +"ら、 <literal>Query.setCacheMode(CacheMode.REFRESH)</literal> を呼び出すべき" +"です。これは 元となるデータが別のプロセスによって更新されたり（すなわち" +"Hibernateを通じて更新されない）、 アプリケーションに特定のクエリリザルトセッ" +"トを選択してリフレッシュさせる場合に特に有用です。 さらに有用なもう一つの方法" +"は、 <literal>SessionFactory.evictQueries()</literal> によってクエリキャッ" +"シュ領域を消去することです。" -#: index.docbook:955 +#. Tag: title +#: performance.xml:955 +#, no-c-format msgid "Understanding Collection performance" -msgstr "クエリが自身のクエリキャッシュ領域のリフレッシュを強制しなければならないなら、 <literal>Query.setCacheMode(CacheMode.REFRESH)</literal> を呼び出すべきです。これは 元となるデータが別のプロセスによって更新されたり（すなわちHibernateを通じて更新されない）、 アプリケーションに特定のクエリリザルトセットを選択してリフレッシュさせる場合に特に有用です。 さらに有用なもう一つの方法は、 <literal>SessionFactory.evictQueries()</literal> によってクエリキャッシュ領域を消去することです。" +msgstr "コレクションのパフォーマンスの理解" -#: index.docbook:957 -msgid "We've already spent quite some time talking about collections. In this section we will highlight a couple more issues about how collections behave at runtime." -msgstr "☆14.1" +#. Tag: para +#: performance.xml:957 +#, no-c-format +msgid "" +"We've already spent quite some time talking about collections. In this " +"section we will highlight a couple more issues about how collections behave " +"at runtime." +msgstr "" +"コレクションの話題にはすでに多くの時間を使いました。この節では コレクションが" +"実行時にどのように振舞うかについての話題を2、3取り上げます。" -#: index.docbook:964 +#. Tag: title +#: performance.xml:964 +#, no-c-format msgid "Taxonomy" -msgstr "コレクションのパフォーマンスの理解" +msgstr "分類" -#: index.docbook:966 +#. Tag: para +#: performance.xml:966 +#, no-c-format msgid "Hibernate defines three basic kinds of collections:" -msgstr "コレクションの話題にはすでに多くの時間を使いました。この節では コレクションが実行時にどのように振舞うかについての話題を2、3取り上げます。" +msgstr "Hibernateは3つの基本的なコレクションの種類を定義しています。" -#: index.docbook:970 +#. Tag: para +#: performance.xml:970 +#, no-c-format msgid "collections of values" -msgstr "<title>分類</title>" +msgstr "値のコレクション" -#: index.docbook:973 +#. Tag: para +#: performance.xml:973 +#, no-c-format msgid "one to many associations" -msgstr "Hibernateは3つの基本的なコレクションの種類を定義しています。" +msgstr "一対多関連" -#: index.docbook:976 +#. Tag: para +#: performance.xml:976 +#, no-c-format msgid "many to many associations" -msgstr "値のコレクション" +msgstr "多対多関連" -#: index.docbook:980 -msgid "This classification distinguishes the various table and foreign key relationships but does not tell us quite everything we need to know about the relational model. To fully understand the relational structure and performance characteristics, we must also consider the structure of the primary key that is used by Hibernate to update or delete collection rows. This suggests the following classification:" -msgstr "一対多関連" +#. Tag: para +#: performance.xml:980 +#, no-c-format +msgid "" +"This classification distinguishes the various table and foreign key " +"relationships but does not tell us quite everything we need to know about " +"the relational model. To fully understand the relational structure and " +"performance characteristics, we must also consider the structure of the " +"primary key that is used by Hibernate to update or delete collection rows. " +"This suggests the following classification:" +msgstr "" +"この分類はさまざまなテーブルや外部キー関連を区別しますが、私たちが知る必要の" +"ある 関連モデルについてほとんどなにも教えてくれません。関連構造やパフォーマン" +"スの特徴を 完全に理解するには、Hibernateがコレクションの行を更新、削除するた" +"めに使う主キーの 構造もまた考えなければなりません。これは以下の分類を提示しま" +"す。" -#: index.docbook:991 +#. Tag: para +#: performance.xml:991 +#, no-c-format msgid "indexed collections" -msgstr "多対多関連" +msgstr "インデックス付きコレクション" -#: index.docbook:994 +#. Tag: para +#: performance.xml:994 +#, no-c-format msgid "sets" -msgstr "この分類はさまざまなテーブルや外部キー関連を区別しますが、私たちが知る必要のある 関連モデルについてほとんどなにも教えてくれません。関連構造やパフォーマンスの特徴を 完全に理解するには、Hibernateがコレクションの行を更新、削除するために使う主キーの 構造もまた考えなければなりません。これは以下の分類を提示します。" +msgstr "set" -#: index.docbook:997 +#. Tag: para +#: performance.xml:997 +#, no-c-format msgid "bags" -msgstr "インデックス付きコレクション" +msgstr "bag" -#: index.docbook:1001 -msgid "All indexed collections (maps, lists, arrays) have a primary key consisting of the <literal>&lt;key&gt;</literal> and <literal>&lt;index&gt;</literal> columns. In this case collection updates are usually extremely efficient - the primary key may be efficiently indexed and a particular row may be efficiently located when Hibernate tries to update or delete it." -msgstr "<para>set</para>" +#. Tag: para +#: performance.xml:1001 +#, no-c-format +msgid "" +"All indexed collections (maps, lists, arrays) have a primary key consisting " +"of the <literal>&lt;key&gt;</literal> and <literal>&lt;index&gt;</literal> " +"columns. In this case collection updates are usually extremely efficient - " +"the primary key may be efficiently indexed and a particular row may be " +"efficiently located when Hibernate tries to update or delete it." +msgstr "" +"すべてのインデックス付きコレクション（map、list、配列）は <literal>&lt;" +"key&gt;</literal> と <literal>&lt;index&gt;</literal> カラムからなる主キーを" +"持っています。この場合は コレクションの更新は非常に効率的です。主キーは有用な" +"インデックスになり、Hibernateが 特定の行を更新または削除するときに、その行を" +"効率的に見つけることができます。" -#: index.docbook:1009 -msgid "Sets have a primary key consisting of <literal>&lt;key&gt;</literal> and element columns. This may be less efficient for some types of collection element, particularly composite elements or large text or binary fields; the database may not be able to index a complex primary key as efficently. On the other hand, for one to many or many to many associations, particularly in the case of synthetic identifiers, it is likely to be just as efficient. (Side-note: if you want <literal>SchemaExport</literal> to actually create the primary key of a <literal>&lt;set&gt;</literal> for you, you must declare all columns as <literal>not-null=\"true\"</literal>.)" -msgstr "<para>bag</para>" +#. Tag: para +#: performance.xml:1009 +#, no-c-format +msgid "" +"Sets have a primary key consisting of <literal>&lt;key&gt;</literal> and " +"element columns. This may be less efficient for some types of collection " +"element, particularly composite elements or large text or binary fields; the " +"database may not be able to index a complex primary key as efficently. On " +"the other hand, for one to many or many to many associations, particularly " +"in the case of synthetic identifiers, it is likely to be just as efficient. " +"(Side-note: if you want <literal>SchemaExport</literal> to actually create " +"the primary key of a <literal>&lt;set&gt;</literal> for you, you must " +"declare all columns as <literal>not-null=\"true\"</literal>.)" +msgstr "" +"setは <literal>&lt;key&gt;</literal> からなる主キーと要素のカラムを持っていま" +"す。 これはコレクション要素のいくつかの型については効率的ではないかもしれませ" +"ん。 特に複合要素、大きなテキスト、バイナリフィールドでは非効率です。データ" +"ベースは 複合主キーに効率的にインデックスを付けることができないからです。一" +"方、1対多や多対多関連において、 特に人工識別子の場合は同じぐらい効率的です。" +"（余談： <literal>SchemaExport</literal> で実際に <literal>&lt;set&gt;</" +"literal> の主キーを作りたいなら、すべてのカラムで <literal>not-null=\"true" +"\"</literal> を宣言しなければなりません。）" -#: index.docbook:1020 -msgid "<literal>&lt;idbag&gt;</literal> mappings define a surrogate key, so they are always very efficient to update. In fact, they are the best case." -msgstr "すべてのインデックス付きコレクション（map、list、配列）は <literal>&lt;key&gt;</literal> と <literal>&lt;index&gt;</literal> カラムからなる主キーを持っています。この場合は コレクションの更新は非常に効率的です。主キーは有用なインデックスになり、Hibernateが 特定の行を更新または削除するときに、その行を効率的に見つけることができます。" +#. Tag: para +#: performance.xml:1020 +#, no-c-format +msgid "" +"<literal>&lt;idbag&gt;</literal> mappings define a surrogate key, so they " +"are always very efficient to update. In fact, they are the best case." +msgstr "" +"<literal>&lt;idbag&gt;</literal> マッピングは代理キーを定義します。そのため " +"更新は常に非常に効率的です。事実上、これは最善のケースです。" -#: index.docbook:1025 -msgid "Bags are the worst case. Since a bag permits duplicate element values and has no index column, no primary key may be defined. Hibernate has no way of distinguishing between duplicate rows. Hibernate resolves this problem by completely removing (in a single <literal>DELETE</literal>) and recreating the collection whenever it changes. This might be very inefficient." -msgstr "setは <literal>&lt;key&gt;</literal> からなる主キーと要素のカラムを持っています。 これはコレクション要素のいくつかの型については効率的ではないかもしれません。 特に複合要素、大きなテキスト、バイナリフィールドでは非効率です。データベースは 複合主キーに効率的にインデックスを付けることができないからです。一方、1対多や多対多関連において、 特に人工識別子の場合は同じぐらい効率的です。（余談： <literal>SchemaExport</literal> で実際に <literal>&lt;set&gt;</literal> の主キーを作りたいなら、すべてのカラムで <literal>not-null=\"true\"</literal> を宣言しなければなりません。）" +#. Tag: para +#: performance.xml:1025 +#, no-c-format +msgid "" +"Bags are the worst case. Since a bag permits duplicate element values and " +"has no index column, no primary key may be defined. Hibernate has no way of " +"distinguishing between duplicate rows. Hibernate resolves this problem by " +"completely removing (in a single <literal>DELETE</literal>) and recreating " +"the collection whenever it changes. This might be very inefficient." +msgstr "" +"bagは最悪のケースです。bagは要素の値の重複が可能で、インデックスカラムを持た" +"ないため、 主キーは定義されないかもしれません。Hibernateには重複した行を区別" +"する方法がありません。 Hibernateはこの問題の解決のために、変更があったときに" +"は常に完全な削除 （一つの <literal>DELETE</literal> による）を行い、コレク" +"ションの再作成を行います。 これは非常に非効率的かもしれません。" -#: index.docbook:1033 -msgid "Note that for a one-to-many association, the \"primary key\" may not be the physical primary key of the database table - but even in this case, the above classification is still useful. (It still reflects how Hibernate \"locates\" individual rows of the collection.)" -msgstr "<literal>&lt;idbag&gt;</literal> マッピングは代理キーを定義します。そのため 更新は常に非常に効率的です。事実上、これは最善のケースです。" +#. Tag: para +#: performance.xml:1033 +#, no-c-format +msgid "" +"Note that for a one-to-many association, the \"primary key\" may not be the " +"physical primary key of the database table - but even in this case, the " +"above classification is still useful. (It still reflects how Hibernate " +"\"locates\" individual rows of the collection.)" +msgstr "" +"1対多関連では、「主キー」はデータベースのテーブルの物理的な 主キーではないか" +"もしれないことに注意してください。しかしこの場合でさえ、上記の分類はまだ有用" +"です。 （Hibernateがコレクションの個々の行をどうやって「見つけるか」を表して" +"います。）" -#: index.docbook:1043 -msgid "Lists, maps, idbags and sets are the most efficient collections to update" -msgstr "bagは最悪のケースです。bagは要素の値の重複が可能で、インデックスカラムを持たないため、 主キーは定義されないかもしれません。Hibernateには重複した行を区別する方法がありません。 Hibernateはこの問題の解決のために、変更があったときには常に完全な削除 （一つの <literal>DELETE</literal> による）を行い、コレクションの再作成を行います。 これは非常に非効率的かもしれません。" +#. Tag: title +#: performance.xml:1043 +#, no-c-format +msgid "" +"Lists, maps, idbags and sets are the most efficient collections to update" +msgstr "更新にもっとも効率的なコレクション list、map、idbag、set" -#: index.docbook:1045 -msgid "From the discussion above, it should be clear that indexed collections and (usually) sets allow the most efficient operation in terms of adding, removing and updating elements." -msgstr "1対多関連では、「主キー」はデータベースのテーブルの物理的な 主キーではないかもしれないことに注意してください。しかしこの場合でさえ、上記の分類はまだ有用です。 （Hibernateがコレクションの個々の行をどうやって「見つけるか」を表しています。）" +#. Tag: para +#: performance.xml:1045 +#, no-c-format +msgid "" +"From the discussion above, it should be clear that indexed collections and " +"(usually) sets allow the most efficient operation in terms of adding, " +"removing and updating elements." +msgstr "" +"上での議論から、インデックス付きコレクションと（普通の）setは要素の追加、削" +"除、 更新でもっとも効率的な操作が出来ることは明らかです。" -#: index.docbook:1051 -msgid "There is, arguably, one more advantage that indexed collections have over sets for many to many associations or collections of values. Because of the structure of a <literal>Set</literal>, Hibernate doesn't ever <literal>UPDATE</literal> a row when an element is \"changed\". Changes to a <literal>Set</literal> always work via <literal>INSERT</literal> and <literal>DELETE</literal> (of individual rows). Once again, this consideration does not apply to one to many associations." -msgstr "更新にもっとも効率的なコレクション list、map、idbag、set" +#. Tag: para +#: performance.xml:1051 +#, no-c-format +msgid "" +"There is, arguably, one more advantage that indexed collections have over " +"sets for many to many associations or collections of values. Because of the " +"structure of a <literal>Set</literal>, Hibernate doesn't ever " +"<literal>UPDATE</literal> a row when an element is \"changed\". Changes to a " +"<literal>Set</literal> always work via <literal>INSERT</literal> and " +"<literal>DELETE</literal> (of individual rows). Once again, this " +"consideration does not apply to one to many associations." +msgstr "" +"ほぼ間違いなく、多対多関連や値のコレクションにおいて、インデックス付きコレク" +"ションが setよりも優れている点が一つ以上あります。 <literal>Set</literal> は" +"その 構造のために、Hibernateは要素が「変更」されたときに行を決して " +"<literal>UPDATE</literal> しません。 <literal>Set</literal> への変更は常に" +"（個々の行の）<literal>INSERT</literal> と <literal>DELETE</literal> によって" +"行います。繰り返しますが、これは一対多関連には 当てはまりません。" -#: index.docbook:1060 -msgid "After observing that arrays cannot be lazy, we would conclude that lists, maps and idbags are the most performant (non-inverse) collection types, with sets not far behind. Sets are expected to be the most common kind of collection in Hibernate applications. This is because the \"set\" semantics are most natural in the relational model." -msgstr "上での議論から、インデックス付きコレクションと（普通の）setは要素の追加、削除、 更新でもっとも効率的な操作が出来ることは明らかです。" +#. Tag: para +#: performance.xml:1060 +#, no-c-format +msgid "" +"After observing that arrays cannot be lazy, we would conclude that lists, " +"maps and idbags are the most performant (non-inverse) collection types, with " +"sets not far behind. Sets are expected to be the most common kind of " +"collection in Hibernate applications. This is because the \"set\" semantics " +"are most natural in the relational model." +msgstr "" +"配列は遅延処理ができないという決まりなので、結論として、list、map、idbagが" +"もっとも パフォーマンスの良い（inverseではない）コレクションタイプとなりま" +"す。setも それほど違いはありません。Hibernateのアプリケーションでは、setはコ" +"レクションのもっとも 共通の種類として期待されます。setの表現は関連モデルでは" +"もっとも自然だからです。" -#: index.docbook:1068 -msgid "However, in well-designed Hibernate domain models, we usually see that most collections are in fact one-to-many associations with <literal>inverse=\"true\"</literal>. For these associations, the update is handled by the many-to-one end of the association, and so considerations of collection update performance simply do not apply." -msgstr "ほぼ間違いなく、多対多関連や値のコレクションにおいて、インデックス付きコレクションが setよりも優れている点が一つ以上あります。 <literal>Set</literal> はその 構造のために、Hibernateは要素が「変更」されたときに行を決して <literal>UPDATE</literal> しません。 <literal>Set</literal> への変更は常に（個々の行の）<literal>INSERT</literal> と <literal>DELETE</literal> によって行います。繰り返しますが、これは一対多関連には 当てはまりません。" +#. Tag: para +#: performance.xml:1068 +#, no-c-format +msgid "" +"However, in well-designed Hibernate domain models, we usually see that most " +"collections are in fact one-to-many associations with <literal>inverse=\"true" +"\"</literal>. For these associations, the update is handled by the many-to-" +"one end of the association, and so considerations of collection update " +"performance simply do not apply." +msgstr "" +"しかし、よくデザインされたHibernateのドメインモデルでは、通常もっとも多いコレ" +"クションは 事実上 <literal>inverse=\"true\"</literal> を指定した1対多関連で" +"す。これらの関連では、 更新は多対一の関連端で扱われ、コレクションの更新パ" +"フォーマンスの問題は当てはまりません。" -#: index.docbook:1078 +#. Tag: title +#: performance.xml:1078 +#, no-c-format msgid "Bags and lists are the most efficient inverse collections" -msgstr "配列は遅延処理ができないという決まりなので、結論として、list、map、idbagがもっとも パフォーマンスの良い（inverseではない）コレクションタイプとなります。setも それほど違いはありません。Hibernateのアプリケーションでは、setはコレクションのもっとも 共通の種類として期待されます。setの表現は関連モデルではもっとも自然だからです。" +msgstr "inverseコレクションにもっとも最適なbagとlist" -#: index.docbook:1080 -msgid "Just before you ditch bags forever, there is a particular case in which bags (and also lists) are much more performant than sets. For a collection with <literal>inverse=\"true\"</literal> (the standard bidirectional one-to-many relationship idiom, for example) we can add elements to a bag or list without needing to initialize (fetch) the bag elements! This is because <literal>Collection.add()</literal> or <literal>Collection.addAll()</literal> must always return true for a bag or <literal>List</literal> (unlike a <literal>Set</literal>). This can make the following common code much faster." -msgstr "しかし、よくデザインされたHibernateのドメインモデルでは、通常もっとも多いコレクションは 事実上 <literal>inverse=\"true\"</literal> を指定した1対多関連です。これらの関連では、 更新は多対一の関連端で扱われ、コレクションの更新パフォーマンスの問題は当てはまりません。" +#. Tag: para +#: performance.xml:1080 +#, no-c-format +msgid "" +"Just before you ditch bags forever, there is a particular case in which bags " +"(and also lists) are much more performant than sets. For a collection with " +"<literal>inverse=\"true\"</literal> (the standard bidirectional one-to-many " +"relationship idiom, for example) we can add elements to a bag or list " +"without needing to initialize (fetch) the bag elements! This is because " +"<literal>Collection.add()</literal> or <literal>Collection.addAll()</" +"literal> must always return true for a bag or <literal>List</literal> " +"(unlike a <literal>Set</literal>). This can make the following common code " +"much faster." +msgstr "" +"bagを見放してしまう前に、bag（そしてlistも）がsetよりもずっとパフォーマンスが" +"良い特別なケースを 紹介します。 <literal>inverse=\"true\"</literal> のコレク" +"ション（一般的な1対多関連の使い方など）で、 bagの要素を初期化（フェッチ）する" +"必要なくbagやlistに要素を追加できます！ これは <literal>Collection.add()</" +"literal> や <literal>Collection.addAll()</literal> はbagや <literal>List</" +"literal> では常にtrueを返さなければならないからです （ <literal>Set</" +"literal> とは異なります）。 これは以下の共通処理をより速くすることができま" +"す。" -#: index.docbook:1090 +#. Tag: programlisting +#: performance.xml:1090 +#, no-c-format msgid "" - "<![CDATA[Parent p = (Parent) sess.load(Parent.class, id);\n" - "Child c = new Child();\n" - "c.setParent(p);\n" - "p.getChildren().add(c); //no need to fetch the collection!\n" - "sess.flush();]]>" -msgstr "inverseコレクションにもっとも最適なbagとlist" +"<![CDATA[Parent p = (Parent) sess.load(Parent.class, id);\n" +"Child c = new Child();\n" +"c.setParent(p);\n" +"p.getChildren().add(c); //no need to fetch the collection!\n" +"sess.flush();]]>" +msgstr "" -#: index.docbook:1095 +#. Tag: title +#: performance.xml:1095 +#, no-c-format msgid "One shot delete" -msgstr "bagを見放してしまう前に、bag（そしてlistも）がsetよりもずっとパフォーマンスが良い特別なケースを 紹介します。 <literal>inverse=\"true\"</literal> のコレクション（一般的な1対多関連の使い方など）で、 bagの要素を初期化（フェッチ）する必要なくbagやlistに要素を追加できます！ これは <literal>Collection.add()</literal> や <literal>Collection.addAll()</literal> はbagや <literal>List</literal> では常にtrueを返さなければならないからです （ <literal>Set</literal> とは異なります）。 これは以下の共通処理をより速くすることができます。" +msgstr "一括削除" -#: index.docbook:1097 -msgid "Occasionally, deleting collection elements one by one can be extremely inefficient. Hibernate isn't completely stupid, so it knows not to do that in the case of an newly-empty collection (if you called <literal>list.clear()</literal>, for example). In this case, Hibernate will issue a single <literal>DELETE</literal> and we are done!" +#. Tag: para +#: performance.xml:1097 +#, no-c-format +msgid "" +"Occasionally, deleting collection elements one by one can be extremely " +"inefficient. Hibernate isn't completely stupid, so it knows not to do that " +"in the case of an newly-empty collection (if you called <literal>list.clear()" +"</literal>, for example). In this case, Hibernate will issue a single " +"<literal>DELETE</literal> and we are done!" msgstr "" - "<![CDATA[Parent p = (Parent) sess.load(Parent.class, id); -\n" - "Child c = new Child(); -\n" - "c.setParent(p); -\n" - "p.getChildren().add(c); //no need to fetch the collection! -\n" - "sess.flush();]]>" +"時々、コレクションの要素を一つ一つ削除することは極めて非効率的になることがあ" +"ります。 Hibernateは愚かではないので、新しい空のコレクションの場合" +"（ <literal>list.clear()</literal> を呼び出した場合など）ではこれをすべきでな" +"いことを知っています。この場合は、Hibernateは <literal>DELETE</literal> を一" +"回発行して、それですべて終わります！" -#: index.docbook:1104 -msgid "Suppose we add a single element to a collection of size twenty and then remove two elements. Hibernate will issue one <literal>INSERT</literal> statement and two <literal>DELETE</literal> statements (unless the collection is a bag). This is certainly desirable." -msgstr "一括削除" +#. Tag: para +#: performance.xml:1104 +#, no-c-format +msgid "" +"Suppose we add a single element to a collection of size twenty and then " +"remove two elements. Hibernate will issue one <literal>INSERT</literal> " +"statement and two <literal>DELETE</literal> statements (unless the " +"collection is a bag). This is certainly desirable." +msgstr "" +"サイズ20のコレクションに一つの要素を追加し、それから二つの要素を削除するとし" +"ます。 Hibernateは一つの <literal>INSERT</literal> 文と二つの " +"<literal>DELETE</literal> 文を発行します （コレクションがbagでなければ）。こ" +"れは確かに望ましい動作です。" -#: index.docbook:1110 -msgid "However, suppose that we remove eighteen elements, leaving two and then add thee new elements. There are two possible ways to proceed" -msgstr "時々、コレクションの要素を一つ一つ削除することは極めて非効率的になることがあります。 Hibernateは愚かではないので、新しい空のコレクションの場合（ <literal>list.clear()</literal> を呼び出した場合など）ではこれをすべきでないことを知っています。この場合は、Hibernateは <literal>DELETE</literal> を一回発行して、それですべて終わります！" +#. Tag: para +#: performance.xml:1110 +#, no-c-format +msgid "" +"However, suppose that we remove eighteen elements, leaving two and then add " +"thee new elements. There are two possible ways to proceed" +msgstr "" +"しかし、18個の要素を削除して2つを残し、それから3つ新しい要素を追加するとしま" +"す。 このとき二つの方法があります。" -#: index.docbook:1117 +#. Tag: para +#: performance.xml:1117 +#, no-c-format msgid "delete eighteen rows one by one and then insert three rows" -msgstr "サイズ20のコレクションに一つの要素を追加し、それから二つの要素を削除するとします。 Hibernateは一つの <literal>INSERT</literal> 文と二つの <literal>DELETE</literal> 文を発行します （コレクションがbagでなければ）。これは確かに望ましい動作です。" +msgstr "18行を一つ一つ削除して、3行を追加する" -#: index.docbook:1120 -msgid "remove the whole collection (in one SQL <literal>DELETE</literal>) and insert all five current elements (one by one)" -msgstr "しかし、18個の要素を削除して2つを残し、それから3つ新しい要素を追加するとします。 このとき二つの方法があります。" +#. Tag: para +#: performance.xml:1120 +#, no-c-format +msgid "" +"remove the whole collection (in one SQL <literal>DELETE</literal>) and " +"insert all five current elements (one by one)" +msgstr "" +"コレクション全体を削除（ <literal>DELETE</literal> のSQLを一回）し、そして5つ" +"の要素すべてを （一つずつ）追加する" -#: index.docbook:1125 -msgid "Hibernate isn't smart enough to know that the second option is probably quicker in this case. (And it would probably be undesirable for Hibernate to be that smart; such behaviour might confuse database triggers, etc.)" -msgstr "18行を一つ一つ削除して、3行を追加する" +#. Tag: para +#: performance.xml:1125 +#, no-c-format +msgid "" +"Hibernate isn't smart enough to know that the second option is probably " +"quicker in this case. (And it would probably be undesirable for Hibernate to " +"be that smart; such behaviour might confuse database triggers, etc.)" +msgstr "" +"Hibernateはこの場合に2番目の方法がより速いだろうとわかるほど賢くはありませ" +"ん。 （そしてHibernateがこのように賢いことも望ましくないでしょう。このような" +"振る舞いは データベースのトリガなどを混乱させるかもしれません。）" -#: index.docbook:1131 -msgid "Fortunately, you can force this behaviour (ie. the second strategy) at any time by discarding (ie. dereferencing) the original collection and returning a newly instantiated collection with all the current elements. This can be very useful and powerful from time to time." -msgstr "コレクション全体を削除（ <literal>DELETE</literal> のSQLを一回）し、そして5つの要素すべてを （一つずつ）追加する" +#. Tag: para +#: performance.xml:1131 +#, no-c-format +msgid "" +"Fortunately, you can force this behaviour (ie. the second strategy) at any " +"time by discarding (ie. dereferencing) the original collection and returning " +"a newly instantiated collection with all the current elements. This can be " +"very useful and powerful from time to time." +msgstr "" +"幸いにも、元のコレクションを捨て（つまり参照をやめて）、現在の要素をすべて持" +"つ新しいコレクションの インスタンスを返すことで、いつでもこの振る舞い（2番目" +"の戦略）を強制することが出来ます。 時にこれはとても便利で強力です。" -#: index.docbook:1137 -msgid "Of course, one-shot-delete does not apply to collections mapped <literal>inverse=\"true\"</literal>." -msgstr "Hibernateはこの場合に2番目の方法がより速いだろうとわかるほど賢くはありません。 （そしてHibernateがこのように賢いことも望ましくないでしょう。このような振る舞いは データベースのトリガなどを混乱させるかもしれません。）" +#. Tag: para +#: performance.xml:1137 +#, no-c-format +msgid "" +"Of course, one-shot-delete does not apply to collections mapped " +"<literal>inverse=\"true\"</literal>." +msgstr "" +"もちろん、一括削除は <literal>inverse=\"true\"</literal> を指定したコレクショ" +"ンには行いません。" -#: index.docbook:1146 +#. Tag: title +#: performance.xml:1146 +#, no-c-format msgid "Monitoring performance" -msgstr "幸いにも、元のコレクションを捨て（つまり参照をやめて）、現在の要素をすべて持つ新しいコレクションの インスタンスを返すことで、いつでもこの振る舞い（2番目の戦略）を強制することが出来ます。 時にこれはとても便利で強力です。" +msgstr "パフォーマンスのモニタリング" -#: index.docbook:1148 -msgid "Optimization is not much use without monitoring and access to performance numbers. Hibernate provides a full range of figures about its internal operations. Statistics in Hibernate are available per <literal>SessionFactory</literal>." -msgstr "もちろん、一括削除は <literal>inverse=\"true\"</literal> を指定したコレクションには行いません。" +#. Tag: para +#: performance.xml:1148 +#, no-c-format +msgid "" +"Optimization is not much use without monitoring and access to performance " +"numbers. Hibernate provides a full range of figures about its internal " +"operations. Statistics in Hibernate are available per " +"<literal>SessionFactory</literal>." +msgstr "" +"最適化はモニタリングやパフォーマンスを示す数値がなければ十分に行えません。 " +"Hibernateは内部処理のすべての範囲の数値を提供します。 Hibernateの統計情報は " +"<literal>SessionFactory</literal> 単位で取得可能です。" -#: index.docbook:1155 +#. Tag: title +#: performance.xml:1155 +#, no-c-format msgid "Monitoring a SessionFactory" -msgstr "パフォーマンスのモニタリング" +msgstr "SessionFactoryのモニタリング" -#: index.docbook:1157 -msgid "You can access <literal>SessionFactory</literal> metrics in two ways. Your first option is to call <literal>sessionFactory.getStatistics()</literal> and read or display the <literal>Statistics</literal> yourself." -msgstr "最適化はモニタリングやパフォーマンスを示す数値がなければ十分に行えません。 Hibernateは内部処理のすべての範囲の数値を提供します。 Hibernateの統計情報は <literal>SessionFactory</literal> 単位で取得可能です。" +#. Tag: para +#: performance.xml:1157 +#, no-c-format +msgid "" +"You can access <literal>SessionFactory</literal> metrics in two ways. Your " +"first option is to call <literal>sessionFactory.getStatistics()</literal> " +"and read or display the <literal>Statistics</literal> yourself." +msgstr "" +"<literal>SessionFactory</literal> のメトリクスにアクセスするには2つの方法があ" +"ります。 最初の方法は、 <literal>sessionFactory.getStatistics()</literal> を" +"呼び出し、 自分で <literal>Statistics</literal> の読み込みや表示を行います。" -#: index.docbook:1163 -msgid "Hibernate can also use JMX to publish metrics if you enable the <literal>StatisticsService</literal> MBean. You may enable a single MBean for all your <literal>SessionFactory</literal> or one per factory. See the following code for minimalistic configuration examples:" -msgstr "SessionFactoryのモニタリング" +#. Tag: para +#: performance.xml:1163 +#, no-c-format +msgid "" +"Hibernate can also use JMX to publish metrics if you enable the " +"<literal>StatisticsService</literal> MBean. You may enable a single MBean " +"for all your <literal>SessionFactory</literal> or one per factory. See the " +"following code for minimalistic configuration examples:" +msgstr "" +"<literal>StatisticsService</literal> MBeanを有効にしていれば、HibernateはJMX" +"を使って メトリクスを発行することもできます。1つのMBeanをすべての " +"<literal>SessionFactory</literal> に対して有効にするか、SessionFactoryごとに" +"一つのMBeanを有効にすることが出来ます。 最小限の設定例である以下のコードを見" +"てください。" -#: index.docbook:1170 +#. Tag: programlisting +#: performance.xml:1170 +#, no-c-format msgid "" - "<![CDATA[// MBean service registration for a specific SessionFactory\n" - "Hashtable tb = new Hashtable();\n" - "tb.put(\"type\", \"statistics\");\n" - "tb.put(\"sessionFactory\", \"myFinancialApp\");\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" - "\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation\n" - "stats.setSessionFactory(sessionFactory); // Bind the stats to a SessionFactory\n" - "server.registerMBean(stats, on); // Register the Mbean on the server]]>" -msgstr "<literal>SessionFactory</literal> のメトリクスにアクセスするには2つの方法があります。 最初の方法は、 <literal>sessionFactory.getStatistics()</literal> を呼び出し、 自分で <literal>Statistics</literal> の読み込みや表示を行います。" +"<![CDATA[// MBean service registration for a specific SessionFactory\n" +"Hashtable tb = new Hashtable();\n" +"tb.put(\"type\", \"statistics\");\n" +"tb.put(\"sessionFactory\", \"myFinancialApp\");\n" +"ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +"\n" +"StatisticsService stats = new StatisticsService(); // MBean implementation\n" +"stats.setSessionFactory(sessionFactory); // Bind the stats to a " +"SessionFactory\n" +"server.registerMBean(stats, on); // Register the Mbean on the server]]>" +msgstr "" -#: index.docbook:1173 +#. Tag: programlisting +#: performance.xml:1173 +#, no-c-format msgid "" - "<![CDATA[// MBean service registration for all SessionFactory's\n" - "Hashtable tb = new Hashtable();\n" - "tb.put(\"type\", \"statistics\");\n" - "tb.put(\"sessionFactory\", \"all\");\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" - "\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation\n" - "server.registerMBean(stats, on); // Register the MBean on the server]]>" -msgstr "<literal>StatisticsService</literal> MBeanを有効にしていれば、HibernateはJMXを使って メトリクスを発行することもできます。1つのMBeanをすべての <literal>SessionFactory</literal> に対して有効にするか、SessionFactoryごとに一つのMBeanを有効にすることが出来ます。 最小限の設定例である以下のコードを見てください。" +"<![CDATA[// MBean service registration for all SessionFactory's\n" +"Hashtable tb = new Hashtable();\n" +"tb.put(\"type\", \"statistics\");\n" +"tb.put(\"sessionFactory\", \"all\");\n" +"ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name\n" +"\n" +"StatisticsService stats = new StatisticsService(); // MBean implementation\n" +"server.registerMBean(stats, on); // Register the MBean on the server]]>" +msgstr "" -#: index.docbook:1175 -msgid "TODO: This doesn't make sense: In the first case, we retrieve and use the MBean directly. In the second one, we must give the JNDI name in which the session factory is held before using it. Use <literal>hibernateStatsBean.setSessionFactoryJNDIName(\"my/JNDI/Name\")</literal>" +#. Tag: para +#: performance.xml:1175 +#, no-c-format +msgid "" +"TODO: This doesn't make sense: In the first case, we retrieve and use the " +"MBean directly. In the second one, we must give the JNDI name in which the " +"session factory is held before using it. Use <literal>hibernateStatsBean." +"setSessionFactoryJNDIName(\"my/JNDI/Name\")</literal>" msgstr "" - "<![CDATA[// MBean service registration for a specific SessionFactory -\n" - "Hashtable tb = new Hashtable(); -\n" - "tb.put(\"type\", \"statistics\"); -\n" - "tb.put(\"sessionFactory\", \"myFinancialApp\"); -\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name -\n" - " -\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation -\n" - "stats.setSessionFactory(sessionFactory); // Bind the stats to a SessionFactory -\n" - "server.registerMBean(stats, on); // Register the Mbean on the server]]>" +"TODO: これは意味がありません。最初のケースは、MBeanを直接復元して使用します。" +"2番目のケースは、 使う前にsession factoryが持っているJNDI名を渡さなければなり" +"ません。 <literal>hibernateStatsBean.setSessionFactoryJNDIName(\"my/JNDI/Name" +"\")</literal> を使ってください。" -#: index.docbook:1180 -msgid "You can (de)activate the monitoring for a <literal>SessionFactory</literal>" +#. Tag: para +#: performance.xml:1180 +#, no-c-format +msgid "" +"You can (de)activate the monitoring for a <literal>SessionFactory</literal>" msgstr "" - "<![CDATA[// MBean service registration for all SessionFactory's -\n" - "Hashtable tb = new Hashtable(); -\n" - "tb.put(\"type\", \"statistics\"); -\n" - "tb.put(\"sessionFactory\", \"all\"); -\n" - "ObjectName on = new ObjectName(\"hibernate\", tb); // MBean object name -\n" - " -\n" - "StatisticsService stats = new StatisticsService(); // MBean implementation -\n" - "server.registerMBean(stats, on); // Register the MBean on the server]]>" +"<literal>SessionFactory</literal> に対してモニタリングの開始（終了）を行うこ" +"とが出来ます。" -#: index.docbook:1185 -msgid "at configuration time, set <literal>hibernate.generate_statistics</literal> to <literal>false</literal>" -msgstr "TODO: これは意味がありません。最初のケースは、MBeanを直接復元して使用します。2番目のケースは、 使う前にsession factoryが持っているJNDI名を渡さなければなりません。 <literal>hibernateStatsBean.setSessionFactoryJNDIName(\"my/JNDI/Name\")</literal> を使ってください。" +#. Tag: para +#: performance.xml:1185 +#, no-c-format +msgid "" +"at configuration time, set <literal>hibernate.generate_statistics</literal> " +"to <literal>false</literal>" +msgstr "" +"設定時には、 <literal>hibernate.generate_statistics</literal> を " +"<literal>false</literal> にします" -#: index.docbook:1192 -msgid "at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> or <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal>" -msgstr "<literal>SessionFactory</literal> に対してモニタリングの開始（終了）を行うことが出来ます。" +#. Tag: para +#: performance.xml:1192 +#, no-c-format +msgid "" +"at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> " +"or <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal>" +msgstr "" +"実行時に、 <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> " +"または <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal> を呼" +"び出します" -#: index.docbook:1199 -msgid "Statistics can be reset programatically using the <literal>clear()</literal> method. A summary can be sent to a logger (info level) using the <literal>logSummary()</literal> method." -msgstr "設定時には、 <literal>hibernate.generate_statistics</literal> を <literal>false</literal> にします" +#. Tag: para +#: performance.xml:1199 +#, no-c-format +msgid "" +"Statistics can be reset programatically using the <literal>clear()</literal> " +"method. A summary can be sent to a logger (info level) using the " +"<literal>logSummary()</literal> method." +msgstr "" +"統計は <literal>clear()</literal> メソッドを使って手動でリセットすることが出" +"来ます。 サマリは <literal>logSummary()</literal> メソッドを使ってloggerに送" +"ることが出来ます （infoレベルです）。" -#: index.docbook:1208 +#. Tag: title +#: performance.xml:1208 +#, no-c-format msgid "Metrics" -msgstr "実行時に、 <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> または <literal>hibernateStatsBean.setStatisticsEnabled(true)</literal> を呼び出します" - -#: index.docbook:1210 -msgid "Hibernate provides a number of metrics, from very basic to the specialized information only relevant in certain scenarios. All available counters are described in the <literal>Statistics</literal> interface API, in three categories:" -msgstr "統計は <literal>clear()</literal> メソッドを使って手動でリセットすることが出来ます。 サマリは <literal>logSummary()</literal> メソッドを使ってloggerに送ることが出来ます （infoレベルです）。" - -#: index.docbook:1217 -msgid "Metrics related to the general <literal>Session</literal> usage, such as number of open sessions, retrieved JDBC connections, etc." msgstr "メトリクス" -#: index.docbook:1223 -msgid "Metrics related to he entities, collections, queries, and caches as a whole (aka global metrics)," -msgstr "多くのものがあります。すべての使用可能なカウンタは <literal>Statistics</literal> インターフェイスのAPIに書かれており、3つの分類があります。" +#. Tag: para +#: performance.xml:1210 +#, no-c-format +msgid "" +"Hibernate provides a number of metrics, from very basic to the specialized " +"information only relevant in certain scenarios. All available counters are " +"described in the <literal>Statistics</literal> interface API, in three " +"categories:" +msgstr "" +"多くのものがあります。すべての使用可能なカウンタは <literal>Statistics</" +"literal> インターフェイスのAPIに書かれており、3つの分類があります。" -#: index.docbook:1229 -msgid "Detailed metrics related to a particular entity, collection, query or cache region." -msgstr "メトリクスは一般的な <literal>Session</literal> の使い方と関係しています。 オープンしたセッションの数がJDBCコネクションと関連しているのと同じです。" +#. Tag: para +#: performance.xml:1217 +#, no-c-format +msgid "" +"Metrics related to the general <literal>Session</literal> usage, such as " +"number of open sessions, retrieved JDBC connections, etc." +msgstr "" +"メトリクスは一般的な <literal>Session</literal> の使い方と関係しています。 " +"オープンしたセッションの数がJDBCコネクションと関連しているのと同じです。" -#: index.docbook:1236 -msgid "For exampl,e you can check the cache hit, miss, and put ratio of entities, collections and queries, and the average time a query needs. Beware that the number of milliseconds is subject to approximation in Java. Hibernate is tied to the JVM precision, on some platforms this might even only be accurate to 10 seconds." -msgstr "メトリクスは要素、コレクション、クエリやキャッシュなど全体に 関係しています（別名はグローバルメトリクスです）。" +#. Tag: para +#: performance.xml:1223 +#, no-c-format +msgid "" +"Metrics related to he entities, collections, queries, and caches as a whole " +"(aka global metrics)," +msgstr "" +"メトリクスは要素、コレクション、クエリやキャッシュなど全体に 関係しています" +"（別名はグローバルメトリクスです）。" -#: index.docbook:1243 -msgid "Simple getters are used to access the global metrics (i.e. not tied to a particular entity, collection, cache region, etc.). You can access the metrics of a particular entity, collection or cache region through its name, and through its HQL or SQL representation for queries. Please refer to the <literal>Statistics</literal>, <literal>EntityStatistics</literal>, <literal>CollectionStatistics</literal>, <literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</literal> API Javadoc for more information. The following code shows a simple example:" -msgstr "メトリクスの詳細は特定のエンティティ、コレクション、クエリ、キャッシュ領域に関係しています。" +#. Tag: para +#: performance.xml:1229 +#, no-c-format +msgid "" +"Detailed metrics related to a particular entity, collection, query or cache " +"region." +msgstr "" +"メトリクスの詳細は特定のエンティティ、コレクション、クエリ、キャッシュ領域に" +"関係しています。" -#: index.docbook:1253 +#. Tag: para +#: performance.xml:1236 +#, no-c-format msgid "" - "<![CDATA[Statistics stats = HibernateUtil.sessionFactory.getStatistics();\n" - "\n" - "double queryCacheHitCount = stats.getQueryCacheHitCount();\n" - "double queryCacheMissCount = stats.getQueryCacheMissCount();\n" - "double queryCacheHitRatio =\n" - " queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount);\n" - "\n" - "log.info(\"Query Hit ratio:\" + queryCacheHitRatio);\n" - "\n" - "EntityStatistics entityStats =\n" - " stats.getEntityStatistics( Cat.class.getName() );\n" - "long changes =\n" - " entityStats.getInsertCount()\n" - " + entityStats.getUpdateCount()\n" - " + entityStats.getDeleteCount();\n" - "log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );]]>" -msgstr "例として、キャッシュのヒット、ヒットミスや、要素、コレクション、クエリの割合、クエリの実行に 必要な平均時間を確認できます。ミリ秒の数値はJavaの近似を受けることに注意してください。 HibernateはJVMの精度に制限され、プラットフォームによっては10秒単位でしか正確でないかもしれません。" +"For exampl,e you can check the cache hit, miss, and put ratio of entities, " +"collections and queries, and the average time a query needs. Beware that the " +"number of milliseconds is subject to approximation in Java. Hibernate is " +"tied to the JVM precision, on some platforms this might even only be " +"accurate to 10 seconds." +msgstr "" +"例として、キャッシュのヒット、ヒットミスや、要素、コレクション、クエリの割" +"合、クエリの実行に 必要な平均時間を確認できます。ミリ秒の数値はJavaの近似を受" +"けることに注意してください。 HibernateはJVMの精度に制限され、プラットフォーム" +"によっては10秒単位でしか正確でないかもしれません。" -#: index.docbook:1255 -msgid "To work on all entities, collections, queries and region caches, you can retrieve the list of names of entities, collections, queries and region caches with the following methods: <literal>getQueries()</literal>, <literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</literal>, and <literal>getSecondLevelCacheRegionNames()</literal>." -msgstr "単純なgetterはグローバルメトリクス（すなわち特定のエンティティ、コレクション、キャッシュ領域などに縛られない） にアクセスするために使います。特定のエンティティ、コレクション、キャッシュ領域のメトリクスは、 それらの名前や、クエリのHQL、SQL表現によってアクセスすることが出来ます。さらに詳しい情報は、 <literal>Statistics</literal> 、 <literal>EntityStatistics</literal> 、 <literal>CollectionStatistics</literal> 、 <literal>SecondLevelCacheStatistics</literal> 、 <literal>QueryStatistics</literal> APIのjavadocを 参照してください。以下のコードは簡単な例です。" +#. Tag: para +#: performance.xml:1243 +#, no-c-format +msgid "" +"Simple getters are used to access the global metrics (i.e. not tied to a " +"particular entity, collection, cache region, etc.). You can access the " +"metrics of a particular entity, collection or cache region through its name, " +"and through its HQL or SQL representation for queries. Please refer to the " +"<literal>Statistics</literal>, <literal>EntityStatistics</literal>, " +"<literal>CollectionStatistics</literal>, " +"<literal>SecondLevelCacheStatistics</literal>, and <literal>QueryStatistics</" +"literal> API Javadoc for more information. The following code shows a simple " +"example:" +msgstr "" +"単純なgetterはグローバルメトリクス（すなわち特定のエンティティ、コレクショ" +"ン、キャッシュ領域などに縛られない） にアクセスするために使います。特定のエン" +"ティティ、コレクション、キャッシュ領域のメトリクスは、 それらの名前や、クエリ" +"のHQL、SQL表現によってアクセスすることが出来ます。さらに詳しい情報は、 " +"<literal>Statistics</literal> 、 <literal>EntityStatistics</literal> 、 " +"<literal>CollectionStatistics</literal> 、 " +"<literal>SecondLevelCacheStatistics</literal> 、 <literal>QueryStatistics</" +"literal> APIのjavadocを 参照してください。以下のコードは簡単な例です。" -#: index.docbook:1352 -msgid "appended paragraph 1" +#. Tag: programlisting +#: performance.xml:1253 +#, no-c-format +msgid "" +"<![CDATA[Statistics stats = HibernateUtil.sessionFactory.getStatistics();\n" +"\n" +"double queryCacheHitCount = stats.getQueryCacheHitCount();\n" +"double queryCacheMissCount = stats.getQueryCacheMissCount();\n" +"double queryCacheHitRatio =\n" +" queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount);\n" +"\n" +"log.info(\"Query Hit ratio:\" + queryCacheHitRatio);\n" +"\n" +"EntityStatistics entityStats =\n" +" stats.getEntityStatistics( Cat.class.getName() );\n" +"long changes =\n" +" entityStats.getInsertCount()\n" +" + entityStats.getUpdateCount()\n" +" + entityStats.getDeleteCount();\n" +"log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );]]>" msgstr "" - "<![CDATA[Statistics stats = HibernateUtil.sessionFactory.getStatistics(); -\n" - " -\n" - "double queryCacheHitCount = stats.getQueryCacheHitCount(); -\n" - "double queryCacheMissCount = stats.getQueryCacheMissCount(); -\n" - "double queryCacheHitRatio = -\n" - " queryCacheHitCount / (queryCacheHitCount + queryCacheMissCount); -\n" - " -\n" - "log.info(\"Query Hit ratio:\" + queryCacheHitRatio); -\n" - " -\n" - "EntityStatistics entityStats = -\n" - " stats.getEntityStatistics( Cat.class.getName() ); -\n" - "long changes = -\n" - " entityStats.getInsertCount() -\n" - " + entityStats.getUpdateCount() -\n" - " + entityStats.getDeleteCount(); -\n" - "log.info(Cat.class.getName() + \" changed \" + changes + \"times\" );]]>" -#: index.docbook:1369 -msgid "appended paragraph 2" -msgstr "すべてのエンティティ、コレクション、クエリ、キャッシュ領域に対して行う場合は、 <literal>getQueries()</literal> 、 <literal>getEntityNames()</literal>、 <literal>getCollectionRoleNames()</literal> 、 <literal>getSecondLevelCacheRegionNames()</literal> メソッドで それぞれの名前のリストを取得することが出来ます。" +#. Tag: para +#: performance.xml:1255 +#, no-c-format +msgid "" +"To work on all entities, collections, queries and region caches, you can " +"retrieve the list of names of entities, collections, queries and region " +"caches with the following methods: <literal>getQueries()</literal>, " +"<literal>getEntityNames()</literal>, <literal>getCollectionRoleNames()</" +"literal>, and <literal>getSecondLevelCacheRegionNames()</literal>." +msgstr "" +"すべてのエンティティ、コレクション、クエリ、キャッシュ領域に対して行う場合" +"は、 <literal>getQueries()</literal> 、 <literal>getEntityNames()</" +"literal>、 <literal>getCollectionRoleNames()</literal> 、 " +"<literal>getSecondLevelCacheRegionNames()</literal> メソッドで それぞれの名前" +"のリストを取得することが出来ます。" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#~ msgid "yes" +#~ msgstr "yes" Modified: core/trunk/documentation/manual/translations/ja-JP/content/persistent_classes.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/persistent_classes.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/persistent_classes.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,867 +1,856 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: persistent_classes.xml:5 +#, no-c-format msgid "Persistent Classes" msgstr "永続クラス" -#: index.docbook:7 -msgid "Persistent classes are classes in an application that implement the entities of the business problem (e.g. Customer and Order in an E-commerce application). Not all instances of a persistent class are considered to be in the persistent state - an instance may instead be transient or detached." -msgstr "永続クラスはビジネス上の問題のエンティティ（例えば、Eコマースアプリケーションの顧客や注文） を実装するアプリケーションのクラスです。 永続クラスのすべてのインスタンスが永続状態であると見なされるわけではありません。 インスタンスは逆に一時的（transient）であったり、分離状態（detached）であったりするかもしれません。" +#. Tag: para +#: persistent_classes.xml:7 +#, no-c-format +msgid "" +"Persistent classes are classes in an application that implement the entities " +"of the business problem (e.g. Customer and Order in an E-commerce " +"application). Not all instances of a persistent class are considered to be " +"in the persistent state - an instance may instead be transient or detached." +msgstr "" +"永続クラスはビジネス上の問題のエンティティ（例えば、Eコマースアプリケーション" +"の顧客や注文） を実装するアプリケーションのクラスです。 永続クラスのすべての" +"インスタンスが永続状態であると見なされるわけではありません。 インスタンスは逆" +"に一時的（transient）であったり、分離状態（detached）であったりするかもしれま" +"せん。" -#: index.docbook:14 -msgid "Hibernate works best if these classes follow some simple rules, also known as the Plain Old Java Object (POJO) programming model. However, none of these rules are hard requirements. Indeed, Hibernate3 assumes very little about the nature of your persistent objects. You may express a domain model in other ways: using trees of <literal>Map</literal> instances, for example." -msgstr "Plain Old Java Object (POJO)プログラミングモデルとしても知られる いくつかの単純なルールに従うなら、Hibernateは最もよく働きます。 しかしこれらのルールは難しいものではありません。 実際Hibernate3は永続オブジェクトの性質にほとんど何の前提も置いていません。 ドメインモデルは他の方法で表現することもできます。 例えば <literal>Map</literal> インスタンスのツリーを使う方法があります。" +#. Tag: para +#: persistent_classes.xml:14 +#, no-c-format +msgid "" +"Hibernate works best if these classes follow some simple rules, also known " +"as the Plain Old Java Object (POJO) programming model. However, none of " +"these rules are hard requirements. Indeed, Hibernate3 assumes very little " +"about the nature of your persistent objects. You may express a domain model " +"in other ways: using trees of <literal>Map</literal> instances, for example." +msgstr "" +"Plain Old Java Object (POJO)プログラミングモデルとしても知られる いくつかの単" +"純なルールに従うなら、Hibernateは最もよく働きます。 しかしこれらのルールは難" +"しいものではありません。 実際Hibernate3は永続オブジェクトの性質にほとんど何の" +"前提も置いていません。 ドメインモデルは他の方法で表現することもできます。 例" +"えば <literal>Map</literal> インスタンスのツリーを使う方法があります。" -#: index.docbook:23 +#. Tag: title +#: persistent_classes.xml:23 +#, no-c-format msgid "A simple POJO example" msgstr "単純なPOJOの例" -#: index.docbook:25 +#. Tag: para +#: persistent_classes.xml:25 +#, no-c-format msgid "Most Java applications require a persistent class representing felines." -msgstr "ほとんどのJavaアプリケーションにはネコ科の動物を表現する永続クラスが必要です。" +msgstr "" +"ほとんどのJavaアプリケーションにはネコ科の動物を表現する永続クラスが必要で" +"す。" -#: index.docbook:29 +#. Tag: programlisting +#: persistent_classes.xml:29 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "import java.util.Set;\n" - "import java.util.Date;\n" - "\n" - "public class Cat {\n" - " private Long id; // identifier\n" - "\n" - " private Date birthdate;\n" - " private Color color;\n" - " private char sex;\n" - " private float weight;\n" - " private int litterId;\n" - "\n" - " private Cat mother;\n" - " private Set kittens = new HashSet();\n" - "\n" - " private void setId(Long id) {\n" - " this.id=id;\n" - " }\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - "\n" - " void setBirthdate(Date date) {\n" - " birthdate = date;\n" - " }\n" - " public Date getBirthdate() {\n" - " return birthdate;\n" - " }\n" - "\n" - " void setWeight(float weight) {\n" - " this.weight = weight;\n" - " }\n" - " public float getWeight() {\n" - " return weight;\n" - " }\n" - "\n" - " public Color getColor() {\n" - " return color;\n" - " }\n" - " void setColor(Color color) {\n" - " this.color = color;\n" - " }\n" - "\n" - " void setSex(char sex) {\n" - " this.sex=sex;\n" - " }\n" - " public char getSex() {\n" - " return sex;\n" - " }\n" - "\n" - " void setLitterId(int id) {\n" - " this.litterId = id;\n" - " }\n" - " public int getLitterId() {\n" - " return litterId;\n" - " }\n" - "\n" - " void setMother(Cat mother) {\n" - " this.mother = mother;\n" - " }\n" - " public Cat getMother() {\n" - " return mother;\n" - " }\n" - " void setKittens(Set kittens) {\n" - " this.kittens = kittens;\n" - " }\n" - " public Set getKittens() {\n" - " return kittens;\n" - " }\n" - " \n" - " // addKitten not needed by Hibernate\n" - " public void addKitten(Cat kitten) {\n" - " kitten.setMother(this);\n" - " kitten.setLitterId( kittens.size() ); \n" - " kittens.add(kitten);\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"import java.util.Set;\n" +"import java.util.Date;\n" +"\n" +"public class Cat {\n" +" private Long id; // identifier\n" +"\n" +" private Date birthdate;\n" +" private Color color;\n" +" private char sex;\n" +" private float weight;\n" +" private int litterId;\n" +"\n" +" private Cat mother;\n" +" private Set kittens = new HashSet();\n" +"\n" +" private void setId(Long id) {\n" +" this.id=id;\n" +" }\n" +" public Long getId() {\n" +" return id;\n" +" }\n" +"\n" +" void setBirthdate(Date date) {\n" +" birthdate = date;\n" +" }\n" +" public Date getBirthdate() {\n" +" return birthdate;\n" +" }\n" +"\n" +" void setWeight(float weight) {\n" +" this.weight = weight;\n" +" }\n" +" public float getWeight() {\n" +" return weight;\n" +" }\n" +"\n" +" public Color getColor() {\n" +" return color;\n" +" }\n" +" void setColor(Color color) {\n" +" this.color = color;\n" +" }\n" +"\n" +" void setSex(char sex) {\n" +" this.sex=sex;\n" +" }\n" +" public char getSex() {\n" +" return sex;\n" +" }\n" +"\n" +" void setLitterId(int id) {\n" +" this.litterId = id;\n" +" }\n" +" public int getLitterId() {\n" +" return litterId;\n" +" }\n" +"\n" +" void setMother(Cat mother) {\n" +" this.mother = mother;\n" +" }\n" +" public Cat getMother() {\n" +" return mother;\n" +" }\n" +" void setKittens(Set kittens) {\n" +" this.kittens = kittens;\n" +" }\n" +" public Set getKittens() {\n" +" return kittens;\n" +" }\n" +" \n" +" // addKitten not needed by Hibernate\n" +" public void addKitten(Cat kitten) {\n" +" kitten.setMother(this);\n" +" kitten.setLitterId( kittens.size() ); \n" +" kittens.add(kitten);\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[package eg; -\n" - "import java.util.Set; -\n" - "import java.util.Date; -\n" - " -\n" - "public class Cat { -\n" - " private Long id; // identifier -\n" - " -\n" - " private Date birthdate; -\n" - " private Color color; -\n" - " private char sex; -\n" - " private float weight; -\n" - " private int litterId; -\n" - " -\n" - " private Cat mother; -\n" - " private Set kittens = new HashSet(); -\n" - " -\n" - " private void setId(Long id) { -\n" - " this.id=id; -\n" - " } -\n" - " public Long getId() { -\n" - " return id; -\n" - " } -\n" - " -\n" - " void setBirthdate(Date date) { -\n" - " birthdate = date; -\n" - " } -\n" - " public Date getBirthdate() { -\n" - " return birthdate; -\n" - " } -\n" - " -\n" - " void setWeight(float weight) { -\n" - " this.weight = weight; -\n" - " } -\n" - " public float getWeight() { -\n" - " return weight; -\n" - " } -\n" - " -\n" - " public Color getColor() { -\n" - " return color; -\n" - " } -\n" - " void setColor(Color color) { -\n" - " this.color = color; -\n" - " } -\n" - " -\n" - " void setSex(char sex) { -\n" - " this.sex=sex; -\n" - " } -\n" - " public char getSex() { -\n" - " return sex; -\n" - " } -\n" - " -\n" - " void setLitterId(int id) { -\n" - " this.litterId = id; -\n" - " } -\n" - " public int getLitterId() { -\n" - " return litterId; -\n" - " } -\n" - " -\n" - " void setMother(Cat mother) { -\n" - " this.mother = mother; -\n" - " } -\n" - " public Cat getMother() { -\n" - " return mother; -\n" - " } -\n" - " void setKittens(Set kittens) { -\n" - " this.kittens = kittens; -\n" - " } -\n" - " public Set getKittens() { -\n" - " return kittens; -\n" - " } -\n" - " -\n" - " // addKitten not needed by Hibernate -\n" - " public void addKitten(Cat kitten) { -\n" - " kitten.setMother(this); -\n" - " kitten.setLitterId( kittens.size() ); -\n" - " kittens.add(kitten); -\n" - " } -\n" - "}]]>" -#: index.docbook:31 +#. Tag: para +#: persistent_classes.xml:31 +#, no-c-format msgid "There are four main rules to follow here:" msgstr "従うべき4つのルールがあります：" -#: index.docbook:37 +#. Tag: title +#: persistent_classes.xml:37 +#, no-c-format msgid "Implement a no-argument constructor" msgstr "引数のないコンストラクタを実装する" -#: index.docbook:39 -msgid "<literal>Cat</literal> has a no-argument constructor. All persistent classes must have a default constructor (which may be non-public) so that Hibernate can instantiate them using <literal>Constructor.newInstance()</literal>. We strongly recommend having a default constructor with at least <emphasis>package</emphasis> visibility for runtime proxy generation in Hibernate." -msgstr "<literal>Cat</literal> には引数のないコンストラクタがあります。 Hibernateが <literal>Constructor.newInstance()</literal> を使って永続クラスの インスタンス化を行えるように、すべての永続クラスにはデフォルトコンストラクタ （publicでなくても構いません）がなければなりません。 Hibernateの実行時プロキシ生成のために、少なくとも <emphasis>package</emphasis> の可視性を持つデフォルトコンストラクタを強くお勧めします。" +#. Tag: para +#: persistent_classes.xml:39 +#, no-c-format +msgid "" +"<literal>Cat</literal> has a no-argument constructor. All persistent classes " +"must have a default constructor (which may be non-public) so that Hibernate " +"can instantiate them using <literal>Constructor.newInstance()</literal>. We " +"strongly recommend having a default constructor with at least " +"<emphasis>package</emphasis> visibility for runtime proxy generation in " +"Hibernate." +msgstr "" +"<literal>Cat</literal> には引数のないコンストラクタがあります。 Hibernateが " +"<literal>Constructor.newInstance()</literal> を使って永続クラスの インスタン" +"ス化を行えるように、すべての永続クラスにはデフォルトコンストラクタ （publicで" +"なくても構いません）がなければなりません。 Hibernateの実行時プロキシ生成のた" +"めに、少なくとも <emphasis>package</emphasis> の可視性を持つデフォルトコンス" +"トラクタを強くお勧めします。" -#: index.docbook:49 +#. Tag: title +#: persistent_classes.xml:49 +#, no-c-format msgid "Provide an identifier property (optional)" msgstr "識別子プロパティを用意する（オプション）" -#: index.docbook:51 -msgid "<literal>Cat</literal> has a property called <literal>id</literal>. This property maps to the primary key column of a database table. The property might have been called anything, and its type might have been any primitive type, any primitive \"wrapper\" type, <literal>java.lang.String</literal> or <literal>java.util.Date</literal>. (If your legacy database table has composite keys, you can even use a user-defined class with properties of these types - see the section on composite identifiers later.)" -msgstr "<literal>Cat</literal> には <literal>id</literal> というプロパティがあります。 このプロパティはデータベーステーブルの主キーカラムへマッピングされます。 このプロパティの名前は何でも構いませんし、型はどのようなプリミティブ型でも、 プリミティブの「ラッパー」型でも、<literal>java.lang.String</literal> や <literal>java.util.Date</literal> でも構いません。 （もしレガシーデータベーステーブルが複合キーを持つならば、 今述べたような型のプロパティを持つユーザ定義のクラスを使うことさえ可能です。 後で複合識別子の節を見てください。）" +#. Tag: para +#: persistent_classes.xml:51 +#, no-c-format +msgid "" +"<literal>Cat</literal> has a property called <literal>id</literal>. This " +"property maps to the primary key column of a database table. The property " +"might have been called anything, and its type might have been any primitive " +"type, any primitive \"wrapper\" type, <literal>java.lang.String</literal> or " +"<literal>java.util.Date</literal>. (If your legacy database table has " +"composite keys, you can even use a user-defined class with properties of " +"these types - see the section on composite identifiers later.)" +msgstr "" +"<literal>Cat</literal> には <literal>id</literal> というプロパティがありま" +"す。 このプロパティはデータベーステーブルの主キーカラムへマッピングされま" +"す。 このプロパティの名前は何でも構いませんし、型はどのようなプリミティブ型で" +"も、 プリミティブの「ラッパー」型でも、<literal>java.lang.String</literal> " +"や <literal>java.util.Date</literal> でも構いません。 （もしレガシーデータ" +"ベーステーブルが複合キーを持つならば、 今述べたような型のプロパティを持つユー" +"ザ定義のクラスを使うことさえ可能です。 後で複合識別子の節を見てください。）" -#: index.docbook:60 -msgid "The identifier property is strictly optional. You can leave them off and let Hibernate keep track of object identifiers internally. We do not recommend this, however." -msgstr "識別子プロパティは厳密にはオプションです。 これを省略して、Hibernateに内部的にオブジェクトの識別子を追跡させることは可能です。 しかしおすすめはしません。" +#. Tag: para +#: persistent_classes.xml:60 +#, no-c-format +msgid "" +"The identifier property is strictly optional. You can leave them off and let " +"Hibernate keep track of object identifiers internally. We do not recommend " +"this, however." +msgstr "" +"識別子プロパティは厳密にはオプションです。 これを省略して、Hibernateに内部的" +"にオブジェクトの識別子を追跡させることは可能です。 しかしおすすめはしません。" -#: index.docbook:65 -msgid "In fact, some functionality is available only to classes which declare an identifier property:" -msgstr "実際に、識別子プロパティを宣言するクラスだけが利用可能な機能がいくつかあります：" +#. Tag: para +#: persistent_classes.xml:65 +#, no-c-format +msgid "" +"In fact, some functionality is available only to classes which declare an " +"identifier property:" +msgstr "" +"実際に、識別子プロパティを宣言するクラスだけが利用可能な機能がいくつかありま" +"す：" -#: index.docbook:72 -msgid "Transitive reattachment for detached objects (cascade update or cascade merge) - see" -msgstr "分離オブジェクトの連鎖的な再追加（カスケード更新やカスケードマージ）。 <xref linkend=\"objectstate-transitive\"/> を参照してください。" +#. Tag: para +#: persistent_classes.xml:72 +#, fuzzy, no-c-format +msgid "" +"Transitive reattachment for detached objects (cascade update or cascade " +"merge) - see" +msgstr "" +"分離オブジェクトの連鎖的な再追加（カスケード更新やカスケードマージ）。 <xref " +"linkend=\"objectstate-transitive\"/> を参照してください。" -#: index.docbook:79 +#. Tag: literal +#: persistent_classes.xml:79 +#, no-c-format msgid "Session.saveOrUpdate()" msgstr "Session.saveOrUpdate()" -#: index.docbook:84 +#. Tag: literal +#: persistent_classes.xml:84 +#, no-c-format msgid "Session.merge()" msgstr "Session.merge()" -#: index.docbook:89 -msgid "We recommend you declare consistently-named identifier properties on persistent classes. We further recommend that you use a nullable (ie. non-primitive) type." -msgstr "永続クラスには、一貫した名前の識別子プロパティを定義することをお勧めします。 さらにnull値を取れる(つまりプリミティブではない)型を使った方がよいでしょう。" +#. Tag: para +#: persistent_classes.xml:89 +#, no-c-format +msgid "" +"We recommend you declare consistently-named identifier properties on " +"persistent classes. We further recommend that you use a nullable (ie. non-" +"primitive) type." +msgstr "" +"永続クラスには、一貫した名前の識別子プロパティを定義することをお勧めします。 " +"さらにnull値を取れる(つまりプリミティブではない)型を使った方がよいでしょう。" -#: index.docbook:96 +#. Tag: title +#: persistent_classes.xml:96 +#, no-c-format msgid "Prefer non-final classes (optional)" msgstr "finalクラスにしない（オプション）" -#: index.docbook:97 -msgid "A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon the persistent class being either non-final, or the implementation of an interface that declares all public methods." -msgstr "Hibernateの中心的な特徴である <emphasis>プロキシ</emphasis> は、 永続クラスがfinalでないこと、またはメソッドを全部publicで宣言している インターフェイスが実装されているかに依存しています。" +#. Tag: para +#: persistent_classes.xml:97 +#, no-c-format +msgid "" +"A central feature of Hibernate, <emphasis>proxies</emphasis>, depends upon " +"the persistent class being either non-final, or the implementation of an " +"interface that declares all public methods." +msgstr "" +"Hibernateの中心的な特徴である <emphasis>プロキシ</emphasis> は、 永続クラスが" +"finalでないこと、またはメソッドを全部publicで宣言している インターフェイスが" +"実装されているかに依存しています。" -#: index.docbook:102 -msgid "You can persist <literal>final</literal> classes that do not implement an interface with Hibernate, but you won't be able to use proxies for lazy association fetching - which will limit your options for performance tuning." -msgstr "Hibernateでインターフェイスを実装していない <literal>final</literal> クラスを永続化することはできますが、 遅延関連フェッチに対してプロキシを使うことはできなくなります。 これはパフォーマンスチューニングへの選択肢を狭めることになります。" +#. Tag: para +#: persistent_classes.xml:102 +#, no-c-format +msgid "" +"You can persist <literal>final</literal> classes that do not implement an " +"interface with Hibernate, but you won't be able to use proxies for lazy " +"association fetching - which will limit your options for performance tuning." +msgstr "" +"Hibernateでインターフェイスを実装していない <literal>final</literal> クラスを" +"永続化することはできますが、 遅延関連フェッチに対してプロキシを使うことはでき" +"なくなります。 これはパフォーマンスチューニングへの選択肢を狭めることになりま" +"す。" -#: index.docbook:107 -msgid "You should also avoid declaring <literal>public final</literal> methods on the non-final classes. If you want to use a class with a <literal>public final</literal> method, you must explicitly disable proxying by setting <literal>lazy=\"false\"</literal>." -msgstr "finalではないクラスで <literal>public final</literal> メソッドを定義することも避けるべきです。 <literal>public final</literal> メソッドを持つクラスを使いたければ、 <literal>lazy=\"false\"</literal> と設定して明示的にプロキシを無効にしなければなりません。" +#. Tag: para +#: persistent_classes.xml:107 +#, no-c-format +msgid "" +"You should also avoid declaring <literal>public final</literal> methods on " +"the non-final classes. If you want to use a class with a <literal>public " +"final</literal> method, you must explicitly disable proxying by setting " +"<literal>lazy=\"false\"</literal>." +msgstr "" +"finalではないクラスで <literal>public final</literal> メソッドを定義すること" +"も避けるべきです。 <literal>public final</literal> メソッドを持つクラスを使い" +"たければ、 <literal>lazy=\"false\"</literal> と設定して明示的にプロキシを無効" +"にしなければなりません。" -#: index.docbook:115 +#. Tag: title +#: persistent_classes.xml:115 +#, no-c-format msgid "Declare accessors and mutators for persistent fields (optional)" msgstr "永続フィールドに対するアクセサとミューテータを定義する（オプション）" -#: index.docbook:117 -msgid "<literal>Cat</literal> declares accessor methods for all its persistent fields. Many other ORM tools directly persist instance variables. We believe it is better to provide an indirection between the relational schema and internal data structures of the class. By default, Hibernate persists JavaBeans style properties, and recognizes method names of the form <literal>getFoo</literal>, <literal>isFoo</literal> and <literal>setFoo</literal>. You may switch to direct field access for particular properties, if needed." -msgstr "<literal>Cat</literal> ではすべての永続フィールドに対してアクセサメソッドを定義しています。 他の多くのORMツールは、永続インスタンス変数を直接永続化します。 私たちはリレーショナルスキーマとクラスの内部構造を分離する方が良いと信じています。 デフォルトでは、HibernateはJavaBeanスタイルのプロパティを永続化し、 <literal>getFoo</literal>, <literal>isFoo</literal>, <literal>setFoo</literal> 形式のメソッド名を認識します。 しかし必要なら、特定のプロパティに対して、直接のフィールドアクセスに切り替えることは可能です。" +#. Tag: para +#: persistent_classes.xml:117 +#, no-c-format +msgid "" +"<literal>Cat</literal> declares accessor methods for all its persistent " +"fields. Many other ORM tools directly persist instance variables. We believe " +"it is better to provide an indirection between the relational schema and " +"internal data structures of the class. By default, Hibernate persists " +"JavaBeans style properties, and recognizes method names of the form " +"<literal>getFoo</literal>, <literal>isFoo</literal> and <literal>setFoo</" +"literal>. You may switch to direct field access for particular properties, " +"if needed." +msgstr "" +"<literal>Cat</literal> ではすべての永続フィールドに対してアクセサメソッドを定" +"義しています。 他の多くのORMツールは、永続インスタンス変数を直接永続化しま" +"す。 私たちはリレーショナルスキーマとクラスの内部構造を分離する方が良いと信じ" +"ています。 デフォルトでは、HibernateはJavaBeanスタイルのプロパティを永続化" +"し、 <literal>getFoo</literal>, <literal>isFoo</literal>, <literal>setFoo</" +"literal> 形式のメソッド名を認識します。 しかし必要なら、特定のプロパティに対" +"して、直接のフィールドアクセスに切り替えることは可能です。" -#: index.docbook:127 -msgid "Properties need <emphasis>not</emphasis> be declared public - Hibernate can persist a property with a default, <literal>protected</literal> or <literal>private</literal> get / set pair." -msgstr "プロパティはpublicで宣言する必要は <emphasis>ありません</emphasis> 。 Hibernateはデフォルト、<literal>protected</literal> もしくは <literal>private</literal> のget / setのペアを持つプロパティを永続化することができます。" +#. Tag: para +#: persistent_classes.xml:127 +#, no-c-format +msgid "" +"Properties need <emphasis>not</emphasis> be declared public - Hibernate can " +"persist a property with a default, <literal>protected</literal> or " +"<literal>private</literal> get / set pair." +msgstr "" +"プロパティはpublicで宣言する必要は <emphasis>ありません</emphasis> 。 " +"Hibernateはデフォルト、<literal>protected</literal> もしくは " +"<literal>private</literal> のget / setのペアを持つプロパティを永続化すること" +"ができます。" -#: index.docbook:138 +#. Tag: title +#: persistent_classes.xml:138 +#, no-c-format msgid "Implementing inheritance" msgstr "継承の実装" -#: index.docbook:140 -msgid "A subclass must also observe the first and second rules. It inherits its identifier property from the superclass, <literal>Cat</literal>." -msgstr "サブクラスも1番目と2番目のルールを守らなければなりません。 サブクラスはスーパークラス <literal>Cat</literal> から識別子プロパティを継承します。" +#. Tag: para +#: persistent_classes.xml:140 +#, no-c-format +msgid "" +"A subclass must also observe the first and second rules. It inherits its " +"identifier property from the superclass, <literal>Cat</literal>." +msgstr "" +"サブクラスも1番目と2番目のルールを守らなければなりません。 サブクラスはスー" +"パークラス <literal>Cat</literal> から識別子プロパティを継承します。" -#: index.docbook:145 +#. Tag: programlisting +#: persistent_classes.xml:145 +#, no-c-format msgid "" - "<![CDATA[package eg;\n" - "\n" - "public class DomesticCat extends Cat {\n" - " private String name;\n" - "\n" - " public String getName() {\n" - " return name;\n" - " }\n" - " protected void setName(String name) {\n" - " this.name=name;\n" - " }\n" - "}]]>" +"<![CDATA[package eg;\n" +"\n" +"public class DomesticCat extends Cat {\n" +" private String name;\n" +"\n" +" public String getName() {\n" +" return name;\n" +" }\n" +" protected void setName(String name) {\n" +" this.name=name;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[package eg; -\n" - " -\n" - "public class DomesticCat extends Cat { -\n" - " private String name; -\n" - " -\n" - " public String getName() { -\n" - " return name; -\n" - " } -\n" - " protected void setName(String name) { -\n" - " this.name=name; -\n" - " } -\n" - "}]]>" -#: index.docbook:149 -msgid "Implementing <literal>equals()</literal> and <literal>hashCode()</literal>" +#. Tag: title +#: persistent_classes.xml:149 +#, no-c-format +msgid "" +"Implementing <literal>equals()</literal> and <literal>hashCode()</literal>" msgstr "<literal>equals()</literal> と <literal>hashCode()</literal> の実装" -#: index.docbook:151 -msgid "You have to override the <literal>equals()</literal> and <literal>hashCode()</literal> methods if you" -msgstr "以下の条件の場合、 <literal>equals()</literal> と <literal>hashCode()</literal> メソッドをオーバーライドしなければなりません、" +#. Tag: para +#: persistent_classes.xml:151 +#, no-c-format +msgid "" +"You have to override the <literal>equals()</literal> and <literal>hashCode()" +"</literal> methods if you" +msgstr "" +"以下の条件の場合、 <literal>equals()</literal> と <literal>hashCode()</" +"literal> メソッドをオーバーライドしなければなりません、" -#: index.docbook:157 -msgid "intend to put instances of persistent classes in a <literal>Set</literal> (the recommended way to represent many-valued associations) <emphasis>and</emphasis>" -msgstr "永続クラスのインスタンスを <literal>Set</literal> に置く場合。 （これは多値の関連を表現するおすすめの方法です） <emphasis>そして同時に</emphasis>" +#. Tag: para +#: persistent_classes.xml:157 +#, no-c-format +msgid "" +"intend to put instances of persistent classes in a <literal>Set</literal> " +"(the recommended way to represent many-valued associations) <emphasis>and</" +"emphasis>" +msgstr "" +"永続クラスのインスタンスを <literal>Set</literal> に置く場合。 （これは多値の" +"関連を表現するおすすめの方法です） <emphasis>そして同時に</emphasis>" -#: index.docbook:164 +#. Tag: para +#: persistent_classes.xml:164 +#, no-c-format msgid "intend to use reattachment of detached instances" msgstr "分離インスタンスをセッションへ再追加する場合。" -#: index.docbook:170 -msgid "Hibernate guarantees equivalence of persistent identity (database row) and Java identity only inside a particular session scope. So as soon as we mix instances retrieved in different sessions, we must implement <literal>equals()</literal> and <literal>hashCode()</literal> if we wish to have meaningful semantics for <literal>Set</literal>s." -msgstr "Hibernateは、永続ID（データベースの行）と、特定のセッションスコープ内に 限定ですがJavaIDとが等価であることを保証します。 ですから異なるセッションで検索したインスタンスを組み合わせる場合、 <literal>Set</literal> に意味のあるセマンティクスを持たせようと思っているなら すぐに<literal>equals()</literal> と <literal>hashCode()</literal> を実装しなければなりません。" +#. Tag: para +#: persistent_classes.xml:170 +#, no-c-format +msgid "" +"Hibernate guarantees equivalence of persistent identity (database row) and " +"Java identity only inside a particular session scope. So as soon as we mix " +"instances retrieved in different sessions, we must implement <literal>equals" +"()</literal> and <literal>hashCode()</literal> if we wish to have meaningful " +"semantics for <literal>Set</literal>s." +msgstr "" +"Hibernateは、永続ID（データベースの行）と、特定のセッションスコープ内に 限定" +"ですがJavaIDとが等価であることを保証します。 ですから異なるセッションで検索し" +"たインスタンスを組み合わせる場合、 <literal>Set</literal> に意味のあるセマン" +"ティクスを持たせようと思っているなら すぐに<literal>equals()</literal> と " +"<literal>hashCode()</literal> を実装しなければなりません。" -#: index.docbook:178 -msgid "The most obvious way is to implement <literal>equals()</literal>/<literal>hashCode()</literal> by comparing the identifier value of both objects. If the value is the same, both must be the same database row, they are therefore equal (if both are added to a <literal>Set</literal>, we will only have one element in the <literal>Set</literal>). Unfortunately, we can't use that approach with generated identifiers! Hibernate will only assign identifier values to objects that are persistent, a newly created instance will not have any identifier value! Furthermore, if an instance is unsaved and currently in a <literal>Set</literal>, saving it will assign an identifier value to the object. If <literal>equals()</literal> and <literal>hashCode()</literal> are based on the identifier value, the hash code would change, breaking the contract of the <literal>Set</literal>. See the Hibernate website for a full discussion of this problem. Note that this is not a Hibernate issue, but ! normal Java semantics of object identity and equality." -msgstr "最も明白な方法は、両方のオブジェクトの識別子の値の比較によって <literal>equals()</literal>と <literal>hashCode()</literal> を実装する方法です。 値が同じなら、両者はデータベースの同じ行でなければならないため等しくなります。 （両者が <literal>Set</literal> に追加されても、 <literal>Set</literal> には1個の要素しかないことになります） 残念なことに、生成された識別子にはこのアプローチを使うことができません。 Hibernateは永続化されたオブジェクトへ識別子の値を代入するだけであり、 新しく作成されたインスタンスはどのような識別子の値も持っていません。 さらに、インスタンスがセーブされておらず、現在 <literal>Set</literal> の中にあれば、 セーブするとオブジェクトへ識別子の値を代入することになります。 もし <literal! +#. Tag: para +#: persistent_classes.xml:178 +#, no-c-format +msgid "" +"The most obvious way is to implement <literal>equals()</literal>/" +"<literal>hashCode()</literal> by comparing the identifier value of both " +"objects. If the value is the same, both must be the same database row, they " +"are therefore equal (if both are added to a <literal>Set</literal>, we will " +"only have one element in the <literal>Set</literal>). Unfortunately, we " +"can't use that approach with generated identifiers! Hibernate will only " +"assign identifier values to objects that are persistent, a newly created " +"instance will not have any identifier value! Furthermore, if an instance is " +"unsaved and currently in a <literal>Set</literal>, saving it will assign an " +"identifier value to the object. If <literal>equals()</literal> and " +"<literal>hashCode()</literal> are based on the identifier value, the hash " +"code would change, breaking the contract of the <literal>Set</literal>. See " +"the Hibernate website for a full discussion of this problem. Note that this " +"is not a Hibernate issue, but normal Java semantics of object identity and " +"equality." +msgstr "" +"最も明白な方法は、両方のオブジェクトの識別子の値の比較によって " +"<literal>equals()</literal>と <literal>hashCode()</literal> を実装する方法で" +"す。 値が同じなら、両者はデータベースの同じ行でなければならないため等しくなり" +"ます。 （両者が <literal>Set</literal> に追加されても、 <literal>Set</" +"literal> には1個の要素しかないことになります） 残念なことに、生成された識別子" +"にはこのアプローチを使うことができません。 Hibernateは永続化されたオブジェク" +"トへ識別子の値を代入するだけであり、 新しく作成されたインスタンスはどのような" +"識別子の値も持っていません。 さらに、インスタンスがセーブされておらず、現在 " +"<literal>Set</literal> の中にあれば、 セーブするとオブジェクトへ識別子の値を" +"代入することになります。 もし <literal>equals()</literal> と " +"<literal>hashCode()</literal> が識別子の値に基づいているなら、 ハッシュコード" +"が変更されると <literal>Set</literal> の規約が破られます。 この問題についての" +"完全な議論は、Hibernateのウェブサイトを見てください。 これはHibernateの問題で" +"はなく、オブジェクトの同一性と等価性についての、 通常のJavaのセマンティクスで" +"あることに注意してください。" -#: index.docbook:192 -msgid "We recommend implementing <literal>equals()</literal> and <literal>hashCode()</literal> using <emphasis>Business key equality</emphasis>. Business key equality means that the <literal>equals()</literal> method compares only the properties that form the business key, a key that would identify our instance in the real world (a <emphasis>natural</emphasis> candidate key):" -msgstr "<emphasis>ビジネスキーの等価性</emphasis> を使って、 <literal>equals()</literal> と <literal>hashCode()</literal> を実装することをお勧めします。 ビジネスキーの等価性とは、<literal>equals()</literal> メソッドが、ビジネスキー、 つまり現実の世界においてインスタンスを特定するキー（<emphasis>自然</emphasis> 候補キー） を形成するプロパティだけを比較することを意味します。" +#. Tag: para +#: persistent_classes.xml:192 +#, no-c-format +msgid "" +"We recommend implementing <literal>equals()</literal> and <literal>hashCode()" +"</literal> using <emphasis>Business key equality</emphasis>. Business key " +"equality means that the <literal>equals()</literal> method compares only the " +"properties that form the business key, a key that would identify our " +"instance in the real world (a <emphasis>natural</emphasis> candidate key):" +msgstr "" +"<emphasis>ビジネスキーの等価性</emphasis> を使って、 <literal>equals()</" +"literal> と <literal>hashCode()</literal> を実装することをお勧めします。 ビジ" +"ネスキーの等価性とは、<literal>equals()</literal> メソッドが、ビジネスキー、 " +"つまり現実の世界においてインスタンスを特定するキー（<emphasis>自然</" +"emphasis> 候補キー） を形成するプロパティだけを比較することを意味します。" -#: index.docbook:200 +#. Tag: programlisting +#: persistent_classes.xml:200 +#, no-c-format msgid "" - "<![CDATA[public class Cat {\n" - "\n" - " ...\n" - " public boolean equals(Object other) {\n" - " if (this == other) return true;\n" - " if ( !(other instanceof Cat) ) return false;\n" - "\n" - " final Cat cat = (Cat) other;\n" - "\n" - " if ( !cat.getLitterId().equals( getLitterId() ) ) return false;\n" - " if ( !cat.getMother().equals( getMother() ) ) return false;\n" - "\n" - " return true;\n" - " }\n" - "\n" - " public int hashCode() {\n" - " int result;\n" - " result = getMother().hashCode();\n" - " result = 29 * result + getLitterId();\n" - " return result;\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[public class Cat {\n" +"\n" +" ...\n" +" public boolean equals(Object other) {\n" +" if (this == other) return true;\n" +" if ( !(other instanceof Cat) ) return false;\n" +"\n" +" final Cat cat = (Cat) other;\n" +"\n" +" if ( !cat.getLitterId().equals( getLitterId() ) ) return false;\n" +" if ( !cat.getMother().equals( getMother() ) ) return false;\n" +"\n" +" return true;\n" +" }\n" +"\n" +" public int hashCode() {\n" +" int result;\n" +" result = getMother().hashCode();\n" +" result = 29 * result + getLitterId();\n" +" return result;\n" +" }\n" +"\n" +"}]]>" msgstr "" - "<![CDATA[public class Cat { -\n" - " -\n" - " ... -\n" - " public boolean equals(Object other) { -\n" - " if (this == other) return true; -\n" - " if ( !(other instanceof Cat) ) return false; -\n" - " -\n" - " final Cat cat = (Cat) other; -\n" - " -\n" - " if ( !cat.getLitterId().equals( getLitterId() ) ) return false; -\n" - " if ( !cat.getMother().equals( getMother() ) ) return false; -\n" - " -\n" - " return true; -\n" - " } -\n" - " -\n" - " public int hashCode() { -\n" - " int result; -\n" - " result = getMother().hashCode(); -\n" - " result = 29 * result + getLitterId(); -\n" - " return result; -\n" - " } -\n" - " -\n" - "}]]>" -#: index.docbook:202 -msgid "Note that a business key does not have to be as solid as a database primary key candidate (see <xref linkend=\"transactions-basics-identity\"/>). Immutable or unique properties are usually good candidates for a business key." -msgstr "ビジネスキーはデータベースの主キー候補ほど安定である必要はないことに注意してください （<xref linkend=\"transactions-basics-identity\"/> を見てください）。 更新不可なプロパティやユニークなプロパティは、通常ビジネスキーのよい候補です。" +#. Tag: para +#: persistent_classes.xml:202 +#, no-c-format +msgid "" +"Note that a business key does not have to be as solid as a database primary " +"key candidate (see <xref linkend=\"transactions-basics-identity\"/>). " +"Immutable or unique properties are usually good candidates for a business " +"key." +msgstr "" +"ビジネスキーはデータベースの主キー候補ほど安定である必要はないことに注意して" +"ください （<xref linkend=\"transactions-basics-identity\"/> を見てくださ" +"い）。 更新不可なプロパティやユニークなプロパティは、通常ビジネスキーのよい候" +"補です。" -#: index.docbook:212 +#. Tag: title +#: persistent_classes.xml:212 +#, no-c-format msgid "Dynamic models" msgstr "動的モデル" -#: index.docbook:215 -msgid "Note that the following features are currently considered experimental and may change in the near future." -msgstr "以下の機能は現在実験段階にあると見なされており、 近い将来変更される可能性があることに注意してください。" +#. Tag: emphasis +#: persistent_classes.xml:215 +#, no-c-format +msgid "" +"Note that the following features are currently considered experimental and " +"may change in the near future." +msgstr "" +"以下の機能は現在実験段階にあると見なされており、 近い将来変更される可能性があ" +"ることに注意してください。" -#: index.docbook:219 -msgid "Persistent entities don't necessarily have to be represented as POJO classes or as JavaBean objects at runtime. Hibernate also supports dynamic models (using <literal>Map</literal>s of <literal>Map</literal>s at runtime) and the representation of entities as DOM4J trees. With this approach, you don't write persistent classes, only mapping files." -msgstr "永続エンティティは、必ずしも実行時にPOJOクラスやJavaBeanオブジェクトで表現する必要はありません。 Hibernateは（実行時に <literal>Map</literal> の <literal>Map</literal> を使う）動的モデルと、 DOM4Jツリーとしてのエンティティの表現もサポートします。 このアプローチを使うと永続クラスを書かず、マッピングファイルだけを書くことになります。" +#. Tag: para +#: persistent_classes.xml:219 +#, no-c-format +msgid "" +"Persistent entities don't necessarily have to be represented as POJO classes " +"or as JavaBean objects at runtime. Hibernate also supports dynamic models " +"(using <literal>Map</literal>s of <literal>Map</literal>s at runtime) and " +"the representation of entities as DOM4J trees. With this approach, you don't " +"write persistent classes, only mapping files." +msgstr "" +"永続エンティティは、必ずしも実行時にPOJOクラスやJavaBeanオブジェクトで表現す" +"る必要はありません。 Hibernateは（実行時に <literal>Map</literal> の " +"<literal>Map</literal> を使う）動的モデルと、 DOM4Jツリーとしてのエンティティ" +"の表現もサポートします。 このアプローチを使うと永続クラスを書かず、マッピング" +"ファイルだけを書くことになります。" -#: index.docbook:227 -msgid "By default, Hibernate works in normal POJO mode. You may set a default entity representation mode for a particular <literal>SessionFactory</literal> using the <literal>default_entity_mode</literal> configuration option (see <xref linkend=\"configuration-optional-properties\"/>." -msgstr "デフォルトでは、Hibernateは通常のPOJOモードで動作します。 <literal>default_entity_mode</literal> 設定オプションを使って、 特定の <literal>SessionFactory</literal> に対するデフォルトのエンティティ表現モードを設定することができます （<xref linkend=\"configuration-optional-properties\"/> を見てください）。" +#. Tag: para +#: persistent_classes.xml:227 +#, no-c-format +msgid "" +"By default, Hibernate works in normal POJO mode. You may set a default " +"entity representation mode for a particular <literal>SessionFactory</" +"literal> using the <literal>default_entity_mode</literal> configuration " +"option (see <xref linkend=\"configuration-optional-properties\"/>." +msgstr "" +"デフォルトでは、Hibernateは通常のPOJOモードで動作します。 " +"<literal>default_entity_mode</literal> 設定オプションを使って、 特定の " +"<literal>SessionFactory</literal> に対するデフォルトのエンティティ表現モード" +"を設定することができます （<xref linkend=\"configuration-optional-properties" +"\"/> を見てください）。" -#: index.docbook:234 -msgid "The following examples demonstrates the representation using <literal>Map</literal>s. First, in the mapping file, an <literal>entity-name</literal> has to be declared instead of (or in addition to) a class name:" -msgstr "以下の例では <literal>Map</literal> を使った表現を紹介します。 まずマッピングファイルで、クラス名の代わりに（またはそれに加えて） <literal>entity-name</literal> を定義しなければなりません：" +#. Tag: para +#: persistent_classes.xml:234 +#, no-c-format +msgid "" +"The following examples demonstrates the representation using <literal>Map</" +"literal>s. First, in the mapping file, an <literal>entity-name</literal> has " +"to be declared instead of (or in addition to) a class name:" +msgstr "" +"以下の例では <literal>Map</literal> を使った表現を紹介します。 まずマッピング" +"ファイルで、クラス名の代わりに（またはそれに加えて） <literal>entity-name</" +"literal> を定義しなければなりません：" -#: index.docbook:240 +#. Tag: programlisting +#: persistent_classes.xml:240 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class entity-name=\"Customer\">\n" - "\n" - " <id name=\"id\"\n" - " type=\"long\"\n" - " column=\"ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - "\n" - " <property name=\"name\"\n" - " column=\"NAME\"\n" - " type=\"string\"/>\n" - "\n" - " <property name=\"address\"\n" - " column=\"ADDRESS\"\n" - " type=\"string\"/>\n" - "\n" - " <many-to-one name=\"organization\"\n" - " column=\"ORGANIZATION_ID\"\n" - " class=\"Organization\"/>\n" - "\n" - " <bag name=\"orders\"\n" - " inverse=\"true\"\n" - " lazy=\"false\"\n" - " cascade=\"all\">\n" - " <key column=\"CUSTOMER_ID\"/>\n" - " <one-to-many class=\"Order\"/>\n" - " </bag>\n" - "\n" - " </class>\n" - " \n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class entity-name=\"Customer\">\n" +"\n" +" <id name=\"id\"\n" +" type=\"long\"\n" +" column=\"ID\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +"\n" +" <property name=\"name\"\n" +" column=\"NAME\"\n" +" type=\"string\"/>\n" +"\n" +" <property name=\"address\"\n" +" column=\"ADDRESS\"\n" +" type=\"string\"/>\n" +"\n" +" <many-to-one name=\"organization\"\n" +" column=\"ORGANIZATION_ID\"\n" +" class=\"Organization\"/>\n" +"\n" +" <bag name=\"orders\"\n" +" inverse=\"true\"\n" +" lazy=\"false\"\n" +" cascade=\"all\">\n" +" <key column=\"CUSTOMER_ID\"/>\n" +" <one-to-many class=\"Order\"/>\n" +" </bag>\n" +"\n" +" </class>\n" +" \n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " -\n" - " <class entity-name=\"Customer\"> -\n" - " -\n" - " <id name=\"id\" -\n" - " type=\"long\" -\n" - " column=\"ID\"> -\n" - " <generator class=\"sequence\"/> -\n" - " </id> -\n" - " -\n" - " <property name=\"name\" -\n" - " column=\"NAME\" -\n" - " type=\"string\"/> -\n" - " -\n" - " <property name=\"address\" -\n" - " column=\"ADDRESS\" -\n" - " type=\"string\"/> -\n" - " -\n" - " <many-to-one name=\"organization\" -\n" - " column=\"ORGANIZATION_ID\" -\n" - " class=\"Organization\"/> -\n" - " -\n" - " <bag name=\"orders\" -\n" - " inverse=\"true\" -\n" - " lazy=\"false\" -\n" - " cascade=\"all\"> -\n" - " <key column=\"CUSTOMER_ID\"/> -\n" - " <one-to-many class=\"Order\"/> -\n" - " </bag> -\n" - " -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:242 -msgid "Note that even though associations are declared using target class names, the target type of an associations may also be a dynamic entity instead of a POJO." -msgstr "関連がターゲットのクラス名を使って定義していたとしても、 関連のターゲット型もPOJOではなく動的なエンティティでも構わないことに注意してください。" +#. Tag: para +#: persistent_classes.xml:242 +#, no-c-format +msgid "" +"Note that even though associations are declared using target class names, " +"the target type of an associations may also be a dynamic entity instead of a " +"POJO." +msgstr "" +"関連がターゲットのクラス名を使って定義していたとしても、 関連のターゲット型も" +"POJOではなく動的なエンティティでも構わないことに注意してください。" -#: index.docbook:249 -msgid "After setting the default entity mode to <literal>dynamic-map</literal> for the <literal>SessionFactory</literal>, we can at runtime work with <literal>Map</literal>s of <literal>Map</literal>s:" -msgstr "<literal>SessionFactory</literal> に対してデフォルトのエンティティモードを <literal>dynamic-map</literal> に設定した後、 実行時に <literal>Map</literal> の <literal>Map</literal> を使うことができます：" +#. Tag: para +#: persistent_classes.xml:249 +#, no-c-format +msgid "" +"After setting the default entity mode to <literal>dynamic-map</literal> for " +"the <literal>SessionFactory</literal>, we can at runtime work with " +"<literal>Map</literal>s of <literal>Map</literal>s:" +msgstr "" +"<literal>SessionFactory</literal> に対してデフォルトのエンティティモードを " +"<literal>dynamic-map</literal> に設定した後、 実行時に <literal>Map</" +"literal> の <literal>Map</literal> を使うことができます：" -#: index.docbook:255 +#. Tag: programlisting +#: persistent_classes.xml:255 +#, no-c-format msgid "" - "<![CDATA[Session s = openSession();\n" - "Transaction tx = s.beginTransaction();\n" - "Session s = openSession();\n" - "\n" - "// Create a customer\n" - "Map david = new HashMap();\n" - "david.put(\"name\", \"David\");\n" - "\n" - "// Create an organization\n" - "Map foobar = new HashMap();\n" - "foobar.put(\"name\", \"Foobar Inc.\");\n" - "\n" - "// Link both\n" - "david.put(\"organization\", foobar);\n" - "\n" - "// Save both\n" - "s.save(\"Customer\", david);\n" - "s.save(\"Organization\", foobar);\n" - "\n" - "tx.commit();\n" - "s.close();]]>" +"<![CDATA[Session s = openSession();\n" +"Transaction tx = s.beginTransaction();\n" +"Session s = openSession();\n" +"\n" +"// Create a customer\n" +"Map david = new HashMap();\n" +"david.put(\"name\", \"David\");\n" +"\n" +"// Create an organization\n" +"Map foobar = new HashMap();\n" +"foobar.put(\"name\", \"Foobar Inc.\");\n" +"\n" +"// Link both\n" +"david.put(\"organization\", foobar);\n" +"\n" +"// Save both\n" +"s.save(\"Customer\", david);\n" +"s.save(\"Organization\", foobar);\n" +"\n" +"tx.commit();\n" +"s.close();]]>" msgstr "" - "<![CDATA[Session s = openSession(); -\n" - "Transaction tx = s.beginTransaction(); -\n" - "Session s = openSession(); -\n" - " -\n" - "// Create a customer -\n" - "Map david = new HashMap(); -\n" - "david.put(\"name\", \"David\"); -\n" - " -\n" - "// Create an organization -\n" - "Map foobar = new HashMap(); -\n" - "foobar.put(\"name\", \"Foobar Inc.\"); -\n" - " -\n" - "// Link both -\n" - "david.put(\"organization\", foobar); -\n" - " -\n" - "// Save both -\n" - "s.save(\"Customer\", david); -\n" - "s.save(\"Organization\", foobar); -\n" - " -\n" - "tx.commit(); -\n" - "s.close();]]>" -#: index.docbook:257 -msgid "The advantages of a dynamic mapping are quick turnaround time for prototyping without the need for entity class implementation. However, you lose compile-time type checking and will very likely deal with many exceptions at runtime. Thanks to the Hibernate mapping, the database schema can easily be normalized and sound, allowing to add a proper domain model implementation on top later on." -msgstr "動的なマッピングの利点は、エンティティクラスの実装を必要としないため、 プロトタイピングに要するターンアラウンドタイムが早いということです。 しかしコンパイル時の型チェックがないので、実行時に非常に多くの例外処理を扱わなければならないでしょう。 Hibernateマッピングのおかげで、データベーススキーマは容易に正規化でき、健全になり、 後で適切なドメインモデルの実装を追加することが可能になります。" +#. Tag: para +#: persistent_classes.xml:257 +#, no-c-format +msgid "" +"The advantages of a dynamic mapping are quick turnaround time for " +"prototyping without the need for entity class implementation. However, you " +"lose compile-time type checking and will very likely deal with many " +"exceptions at runtime. Thanks to the Hibernate mapping, the database schema " +"can easily be normalized and sound, allowing to add a proper domain model " +"implementation on top later on." +msgstr "" +"動的なマッピングの利点は、エンティティクラスの実装を必要としないため、 プロト" +"タイピングに要するターンアラウンドタイムが早いということです。 しかしコンパイ" +"ル時の型チェックがないので、実行時に非常に多くの例外処理を扱わなければならな" +"いでしょう。 Hibernateマッピングのおかげで、データベーススキーマは容易に正規" +"化でき、健全になり、 後で適切なドメインモデルの実装を追加することが可能になり" +"ます。" -#: index.docbook:265 -msgid "Entity representation modes can also be set on a per <literal>Session</literal> basis:" -msgstr "エンティティ表現モードは <literal>Session</literal> ごとに設定することも可能です。" +#. Tag: para +#: persistent_classes.xml:265 +#, no-c-format +msgid "" +"Entity representation modes can also be set on a per <literal>Session</" +"literal> basis:" +msgstr "" +"エンティティ表現モードは <literal>Session</literal> ごとに設定することも可能" +"です。" -#: index.docbook:270 +#. Tag: programlisting +#: persistent_classes.xml:270 +#, no-c-format msgid "" - "<![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode.MAP);\n" - "\n" - "// Create a customer\n" - "Map david = new HashMap();\n" - "david.put(\"name\", \"David\");\n" - "dynamicSession.save(\"Customer\", david);\n" - "...\n" - "dynamicSession.flush();\n" - "dynamicSession.close()\n" - "...\n" - "// Continue on pojoSession\n" - "]]>" +"<![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode.MAP);\n" +"\n" +"// Create a customer\n" +"Map david = new HashMap();\n" +"david.put(\"name\", \"David\");\n" +"dynamicSession.save(\"Customer\", david);\n" +"...\n" +"dynamicSession.flush();\n" +"dynamicSession.close()\n" +"...\n" +"// Continue on pojoSession\n" +"]]>" msgstr "" - "<![CDATA[Session dynamicSession = pojoSession.getSession(EntityMode.MAP); -\n" - " -\n" - "// Create a customer -\n" - "Map david = new HashMap(); -\n" - "david.put(\"name\", \"David\"); -\n" - "dynamicSession.save(\"Customer\", david); -\n" - "... -\n" - "dynamicSession.flush(); -\n" - "dynamicSession.close() -\n" - "... -\n" - "// Continue on pojoSession -\n" - "]]>" -#: index.docbook:273 -msgid "Please note that the call to <literal>getSession()</literal> using an <literal>EntityMode</literal> is on the <literal>Session</literal> API, not the <literal>SessionFactory</literal>. That way, the new <literal>Session</literal> shares the underlying JDBC connection, transaction, and other context information. This means you don't have tocall <literal>flush()</literal> and <literal>close()</literal> on the secondary <literal>Session</literal>, and also leave the transaction and connection handling to the primary unit of work." -msgstr "<literal>EntityMode</literal> を使った <literal>getSession()</literal> の呼び出しは <literal>SessionFactory</literal> ではなく <literal>Session</literal> APIにあることに注意してください。 その方法では、新しい <literal>Session</literal> は、ベースとなるJDBCコネクション、 トランザクション、その他のコンテキスト情報を共有します。 これは2番目の <literal>Session</literal> では <literal>flush()</literal> と <literal>close()</literal> を呼ぶ必要がないということ、そのためトランザクションとコネクションの管理を 1番目の作業単位(Unit of Work)に任せることができるということです。" +#. Tag: para +#: persistent_classes.xml:273 +#, no-c-format +msgid "" +"Please note that the call to <literal>getSession()</literal> using an " +"<literal>EntityMode</literal> is on the <literal>Session</literal> API, not " +"the <literal>SessionFactory</literal>. That way, the new <literal>Session</" +"literal> shares the underlying JDBC connection, transaction, and other " +"context information. This means you don't have tocall <literal>flush()</" +"literal> and <literal>close()</literal> on the secondary <literal>Session</" +"literal>, and also leave the transaction and connection handling to the " +"primary unit of work." +msgstr "" +"<literal>EntityMode</literal> を使った <literal>getSession()</literal> の呼び" +"出しは <literal>SessionFactory</literal> ではなく <literal>Session</literal> " +"APIにあることに注意してください。 その方法では、新しい <literal>Session</" +"literal> は、ベースとなるJDBCコネクション、 トランザクション、その他のコンテ" +"キスト情報を共有します。 これは2番目の <literal>Session</literal> では " +"<literal>flush()</literal> と <literal>close()</literal> を呼ぶ必要がないとい" +"うこと、そのためトランザクションとコネクションの管理を 1番目の作業単位(Unit " +"of Work)に任せることができるということです。" -#: index.docbook:283 -msgid "More information about the XML representation capabilities can be found in <xref linkend=\"xml\"/>." -msgstr "XML表現の能力についてのさらなる情報は <xref linkend=\"xml\"/> で見つかります。" +#. Tag: para +#: persistent_classes.xml:283 +#, no-c-format +msgid "" +"More information about the XML representation capabilities can be found in " +"<xref linkend=\"xml\"/>." +msgstr "" +"XML表現の能力についてのさらなる情報は <xref linkend=\"xml\"/> で見つかりま" +"す。" -#: index.docbook:291 +#. Tag: title +#: persistent_classes.xml:291 +#, no-c-format msgid "Tuplizers" msgstr "Tuplizer" -#: index.docbook:293 -msgid "<literal>org.hibernate.tuple.Tuplizer</literal>, and its sub-interfaces, are responsible for managing a particular representation of a piece of data, given that representation's <literal>org.hibernate.EntityMode</literal>. If a given piece of data is thought of as a data structure, then a tuplizer is the thing which knows how to create such a data structure and how to extract values from and inject values into such a data structure. For example, for the POJO entity mode, the correpsonding tuplizer knows how create the POJO through its constructor and how to access the POJO properties using the defined property accessors. There are two high-level types of Tuplizers, represented by the <literal>org.hibernate.tuple.entity.EntityTuplizer</literal> and <literal>org.hibernate.tuple.component.ComponentTuplizer</literal> interfaces. <literal>EntityTuplizer</literal>s are responsible for managing the above mentioned contracts in regards to entities, while <literal>ComponentTu! plizer</literal>s do the same for components." -msgstr "<literal>org.hibernate.tuple.Tuplizer</literal> とそのサブインターフェイスは、 表現の <literal>org.hibernate.EntityMode</literal> を利用して、 データ断片のある表現の管理に責任を持ちます。 与えられたデータ断片をデータ構造として考えるなら、Tuplizerはそのようなデータ構造を どのように作成するかを知り、そのようなデータ構造からどのように値を抽出し、 注入するかを知っています。 例えばPOJOエンティティモードでは、対応するTuplizerはコンストラクタを通して、 POJOをどのように作成するか、定義されたプロパティアクセサを使い、 POJOプロパティにどのようにアクセスするかを知ります。 Tuplizerには二つのハイレベルの型があります。 それらは、<literal>org.hibernate.tuple.EntityTuplizer</literal> と <literal>org.hibernate.tuple.ComponentTuplizer</literal> ! インターフェイスで表現されます。 <literal>EntityTuplizer</literal> は上で述べたようなエンティティに関する契約の管理に責任を持ちます。 一方、<literal>ComponentTuplizer</literal> はコンポーネントに関する契約の管理に責任を持ちます。" +#. Tag: para +#: persistent_classes.xml:293 +#, no-c-format +msgid "" +"<literal>org.hibernate.tuple.Tuplizer</literal>, and its sub-interfaces, are " +"responsible for managing a particular representation of a piece of data, " +"given that representation's <literal>org.hibernate.EntityMode</literal>. If " +"a given piece of data is thought of as a data structure, then a tuplizer is " +"the thing which knows how to create such a data structure and how to extract " +"values from and inject values into such a data structure. For example, for " +"the POJO entity mode, the correpsonding tuplizer knows how create the POJO " +"through its constructor and how to access the POJO properties using the " +"defined property accessors. There are two high-level types of Tuplizers, " +"represented by the <literal>org.hibernate.tuple.entity.EntityTuplizer</" +"literal> and <literal>org.hibernate.tuple.component.ComponentTuplizer</" +"literal> interfaces. <literal>EntityTuplizer</literal>s are responsible for " +"managing the above mentioned contracts in regards to entities, while " +"<literal>ComponentTuplizer</literal>s do the same for components." +msgstr "" +"<literal>org.hibernate.tuple.Tuplizer</literal> とそのサブインターフェイス" +"は、 表現の <literal>org.hibernate.EntityMode</literal> を利用して、 データ断" +"片のある表現の管理に責任を持ちます。 与えられたデータ断片をデータ構造として考" +"えるなら、Tuplizerはそのようなデータ構造を どのように作成するかを知り、そのよ" +"うなデータ構造からどのように値を抽出し、 注入するかを知っています。 例えば" +"POJOエンティティモードでは、対応するTuplizerはコンストラクタを通して、 POJOを" +"どのように作成するか、定義されたプロパティアクセサを使い、 POJOプロパティにど" +"のようにアクセスするかを知ります。 Tuplizerには二つのハイレベルの型がありま" +"す。 それらは、<literal>org.hibernate.tuple.EntityTuplizer</literal> と " +"<literal>org.hibernate.tuple.ComponentTuplizer</literal> インターフェイスで表" +"現されます。 <literal>EntityTuplizer</literal> は上で述べたようなエンティティ" +"に関する契約の管理に責任を持ちます。 一方、<literal>ComponentTuplizer</" +"literal> はコンポーネントに関する契約の管理に責任を持ちます。" -#: index.docbook:308 -msgid "Users may also plug in their own tuplizers. Perhaps you require that a <literal>java.util.Map</literal> implementation other than <literal>java.util.HashMap</literal> be used while in the dynamic-map entity-mode; or perhaps you need to define a different proxy generation strategy than the one used by default. Both would be achieved by defining a custom tuplizer implementation. Tuplizers definitions are attached to the entity or component mapping they are meant to manage. Going back to the example of our customer entity:" -msgstr "ユーザは独自のTuplizerに差し替えることも可能です。 おそらくdynamic-map entity-modeの際に <literal>java.util.HashMap</literal> を使うのではなく、 <literal>java.util.Map</literal> の実装が必要でしょう。 もしくは、おそらくデフォルトのものではなく、別のプロキシ生成戦略の定義が必要でしょう。 両者とも、カスタムのTuplizer実装を定義することで達成されます。 Tuplizerの定義は、管理しようとするエンティティやコンポーネントのマッピングに結び付けられます。 顧客エンティティの例に戻ると：" +#. Tag: para +#: persistent_classes.xml:308 +#, no-c-format +msgid "" +"Users may also plug in their own tuplizers. Perhaps you require that a " +"<literal>java.util.Map</literal> implementation other than <literal>java." +"util.HashMap</literal> be used while in the dynamic-map entity-mode; or " +"perhaps you need to define a different proxy generation strategy than the " +"one used by default. Both would be achieved by defining a custom tuplizer " +"implementation. Tuplizers definitions are attached to the entity or " +"component mapping they are meant to manage. Going back to the example of our " +"customer entity:" +msgstr "" +"ユーザは独自のTuplizerに差し替えることも可能です。 おそらくdynamic-map " +"entity-modeの際に <literal>java.util.HashMap</literal> を使うのではなく、 " +"<literal>java.util.Map</literal> の実装が必要でしょう。 もしくは、おそらくデ" +"フォルトのものではなく、別のプロキシ生成戦略の定義が必要でしょう。 両者とも、" +"カスタムのTuplizer実装を定義することで達成されます。 Tuplizerの定義は、管理し" +"ようとするエンティティやコンポーネントのマッピングに結び付けられます。 顧客エ" +"ンティティの例に戻ると：" -#: index.docbook:317 +#. Tag: programlisting +#: persistent_classes.xml:317 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - " <class entity-name=\"Customer\">\n" - " <!--\n" - " Override the dynamic-map entity-mode\n" - " tuplizer for the customer entity\n" - " -->\n" - " <tuplizer entity-mode=\"dynamic-map\"\n" - " class=\"CustomMapTuplizerImpl\"/>\n" - "\n" - " <id name=\"id\" type=\"long\" column=\"ID\">\n" - " <generator class=\"sequence\"/>\n" - " </id>\n" - "\n" - " <!-- other properties -->\n" - " ...\n" - " </class>\n" - "</hibernate-mapping>\n" - "\n" - "\n" - "public class CustomMapTuplizerImpl\n" - " extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {\n" - " // override the buildInstantiator() method to plug in our custom map...\n" - " protected final Instantiator buildInstantiator(\n" - " org.hibernate.mapping.PersistentClass mappingInfo) {\n" - " return new CustomMapInstantiator( mappingInfo );\n" - " }\n" - "\n" - " private static final class CustomMapInstantiator\n" - " extends org.hibernate.tuple.DynamicMapInstantitor {\n" - " // override the generateMap() method to return our custom map...\n" - " protected final Map generateMap() {\n" - " return new CustomMap();\n" - " }\n" - " }\n" - "}]]>" +"<![CDATA[<hibernate-mapping>\n" +" <class entity-name=\"Customer\">\n" +" <!--\n" +" Override the dynamic-map entity-mode\n" +" tuplizer for the customer entity\n" +" -->\n" +" <tuplizer entity-mode=\"dynamic-map\"\n" +" class=\"CustomMapTuplizerImpl\"/>\n" +"\n" +" <id name=\"id\" type=\"long\" column=\"ID\">\n" +" <generator class=\"sequence\"/>\n" +" </id>\n" +"\n" +" <!-- other properties -->\n" +" ...\n" +" </class>\n" +"</hibernate-mapping>\n" +"\n" +"\n" +"public class CustomMapTuplizerImpl\n" +" extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer {\n" +" // override the buildInstantiator() method to plug in our custom map...\n" +" protected final Instantiator buildInstantiator(\n" +" org.hibernate.mapping.PersistentClass mappingInfo) {\n" +" return new CustomMapInstantiator( mappingInfo );\n" +" }\n" +"\n" +" private static final class CustomMapInstantiator\n" +" extends org.hibernate.tuple.DynamicMapInstantitor {\n" +" // override the generateMap() method to return our custom map...\n" +" protected final Map generateMap() {\n" +" return new CustomMap();\n" +" }\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " <class entity-name=\"Customer\"> -\n" - " <!-- -\n" - " Override the dynamic-map entity-mode -\n" - " tuplizer for the customer entity -\n" - " --> -\n" - " <tuplizer entity-mode=\"dynamic-map\" -\n" - " class=\"CustomMapTuplizerImpl\"/> -\n" - " -\n" - " <id name=\"id\" type=\"long\" column=\"ID\"> -\n" - " <generator class=\"sequence\"/> -\n" - " </id> -\n" - " -\n" - " <!-- other properties --> -\n" - " ... -\n" - " </class> -\n" - "</hibernate-mapping> -\n" - " -\n" - " -\n" - "public class CustomMapTuplizerImpl -\n" - " extends org.hibernate.tuple.entity.DynamicMapEntityTuplizer { -\n" - " // override the buildInstantiator() method to plug in our custom map... -\n" - " protected final Instantiator buildInstantiator( -\n" - " org.hibernate.mapping.PersistentClass mappingInfo) { -\n" - " return new CustomMapInstantiator( mappingInfo ); -\n" - " } -\n" - " -\n" - " private static final class CustomMapInstantiator -\n" - " extends org.hibernate.tuple.DynamicMapInstantitor { -\n" - " // override the generateMap() method to return our custom map... -\n" - " protected final Map generateMap() { -\n" - " return new CustomMap(); -\n" - " } -\n" - " } -\n" - "}]]>" -#: index.docbook:322 -msgid "TODO: Document user-extension framework in the property and proxy packages" -msgstr "TODO: プロパティとプロキシパッケージのユーザ拡張フレームワークを文書化すること" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: persistent_classes.xml:322 +#, no-c-format +msgid "" +"TODO: Document user-extension framework in the property and proxy packages" +msgstr "" +"TODO: プロパティとプロキシパッケージのユーザ拡張フレームワークを文書化するこ" +"と" Modified: core/trunk/documentation/manual/translations/ja-JP/content/preface.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/preface.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/preface.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,68 +1,196 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:21 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: preface.xml:21 +#, no-c-format msgid "Preface" -msgstr "<title>前書き</title>" +msgstr "前書き" -#: index.docbook:23 -msgid "Working with object-oriented software and a relational database can be cumbersome and time consuming in today's enterprise environments. Hibernate is an object/relational mapping tool for Java environments. The term object/relational mapping (ORM) refers to the technique of mapping a data representation from an object model to a relational data model with a SQL-based schema." -msgstr "今日の企業環境において、オブジェクト指向ソフトウェアとリレーショナルデータベースに関わる作業は 煩雑で膨大な時間を必要とします。 HibernateはJava環境のオブジェクト/リレーショナルマッピングツールです。 オブジェクト/リレーショナルマッピング（ORM）とは、 オブジェクトモデルからSQLベーススキーマのリレーショナルデータモデルへと、 データ表現をマッピングする（対応付ける）技術のことです。" +#. Tag: para +#: preface.xml:23 +#, no-c-format +msgid "" +"Working with object-oriented software and a relational database can be " +"cumbersome and time consuming in today's enterprise environments. Hibernate " +"is an object/relational mapping tool for Java environments. The term object/" +"relational mapping (ORM) refers to the technique of mapping a data " +"representation from an object model to a relational data model with a SQL-" +"based schema." +msgstr "" +"今日の企業環境において、オブジェクト指向ソフトウェアとリレーショナルデータ" +"ベースに関わる作業は 煩雑で膨大な時間を必要とします。 HibernateはJava環境のオ" +"ブジェクト/リレーショナルマッピングツールです。 オブジェクト/リレーショナル" +"マッピング（ORM）とは、 オブジェクトモデルからSQLベーススキーマのリレーショナ" +"ルデータモデルへと、 データ表現をマッピングする（対応付ける）技術のことです。" -#: index.docbook:31 -msgid "Hibernate not only takes care of the mapping from Java classes to database tables (and from Java data types to SQL data types), but also provides data query and retrieval facilities and can significantly reduce development time otherwise spent with manual data handling in SQL and JDBC." -msgstr "HibernateはJavaクラスからデータベーステーブルへ（そしてJavaデータ型からSQLデータ型へ） のマッピングを処理するだけではなく、データのクエリと復元の仕組みも提供します。 このおかげでSQLとJDBCを使った手作業でのデータ処理に費やされていた開発時間を大幅に削減できます。" +#. Tag: para +#: preface.xml:31 +#, no-c-format +msgid "" +"Hibernate not only takes care of the mapping from Java classes to database " +"tables (and from Java data types to SQL data types), but also provides data " +"query and retrieval facilities and can significantly reduce development time " +"otherwise spent with manual data handling in SQL and JDBC." +msgstr "" +"HibernateはJavaクラスからデータベーステーブルへ（そしてJavaデータ型からSQL" +"データ型へ） のマッピングを処理するだけではなく、データのクエリと復元の仕組み" +"も提供します。 このおかげでSQLとJDBCを使った手作業でのデータ処理に費やされて" +"いた開発時間を大幅に削減できます。" -#: index.docbook:38 -msgid "Hibernates goal is to relieve the developer from 95 percent of common data persistence related programming tasks. Hibernate may not be the best solution for data-centric applications that only use stored-procedures to implement the business logic in the database, it is most useful with object-oriented domain models and business logic in the Java-based middle-tier. However, Hibernate can certainly help you to remove or encapsulate vendor-specific SQL code and will help with the common task of result set translation from a tabular representation to a graph of objects." -msgstr "Hibernateの最終目標は、データの永続化に関わる一般的なプログラミング作業の95％から開発者を解放することです。 Hibernateはビジネスロジックの実装にストアドプロシージャを使う データ中心アプリケーションに対してのベストソリューションであるに留まりません。 オブジェクト指向ドメインモデルとJavaベースの中間層でのビジネスロジックに対して最も役に立ちます。 しかしHibernateはベンダ固有のSQLコードを削減またはカプセル化したり、 表形式からオブジェクトのグラフへとリザルトセットを変換するなどの、 一般的なタスクにも役立つでしょう。" +#. Tag: para +#: preface.xml:38 +#, no-c-format +msgid "" +"Hibernates goal is to relieve the developer from 95 percent of common data " +"persistence related programming tasks. Hibernate may not be the best " +"solution for data-centric applications that only use stored-procedures to " +"implement the business logic in the database, it is most useful with object-" +"oriented domain models and business logic in the Java-based middle-tier. " +"However, Hibernate can certainly help you to remove or encapsulate vendor-" +"specific SQL code and will help with the common task of result set " +"translation from a tabular representation to a graph of objects." +msgstr "" +"Hibernateの最終目標は、データの永続化に関わる一般的なプログラミング作業の95％" +"から開発者を解放することです。 Hibernateはビジネスロジックの実装にストアドプ" +"ロシージャを使う データ中心アプリケーションに対してのベストソリューションであ" +"るに留まりません。 オブジェクト指向ドメインモデルとJavaベースの中間層でのビジ" +"ネスロジックに対して最も役に立ちます。 しかしHibernateはベンダ固有のSQLコード" +"を削減またはカプセル化したり、 表形式からオブジェクトのグラフへとリザルトセッ" +"トを変換するなどの、 一般的なタスクにも役立つでしょう。" -#: index.docbook:48 -msgid "If you are new to Hibernate and Object/Relational Mapping or even Java, please follow these steps:" -msgstr "Hibernateやオブジェクト/リレーショナルマッピング、 さらにはJavaが初めての方は、以下のステップに従ってください：" +#. Tag: para +#: preface.xml:48 +#, no-c-format +msgid "" +"If you are new to Hibernate and Object/Relational Mapping or even Java, " +"please follow these steps:" +msgstr "" +"Hibernateやオブジェクト/リレーショナルマッピング、 さらにはJavaが初めての方" +"は、以下のステップに従ってください：" -#: index.docbook:55 -msgid "Read <xref linkend=\"tutorial\"/> for a tutorial with step-by-step instructions. The source code for the tutorial is included in the distribution in the <literal>doc/reference/tutorial/</literal> directory." -msgstr "を読んでください。 段階的に解説していきます。 チュートリアルのソースコードはディストリビューションの <literal>doc/reference/tutorial</literal> ディレクトリに含まれています。" +#. Tag: para +#: preface.xml:55 +#, no-c-format +msgid "" +"Read <xref linkend=\"tutorial\"/> for a tutorial with step-by-step " +"instructions. The source code for the tutorial is included in the " +"distribution in the <literal>doc/reference/tutorial/</literal> directory." +msgstr "" +"<xref linkend=\"tutorial\"/> を読んでください。 段階的に解説していきます。 " +"チュートリアルのソースコードはディストリビューションの <literal>doc/" +"reference/tutorial</literal> ディレクトリに含まれています。" -#: index.docbook:63 -msgid "Read <xref linkend=\"architecture\"/> to understand the environments where Hibernate can be used." -msgstr "を読んで、Hibernateが利用可能な環境を理解してください。" +#. Tag: para +#: preface.xml:63 +#, no-c-format +msgid "" +"Read <xref linkend=\"architecture\"/> to understand the environments where " +"Hibernate can be used." +msgstr "" +"<xref linkend=\"architecture\"/> を読んで、Hibernateが利用可能な環境を理解し" +"てください。" -#: index.docbook:69 -msgid "Have a look at the <literal>eg/</literal> directory in the Hibernate distribution, it contains a simple standalone application. Copy your JDBC driver to the <literal>lib/</literal> directory and edit <literal>etc/hibernate.properties</literal>, specifying correct values for your database. From a command prompt in the distribution directory, type <literal>ant eg</literal> (using Ant), or under Windows, type <literal>build eg</literal>." -msgstr "Hibernateディストリビューションの <literal>eg/</literal> ディレクトリを見てください。 簡単なスタンドアローンのアプリケーションがあります。 JDBCドライバを <literal>lib/</literal> ディレクトリにコピーして、 自分のデータベースに合う正しい値を指定するように <literal>etc/hibernate.properties</literal> を編集してください。 ディストリビューションディレクトリから、コマンドプロンプトで <literal>ant eg</literal> とタイプしてください（Antを使います）。 またWindows環境では <literal>build eg</literal> とタイプしてください。" +#. Tag: para +#: preface.xml:69 +#, no-c-format +msgid "" +"Have a look at the <literal>eg/</literal> directory in the Hibernate " +"distribution, it contains a simple standalone application. Copy your JDBC " +"driver to the <literal>lib/</literal> directory and edit <literal>etc/" +"hibernate.properties</literal>, specifying correct values for your database. " +"From a command prompt in the distribution directory, type <literal>ant eg</" +"literal> (using Ant), or under Windows, type <literal>build eg</literal>." +msgstr "" +"Hibernateディストリビューションの <literal>eg/</literal> ディレクトリを見てく" +"ださい。 簡単なスタンドアローンのアプリケーションがあります。 JDBCドライバを " +"<literal>lib/</literal> ディレクトリにコピーして、 自分のデータベースに合う正" +"しい値を指定するように <literal>etc/hibernate.properties</literal> を編集して" +"ください。 ディストリビューションディレクトリから、コマンドプロンプトで " +"<literal>ant eg</literal> とタイプしてください（Antを使います）。 またWindows" +"環境では <literal>build eg</literal> とタイプしてください。" -#: index.docbook:80 -msgid "Use this reference documentation as your primary source of information. Consider reading <emphasis>Java Persistence with Hibernate</emphasis> (http://www.manning.com/bauer2) if you need more help with application design or if you prefer a step-by-step tutorial. Also visit http://caveatemptor.hibernate.org and download the example application for Java Persistence with Hibernate." -msgstr "このリファレンスドキュメントを第一の情報源として利用してください。 アプリケーション設計についてのさらなる情報や段階的なチュートリアルを探しているなら、 <emphasis>Java Persistence with Hibernate</emphasis>（http://www.manning.com/bauer2） をおすすめします。 またhttp://caveatemptor.hibernate.orgから Java Persistence with Hibernateの例題のアプリケーションをダウンロードできます。" +#. Tag: para +#: preface.xml:80 +#, no-c-format +msgid "" +"Use this reference documentation as your primary source of information. " +"Consider reading <emphasis>Java Persistence with Hibernate</emphasis> " +"(http://www.manning.com/bauer2) if you need more help with application " +"design or if you prefer a step-by-step tutorial. Also visit http://" +"caveatemptor.hibernate.org and download the example application for Java " +"Persistence with Hibernate." +msgstr "" +"このリファレンスドキュメントを第一の情報源として利用してください。 アプリケー" +"ション設計についてのさらなる情報や段階的なチュートリアルを探しているなら、 " +"<emphasis>Java Persistence with Hibernate</emphasis>（http://www.manning.com/" +"bauer2） をおすすめします。 またhttp://caveatemptor.hibernate.orgから Java " +"Persistence with Hibernateの例題のアプリケーションをダウンロードできます。" -#: index.docbook:90 +#. Tag: para +#: preface.xml:90 +#, no-c-format msgid "FAQs are answered on the Hibernate website." msgstr "FAQはHibernateウェブサイトにあります。" -#: index.docbook:95 -msgid "Third party demos, examples, and tutorials are linked on the Hibernate website." -msgstr "サードパーティのデモ、例、チュートリアルはHibernateウェブサイトにリンクがあります。" +#. Tag: para +#: preface.xml:95 +#, no-c-format +msgid "" +"Third party demos, examples, and tutorials are linked on the Hibernate " +"website." +msgstr "" +"サードパーティのデモ、例、チュートリアルはHibernateウェブサイトにリンクがあり" +"ます。" -#: index.docbook:101 -msgid "The Community Area on the Hibernate website is a good resource for design patterns and various integration solutions (Tomcat, JBoss AS, Struts, EJB, etc.)." -msgstr "Hibernateウェブサイトのコミュニティエリアは、デザインパターンやさまざまな統合ソリューション （Tomcat, JBoss AS, Struts, EJB, 等）についてのよい情報源です。" +#. Tag: para +#: preface.xml:101 +#, no-c-format +msgid "" +"The Community Area on the Hibernate website is a good resource for design " +"patterns and various integration solutions (Tomcat, JBoss AS, Struts, EJB, " +"etc.)." +msgstr "" +"Hibernateウェブサイトのコミュニティエリアは、デザインパターンやさまざまな統合" +"ソリューション （Tomcat, JBoss AS, Struts, EJB, 等）についてのよい情報源で" +"す。" -#: index.docbook:109 -msgid "If you have questions, use the user forum linked on the Hibernate website. We also provide a JIRA issue trackings system for bug reports and feature requests. If you are interested in the development of Hibernate, join the developer mailing list. If you are interested in translating this documentation into your language, contact us on the developer mailing list." -msgstr "質問があればHibernateウェブサイトのユーザフォーラムを活用してください。 またバグレポートとフィーチャリクエストのためJIRA課題追跡システムを用意しています。 Hibernateの開発に興味があれば、開発者メーリングリストに参加してください。 このドキュメントをあなたの国の言葉に翻訳したい場合は、 開発者メーリングリストで私たちにコンタクトを取ってください。" +#. Tag: para +#: preface.xml:109 +#, no-c-format +msgid "" +"If you have questions, use the user forum linked on the Hibernate website. " +"We also provide a JIRA issue trackings system for bug reports and feature " +"requests. If you are interested in the development of Hibernate, join the " +"developer mailing list. If you are interested in translating this " +"documentation into your language, contact us on the developer mailing list." +msgstr "" +"質問があればHibernateウェブサイトのユーザフォーラムを活用してください。 また" +"バグレポートとフィーチャリクエストのためJIRA課題追跡システムを用意していま" +"す。 Hibernateの開発に興味があれば、開発者メーリングリストに参加してくださ" +"い。 このドキュメントをあなたの国の言葉に翻訳したい場合は、 開発者メーリング" +"リストで私たちにコンタクトを取ってください。" -#: index.docbook:117 -msgid "Commercial development support, production support, and training for Hibernate is available through JBoss Inc. (see http://www.hibernate.org/SupportTraining/). Hibernate is a Professional Open Source project and a critical component of the JBoss Enterprise Middleware System (JEMS) suite of products." -msgstr "商用開発のサポート、製品のサポート、HibernateのトレーニングはJBoss Inc.が提供しています （http://www.hibernate.org/SupportTraining/を見てください）。 HibernateはProfessional Open Sourceプロジェクト、 そしてJBoss Enterprise Middleware System（JEMS）プロダクトスイートのクリティカルコンポーネントです。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: preface.xml:117 +#, no-c-format +msgid "" +"Commercial development support, production support, and training for " +"Hibernate is available through JBoss Inc. (see http://www.hibernate.org/" +"SupportTraining/). Hibernate is a Professional Open Source project and a " +"critical component of the JBoss Enterprise Middleware System (JEMS) suite of " +"products." +msgstr "" +"商用開発のサポート、製品のサポート、HibernateのトレーニングはJBoss Inc.が提供" +"しています （http://www.hibernate.org/SupportTraining/を見てください）。 " +"HibernateはProfessional Open Sourceプロジェクト、 そしてJBoss Enterprise " +"Middleware System（JEMS）プロダクトスイートのクリティカルコンポーネントです。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/query_criteria.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/query_criteria.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/query_criteria.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,672 +1,773 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: query_criteria.xml:5 +#, no-c-format msgid "Criteria Queries" msgstr "Criteriaクエリ" -#: index.docbook:7 +#. Tag: para +#: query_criteria.xml:7 +#, no-c-format msgid "Hibernate features an intuitive, extensible criteria query API." msgstr "Hibernateには、直感的で拡張可能なcriteriaクエリAPIが用意されています。" -#: index.docbook:12 +#. Tag: title +#: query_criteria.xml:12 +#, no-c-format msgid "Creating a <literal>Criteria</literal> instance" msgstr "<literal>Criteria</literal> インスタンスの作成" -#: index.docbook:14 -msgid "The interface <literal>org.hibernate.Criteria</literal> represents a query against a particular persistent class. The <literal>Session</literal> is a factory for <literal>Criteria</literal> instances." -msgstr "<literal>org.hibernate.Criteria</literal> インターフェイスは特定の永続性クラスに対するクエリを表現します。 <literal>Session</literal> は <literal>Criteria</literal> インスタンスのファクトリです。" +#. Tag: para +#: query_criteria.xml:14 +#, no-c-format +msgid "" +"The interface <literal>org.hibernate.Criteria</literal> represents a query " +"against a particular persistent class. The <literal>Session</literal> is a " +"factory for <literal>Criteria</literal> instances." +msgstr "" +"<literal>org.hibernate.Criteria</literal> インターフェイスは特定の永続性クラ" +"スに対するクエリを表現します。 <literal>Session</literal> は " +"<literal>Criteria</literal> インスタンスのファクトリです。" -#: index.docbook:20 +#. Tag: programlisting +#: query_criteria.xml:20 +#, no-c-format msgid "" - "<![CDATA[Criteria crit = sess.createCriteria(Cat.class);\n" - "crit.setMaxResults(50);\n" - "List cats = crit.list();]]>" +"<![CDATA[Criteria crit = sess.createCriteria(Cat.class);\n" +"crit.setMaxResults(50);\n" +"List cats = crit.list();]]>" msgstr "" - "<![CDATA[Criteria crit = sess.createCriteria(Cat.class);\n" - "crit.setMaxResults(50);\n" - "List cats = crit.list();]]>" -#: index.docbook:25 +#. Tag: title +#: query_criteria.xml:25 +#, no-c-format msgid "Narrowing the result set" msgstr "リザルトセットの絞込み" -#: index.docbook:27 -msgid "An individual query criterion is an instance of the interface <literal>org.hibernate.criterion.Criterion</literal>. The class <literal>org.hibernate.criterion.Restrictions</literal> defines factory methods for obtaining certain built-in <literal>Criterion</literal> types." -msgstr "<literal>org.hibernate.criterion.Criterion</literal> インターフェイスのインスタンスは、 個別のクエリクライテリオン（問い合わせの判定基準）を表します。 <literal>org.hibernate.criterion.Restrictions</literal> クラスは、ある組み込みの <literal>Criterion</literal> 型を取得するためのファクトリメソッドを持っています。" +#. Tag: para +#: query_criteria.xml:27 +#, no-c-format +msgid "" +"An individual query criterion is an instance of the interface <literal>org." +"hibernate.criterion.Criterion</literal>. The class <literal>org.hibernate." +"criterion.Restrictions</literal> defines factory methods for obtaining " +"certain built-in <literal>Criterion</literal> types." +msgstr "" +"<literal>org.hibernate.criterion.Criterion</literal> インターフェイスのインス" +"タンスは、 個別のクエリクライテリオン（問い合わせの判定基準）を表します。 " +"<literal>org.hibernate.criterion.Restrictions</literal> クラスは、ある組み込" +"みの <literal>Criterion</literal> 型を取得するためのファクトリメソッドを持っ" +"ています。" -#: index.docbook:35 +#. Tag: programlisting +#: query_criteria.xml:35 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +" .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.between(\"weight\", minWeight, maxWeight) )\n" - " .list();]]>" -#: index.docbook:37 +#. Tag: para +#: query_criteria.xml:37 +#, no-c-format msgid "Restrictions may be grouped logically." msgstr "Restriction（限定）は、論理的にグループ化できます。" -#: index.docbook:41 +#. Tag: programlisting +#: query_criteria.xml:41 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.or(\n" - " Restrictions.eq( \"age\", new Integer(0) ),\n" - " Restrictions.isNull(\"age\")\n" - " ) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +" .add( Restrictions.or(\n" +" Restrictions.eq( \"age\", new Integer(0) ),\n" +" Restrictions.isNull(\"age\")\n" +" ) )\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .add( Restrictions.or(\n" - " Restrictions.eq( \"age\", new Integer(0) ),\n" - " Restrictions.isNull(\"age\")\n" - " ) )\n" - " .list();]]>" -#: index.docbook:43 +#. Tag: programlisting +#: query_criteria.xml:43 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .add( Restrictions.disjunction()\n" - " .add( Restrictions.isNull(\"age\") )\n" - " .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" - " ) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", \"Pk" +"\" } ) )\n" +" .add( Restrictions.disjunction()\n" +" .add( Restrictions.isNull(\"age\") )\n" +" .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" +" .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" +" .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" +" ) )\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.in( \"name\", new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .add( Restrictions.disjunction()\n" - " .add( Restrictions.isNull(\"age\") )\n" - " .add( Restrictions.eq(\"age\", new Integer(0) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(1) ) )\n" - " .add( Restrictions.eq(\"age\", new Integer(2) ) )\n" - " ) )\n" - " .list();]]>" -#: index.docbook:45 -msgid "There are quite a range of built-in criterion types (<literal>Restrictions</literal> subclasses), but one that is especially useful lets you specify SQL directly." -msgstr "元々あるCriterion型（<literal>Restrictions</literal> のサブクラス） はかなりの範囲に及びますが、特に有用なのはSQLを直接指定できるものです。" +#. Tag: para +#: query_criteria.xml:45 +#, no-c-format +msgid "" +"There are quite a range of built-in criterion types (<literal>Restrictions</" +"literal> subclasses), but one that is especially useful lets you specify SQL " +"directly." +msgstr "" +"元々あるCriterion型（<literal>Restrictions</literal> のサブクラス） はかなり" +"の範囲に及びますが、特に有用なのはSQLを直接指定できるものです。" -#: index.docbook:50 +#. Tag: programlisting +#: query_criteria.xml:50 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)\", \"Fritz%\", Hibernate.STRING) )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)\", " +"\"Fritz%\", Hibernate.STRING) )\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.sqlRestriction(\"lower({alias}.name) like lower(?)\", \"Fritz%\", Hibernate.STRING) )\n" - " .list();]]>" -#: index.docbook:52 -msgid "The <literal>{alias}</literal> placeholder with be replaced by the row alias of the queried entity." -msgstr "<literal>{alias}</literal> というプレースホルダは、 問い合わせを受けたエンティティの行の別名によって置き換えられます。" +#. Tag: para +#: query_criteria.xml:52 +#, no-c-format +msgid "" +"The <literal>{alias}</literal> placeholder with be replaced by the row alias " +"of the queried entity." +msgstr "" +"<literal>{alias}</literal> というプレースホルダは、 問い合わせを受けたエン" +"ティティの行の別名によって置き換えられます。" -#: index.docbook:57 -msgid "An alternative approach to obtaining a criterion is to get it from a <literal>Property</literal> instance. You can create a <literal>Property</literal> by calling <literal>Property.forName()</literal>." -msgstr "criterionを得る別の手段は、 <literal>Property</literal> インスタンスから取得することです。 <literal>Property.forName()</literal> を呼び出して、 <literal>Property</literal> インスタンスを作成できます。" +#. Tag: para +#: query_criteria.xml:57 +#, no-c-format +msgid "" +"An alternative approach to obtaining a criterion is to get it from a " +"<literal>Property</literal> instance. You can create a <literal>Property</" +"literal> by calling <literal>Property.forName()</literal>." +msgstr "" +"criterionを得る別の手段は、 <literal>Property</literal> インスタンスから取得" +"することです。 <literal>Property.forName()</literal> を呼び出して、 " +"<literal>Property</literal> インスタンスを作成できます。" -#: index.docbook:63 +#. Tag: programlisting +#: query_criteria.xml:63 +#, no-c-format msgid "" - "<![CDATA[\n" - "Property age = Property.forName(\"age\");\n" - "List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.disjunction()\n" - " .add( age.isNull() )\n" - " .add( age.eq( new Integer(0) ) )\n" - " .add( age.eq( new Integer(1) ) )\n" - " .add( age.eq( new Integer(2) ) )\n" - " ) )\n" - " .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .list();]]>" +"<![CDATA[\n" +"Property age = Property.forName(\"age\");\n" +"List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.disjunction()\n" +" .add( age.isNull() )\n" +" .add( age.eq( new Integer(0) ) )\n" +" .add( age.eq( new Integer(1) ) )\n" +" .add( age.eq( new Integer(2) ) )\n" +" ) )\n" +" .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi\", " +"\"Pk\" } ) )\n" +" .list();]]>" msgstr "" - "<![CDATA[\n" - "Property age = Property.forName(\"age\");\n" - "List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.disjunction()\n" - " .add( age.isNull() )\n" - " .add( age.eq( new Integer(0) ) )\n" - " .add( age.eq( new Integer(1) ) )\n" - " .add( age.eq( new Integer(2) ) )\n" - " ) )\n" - " .add( Property.forName(\"name\").in( new String[] { \"Fritz\", \"Izi\", \"Pk\" } ) )\n" - " .list();]]>" -#: index.docbook:68 +#. Tag: title +#: query_criteria.xml:68 +#, no-c-format msgid "Ordering the results" msgstr "結果の整列" -#: index.docbook:70 -msgid "You may order the results using <literal>org.hibernate.criterion.Order</literal>." -msgstr "<literal>org.hibernate.criterion.Order</literal> を使って結果を並び替えることができます。" +#. Tag: para +#: query_criteria.xml:70 +#, no-c-format +msgid "" +"You may order the results using <literal>org.hibernate.criterion.Order</" +"literal>." +msgstr "" +"<literal>org.hibernate.criterion.Order</literal> を使って結果を並び替えること" +"ができます。" -#: index.docbook:74 +#. Tag: programlisting +#: query_criteria.xml:74 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\")\n" - " .addOrder( Order.asc(\"name\") )\n" - " .addOrder( Order.desc(\"age\") )\n" - " .setMaxResults(50)\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"F%\")\n" +" .addOrder( Order.asc(\"name\") )\n" +" .addOrder( Order.desc(\"age\") )\n" +" .setMaxResults(50)\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\")\n" - " .addOrder( Order.asc(\"name\") )\n" - " .addOrder( Order.desc(\"age\") )\n" - " .setMaxResults(50)\n" - " .list();]]>" -#: index.docbook:76 +#. Tag: programlisting +#: query_criteria.xml:76 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Property.forName(\"name\").like(\"F%\") )\n" - " .addOrder( Property.forName(\"name\").asc() )\n" - " .addOrder( Property.forName(\"age\").desc() )\n" - " .setMaxResults(50)\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Property.forName(\"name\").like(\"F%\") )\n" +" .addOrder( Property.forName(\"name\").asc() )\n" +" .addOrder( Property.forName(\"age\").desc() )\n" +" .setMaxResults(50)\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Property.forName(\"name\").like(\"F%\") )\n" - " .addOrder( Property.forName(\"name\").asc() )\n" - " .addOrder( Property.forName(\"age\").desc() )\n" - " .setMaxResults(50)\n" - " .list();]]>" -#: index.docbook:81 +#. Tag: title +#: query_criteria.xml:81 +#, no-c-format msgid "Associations" -msgstr "<title>関連</title>" +msgstr "関連" -#: index.docbook:83 -msgid "You may easily specify constraints upon related entities by navigating associations using <literal>createCriteria()</literal>." -msgstr "<literal>createCriteria()</literal> を使い、関連をナビゲートすることで、 容易に関係するエンティティに制約を指定できます。" +#. Tag: para +#: query_criteria.xml:83 +#, no-c-format +msgid "" +"You may easily specify constraints upon related entities by navigating " +"associations using <literal>createCriteria()</literal>." +msgstr "" +"<literal>createCriteria()</literal> を使い、関連をナビゲートすることで、 容易" +"に関係するエンティティに制約を指定できます。" -#: index.docbook:88 +#. Tag: programlisting +#: query_criteria.xml:88 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .createCriteria(\"kittens\")\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"F%\") )\n" +" .createCriteria(\"kittens\")\n" +" .add( Restrictions.like(\"name\", \"F%\") )\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .createCriteria(\"kittens\")\n" - " .add( Restrictions.like(\"name\", \"F%\") )\n" - " .list();]]>" -#: index.docbook:90 -msgid "note that the second <literal>createCriteria()</literal> returns a new instance of <literal>Criteria</literal>, which refers to the elements of the <literal>kittens</literal> collection." -msgstr "2番目の <literal>createCriteria()</literal> は、<literal>kittens</literal> コレクションの要素を参照する新しい <literal>Criteria</literal> インスタンスを返すことに注意してください。" +#. Tag: para +#: query_criteria.xml:90 +#, no-c-format +msgid "" +"note that the second <literal>createCriteria()</literal> returns a new " +"instance of <literal>Criteria</literal>, which refers to the elements of the " +"<literal>kittens</literal> collection." +msgstr "" +"2番目の <literal>createCriteria()</literal> は、<literal>kittens</literal> コ" +"レクションの要素を参照する新しい <literal>Criteria</literal> インスタンスを返" +"すことに注意してください。" -#: index.docbook:96 +#. Tag: para +#: query_criteria.xml:96 +#, no-c-format msgid "The following, alternate form is useful in certain circumstances." msgstr "以下のような方法も、状況により有用です。" -#: index.docbook:100 +#. Tag: programlisting +#: query_criteria.xml:100 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createAlias(\"kittens\", \"kt\")\n" - " .createAlias(\"mate\", \"mt\")\n" - " .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .createAlias(\"kittens\", \"kt\")\n" +" .createAlias(\"mate\", \"mt\")\n" +" .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createAlias(\"kittens\", \"kt\")\n" - " .createAlias(\"mate\", \"mt\")\n" - " .add( Restrictions.eqProperty(\"kt.name\", \"mt.name\") )\n" - " .list();]]>" -#: index.docbook:102 -msgid "(<literal>createAlias()</literal> does not create a new instance of <literal>Criteria</literal>.)" -msgstr "（<literal>createAlias()</literal> は新しい <literal>Criteria</literal> インスタンスを作成しません。）" +#. Tag: para +#: query_criteria.xml:102 +#, no-c-format +msgid "" +"(<literal>createAlias()</literal> does not create a new instance of " +"<literal>Criteria</literal>.)" +msgstr "" +"（<literal>createAlias()</literal> は新しい <literal>Criteria</literal> イン" +"スタンスを作成しません。）" -#: index.docbook:107 -msgid "Note that the kittens collections held by the <literal>Cat</literal> instances returned by the previous two queries are <emphasis>not</emphasis> pre-filtered by the criteria! If you wish to retrieve just the kittens that match the criteria, you must use a <literal>ResultTransformer</literal>." -msgstr "前の2つのクエリによって返される <literal>Cat</literal> インスタンスによって保持されるkittensコレクションは、 criteriaによって事前にフィルタリング <emphasis>されない</emphasis> ことに注意してください。 もしcriteriaに適合するkittenを取得したいなら、 <literal>ResultTransformer</literal> を使わなければなりません。" +#. Tag: para +#: query_criteria.xml:107 +#, no-c-format +msgid "" +"Note that the kittens collections held by the <literal>Cat</literal> " +"instances returned by the previous two queries are <emphasis>not</emphasis> " +"pre-filtered by the criteria! If you wish to retrieve just the kittens that " +"match the criteria, you must use a <literal>ResultTransformer</literal>." +msgstr "" +"前の2つのクエリによって返される <literal>Cat</literal> インスタンスによって保" +"持されるkittensコレクションは、 criteriaによって事前にフィルタリング " +"<emphasis>されない</emphasis> ことに注意してください。 もしcriteriaに適合する" +"kittenを取得したいなら、 <literal>ResultTransformer</literal> を使わなければ" +"なりません。" -#: index.docbook:114 +#. Tag: programlisting +#: query_criteria.xml:114 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createCriteria(\"kittens\", \"kt\")\n" - " .add( Restrictions.eq(\"name\", \"F%\") )\n" - " .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" - " .list();\n" - "Iterator iter = cats.iterator();\n" - "while ( iter.hasNext() ) {\n" - " Map map = (Map) iter.next();\n" - " Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" - " Cat kitten = (Cat) map.get(\"kt\");\n" - "}]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .createCriteria(\"kittens\", \"kt\")\n" +" .add( Restrictions.eq(\"name\", \"F%\") )\n" +" .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" +" .list();\n" +"Iterator iter = cats.iterator();\n" +"while ( iter.hasNext() ) {\n" +" Map map = (Map) iter.next();\n" +" Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" +" Cat kitten = (Cat) map.get(\"kt\");\n" +"}]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .createCriteria(\"kittens\", \"kt\")\n" - " .add( Restrictions.eq(\"name\", \"F%\") )\n" - " .setResultTransformer(Criteria.ALIAS_TO_ENTITY_MAP)\n" - " .list();\n" - "Iterator iter = cats.iterator();\n" - "while ( iter.hasNext() ) {\n" - " Map map = (Map) iter.next();\n" - " Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS);\n" - " Cat kitten = (Cat) map.get(\"kt\");\n" - "}]]>" -#: index.docbook:119 +#. Tag: title +#: query_criteria.xml:119 +#, no-c-format msgid "Dynamic association fetching" msgstr "関連の動的フェッチ" -#: index.docbook:121 -msgid "You may specify association fetching semantics at runtime using <literal>setFetchMode()</literal>." -msgstr "<literal>setFetchMode()</literal> を使い、 実行時に関連の復元方法を指定してもよいです。" +#. Tag: para +#: query_criteria.xml:121 +#, no-c-format +msgid "" +"You may specify association fetching semantics at runtime using " +"<literal>setFetchMode()</literal>." +msgstr "" +"<literal>setFetchMode()</literal> を使い、 実行時に関連の復元方法を指定しても" +"よいです。" -#: index.docbook:126 +#. Tag: programlisting +#: query_criteria.xml:126 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .setFetchMode(\"mate\", FetchMode.EAGER)\n" - " .setFetchMode(\"kittens\", FetchMode.EAGER)\n" - " .list();]]>" +"<![CDATA[List cats = sess.createCriteria(Cat.class)\n" +" .add( Restrictions.like(\"name\", \"Fritz%\") )\n" +" .setFetchMode(\"mate\", FetchMode.EAGER)\n" +" .setFetchMode(\"kittens\", FetchMode.EAGER)\n" +" .list();]]>" msgstr "" - "<![CDATA[List cats = sess.createCriteria(Cat.class)\n" - " .add( Restrictions.like(\"name\", \"Fritz%\") )\n" - " .setFetchMode(\"mate\", FetchMode.EAGER)\n" - " .setFetchMode(\"kittens\", FetchMode.EAGER)\n" - " .list();]]>" -#: index.docbook:128 -msgid "This query will fetch both <literal>mate</literal> and <literal>kittens</literal> by outer join. See <xref linkend=\"performance-fetching\"/> for more information." -msgstr "このクエリは外部結合により <literal>mate</literal> と <literal>kittens</literal> の両方をフェッチします。 より多くの情報は <xref linkend=\"performance-fetching\"/> を参照してください。" +#. Tag: para +#: query_criteria.xml:128 +#, no-c-format +msgid "" +"This query will fetch both <literal>mate</literal> and <literal>kittens</" +"literal> by outer join. See <xref linkend=\"performance-fetching\"/> for " +"more information." +msgstr "" +"このクエリは外部結合により <literal>mate</literal> と <literal>kittens</" +"literal> の両方をフェッチします。 より多くの情報は <xref linkend=" +"\"performance-fetching\"/> を参照してください。" -#: index.docbook:136 +#. Tag: title +#: query_criteria.xml:136 +#, no-c-format msgid "Example queries" msgstr "クエリの例" -#: index.docbook:138 -msgid "The class <literal>org.hibernate.criterion.Example</literal> allows you to construct a query criterion from a given instance." -msgstr "<literal>org.hibernate.criterion.Example</literal> クラスは、 与えられたインスタンスからクエリクライテリオンを構築できます。" +#. Tag: para +#: query_criteria.xml:138 +#, no-c-format +msgid "" +"The class <literal>org.hibernate.criterion.Example</literal> allows you to " +"construct a query criterion from a given instance." +msgstr "" +"<literal>org.hibernate.criterion.Example</literal> クラスは、 与えられたイン" +"スタンスからクエリクライテリオンを構築できます。" -#: index.docbook:143 +#. Tag: programlisting +#: query_criteria.xml:143 +#, no-c-format msgid "" - "<![CDATA[Cat cat = new Cat();\n" - "cat.setSex('F');\n" - "cat.setColor(Color.BLACK);\n" - "List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .list();]]>" +"<![CDATA[Cat cat = new Cat();\n" +"cat.setSex('F');\n" +"cat.setColor(Color.BLACK);\n" +"List results = session.createCriteria(Cat.class)\n" +" .add( Example.create(cat) )\n" +" .list();]]>" msgstr "" - "<![CDATA[Cat cat = new Cat();\n" - "cat.setSex('F');\n" - "cat.setColor(Color.BLACK);\n" - "List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .list();]]>" -#: index.docbook:145 -msgid "Version properties, identifiers and associations are ignored. By default, null valued properties are excluded." -msgstr "バージョンプロパティ、識別子、関連は無視されます。 デフォルトではnull値のプロパティは除外されます。" +#. Tag: para +#: query_criteria.xml:145 +#, no-c-format +msgid "" +"Version properties, identifiers and associations are ignored. By default, " +"null valued properties are excluded." +msgstr "" +"バージョンプロパティ、識別子、関連は無視されます。 デフォルトではnull値のプロ" +"パティは除外されます。" -#: index.docbook:150 +#. Tag: para +#: query_criteria.xml:150 +#, no-c-format msgid "You can adjust how the <literal>Example</literal> is applied." -msgstr "どのように <literal>Example</literal> を適用するか 調整することができます。" +msgstr "" +"どのように <literal>Example</literal> を適用するか 調整することができます。" -#: index.docbook:154 +#. Tag: programlisting +#: query_criteria.xml:154 +#, no-c-format msgid "" - "<![CDATA[Example example = Example.create(cat)\n" - " .excludeZeroes() //exclude zero valued properties\n" - " .excludeProperty(\"color\") //exclude the property named \"color\"\n" - " .ignoreCase() //perform case insensitive string comparisons\n" - " .enableLike(); //use like for string comparisons\n" - "List results = session.createCriteria(Cat.class)\n" - " .add(example)\n" - " .list();]]>" +"<![CDATA[Example example = Example.create(cat)\n" +" .excludeZeroes() //exclude zero valued properties\n" +" .excludeProperty(\"color\") //exclude the property named \"color\"\n" +" .ignoreCase() //perform case insensitive string " +"comparisons\n" +" .enableLike(); //use like for string comparisons\n" +"List results = session.createCriteria(Cat.class)\n" +" .add(example)\n" +" .list();]]>" msgstr "" - "<![CDATA[Example example = Example.create(cat)\n" - " .excludeZeroes() //exclude zero valued properties\n" - " .excludeProperty(\"color\") //exclude the property named \"color\"\n" - " .ignoreCase() //perform case insensitive string comparisons\n" - " .enableLike(); //use like for string comparisons\n" - "List results = session.createCriteria(Cat.class)\n" - " .add(example)\n" - " .list();]]>" -#: index.docbook:156 +#. Tag: para +#: query_criteria.xml:156 +#, no-c-format msgid "You can even use examples to place criteria upon associated objects." -msgstr "関連オブジェクトにcriteriaを指定するために、Exampleを使うことも可能です。" +msgstr "" +"関連オブジェクトにcriteriaを指定するために、Exampleを使うことも可能です。" -#: index.docbook:160 +#. Tag: programlisting +#: query_criteria.xml:160 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .createCriteria(\"mate\")\n" - " .add( Example.create( cat.getMate() ) )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .add( Example.create(cat) )\n" +" .createCriteria(\"mate\")\n" +" .add( Example.create( cat.getMate() ) )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .add( Example.create(cat) )\n" - " .createCriteria(\"mate\")\n" - " .add( Example.create( cat.getMate() ) )\n" - " .list();]]>" -#: index.docbook:165 +#. Tag: title +#: query_criteria.xml:165 +#, no-c-format msgid "Projections, aggregation and grouping" msgstr "射影、集約、グループ化" -#: index.docbook:166 -msgid "The class <literal>org.hibernate.criterion.Projections</literal> is a factory for <literal>Projection</literal> instances. We apply a projection to a query by calling <literal>setProjection()</literal>." -msgstr "<literal>org.hibernate.criterion.Projections</literal> クラスは <literal>Projection</literal> インスタンスのファクトリです。 <literal>setProjection()</literal> を呼び出すことで、 クエリに射影を適用します。" +#. Tag: para +#: query_criteria.xml:166 +#, no-c-format +msgid "" +"The class <literal>org.hibernate.criterion.Projections</literal> is a " +"factory for <literal>Projection</literal> instances. We apply a projection " +"to a query by calling <literal>setProjection()</literal>." +msgstr "" +"<literal>org.hibernate.criterion.Projections</literal> クラスは " +"<literal>Projection</literal> インスタンスのファクトリです。 " +"<literal>setProjection()</literal> を呼び出すことで、 クエリに射影を適用しま" +"す。" -#: index.docbook:172 +#. Tag: programlisting +#: query_criteria.xml:172 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.rowCount() )\n" - " .add( Restrictions.eq(\"color\", Color.BLACK) )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.rowCount() )\n" +" .add( Restrictions.eq(\"color\", Color.BLACK) )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.rowCount() )\n" - " .add( Restrictions.eq(\"color\", Color.BLACK) )\n" - " .list();]]>" -#: index.docbook:174 +#. Tag: programlisting +#: query_criteria.xml:174 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount() )\n" - " .add( Projections.avg(\"weight\") )\n" - " .add( Projections.max(\"weight\") )\n" - " .add( Projections.groupProperty(\"color\") )\n" - " )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.rowCount() )\n" +" .add( Projections.avg(\"weight\") )\n" +" .add( Projections.max(\"weight\") )\n" +" .add( Projections.groupProperty(\"color\") )\n" +" )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount() )\n" - " .add( Projections.avg(\"weight\") )\n" - " .add( Projections.max(\"weight\") )\n" - " .add( Projections.groupProperty(\"color\") )\n" - " )\n" - " .list();]]>" -#: index.docbook:176 -msgid "There is no explicit \"group by\" necessary in a criteria query. Certain projection types are defined to be <emphasis>grouping projections</emphasis>, which also appear in the SQL <literal>group by</literal> clause." -msgstr "必要であっても、criteriaクエリに「group by」を明示する必要はありません。 ある種のProjection型は <emphasis>グループ化射影</emphasis> として定義され、 SQLの <literal>group by</literal> 節にも現れます。" +#. Tag: para +#: query_criteria.xml:176 +#, no-c-format +msgid "" +"There is no explicit \"group by\" necessary in a criteria query. Certain " +"projection types are defined to be <emphasis>grouping projections</" +"emphasis>, which also appear in the SQL <literal>group by</literal> clause." +msgstr "" +"必要であっても、criteriaクエリに「group by」を明示する必要はありません。 ある" +"種のProjection型は <emphasis>グループ化射影</emphasis> として定義され、 SQL" +"の <literal>group by</literal> 節にも現れます。" -#: index.docbook:182 -msgid "An alias may optionally be assigned to a projection, so that the projected value may be referred to in restrictions or orderings. Here are two different ways to do this:" -msgstr "任意で射影に別名を付けられるため、射影される値はrestrictionやordering内から参照できます。 別名をつける２つの異なる方法を示します。" +#. Tag: para +#: query_criteria.xml:182 +#, no-c-format +msgid "" +"An alias may optionally be assigned to a projection, so that the projected " +"value may be referred to in restrictions or orderings. Here are two " +"different ways to do this:" +msgstr "" +"任意で射影に別名を付けられるため、射影される値はrestrictionやordering内から参" +"照できます。 別名をつける２つの異なる方法を示します。" -#: index.docbook:188 +#. Tag: programlisting +#: query_criteria.xml:188 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.alias( Projections.groupProperty(\"color\"), \"colr\" ) )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.alias( Projections.groupProperty(\"color\"), " +"\"colr\" ) )\n" +" .addOrder( Order.asc(\"colr\") )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.alias( Projections.groupProperty(\"color\"), \"colr\" ) )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" -#: index.docbook:190 +#. Tag: programlisting +#: query_criteria.xml:190 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" +" .addOrder( Order.asc(\"colr\") )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.groupProperty(\"color\").as(\"colr\") )\n" - " .addOrder( Order.asc(\"colr\") )\n" - " .list();]]>" -#: index.docbook:192 -msgid "The <literal>alias()</literal> and <literal>as()</literal> methods simply wrap a projection instance in another, aliased, instance of <literal>Projection</literal>. As a shortcut, you can assign an alias when you add the projection to a projection list:" -msgstr "<literal>alias()</literal> と <literal>as()</literal> メソッドは、 Projectionインスタンスを別の名前の <literal>Projection</literal> インスタンスで ラップするだけです。 ショートカットとして、射影を射影リストに追加する際に、別名をつけられます。" +#. Tag: para +#: query_criteria.xml:192 +#, no-c-format +msgid "" +"The <literal>alias()</literal> and <literal>as()</literal> methods simply " +"wrap a projection instance in another, aliased, instance of " +"<literal>Projection</literal>. As a shortcut, you can assign an alias when " +"you add the projection to a projection list:" +msgstr "" +"<literal>alias()</literal> と <literal>as()</literal> メソッドは、 Projection" +"インスタンスを別の名前の <literal>Projection</literal> インスタンスで ラップ" +"するだけです。 ショートカットとして、射影を射影リストに追加する際に、別名をつ" +"けられます。" -#: index.docbook:199 +#. Tag: programlisting +#: query_criteria.xml:199 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount(), \"catCountByColor\" )\n" - " .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" - " .add( Projections.max(\"weight\"), \"maxWeight\" )\n" - " .add( Projections.groupProperty(\"color\"), \"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.rowCount(), \"catCountByColor\" )\n" +" .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" +" .add( Projections.max(\"weight\"), \"maxWeight\" )\n" +" .add( Projections.groupProperty(\"color\"), \"color\" )\n" +" )\n" +" .addOrder( Order.desc(\"catCountByColor\") )\n" +" .addOrder( Order.desc(\"avgWeight\") )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount(), \"catCountByColor\" )\n" - " .add( Projections.avg(\"weight\"), \"avgWeight\" )\n" - " .add( Projections.max(\"weight\"), \"maxWeight\" )\n" - " .add( Projections.groupProperty(\"color\"), \"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" -#: index.docbook:201 +#. Tag: programlisting +#: query_criteria.xml:201 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Domestic.class, \"cat\")\n" - " .createAlias(\"kittens\", \"kit\")\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.property(\"cat.name\"), \"catName\" )\n" - " .add( Projections.property(\"kit.name\"), \"kitName\" )\n" - " )\n" - " .addOrder( Order.asc(\"catName\") )\n" - " .addOrder( Order.asc(\"kitName\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Domestic.class, \"cat\")\n" +" .createAlias(\"kittens\", \"kit\")\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.property(\"cat.name\"), \"catName\" )\n" +" .add( Projections.property(\"kit.name\"), \"kitName\" )\n" +" )\n" +" .addOrder( Order.asc(\"catName\") )\n" +" .addOrder( Order.asc(\"kitName\") )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Domestic.class, \"cat\")\n" - " .createAlias(\"kittens\", \"kit\")\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.property(\"cat.name\"), \"catName\" )\n" - " .add( Projections.property(\"kit.name\"), \"kitName\" )\n" - " )\n" - " .addOrder( Order.asc(\"catName\") )\n" - " .addOrder( Order.asc(\"kitName\") )\n" - " .list();]]>" -#: index.docbook:203 -msgid "You can also use <literal>Property.forName()</literal> to express projections:" +#. Tag: para +#: query_criteria.xml:203 +#, no-c-format +msgid "" +"You can also use <literal>Property.forName()</literal> to express " +"projections:" msgstr "射影の式に <literal>Property.forName()</literal> も使用できます。" -#: index.docbook:207 +#. Tag: programlisting +#: query_criteria.xml:207 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Property.forName(\"name\") )\n" - " .add( Property.forName(\"color\").eq(Color.BLACK) )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Property.forName(\"name\") )\n" +" .add( Property.forName(\"color\").eq(Color.BLACK) )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Property.forName(\"name\") )\n" - " .add( Property.forName(\"color\").eq(Color.BLACK) )\n" - " .list();]]>" -#: index.docbook:209 +#. Tag: programlisting +#: query_criteria.xml:209 +#, no-c-format msgid "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount().as(\"catCountByColor\") )\n" - " .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" - " .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" - " .add( Property.forName(\"color\").group().as(\"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" +"<![CDATA[List results = session.createCriteria(Cat.class)\n" +" .setProjection( Projections.projectionList()\n" +" .add( Projections.rowCount().as(\"catCountByColor\") )\n" +" .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" +" .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" +" .add( Property.forName(\"color\").group().as(\"color\" )\n" +" )\n" +" .addOrder( Order.desc(\"catCountByColor\") )\n" +" .addOrder( Order.desc(\"avgWeight\") )\n" +" .list();]]>" msgstr "" - "<![CDATA[List results = session.createCriteria(Cat.class)\n" - " .setProjection( Projections.projectionList()\n" - " .add( Projections.rowCount().as(\"catCountByColor\") )\n" - " .add( Property.forName(\"weight\").avg().as(\"avgWeight\") )\n" - " .add( Property.forName(\"weight\").max().as(\"maxWeight\") )\n" - " .add( Property.forName(\"color\").group().as(\"color\" )\n" - " )\n" - " .addOrder( Order.desc(\"catCountByColor\") )\n" - " .addOrder( Order.desc(\"avgWeight\") )\n" - " .list();]]>" -#: index.docbook:214 +#. Tag: title +#: query_criteria.xml:214 +#, no-c-format msgid "Detached queries and subqueries" msgstr "クエリおよびサブクエリの分離" -#: index.docbook:215 -msgid "The <literal>DetachedCriteria</literal> class lets you create a query outside the scope of a session, and then later execute it using some arbitrary <literal>Session</literal>." -msgstr "<literal>DetachedCriteria</literal> クラスにより、 セッションスコープ外にクエリを作成できます。 後で、任意の <literal>Session</literal> を使って、実行できます。" +#. Tag: para +#: query_criteria.xml:215 +#, no-c-format +msgid "" +"The <literal>DetachedCriteria</literal> class lets you create a query " +"outside the scope of a session, and then later execute it using some " +"arbitrary <literal>Session</literal>." +msgstr "" +"<literal>DetachedCriteria</literal> クラスにより、 セッションスコープ外にクエ" +"リを作成できます。 後で、任意の <literal>Session</literal> を使って、実行でき" +"ます。" -#: index.docbook:220 +#. Tag: programlisting +#: query_criteria.xml:220 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" - " .add( Property.forName(\"sex\").eq('F') );\n" - " \n" - "Session session = ....;\n" - "Transaction txn = session.beginTransaction();\n" - "List results = query.getExecutableCriteria(session).setMaxResults(100).list();\n" - "txn.commit();\n" - "session.close();]]>" +"<![CDATA[DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" +" .add( Property.forName(\"sex\").eq('F') );\n" +" \n" +"Session session = ....;\n" +"Transaction txn = session.beginTransaction();\n" +"List results = query.getExecutableCriteria(session).setMaxResults(100).list" +"();\n" +"txn.commit();\n" +"session.close();]]>" msgstr "" - "<![CDATA[DetachedCriteria query = DetachedCriteria.forClass(Cat.class)\n" - " .add( Property.forName(\"sex\").eq('F') );\n" - " \n" - "Session session = ....;\n" - "Transaction txn = session.beginTransaction();\n" - "List results = query.getExecutableCriteria(session).setMaxResults(100).list();\n" - "txn.commit();\n" - "session.close();]]>" -#: index.docbook:222 -msgid "A <literal>DetachedCriteria</literal> may also be used to express a subquery. Criterion instances involving subqueries may be obtained via <literal>Subqueries</literal> or <literal>Property</literal>." -msgstr "<literal>DetachedCriteria</literal> は、サブクエリを表現するためにも使えます。 サブクエリを伴うCriterionインスタンスは、 <literal>Subqueries</literal> もしくは <literal>Property</literal> から得られます。" +#. Tag: para +#: query_criteria.xml:222 +#, no-c-format +msgid "" +"A <literal>DetachedCriteria</literal> may also be used to express a " +"subquery. Criterion instances involving subqueries may be obtained via " +"<literal>Subqueries</literal> or <literal>Property</literal>." +msgstr "" +"<literal>DetachedCriteria</literal> は、サブクエリを表現するためにも使えま" +"す。 サブクエリを伴うCriterionインスタンスは、 <literal>Subqueries</literal> " +"もしくは <literal>Property</literal> から得られます。" -#: index.docbook:228 +#. Tag: programlisting +#: query_criteria.xml:228 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\").avg() );\n" - "session.createCriteria(Cat.class)\n" - " .add( Property.forName(\"weight\").gt(avgWeight) )\n" - " .list();]]>" +"<![CDATA[DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class)\n" +" .setProjection( Property.forName(\"weight\").avg() );\n" +"session.createCriteria(Cat.class)\n" +" .add( Property.forName(\"weight\").gt(avgWeight) )\n" +" .list();]]>" msgstr "" - "<![CDATA[DetachedCriteria avgWeight = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\").avg() );\n" - "session.createCriteria(Cat.class)\n" - " .add( Property.forName(\"weight\").gt(avgWeight) )\n" - " .list();]]>" -#: index.docbook:230 +#. Tag: programlisting +#: query_criteria.xml:230 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\") );\n" - "session.createCriteria(Cat.class)\n" - " .add( Subqueries.geAll(\"weight\", weights) )\n" - " .list();]]>" +"<![CDATA[DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" +" .setProjection( Property.forName(\"weight\") );\n" +"session.createCriteria(Cat.class)\n" +" .add( Subqueries.geAll(\"weight\", weights) )\n" +" .list();]]>" msgstr "" - "<![CDATA[DetachedCriteria weights = DetachedCriteria.forClass(Cat.class)\n" - " .setProjection( Property.forName(\"weight\") );\n" - "session.createCriteria(Cat.class)\n" - " .add( Subqueries.geAll(\"weight\", weights) )\n" - " .list();]]>" -#: index.docbook:232 +#. Tag: para +#: query_criteria.xml:232 +#, no-c-format msgid "Even correlated subqueries are possible:" msgstr "相互関係があるサブクエリでさえも可能です。" -#: index.docbook:236 +#. Tag: programlisting +#: query_criteria.xml:236 +#, no-c-format msgid "" - "<![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat.class, \"cat2\")\n" - " .setProjection( Property.forName(\"weight\").avg() )\n" - " .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" - "session.createCriteria(Cat.class, \"cat\")\n" - " .add( Property.forName(\"weight\").gt(avgWeightForSex) )\n" - " .list();]]>" +"<![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat." +"class, \"cat2\")\n" +" .setProjection( Property.forName(\"weight\").avg() )\n" +" .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" +"session.createCriteria(Cat.class, \"cat\")\n" +" .add( Property.forName(\"weight\").gt(avgWeightForSex) )\n" +" .list();]]>" msgstr "" - "<![CDATA[DetachedCriteria avgWeightForSex = DetachedCriteria.forClass(Cat.class, \"cat2\")\n" - " .setProjection( Property.forName(\"weight\").avg() )\n" - " .add( Property.forName(\"cat2.sex\").eqProperty(\"cat.sex\") );\n" - "session.createCriteria(Cat.class, \"cat\")\n" - " .add( Property.forName(\"weight\").gt(avgWeightForSex) )\n" - " .list();]]>" -#: index.docbook:245 +#. Tag: title +#: query_criteria.xml:245 +#, no-c-format msgid "Queries by natural identifier" msgstr "自然識別子によるクエリ" -#: index.docbook:247 -msgid "For most queries, including criteria queries, the query cache is not very efficient, because query cache invalidation occurs too frequently. However, there is one special kind of query where we can optimize the cache invalidation algorithm: lookups by a constant natural key. In some applications, this kind of query occurs frequently. The criteria API provides special provision for this use case." -msgstr "criteriaクエリを含むたいていのクエリにとって、 クエリキャッシュはあまり効率がよくないです。 なぜなら、クエリキャッシュが頻繁に無効になるためです。 しかしながら、キャッシュを無効にするアルゴリズムを最適化できる 特別なクエリの種類が１つあります。 更新されない自然キーによる検索です。 いくつかのアプリケーションでは、この種類のクエリが頻繁に現れます。 このような使われ方のために、criteria APIは特別な対策を提供します。" +#. Tag: para +#: query_criteria.xml:247 +#, no-c-format +msgid "" +"For most queries, including criteria queries, the query cache is not very " +"efficient, because query cache invalidation occurs too frequently. However, " +"there is one special kind of query where we can optimize the cache " +"invalidation algorithm: lookups by a constant natural key. In some " +"applications, this kind of query occurs frequently. The criteria API " +"provides special provision for this use case." +msgstr "" +"criteriaクエリを含むたいていのクエリにとって、 クエリキャッシュはあまり効率が" +"よくないです。 なぜなら、クエリキャッシュが頻繁に無効になるためです。 しかし" +"ながら、キャッシュを無効にするアルゴリズムを最適化できる 特別なクエリの種類が" +"１つあります。 更新されない自然キーによる検索です。 いくつかのアプリケーショ" +"ンでは、この種類のクエリが頻繁に現れます。 このような使われ方のために、" +"criteria APIは特別な対策を提供します。" -#: index.docbook:255 -msgid "First, you should map the natural key of your entity using <literal>&lt;natural-id&gt;</literal>, and enable use of the second-level cache." -msgstr "最初に、<literal>&lt;natural-id&gt;</literal> を使って、 エンティティの自然キーをマップしてください。 そして、二次キャッシュを有効にします。" +#. Tag: para +#: query_criteria.xml:255 +#, no-c-format +msgid "" +"First, you should map the natural key of your entity using <literal>&lt;" +"natural-id&gt;</literal>, and enable use of the second-level cache." +msgstr "" +"最初に、<literal>&lt;natural-id&gt;</literal> を使って、 エンティティの自然" +"キーをマップしてください。 そして、二次キャッシュを有効にします。" -#: index.docbook:260 +#. Tag: programlisting +#: query_criteria.xml:260 +#, no-c-format msgid "" - "<![CDATA[<class name=\"User\">\n" - " <cache usage=\"read-write\"/>\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <natural-id>\n" - " <property name=\"name\"/>\n" - " <property name=\"org\"/>\n" - " </natural-id>\n" - " <property name=\"password\"/>\n" - "</class>]]>" +"<![CDATA[<class name=\"User\">\n" +" <cache usage=\"read-write\"/>\n" +" <id name=\"id\">\n" +" <generator class=\"increment\"/>\n" +" </id>\n" +" <natural-id>\n" +" <property name=\"name\"/>\n" +" <property name=\"org\"/>\n" +" </natural-id>\n" +" <property name=\"password\"/>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"User\">\n" - " <cache usage=\"read-write\"/>\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <natural-id>\n" - " <property name=\"name\"/>\n" - " <property name=\"org\"/>\n" - " </natural-id>\n" - " <property name=\"password\"/>\n" - "</class>]]>" -#: index.docbook:262 -msgid "Note that this functionality is not intended for use with entities with <emphasis>mutable</emphasis> natural keys." -msgstr "注意： <emphasis>変更される</emphasis> 自然キーを持つエンティティに この機能を使うのは、意図されていない使い方です。" +#. Tag: para +#: query_criteria.xml:262 +#, no-c-format +msgid "" +"Note that this functionality is not intended for use with entities with " +"<emphasis>mutable</emphasis> natural keys." +msgstr "" +"注意： <emphasis>変更される</emphasis> 自然キーを持つエンティティに この機能" +"を使うのは、意図されていない使い方です。" -#: index.docbook:267 +#. Tag: para +#: query_criteria.xml:267 +#, no-c-format msgid "Next, enable the Hibernate query cache." msgstr "次に、Hibernateクエリキャッシュを有効にします。" -#: index.docbook:271 -msgid "Now, <literal>Restrictions.naturalId()</literal> allows us to make use of the more efficient cache algorithm." -msgstr "これで、<literal>Restrictions.naturalId()</literal> により、 より効率的なキャッシュアルゴリズムを使用できます。" +#. Tag: para +#: query_criteria.xml:271 +#, no-c-format +msgid "" +"Now, <literal>Restrictions.naturalId()</literal> allows us to make use of " +"the more efficient cache algorithm." +msgstr "" +"これで、<literal>Restrictions.naturalId()</literal> により、 より効率的な" +"キャッシュアルゴリズムを使用できます。" -#: index.docbook:276 +#. Tag: programlisting +#: query_criteria.xml:276 +#, no-c-format msgid "" - "<![CDATA[session.createCriteria(User.class)\n" - " .add( Restrictions.naturalId()\n" - " .set(\"name\", \"gavin\")\n" - " .set(\"org\", \"hb\") \n" - " ).setCacheable(true)\n" - " .uniqueResult();]]>" +"<![CDATA[session.createCriteria(User.class)\n" +" .add( Restrictions.naturalId()\n" +" .set(\"name\", \"gavin\")\n" +" .set(\"org\", \"hb\") \n" +" ).setCacheable(true)\n" +" .uniqueResult();]]>" msgstr "" - "<![CDATA[session.createCriteria(User.class)\n" - " .add( Restrictions.naturalId()\n" - " .set(\"name\", \"gavin\")\n" - " .set(\"org\", \"hb\") \n" - " ).setCacheable(true)\n" - " .uniqueResult();]]>" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - Modified: core/trunk/documentation/manual/translations/ja-JP/content/query_hql.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/query_hql.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/query_hql.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1694 +1,2399 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: query_hql.xml:5 +#, no-c-format msgid "HQL: The Hibernate Query Language" msgstr "HQL: The Hibernate Query Language" -#: index.docbook:7 -msgid "Hibernate is equipped with an extremely powerful query language that (quite intentionally) looks very much like SQL. But don't be fooled by the syntax; HQL is fully object-oriented, understanding notions like inheritence, polymorphism and association." -msgstr "HibernateはSQLに非常によく似た(意図的に似せた)強力な問い合わせ言語を備えています。 しかしSQLに似た構文に惑わされないでください。HQLは完全にオブジェクト指向であり、 継承、ポリモーフィズム、関連といった概念を理解します。" +#. Tag: para +#: query_hql.xml:7 +#, no-c-format +msgid "" +"Hibernate is equipped with an extremely powerful query language that (quite " +"intentionally) looks very much like SQL. But don't be fooled by the syntax; " +"HQL is fully object-oriented, understanding notions like inheritence, " +"polymorphism and association." +msgstr "" +"HibernateはSQLに非常によく似た(意図的に似せた)強力な問い合わせ言語を備えてい" +"ます。 しかしSQLに似た構文に惑わされないでください。HQLは完全にオブジェクト指" +"向であり、 継承、ポリモーフィズム、関連といった概念を理解します。" -#: index.docbook:14 +#. Tag: title +#: query_hql.xml:14 +#, no-c-format msgid "Case Sensitivity" msgstr "大文字と小文字の区別" -#: index.docbook:16 -msgid "Queries are case-insensitive, except for names of Java classes and properties. So <literal>SeLeCT</literal> is the same as <literal>sELEct</literal> is the same as <literal>SELECT</literal> but <literal>org.hibernate.eg.FOO</literal> is not <literal>org.hibernate.eg.Foo</literal> and <literal>foo.barSet</literal> is not <literal>foo.BARSET</literal>." -msgstr "クエリはJavaのクラス名とプロパティ名を除いて大文字、小文字を区別しません。 従って <literal>SeLeCT</literal> は <literal>sELEct</literal> と同じで、かつ <literal>SELECT</literal> とも同じですが <literal>net.sf.hibernate.eg.FOO</literal> は <literal>net.sf.hibernate.eg.Foo</literal> とは違い、かつ <literal>foo.barSet</literal> は <literal>foo.BARSET</literal> とも違います。" +#. Tag: para +#: query_hql.xml:16 +#, no-c-format +msgid "" +"Queries are case-insensitive, except for names of Java classes and " +"properties. So <literal>SeLeCT</literal> is the same as <literal>sELEct</" +"literal> is the same as <literal>SELECT</literal> but <literal>org.hibernate." +"eg.FOO</literal> is not <literal>org.hibernate.eg.Foo</literal> and " +"<literal>foo.barSet</literal> is not <literal>foo.BARSET</literal>." +msgstr "" +"クエリはJavaのクラス名とプロパティ名を除いて大文字、小文字を区別しません。 " +"従って <literal>SeLeCT</literal> は <literal>sELEct</literal> と同じで、かつ " +"<literal>SELECT</literal> とも同じですが <literal>net.sf.hibernate.eg.FOO</" +"literal> は <literal>net.sf.hibernate.eg.Foo</literal> とは違い、かつ " +"<literal>foo.barSet</literal> は <literal>foo.BARSET</literal> とも違います。" -#: index.docbook:27 -msgid "This manual uses lowercase HQL keywords. Some users find queries with uppercase keywords more readable, but we find this convention ugly when embedded in Java code." -msgstr "このマニュアルでは小文字のHQLキーワードを使用します。 大文字のキーワードのクエリの方が読みやすいと感じるユーザーもいると思います。 ですが、Javaコード内に埋め込まれたときには見づらいと思います。" +#. Tag: para +#: query_hql.xml:27 +#, no-c-format +msgid "" +"This manual uses lowercase HQL keywords. Some users find queries with " +"uppercase keywords more readable, but we find this convention ugly when " +"embedded in Java code." +msgstr "" +"このマニュアルでは小文字のHQLキーワードを使用します。 大文字のキーワードのク" +"エリの方が読みやすいと感じるユーザーもいると思います。 ですが、Javaコード内に" +"埋め込まれたときには見づらいと思います。" -#: index.docbook:35 +#. Tag: title +#: query_hql.xml:35 +#, no-c-format msgid "The from clause" msgstr "from節" -#: index.docbook:37 +#. Tag: para +#: query_hql.xml:37 +#, no-c-format msgid "The simplest possible Hibernate query is of the form:" msgstr "もっとも単純なHibernateクエリは次の形式です。" -#: index.docbook:41 +#. Tag: programlisting +#: query_hql.xml:41 +#, no-c-format msgid "<![CDATA[from eg.Cat]]>" -msgstr "<![CDATA[from eg.Cat]]>" +msgstr "" -#: index.docbook:43 -msgid "which simply returns all instances of the class <literal>eg.Cat</literal>. We don't usually need to qualify the class name, since <literal>auto-import</literal> is the default. So we almost always just write:" -msgstr "これは単純に　<literal>eg.Cat</literal>　クラスのインスタンスをすべて返します。 必ずしもクラス名を修飾する（クラスにパッケージ名を付ける）必要はありません。 というのも、<literal>auto-import</literal> がデフォルトになっているからです。 そのためほとんどの場合、このように書くだけで十分です。" +#. Tag: para +#: query_hql.xml:43 +#, no-c-format +msgid "" +"which simply returns all instances of the class <literal>eg.Cat</literal>. " +"We don't usually need to qualify the class name, since <literal>auto-import</" +"literal> is the default. So we almost always just write:" +msgstr "" +"これは単純に　<literal>eg.Cat</literal>　クラスのインスタンスをすべて返しま" +"す。 必ずしもクラス名を修飾する（クラスにパッケージ名を付ける）必要はありませ" +"ん。 というのも、<literal>auto-import</literal> がデフォルトになっているから" +"です。 そのためほとんどの場合、このように書くだけで十分です。" -#: index.docbook:49 +#. Tag: programlisting +#: query_hql.xml:49 +#, no-c-format msgid "<![CDATA[from Cat]]>" -msgstr "<![CDATA[from Cat]]>" +msgstr "" -#: index.docbook:51 -msgid "Most of the time, you will need to assign an <emphasis>alias</emphasis>, since you will want to refer to the <literal>Cat</literal> in other parts of the query." -msgstr "ほとんどの場合クエリのほかの部分で　<literal>Cat</literal>　を参照するので、別名を割り当てる必要があるでしょう。" +#. Tag: para +#: query_hql.xml:51 +#, no-c-format +msgid "" +"Most of the time, you will need to assign an <emphasis>alias</emphasis>, " +"since you will want to refer to the <literal>Cat</literal> in other parts of " +"the query." +msgstr "" +"ほとんどの場合クエリのほかの部分で　<literal>Cat</literal>　を参照するので、" +"別名を割り当てる必要があるでしょう。" -#: index.docbook:57, index.docbook:372 +#. Tag: programlisting +#: query_hql.xml:57 query_hql.xml:372 +#, no-c-format msgid "<![CDATA[from Cat as cat]]>" -msgstr "<![CDATA[from Cat as cat]]>" +msgstr "" -#: index.docbook:59 -msgid "This query assigns the alias <literal>cat</literal> to <literal>Cat</literal> instances, so we could use that alias later in the query. The <literal>as</literal> keyword is optional; we could also write:" -msgstr "このクエリでは <literal>Cat</literal> インスタンスに <literal>cat</literal> という別名を付けています。 そのため、後でこのクエリ内で、この別名を使うことができます。 <literal>as</literal> キーワードはオプションです。つまりこのように書くこともできます：" +#. Tag: para +#: query_hql.xml:59 +#, no-c-format +msgid "" +"This query assigns the alias <literal>cat</literal> to <literal>Cat</" +"literal> instances, so we could use that alias later in the query. The " +"<literal>as</literal> keyword is optional; we could also write:" +msgstr "" +"このクエリでは <literal>Cat</literal> インスタンスに <literal>cat</literal> " +"という別名を付けています。 そのため、後でこのクエリ内で、この別名を使うことが" +"できます。 <literal>as</literal> キーワードはオプションです。つまりこのように" +"書くこともできます：" -#: index.docbook:65 +#. Tag: programlisting +#: query_hql.xml:65 +#, no-c-format msgid "<![CDATA[from Cat cat]]>" -msgstr "<![CDATA[from Cat cat]]>" +msgstr "" -#: index.docbook:67 -msgid "Multiple classes may appear, resulting in a cartesian product or \"cross\" join." +#. Tag: para +#: query_hql.xml:67 +#, no-c-format +msgid "" +"Multiple classes may appear, resulting in a cartesian product or \"cross\" " +"join." msgstr "直積、あるいはクロス結合によって多数のクラスが出現することもあります。" -#: index.docbook:71 +#. Tag: programlisting +#: query_hql.xml:71 +#, no-c-format msgid "<![CDATA[from Formula, Parameter]]>" -msgstr "<![CDATA[from Formula, Parameter]]>" +msgstr "" -#: index.docbook:72 +#. Tag: programlisting +#: query_hql.xml:72 +#, no-c-format msgid "<![CDATA[from Formula as form, Parameter as param]]>" -msgstr "<![CDATA[from Formula as form, Parameter as param]]>" +msgstr "" -#: index.docbook:74 -msgid "It is considered good practice to name query aliases using an initial lowercase, consistent with Java naming standards for local variables (eg. <literal>domesticCat</literal>)." -msgstr "ローカル変数のJavaのネーミング基準と一致した、 頭文字に小文字を使ったクエリの別名を付けることはいい習慣です(例えば <literal>domesticCat</literal> )。" +#. Tag: para +#: query_hql.xml:74 +#, no-c-format +msgid "" +"It is considered good practice to name query aliases using an initial " +"lowercase, consistent with Java naming standards for local variables (eg. " +"<literal>domesticCat</literal>)." +msgstr "" +"ローカル変数のJavaのネーミング基準と一致した、 頭文字に小文字を使ったクエリの" +"別名を付けることはいい習慣です(例えば <literal>domesticCat</literal> )。" -#: index.docbook:83 +#. Tag: title +#: query_hql.xml:83 +#, no-c-format msgid "Associations and joins" msgstr "関連と結合" -#: index.docbook:85 -msgid "We may also assign aliases to associated entities, or even to elements of a collection of values, using a <literal>join</literal>." -msgstr "関連するエンティティあるいは値コレクションの要素にも、<literal>結合</literal> を使って別名を割り当てることが出来ます。" +#. Tag: para +#: query_hql.xml:85 +#, no-c-format +msgid "" +"We may also assign aliases to associated entities, or even to elements of a " +"collection of values, using a <literal>join</literal>." +msgstr "" +"関連するエンティティあるいは値コレクションの要素にも、<literal>結合</" +"literal> を使って別名を割り当てることが出来ます。" -#: index.docbook:90 +#. Tag: programlisting +#: query_hql.xml:90 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " inner join cat.mate as mate\n" - " left outer join cat.kittens as kitten]]>" +"<![CDATA[from Cat as cat\n" +" inner join cat.mate as mate\n" +" left outer join cat.kittens as kitten]]>" msgstr "" - "<![CDATA[from Cat as cat -\n" - " inner join cat.mate as mate -\n" - " left outer join cat.kittens as kitten]]>" -#: index.docbook:92 +#. Tag: programlisting +#: query_hql.xml:92 +#, no-c-format msgid "<![CDATA[from Cat as cat left join cat.mate.kittens as kittens]]>" -msgstr "<![CDATA[from Cat as cat left join cat.mate.kittens as kittens]]>" +msgstr "" -#: index.docbook:94 +#. Tag: programlisting +#: query_hql.xml:94 +#, no-c-format msgid "<![CDATA[from Formula form full join form.parameter param]]>" -msgstr "<![CDATA[from Formula form full join form.parameter param]]>" +msgstr "" -#: index.docbook:96 +#. Tag: para +#: query_hql.xml:96 +#, no-c-format msgid "The supported join types are borrowed from ANSI SQL" msgstr "サポートしている結合のタイプはANSI SQLと同じです。" -#: index.docbook:103 +#. Tag: literal +#: query_hql.xml:103 +#, no-c-format msgid "inner join" msgstr "inner join" -#: index.docbook:108 +#. Tag: literal +#: query_hql.xml:108 +#, no-c-format msgid "left outer join" msgstr "left outer join" -#: index.docbook:113 +#. Tag: literal +#: query_hql.xml:113 +#, no-c-format msgid "right outer join" msgstr "right outer join" -#: index.docbook:117 +#. Tag: para +#: query_hql.xml:117 +#, no-c-format msgid "<literal>full join</literal> (not usually useful)" msgstr "<literal>full join</literal> (たいていの場合使いづらい)" -#: index.docbook:123 -msgid "The <literal>inner join</literal>, <literal>left outer join</literal> and <literal>right outer join</literal> constructs may be abbreviated." -msgstr "<literal>inner join</literal>、<literal>left outer join</literal>、<literal>right outer join</literal>には省略形を使うこともできます。" +#. Tag: para +#: query_hql.xml:123 +#, no-c-format +msgid "" +"The <literal>inner join</literal>, <literal>left outer join</literal> and " +"<literal>right outer join</literal> constructs may be abbreviated." +msgstr "" +"<literal>inner join</literal>、<literal>left outer join</literal>、" +"<literal>right outer join</literal>には省略形を使うこともできます。" -#: index.docbook:128 +#. Tag: programlisting +#: query_hql.xml:128 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " join cat.mate as mate\n" - " left join cat.kittens as kitten]]>" +"<![CDATA[from Cat as cat\n" +" join cat.mate as mate\n" +" left join cat.kittens as kitten]]>" msgstr "" - "<![CDATA[from Cat as cat -\n" - " join cat.mate as mate -\n" - " left join cat.kittens as kitten]]>" -#: index.docbook:130 -msgid "You may supply extra join conditions using the HQL <literal>with</literal> keyword." -msgstr "HQLの <literal>with</literal> キーワードを使うと、結合条件を付け加えることができます。" +#. Tag: para +#: query_hql.xml:130 +#, no-c-format +msgid "" +"You may supply extra join conditions using the HQL <literal>with</literal> " +"keyword." +msgstr "" +"HQLの <literal>with</literal> キーワードを使うと、結合条件を付け加えることが" +"できます。" -#: index.docbook:135 +#. Tag: programlisting +#: query_hql.xml:135 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " left join cat.kittens as kitten\n" - " with kitten.bodyWeight > 10.0]]>" +"<![CDATA[from Cat as cat\n" +" left join cat.kittens as kitten\n" +" with kitten.bodyWeight > 10.0]]>" msgstr "" - "<![CDATA[from Cat as cat -\n" - " left join cat.kittens as kitten -\n" - " with kitten.bodyWeight > 10.0]]>" -#: index.docbook:137 -msgid "In addition, a \"fetch\" join allows associations or collections of values to be initialized along with their parent objects, using a single select. This is particularly useful in the case of a collection. It effectively overrides the outer join and lazy declarations of the mapping file for associations and collections. See <xref linkend=\"performance-fetching\"/> for more information." -msgstr "加えて、「フェッチ」結合は関連や値のコレクションを親オブジェクトと一緒に1度のselect句で初期化します。 これは特にコレクションの場合に有用です。これは実質上、関連とコレクションに対するマッピング定義ファイルの外部結合とlazy初期化の定義を上書きすることになります。 <xref linkend=\"performance-fetching\"/> により多くの情報があります。" +#. Tag: para +#: query_hql.xml:137 +#, no-c-format +msgid "" +"In addition, a \"fetch\" join allows associations or collections of values " +"to be initialized along with their parent objects, using a single select. " +"This is particularly useful in the case of a collection. It effectively " +"overrides the outer join and lazy declarations of the mapping file for " +"associations and collections. See <xref linkend=\"performance-fetching\"/> " +"for more information." +msgstr "" +"加えて、「フェッチ」結合は関連や値のコレクションを親オブジェクトと一緒に1度の" +"select句で初期化します。 これは特にコレクションの場合に有用です。これは実質" +"上、関連とコレクションに対するマッピング定義ファイルの外部結合とlazy初期化の" +"定義を上書きすることになります。 <xref linkend=\"performance-fetching\"/> に" +"より多くの情報があります。" -#: index.docbook:145 +#. Tag: programlisting +#: query_hql.xml:145 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " inner join fetch cat.mate\n" - " left join fetch cat.kittens]]>" +"<![CDATA[from Cat as cat\n" +" inner join fetch cat.mate\n" +" left join fetch cat.kittens]]>" msgstr "" - "<![CDATA[from Cat as cat -\n" - " inner join fetch cat.mate -\n" - " left join fetch cat.kittens]]>" -#: index.docbook:147 -msgid "A fetch join does not usually need to assign an alias, because the associated objects should not be used in the <literal>where</literal> clause (or any other clause). Also, the associated objects are not returned directly in the query results. Instead, they may be accessed via the parent object. The only reason we might need an alias is if we are recursively join fetching a further collection:" -msgstr "結合によるフェッチは関連するオブジェクトが <literal>where</literal> 節(または他のどんな節でも) で使われてはならないので、通常別名を割り当てる必要がありません。また関連オブジェクトは問い合わせ結果として 直接返されません。代わりに親オブジェクトを通してアクセスできます。 コレクションを再帰的に結合フェッチする場合のみ、別名が必要になります。" +#. Tag: para +#: query_hql.xml:147 +#, no-c-format +msgid "" +"A fetch join does not usually need to assign an alias, because the " +"associated objects should not be used in the <literal>where</literal> clause " +"(or any other clause). Also, the associated objects are not returned " +"directly in the query results. Instead, they may be accessed via the parent " +"object. The only reason we might need an alias is if we are recursively join " +"fetching a further collection:" +msgstr "" +"結合によるフェッチは関連するオブジェクトが <literal>where</literal> 節(または" +"他のどんな節でも) で使われてはならないので、通常別名を割り当てる必要がありま" +"せん。また関連オブジェクトは問い合わせ結果として 直接返されません。代わりに親" +"オブジェクトを通してアクセスできます。 コレクションを再帰的に結合フェッチする" +"場合のみ、別名が必要になります。" -#: index.docbook:155 +#. Tag: programlisting +#: query_hql.xml:155 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - " inner join fetch cat.mate\n" - " left join fetch cat.kittens child\n" - " left join fetch child.kittens]]>" +"<![CDATA[from Cat as cat\n" +" inner join fetch cat.mate\n" +" left join fetch cat.kittens child\n" +" left join fetch child.kittens]]>" msgstr "" - "<![CDATA[from Cat as cat -\n" - " inner join fetch cat.mate -\n" - " left join fetch cat.kittens child -\n" - " left join fetch child.kittens]]>" -#: index.docbook:157 -msgid "Note that the <literal>fetch</literal> construct may not be used in queries called using <literal>iterate()</literal> (though <literal>scroll()</literal> can be used). Nor should <literal>fetch</literal> be used together with <literal>setMaxResults()</literal> or <literal>setFirstResult()</literal> as these operations are based on the result rows, which usually contain duplicates for eager collection fetching, hence, the number of rows is not what you'd expect. Nor may <literal>fetch</literal> be used together with an ad hoc <literal>with</literal> condition. It is possible to create a cartesian product by join fetching more than one collection in a query, so take care in this case. Join fetching multiple collection roles also sometimes gives unexpected results for bag mappings, so be careful about how you formulate your queries in this case. Finally, note that <literal>full join fetch</literal> and <literal>right join fetch</literal> are not meaningful." -msgstr "<literal>fetch</literal> 構文は <literal>iterate()</literal> を使ったクエリ呼び出しで使用できないことに注意してください （一方で <literal>scroll()</literal> は使用できます）。 また、これらの操作は結果の行に基づいているため、 <literal>fetch</literal> は <literal>setMaxResults()</literal> や <literal>setFirstResult()</literal> と一緒に使用すべきではありません。 通常eagerなコレクションフェッチをすると重複が出てしまうため、あなたが期待するような行数にはならないのです。 そしてまた <literal>fetch</literal> は、アドホックな <literal>with</literal> 条件を 一緒に使うこともできません。 一つのクエリで複数のコレクションを結合フェッチすることにより直積を作成できるので、この場合注意してください。 また、複数のコレクションに対する結合フェッ�! �はbagマッピングに対して予期せぬ結果をもたらすことがあるので、 この場合のクエリの作成には注意してください。 最後に <literal>全外部結合によるフェッチ</literal> と <literal>右外部結合によるフェッチ</literal> は有用ではないことに注意してください。" +#. Tag: para +#: query_hql.xml:157 +#, no-c-format +msgid "" +"Note that the <literal>fetch</literal> construct may not be used in queries " +"called using <literal>iterate()</literal> (though <literal>scroll()</" +"literal> can be used). Nor should <literal>fetch</literal> be used together " +"with <literal>setMaxResults()</literal> or <literal>setFirstResult()</" +"literal> as these operations are based on the result rows, which usually " +"contain duplicates for eager collection fetching, hence, the number of rows " +"is not what you'd expect. Nor may <literal>fetch</literal> be used together " +"with an ad hoc <literal>with</literal> condition. It is possible to create a " +"cartesian product by join fetching more than one collection in a query, so " +"take care in this case. Join fetching multiple collection roles also " +"sometimes gives unexpected results for bag mappings, so be careful about how " +"you formulate your queries in this case. Finally, note that <literal>full " +"join fetch</literal> and <literal>right join fetch</literal> are not " +"meaningful." +msgstr "" +"<literal>fetch</literal> 構文は <literal>iterate()</literal> を使ったクエリ呼" +"び出しで使用できないことに注意してください （一方で <literal>scroll()</" +"literal> は使用できます）。 また、これらの操作は結果の行に基づいているため、 " +"<literal>fetch</literal> は <literal>setMaxResults()</literal> や " +"<literal>setFirstResult()</literal> と一緒に使用すべきではありません。 通常" +"eagerなコレクションフェッチをすると重複が出てしまうため、あなたが期待するよう" +"な行数にはならないのです。 そしてまた <literal>fetch</literal> は、アドホック" +"な <literal>with</literal> 条件を 一緒に使うこともできません。 一つのクエリで" +"複数のコレクションを結合フェッチすることにより直積を作成できるので、この場合" +"注意してください。 また、複数のコレクションに対する結合フェッチはbagマッピン" +"グに対して予期せぬ結果をもたらすことがあるので、 この場合のクエリの作成には注" +"意してください。 最後に <literal>全外部結合によるフェッチ</literal> と " +"<literal>右外部結合によるフェッチ</literal> は有用ではないことに注意してくだ" +"さい。" -#: index.docbook:172 -msgid "If you are using property-level lazy fetching (with bytecode instrumentation), it is possible to force Hibernate to fetch the lazy properties immediately (in the first query) using <literal>fetch all properties</literal>." -msgstr "もしプロパティレベルの遅延フェッチを使う場合（内部的にバイトコード処理をする場合）、 <literal>fetch all properties</literal> を使うことで Hibernateに遅延プロパティを速やかに（最初のクエリで）フェッチさせることができます。" +#. Tag: para +#: query_hql.xml:172 +#, no-c-format +msgid "" +"If you are using property-level lazy fetching (with bytecode " +"instrumentation), it is possible to force Hibernate to fetch the lazy " +"properties immediately (in the first query) using <literal>fetch all " +"properties</literal>." +msgstr "" +"もしプロパティレベルの遅延フェッチを使う場合（内部的にバイトコード処理をする" +"場合）、 <literal>fetch all properties</literal> を使うことで Hibernateに遅延" +"プロパティを速やかに（最初のクエリで）フェッチさせることができます。" -#: index.docbook:178 +#. Tag: programlisting +#: query_hql.xml:178 +#, no-c-format msgid "<![CDATA[from Document fetch all properties order by name]]>" -msgstr "<![CDATA[from Document fetch all properties order by name]]>" +msgstr "" -#: index.docbook:179 -msgid "<![CDATA[from Document doc fetch all properties where lower(doc.name) like '%cats%']]>" -msgstr "<![CDATA[from Document doc fetch all properties where lower(doc.name) like '%cats%']]>" +#. Tag: programlisting +#: query_hql.xml:179 +#, no-c-format +msgid "" +"<![CDATA[from Document doc fetch all properties where lower(doc.name) like '%" +"cats%']]>" +msgstr "" -#: index.docbook:184 +#. Tag: title +#: query_hql.xml:184 +#, no-c-format msgid "Forms of join syntax" msgstr "結合構文の形式" -#: index.docbook:186 -msgid "HQL supports two forms of association joining: <literal>implicit</literal> and <literal>explicit</literal>." -msgstr "HQLは２つの関連結合形式をサポートします：<literal>暗黙的</literal> と <literal>明示的</literal>。" +#. Tag: para +#: query_hql.xml:186 +#, no-c-format +msgid "" +"HQL supports two forms of association joining: <literal>implicit</literal> " +"and <literal>explicit</literal>." +msgstr "" +"HQLは２つの関連結合形式をサポートします：<literal>暗黙的</literal> と " +"<literal>明示的</literal>。" -#: index.docbook:190 -msgid "The queries shown in the previous section all use the <literal>explicit</literal> form where the join keyword is explicitly used in the from clause. This is the recommended form." -msgstr "これまでのセクションでお見せした使い方はすべて <literal>明示的な</literal> 形式で、 from節で明示的にjoinキーワードを使っています。 この形式をおすすめします。" +#. Tag: para +#: query_hql.xml:190 +#, no-c-format +msgid "" +"The queries shown in the previous section all use the <literal>explicit</" +"literal> form where the join keyword is explicitly used in the from clause. " +"This is the recommended form." +msgstr "" +"これまでのセクションでお見せした使い方はすべて <literal>明示的な</literal> 形" +"式で、 from節で明示的にjoinキーワードを使っています。 この形式をおすすめしま" +"す。" -#: index.docbook:195 -msgid "The <literal>implicit</literal> form does not use the join keyword. Instead, the associations are \"dereferenced\" using dot-notation. <literal>implicit</literal> joins can appear in any of the HQL clauses. <literal>implicit</literal> join result in inner joins in the resulting SQL statement." -msgstr "<literal>暗黙的</literal> フォームは、joinキーワードを使いません。代わりに、参照する関連に ドット表記を使います。<literal>暗黙的</literal> 結合は、さまざまなHQLに出てきます。 <literal>暗黙的</literal> 結合の結果は、SQLステートメントの内部結合結果です。" +#. Tag: para +#: query_hql.xml:195 +#, no-c-format +msgid "" +"The <literal>implicit</literal> form does not use the join keyword. Instead, " +"the associations are \"dereferenced\" using dot-notation. <literal>implicit</" +"literal> joins can appear in any of the HQL clauses. <literal>implicit</" +"literal> join result in inner joins in the resulting SQL statement." +msgstr "" +"<literal>暗黙的</literal> フォームは、joinキーワードを使いません。代わりに、" +"参照する関連に ドット表記を使います。<literal>暗黙的</literal> 結合は、さまざ" +"まなHQLに出てきます。 <literal>暗黙的</literal> 結合の結果は、SQLステートメン" +"トの内部結合結果です。" -#: index.docbook:202 +#. Tag: programlisting +#: query_hql.xml:202 +#, no-c-format msgid "<![CDATA[from Cat as cat where cat.mate.name like '%s%']]>" -msgstr "<![CDATA[from Cat as cat where cat.mate.name like '%s%']]>" +msgstr "" -#: index.docbook:206 +#. Tag: title +#: query_hql.xml:206 +#, no-c-format msgid "Refering to identifier property" -msgstr "Select節" +msgstr "Refering to identifier property" -#: index.docbook:208 -msgid "There are, generally speaking, 2 ways to refer to an entity's identifier property:" -msgstr "<literal>select</literal> 節は以下のようにどのオブジェクトと属性をクエリリザルトセットに返すかを選択します。:" +#. Tag: para +#: query_hql.xml:208 +#, no-c-format +msgid "" +"There are, generally speaking, 2 ways to refer to an entity's identifier " +"property:" +msgstr "" +"There are, generally speaking, 2 ways to refer to an entity's identifier " +"property:" -#: index.docbook:213 -msgid "The special property (lowercase) <literal>id</literal> may be used to reference the identifier property of an entity <emphasis>provided that entity does not define a non-identifier property named id</emphasis>." +#. Tag: para +#: query_hql.xml:213 +#, no-c-format +msgid "" +"The special property (lowercase) <literal>id</literal> may be used to " +"reference the identifier property of an entity <emphasis>provided that " +"entity does not define a non-identifier property named id</emphasis>." msgstr "" - "<![CDATA[select mate -\n" - "from Cat as cat -\n" - " inner join cat.mate as mate]]>" +"The special property (lowercase) <literal>id</literal> may be used to " +"reference the identifier property of an entity <emphasis>provided that " +"entity does not define a non-identifier property named id</emphasis>." -#: index.docbook:220 -msgid "If the entity defines a named identifier property, you may use that property name." -msgstr "上記のクエリは他の <literal>Cat</literal> の <literal>mate</literal> を選択します。 実際には次のように、より簡潔に表現できます。:" +#. Tag: para +#: query_hql.xml:220 +#, no-c-format +msgid "" +"If the entity defines a named identifier property, you may use that property " +"name." +msgstr "" +"If the entity defines a named identifier property, you may use that property " +"name." -#: index.docbook:226 -msgid "References to composite identifier properties follow the same naming rules. If the entity has a non-identifier property named id, the composite identifier property can only be referenced by its defined named; otherwise, the special <literal>id</literal> property can be used to rerference the identifier property." -msgstr "<![CDATA[select cat.mate from Cat cat]]>" +#. Tag: para +#: query_hql.xml:226 +#, no-c-format +msgid "" +"References to composite identifier properties follow the same naming rules. " +"If the entity has a non-identifier property named id, the composite " +"identifier property can only be referenced by its defined named; otherwise, " +"the special <literal>id</literal> property can be used to rerference the " +"identifier property." +msgstr "" +"References to composite identifier properties follow the same naming rules. " +"If the entity has a non-identifier property named id, the composite " +"identifier property can only be referenced by its defined named; otherwise, " +"the special <literal>id</literal> property can be used to rerference the " +"identifier property." -#: index.docbook:233 -msgid "Note: this has changed significantly starting in version 3.2.2. In previous versions, <literal>id</literal> <emphasis>always</emphasis> referred to the identifier property no matter what its actual name. A ramification of that decision was that non-identifier properties named <literal>id</literal> could never be referenced in Hibernate queries." -msgstr "クエリはコンポーネント型のプロパティを含む、あらゆる値型のプロパティも返せます。:" +#. Tag: para +#: query_hql.xml:233 +#, fuzzy, no-c-format +msgid "" +"Note: this has changed significantly starting in version 3.2.2. In previous " +"versions, <literal>id</literal> <emphasis>always</emphasis> referred to the " +"identifier property no matter what its actual name. A ramification of that " +"decision was that non-identifier properties named <literal>id</literal> " +"could never be referenced in Hibernate queries." +msgstr "" +"Note: this has changed significantly starting in version 3.2.2. In previous " +"versions, <literal>id</literal><emphasis>always</emphasis> referred to the " +"identifier property no matter what its actual name. A ramification of that " +"decision was that non-identifier properties named <literal>id</literal> " +"could never be referenced in Hibernate queries." -#: index.docbook:242 +#. Tag: title +#: query_hql.xml:242 +#, no-c-format msgid "The select clause" +msgstr "Select節" + +#. Tag: para +#: query_hql.xml:244 +#, no-c-format +msgid "" +"The <literal>select</literal> clause picks which objects and properties to " +"return in the query result set. Consider:" msgstr "" - "<![CDATA[select cat.name from DomesticCat cat -\n" - "where cat.name like 'fri%']]>" +"<literal>select</literal> 節は以下のようにどのオブジェクトと属性をクエリリザ" +"ルトセットに返すかを選択します。:" -#: index.docbook:244 -msgid "The <literal>select</literal> clause picks which objects and properties to return in the query result set. Consider:" -msgstr "<![CDATA[select cust.name.firstName from Customer as cust]]>" +#. Tag: programlisting +#: query_hql.xml:249 +#, no-c-format +msgid "" +"<![CDATA[select mate\n" +"from Cat as cat\n" +" inner join cat.mate as mate]]>" +msgstr "" -#: index.docbook:249 +#. Tag: para +#: query_hql.xml:251 +#, no-c-format msgid "" - "<![CDATA[select mate\n" - "from Cat as cat\n" - " inner join cat.mate as mate]]>" -msgstr "クエリは複数のオブジェクトと(または)プロパティを <literal>Object[]</literal> 型の配列として返せます。" - -#: index.docbook:251 -msgid "The query will select <literal>mate</literal>s of other <literal>Cat</literal>s. Actually, you may express this query more compactly as:" +"The query will select <literal>mate</literal>s of other <literal>Cat</" +"literal>s. Actually, you may express this query more compactly as:" msgstr "" - "<![CDATA[select mother, offspr, mate.name -\n" - "from DomesticCat as mother -\n" - " inner join mother.mate as mate -\n" - " left outer join mother.kittens as offspr]]>" +"上記のクエリは他の <literal>Cat</literal> の <literal>mate</literal> を選択し" +"ます。 実際には次のように、より簡潔に表現できます。:" -#: index.docbook:256 +#. Tag: programlisting +#: query_hql.xml:256 +#, no-c-format msgid "<![CDATA[select cat.mate from Cat cat]]>" -msgstr "もしくは <literal>List</literal> として、" +msgstr "" -#: index.docbook:258 -msgid "Queries may return properties of any value type including properties of component type:" +#. Tag: para +#: query_hql.xml:258 +#, no-c-format +msgid "" +"Queries may return properties of any value type including properties of " +"component type:" msgstr "" - "<![CDATA[select new list(mother, offspr, mate.name) -\n" - "from DomesticCat as mother -\n" - " inner join mother.mate as mate -\n" - " left outer join mother.kittens as offspr]]>" +"クエリはコンポーネント型のプロパティを含む、あらゆる値型のプロパティも返せま" +"す。:" -#: index.docbook:262 +#. Tag: programlisting +#: query_hql.xml:262 +#, no-c-format msgid "" - "<![CDATA[select cat.name from DomesticCat cat\n" - "where cat.name like 'fri%']]>" -msgstr "または、タイプセーフなJavaオブジェクトを返せます。" +"<![CDATA[select cat.name from DomesticCat cat\n" +"where cat.name like 'fri%']]>" +msgstr "" -#: index.docbook:264 +#. Tag: programlisting +#: query_hql.xml:264 +#, no-c-format msgid "<![CDATA[select cust.name.firstName from Customer as cust]]>" msgstr "" - "<![CDATA[select new Family(mother, mate, offspr) -\n" - "from DomesticCat as mother -\n" - " join mother.mate as mate -\n" - " left join mother.kittens as offspr]]>" -#: index.docbook:266 -msgid "Queries may return multiple objects and/or properties as an array of type <literal>Object[]</literal>," -msgstr "あるいは <literal>Family</literal> クラスが適切なコンストラクタを持っているとするならば、" +#. Tag: para +#: query_hql.xml:266 +#, no-c-format +msgid "" +"Queries may return multiple objects and/or properties as an array of type " +"<literal>Object[]</literal>," +msgstr "" +"クエリは複数のオブジェクトと(または)プロパティを <literal>Object[]</literal> " +"型の配列として返せます。" -#: index.docbook:271 +#. Tag: programlisting +#: query_hql.xml:271 +#, no-c-format msgid "" - "<![CDATA[select mother, offspr, mate.name\n" - "from DomesticCat as mother\n" - " inner join mother.mate as mate\n" - " left outer join mother.kittens as offspr]]>" -msgstr "select節に <literal>as</literal> を使って別名をつけることもできます。" +"<![CDATA[select mother, offspr, mate.name\n" +"from DomesticCat as mother\n" +" inner join mother.mate as mate\n" +" left outer join mother.kittens as offspr]]>" +msgstr "" -#: index.docbook:273 +#. Tag: para +#: query_hql.xml:273 +#, no-c-format msgid "or as a <literal>List</literal>," -msgstr "" - "<![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n -\n" - "from Cat cat]]>" +msgstr "もしくは <literal>List</literal> として、" -#: index.docbook:277 +#. Tag: programlisting +#: query_hql.xml:277 +#, no-c-format msgid "" - "<![CDATA[select new list(mother, offspr, mate.name)\n" - "from DomesticCat as mother\n" - " inner join mother.mate as mate\n" - " left outer join mother.kittens as offspr]]>" -msgstr "<literal>select new map</literal> と一緒に使うときに最も役立ちます：" +"<![CDATA[select new list(mother, offspr, mate.name)\n" +"from DomesticCat as mother\n" +" inner join mother.mate as mate\n" +" left outer join mother.kittens as offspr]]>" +msgstr "" -#: index.docbook:279 +#. Tag: para +#: query_hql.xml:279 +#, no-c-format msgid "or as an actual typesafe Java object," +msgstr "または、タイプセーフなJavaオブジェクトを返せます。" + +#. Tag: programlisting +#: query_hql.xml:283 +#, no-c-format +msgid "" +"<![CDATA[select new Family(mother, mate, offspr)\n" +"from DomesticCat as mother\n" +" join mother.mate as mate\n" +" left join mother.kittens as offspr]]>" msgstr "" - "<![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n ) -\n" - "from Cat cat]]>" -#: index.docbook:283 +#. Tag: para +#: query_hql.xml:285 +#, no-c-format msgid "" - "<![CDATA[select new Family(mother, mate, offspr)\n" - "from DomesticCat as mother\n" - " join mother.mate as mate\n" - " left join mother.kittens as offspr]]>" -msgstr "このクエリは別名からselectした値へ <literal>Map</literal> を返します。" +"assuming that the class <literal>Family</literal> has an appropriate " +"constructor." +msgstr "" +"あるいは <literal>Family</literal> クラスが適切なコンストラクタを持っていると" +"するならば、" -#: index.docbook:285 -msgid "assuming that the class <literal>Family</literal> has an appropriate constructor." -msgstr "集約関数" +#. Tag: para +#: query_hql.xml:289 +#, no-c-format +msgid "" +"You may assign aliases to selected expressions using <literal>as</literal>:" +msgstr "select節に <literal>as</literal> を使って別名をつけることもできます。" -#: index.docbook:289 -msgid "You may assign aliases to selected expressions using <literal>as</literal>:" -msgstr "HQLのクエリはプロパティの集約関数の結果も返せます：" - -#: index.docbook:293 +#. Tag: programlisting +#: query_hql.xml:293 +#, no-c-format msgid "" - "<![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n\n" - "from Cat cat]]>" +"<![CDATA[select max(bodyWeight) as max, min(bodyWeight) as min, count(*) as " +"n\n" +"from Cat cat]]>" msgstr "" - "<![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat) -\n" - "from Cat cat]]>" -#: index.docbook:295 -msgid "This is most useful when used together with <literal>select new map</literal>:" -msgstr "サポートしている集約関数は以下のものです。" +#. Tag: para +#: query_hql.xml:295 +#, no-c-format +msgid "" +"This is most useful when used together with <literal>select new map</" +"literal>:" +msgstr "<literal>select new map</literal> と一緒に使うときに最も役立ちます：" -#: index.docbook:299 +#. Tag: programlisting +#: query_hql.xml:299 +#, no-c-format msgid "" - "<![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, count(*) as n )\n" - "from Cat cat]]>" -msgstr "avg(...), sum(...), min(...), max(...)" +"<![CDATA[select new map( max(bodyWeight) as max, min(bodyWeight) as min, " +"count(*) as n )\n" +"from Cat cat]]>" +msgstr "" -#: index.docbook:301 -msgid "This query returns a <literal>Map</literal> from aliases to selected values." -msgstr "count(*)" +#. Tag: para +#: query_hql.xml:301 +#, no-c-format +msgid "" +"This query returns a <literal>Map</literal> from aliases to selected values." +msgstr "このクエリは別名からselectした値へ <literal>Map</literal> を返します。" -#: index.docbook:308 +#. Tag: title +#: query_hql.xml:308 +#, no-c-format msgid "Aggregate functions" -msgstr "count(...), count(distinct ...), count(all...)" +msgstr "集約関数" -#: index.docbook:310 -msgid "HQL queries may even return the results of aggregate functions on properties:" -msgstr "select節において算術操作、連結と承認されたSQL関数を使うことができます。" +#. Tag: para +#: query_hql.xml:310 +#, no-c-format +msgid "" +"HQL queries may even return the results of aggregate functions on properties:" +msgstr "HQLのクエリはプロパティの集約関数の結果も返せます：" -#: index.docbook:314 +#. Tag: programlisting +#: query_hql.xml:314 +#, no-c-format msgid "" - "<![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count(cat)\n" - "from Cat cat]]>" +"<![CDATA[select avg(cat.weight), sum(cat.weight), max(cat.weight), count" +"(cat)\n" +"from Cat cat]]>" msgstr "" - "<![CDATA[select cat.weight + sum(kitten.weight) -\n" - "from Cat cat -\n" - " join cat.kittens kitten -\n" - "group by cat.id, cat.weight]]>" -#: index.docbook:325 +#. Tag: para +#: query_hql.xml:325 +#, no-c-format msgid "The supported aggregate functions are" -msgstr "<![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]>" +msgstr "サポートしている集約関数は以下のものです。" -#: index.docbook:332 +#. Tag: literal +#: query_hql.xml:332 +#, no-c-format msgid "avg(...), sum(...), min(...), max(...)" -msgstr "SQLと同じ意味を持つ <literal>distinct</literal> と <literal>all</literal> キーワードを使うことができます。" +msgstr "avg(...), sum(...), min(...), max(...)" -#: index.docbook:337 +#. Tag: literal +#: query_hql.xml:337 +#, no-c-format msgid "count(*)" -msgstr "" - "<![CDATA[select distinct cat.name from Cat cat -\n" - " -\n" - "select count(distinct cat.name), count(cat) from Cat cat]]>" +msgstr "count(*)" -#: index.docbook:342 +#. Tag: literal +#: query_hql.xml:342 +#, no-c-format msgid "count(...), count(distinct ...), count(all...)" -msgstr "ポリモーフィックなクエリ" +msgstr "count(...), count(distinct ...), count(all...)" -#: index.docbook:347 -msgid "You may use arithmetic operators, concatenation, and recognized SQL functions in the select clause:" -msgstr "次のようなクエリ：" +#. Tag: para +#: query_hql.xml:347 +#, no-c-format +msgid "" +"You may use arithmetic operators, concatenation, and recognized SQL " +"functions in the select clause:" +msgstr "" +"select節において算術操作、連結と承認されたSQL関数を使うことができます。" -#: index.docbook:352 +#. Tag: programlisting +#: query_hql.xml:352 +#, no-c-format msgid "" - "<![CDATA[select cat.weight + sum(kitten.weight)\n" - "from Cat cat\n" - " join cat.kittens kitten\n" - "group by cat.id, cat.weight]]>" -msgstr "<![CDATA[from Cat as cat]]>" +"<![CDATA[select cat.weight + sum(kitten.weight)\n" +"from Cat cat\n" +" join cat.kittens kitten\n" +"group by cat.id, cat.weight]]>" +msgstr "" -#: index.docbook:354 -msgid "<![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]>" -msgstr "<literal>Cat</literal> インスタンスだけではなく、<literal>DomesticCat</literal> のようなサブクラスも返されます。Hibernateクエリは <emphasis>どんな</emphasis> Javaクラスやインターフェイスも <literal>from</literal> 節に入れることができます。 クエリはそのクラスを拡張した、もしくはインターフェイスを実装した全ての永続クラスを返します。 次のクエリは永続オブジェクトをすべて返します:" +#. Tag: programlisting +#: query_hql.xml:354 +#, no-c-format +msgid "" +"<![CDATA[select firstName||' '||initial||' '||upper(lastName) from Person]]>" +msgstr "" -#: index.docbook:356 -msgid "The <literal>distinct</literal> and <literal>all</literal> keywords may be used and have the same semantics as in SQL." -msgstr "<![CDATA[from java.lang.Object o]]>" +#. Tag: para +#: query_hql.xml:356 +#, no-c-format +msgid "" +"The <literal>distinct</literal> and <literal>all</literal> keywords may be " +"used and have the same semantics as in SQL." +msgstr "" +"SQLと同じ意味を持つ <literal>distinct</literal> と <literal>all</literal> " +"キーワードを使うことができます。" -#: index.docbook:361 +#. Tag: programlisting +#: query_hql.xml:361 +#, no-c-format msgid "" - "<![CDATA[select distinct cat.name from Cat cat\n" - "\n" - "select count(distinct cat.name), count(cat) from Cat cat]]>" -msgstr "<literal>Named</literal> インターフェイスは様々な永続クラスによって実装されます。:" +"<![CDATA[select distinct cat.name from Cat cat\n" +"\n" +"select count(distinct cat.name), count(cat) from Cat cat]]>" +msgstr "" -#: index.docbook:366 +#. Tag: title +#: query_hql.xml:366 +#, no-c-format msgid "Polymorphic queries" -msgstr "<![CDATA[from Named n, Named m where n.name = m.name]]>" +msgstr "ポリモーフィックなクエリ" -#: index.docbook:368 +#. Tag: para +#: query_hql.xml:368 +#, no-c-format msgid "A query like:" -msgstr "最後の二つのクエリは、二つ以上のSQL <literal>SELECT</literal> を要求していることに注意してください。 このことは <literal>order by</literal> 節がリザルトセット全体を正確には整列しないことを意味します (さらにそれは、<literal>Query.scroll()</literal> を使用してこれらのクエリを呼ぶことができないことを意味します。)。" +msgstr "次のようなクエリ：" -#: index.docbook:374 -msgid "returns instances not only of <literal>Cat</literal>, but also of subclasses like <literal>DomesticCat</literal>. Hibernate queries may name <emphasis>any</emphasis> Java class or interface in the <literal>from</literal> clause. The query will return instances of all persistent classes that extend that class or implement the interface. The following query would return all persistent objects:" -msgstr "<literal>where</literal> 節は返されるインスタンスのリストを絞ることができます。 もし別名がない場合、名前でプロパティを参照します。" +#. Tag: para +#: query_hql.xml:374 +#, no-c-format +msgid "" +"returns instances not only of <literal>Cat</literal>, but also of subclasses " +"like <literal>DomesticCat</literal>. Hibernate queries may name " +"<emphasis>any</emphasis> Java class or interface in the <literal>from</" +"literal> clause. The query will return instances of all persistent classes " +"that extend that class or implement the interface. The following query would " +"return all persistent objects:" +msgstr "" +"<literal>Cat</literal> インスタンスだけではなく、<literal>DomesticCat</" +"literal> のようなサブクラスも返されます。Hibernateクエリは <emphasis>どんな</" +"emphasis> Javaクラスやインターフェイスも <literal>from</literal> 節に入れるこ" +"とができます。 クエリはそのクラスを拡張した、もしくはインターフェイスを実装し" +"た全ての永続クラスを返します。 次のクエリは永続オブジェクトをすべて返します:" -#: index.docbook:382 +#. Tag: programlisting +#: query_hql.xml:382 +#, no-c-format msgid "<![CDATA[from java.lang.Object o]]>" -msgstr "<![CDATA[from Cat where name='Fritz']]>" +msgstr "" -#: index.docbook:384 -msgid "The interface <literal>Named</literal> might be implemented by various persistent classes:" -msgstr "もし別名がある場合、修飾名を使ってください。" +#. Tag: para +#: query_hql.xml:384 +#, no-c-format +msgid "" +"The interface <literal>Named</literal> might be implemented by various " +"persistent classes:" +msgstr "" +"<literal>Named</literal> インターフェイスは様々な永続クラスによって実装されま" +"す。:" -#: index.docbook:389 +#. Tag: programlisting +#: query_hql.xml:389 +#, no-c-format msgid "<![CDATA[from Named n, Named m where n.name = m.name]]>" -msgstr "<![CDATA[from Cat as cat where cat.name='Fritz']]>" +msgstr "" -#: index.docbook:391 -msgid "Note that these last two queries will require more than one SQL <literal>SELECT</literal>. This means that the <literal>order by</literal> clause does not correctly order the whole result set. (It also means you can't call these queries using <literal>Query.scroll()</literal>.)" -msgstr "名前が'Fritz'という <literal>Cat</literal> のインスタンスを返します。" +#. Tag: para +#: query_hql.xml:391 +#, no-c-format +msgid "" +"Note that these last two queries will require more than one SQL " +"<literal>SELECT</literal>. This means that the <literal>order by</literal> " +"clause does not correctly order the whole result set. (It also means you " +"can't call these queries using <literal>Query.scroll()</literal>.)" +msgstr "" +"最後の二つのクエリは、二つ以上のSQL <literal>SELECT</literal> を要求している" +"ことに注意してください。 このことは <literal>order by</literal> 節がリザルト" +"セット全体を正確には整列しないことを意味します (さらにそれは、<literal>Query." +"scroll()</literal> を使用してこれらのクエリを呼ぶことができないことを意味しま" +"す。)。" -#: index.docbook:400 +#. Tag: title +#: query_hql.xml:400 +#, no-c-format msgid "The where clause" +msgstr "where節" + +#. Tag: para +#: query_hql.xml:402 +#, no-c-format +msgid "" +"The <literal>where</literal> clause allows you to narrow the list of " +"instances returned. If no alias exists, you may refer to properties by name:" msgstr "" - "<![CDATA[select foo -\n" - "from Foo foo, Bar bar -\n" - "where foo.startDate = bar.date]]>" +"<literal>where</literal> 節は返されるインスタンスのリストを絞ることができま" +"す。 もし別名がない場合、名前でプロパティを参照します。" -#: index.docbook:402 -msgid "The <literal>where</literal> clause allows you to narrow the list of instances returned. If no alias exists, you may refer to properties by name:" -msgstr "上のHQLは、<literal>Foo</literal> の <literal>startDate</literal> プロパティと等しい <literal>date</literal> プロパティを持った <literal>bar</literal> インスタンスが存在する、 すべての <literal>Foo</literal> インスタンスを返します。 コンパウンドパス式（例えば「cat.mate.name」）は <literal>where</literal> 節を非常に強力にします。注目：" - -#: index.docbook:407 +#. Tag: programlisting +#: query_hql.xml:407 +#, no-c-format msgid "<![CDATA[from Cat where name='Fritz']]>" -msgstr "<![CDATA[from Cat cat where cat.mate.name is not null]]>" +msgstr "" -#: index.docbook:409 +#. Tag: para +#: query_hql.xml:409 +#, no-c-format msgid "If there is an alias, use a qualified property name:" -msgstr "このクエリはテーブル結合（内部結合）を持つSQLクエリに変換されます。 その代わりに以下のように書くと、" +msgstr "もし別名がある場合、修飾名を使ってください。" -#: index.docbook:413 +#. Tag: programlisting +#: query_hql.xml:413 +#, no-c-format msgid "<![CDATA[from Cat as cat where cat.name='Fritz']]>" msgstr "" - "<![CDATA[from Foo foo -\n" - "where foo.bar.baz.customer.address.city is not null]]>" -#: index.docbook:415 +#. Tag: para +#: query_hql.xml:415 +#, no-c-format msgid "returns instances of <literal>Cat</literal> named 'Fritz'." -msgstr "もし上のクエリを記述したらクエリ内に4つのテーブル結合を必要とするSQLクエリに変換されます。" +msgstr "名前が'Fritz'という <literal>Cat</literal> のインスタンスを返します。" -#: index.docbook:419 +#. Tag: programlisting +#: query_hql.xml:419 +#, no-c-format msgid "" - "<![CDATA[select foo\n" - "from Foo foo, Bar bar\n" - "where foo.startDate = bar.date]]>" -msgstr "<literal>=</literal> 演算子は以下のように、プロパティだけでなくインスタンスを比較するためにも使われます。：" +"<![CDATA[select foo\n" +"from Foo foo, Bar bar\n" +"where foo.startDate = bar.date]]>" +msgstr "" -#: index.docbook:421 -msgid "will return all instances of <literal>Foo</literal> for which there exists an instance of <literal>bar</literal> with a <literal>date</literal> property equal to the <literal>startDate</literal> property of the <literal>Foo</literal>. Compound path expressions make the <literal>where</literal> clause extremely powerful. Consider:" -msgstr "<![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]>" +#. Tag: para +#: query_hql.xml:421 +#, no-c-format +msgid "" +"will return all instances of <literal>Foo</literal> for which there exists " +"an instance of <literal>bar</literal> with a <literal>date</literal> " +"property equal to the <literal>startDate</literal> property of the " +"<literal>Foo</literal>. Compound path expressions make the <literal>where</" +"literal> clause extremely powerful. Consider:" +msgstr "" +"上のHQLは、<literal>Foo</literal> の <literal>startDate</literal> プロパティ" +"と等しい <literal>date</literal> プロパティを持った <literal>bar</literal> イ" +"ンスタンスが存在する、 すべての <literal>Foo</literal> インスタンスを返しま" +"す。 コンパウンドパス式（例えば「cat.mate.name」）は <literal>where</" +"literal> 節を非常に強力にします。注目：" -#: index.docbook:430 +#. Tag: programlisting +#: query_hql.xml:430 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.mate.name is not null]]>" msgstr "" - "<![CDATA[select cat, mate -\n" - "from Cat cat, Cat mate -\n" - "where cat.mate = mate]]>" -#: index.docbook:432 -msgid "This query translates to an SQL query with a table (inner) join. If you were to write something like" -msgstr "<literal>id</literal> (小文字)は特別なプロパティであり、 オブジェクトのユニークな識別子を参照するために使用できます。(さらに、そのプロパティ名を使用できます。)" +#. Tag: para +#: query_hql.xml:432 +#, no-c-format +msgid "" +"This query translates to an SQL query with a table (inner) join. If you were " +"to write something like" +msgstr "" +"このクエリはテーブル結合（内部結合）を持つSQLクエリに変換されます。 その代わ" +"りに以下のように書くと、" -#: index.docbook:437 +#. Tag: programlisting +#: query_hql.xml:437 +#, no-c-format msgid "" - "<![CDATA[from Foo foo\n" - "where foo.bar.baz.customer.address.city is not null]]>" +"<![CDATA[from Foo foo\n" +"where foo.bar.baz.customer.address.city is not null]]>" msgstr "" - "<![CDATA[from Cat as cat where cat.id = 123 -\n" - " -\n" - "from Cat as cat where cat.mate.id = 69]]>" -#: index.docbook:439 -msgid "you would end up with a query that would require four table joins in SQL." -msgstr "2番目のクエリは効率的です。テーブル結合が必要ありません！" +#. Tag: para +#: query_hql.xml:439 +#, no-c-format +msgid "" +"you would end up with a query that would require four table joins in SQL." +msgstr "" +"もし上のクエリを記述したらクエリ内に4つのテーブル結合を必要とするSQLクエリに" +"変換されます。" -#: index.docbook:443 -msgid "The <literal>=</literal> operator may be used to compare not only properties, but also instances:" -msgstr "また複合識別子のプロパティも使用できます。ここで <literal>Person</literal> が <literal>country</literal> と <literal>medicareNumber</literal> からなる複合識別子を持つと仮定します。" +#. Tag: para +#: query_hql.xml:443 +#, no-c-format +msgid "" +"The <literal>=</literal> operator may be used to compare not only " +"properties, but also instances:" +msgstr "" +"<literal>=</literal> 演算子は以下のように、プロパティだけでなくインスタンスを" +"比較するためにも使われます。：" -#: index.docbook:448 +#. Tag: programlisting +#: query_hql.xml:448 +#, no-c-format msgid "<![CDATA[from Cat cat, Cat rival where cat.mate = rival.mate]]>" msgstr "" - "<![CDATA[from bank.Person person -\n" - "where person.id.country = 'AU' -\n" - " and person.id.medicareNumber = 123456]]>" -#: index.docbook:450 +#. Tag: programlisting +#: query_hql.xml:450 +#, no-c-format msgid "" - "<![CDATA[select cat, mate\n" - "from Cat cat, Cat mate\n" - "where cat.mate = mate]]>" +"<![CDATA[select cat, mate\n" +"from Cat cat, Cat mate\n" +"where cat.mate = mate]]>" msgstr "" - "<![CDATA[from bank.Account account -\n" - "where account.owner.id.country = 'AU' -\n" - " and account.owner.id.medicareNumber = 123456]]>" -#: index.docbook:452 -msgid "The special property (lowercase) <literal>id</literal> may be used to reference the unique identifier of an object. See <xref linkend=\"queryhql-identifier-property\"/> for more information." -msgstr "もう一度言いますが、2番目のクエリにはテーブル結合が必要ありません。" +#. Tag: para +#: query_hql.xml:452 +#, no-c-format +msgid "" +"The special property (lowercase) <literal>id</literal> may be used to " +"reference the unique identifier of an object. See <xref linkend=\"queryhql-" +"identifier-property\"/> for more information." +msgstr "" +"<literal>id</literal> (小文字)は特別なプロパティであり、 オブジェクトのユニー" +"クな識別子を参照するために使用できます。(さらに、そのプロパティ名を使用できま" +"す。)" -#: index.docbook:458 +#. Tag: programlisting +#: query_hql.xml:458 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat where cat.id = 123\n" - "\n" - "from Cat as cat where cat.mate.id = 69]]>" -msgstr "同様に <literal>class</literal> は特別なプロパティであり、 ポリモーフィックな永続化におけるインスタンスのdiscriminator値にアクセスします。 where節に埋め込まれたJavaのクラス名はそのdiscriminator値に変換されます。" +"<![CDATA[from Cat as cat where cat.id = 123\n" +"\n" +"from Cat as cat where cat.mate.id = 69]]>" +msgstr "" -#: index.docbook:460 +#. Tag: para +#: query_hql.xml:460 +#, no-c-format msgid "The second query is efficient. No table join is required!" -msgstr "<![CDATA[from Cat cat where cat.class = DomesticCat]]>" +msgstr "2番目のクエリは効率的です。テーブル結合が必要ありません！" -#: index.docbook:464 -msgid "Properties of composite identifiers may also be used. Suppose <literal>Person</literal> has a composite identifier consisting of <literal>country</literal> and <literal>medicareNumber</literal>. Again, see <xref linkend=\"queryhql-identifier-property\"/> for more information regarding referencing identifier properties." -msgstr "またコンポーネントや複合ユーザ型(またそのコンポーネントのコンポーネントなど)のプロパティも指定できます。 しかし決して（コンポーネントのプロパティではなく）コンポーネント型のプロパティで終了するパス式を使わないでください。 例えばもし <literal>store.owner</literal> が <literal>address</literal> コンポーネントを持つエンティティならば以下のような結果となります。" +#. Tag: para +#: query_hql.xml:464 +#, no-c-format +msgid "" +"Properties of composite identifiers may also be used. Suppose " +"<literal>Person</literal> has a composite identifier consisting of " +"<literal>country</literal> and <literal>medicareNumber</literal>. Again, see " +"<xref linkend=\"queryhql-identifier-property\"/> for more information " +"regarding referencing identifier properties." +msgstr "" +"また複合識別子のプロパティも使用できます。ここで <literal>Person</literal> " +"が <literal>country</literal> と <literal>medicareNumber</literal> からなる複" +"合識別子を持つと仮定します。" -#: index.docbook:471 +#. Tag: programlisting +#: query_hql.xml:471 +#, no-c-format msgid "" - "<![CDATA[from bank.Person person\n" - "where person.id.country = 'AU'\n" - " and person.id.medicareNumber = 123456]]>" +"<![CDATA[from bank.Person person\n" +"where person.id.country = 'AU'\n" +" and person.id.medicareNumber = 123456]]>" msgstr "" - "<![CDATA[store.owner.address.city // okay -\n" - "store.owner.address // error!]]>" -#: index.docbook:473 +#. Tag: programlisting +#: query_hql.xml:473 +#, no-c-format msgid "" - "<![CDATA[from bank.Account account\n" - "where account.owner.id.country = 'AU'\n" - " and account.owner.id.medicareNumber = 123456]]>" -msgstr "\"any\"型は特別なプロパティである <literal>id</literal> と <literal>class</literal> を持ち、 以下の方法で結合を表現することを可能にします(<literal>AuditLog.item</literal> は <literal>&lt;any&gt;</literal> でマッピングされたプロパティです)。" +"<![CDATA[from bank.Account account\n" +"where account.owner.id.country = 'AU'\n" +" and account.owner.id.medicareNumber = 123456]]>" +msgstr "" -#: index.docbook:475 +#. Tag: para +#: query_hql.xml:475 +#, no-c-format msgid "Once again, the second query requires no table join." +msgstr "もう一度言いますが、2番目のクエリにはテーブル結合が必要ありません。" + +#. Tag: para +#: query_hql.xml:479 +#, no-c-format +msgid "" +"Likewise, the special property <literal>class</literal> accesses the " +"discriminator value of an instance in the case of polymorphic persistence. A " +"Java class name embedded in the where clause will be translated to its " +"discriminator value." msgstr "" - "<![CDATA[from AuditLog log, Payment payment -\n" - "where log.item.class = 'Payment' and log.item.id = payment.id]]>" +"同様に <literal>class</literal> は特別なプロパティであり、 ポリモーフィックな" +"永続化におけるインスタンスのdiscriminator値にアクセスします。 where節に埋め込" +"まれたJavaのクラス名はそのdiscriminator値に変換されます。" -#: index.docbook:479 -msgid "Likewise, the special property <literal>class</literal> accesses the discriminator value of an instance in the case of polymorphic persistence. A Java class name embedded in the where clause will be translated to its discriminator value." -msgstr "<literal>log.item.class</literal> と <literal>payment.class</literal> が 上記のクエリ中で全く異なるデータベースカラムの値を参照するということに注意してください。" - -#: index.docbook:485 +#. Tag: programlisting +#: query_hql.xml:485 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.class = DomesticCat]]>" -msgstr "Expressions 式" +msgstr "" -#: index.docbook:487 -msgid "You may also use components or composite user types, or properties of said component types. See <xref linkend=\"queryhql-coomponents\"/> for more details." -msgstr "SQLの <literal>where</literal> 節で記述することが出来る式のほとんどをHQLでも記述できます。:" +#. Tag: para +#: query_hql.xml:487 +#, no-c-format +msgid "" +"You may also use components or composite user types, or properties of said " +"component types. See <xref linkend=\"queryhql-components\"/> for more " +"details." +msgstr "" +"またコンポーネントや複合ユーザ型(またそのコンポーネントのコンポーネントなど)" +"のプロパティも指定できます。 しかし決して（コンポーネントのプロパティではな" +"く）コンポーネント型のプロパティで終了するパス式を使わないでください。 例えば" +"もし <literal>store.owner</literal> が <literal>address</literal> コンポーネ" +"ントを持つエンティティならば以下のような結果となります。" -#: index.docbook:492 -msgid "An \"any\" type has the special properties <literal>id</literal> and <literal>class</literal>, allowing us to express a join in the following way (where <literal>AuditLog.item</literal> is a property mapped with <literal>&lt;any&gt;</literal>)." -msgstr "算術演算子：<literal>+, -, *, /</literal>" +#. Tag: para +#: query_hql.xml:492 +#, no-c-format +msgid "" +"An \"any\" type has the special properties <literal>id</literal> and " +"<literal>class</literal>, allowing us to express a join in the following way " +"(where <literal>AuditLog.item</literal> is a property mapped with " +"<literal>&lt;any&gt;</literal>)." +msgstr "" +"\"any\"型は特別なプロパティである <literal>id</literal> と <literal>class</" +"literal> を持ち、 以下の方法で結合を表現することを可能にします" +"(<literal>AuditLog.item</literal> は <literal>&lt;any&gt;</literal> でマッピ" +"ングされたプロパティです)。" -#: index.docbook:498 +#. Tag: programlisting +#: query_hql.xml:498 +#, no-c-format msgid "" - "<![CDATA[from AuditLog log, Payment payment\n" - "where log.item.class = 'Payment' and log.item.id = payment.id]]>" -msgstr "2項比較演算子：<literal>=, &gt;=, &lt;=, &lt;&gt;, !=, like</literal>" +"<![CDATA[from AuditLog log, Payment payment\n" +"where log.item.class = 'Payment' and log.item.id = payment.id]]>" +msgstr "" -#: index.docbook:500 -msgid "Notice that <literal>log.item.class</literal> and <literal>payment.class</literal> would refer to the values of completely different database columns in the above query." -msgstr "論理演算子：<literal>and, or, not</literal>" +#. Tag: para +#: query_hql.xml:500 +#, no-c-format +msgid "" +"Notice that <literal>log.item.class</literal> and <literal>payment.class</" +"literal> would refer to the values of completely different database columns " +"in the above query." +msgstr "" +"<literal>log.item.class</literal> と <literal>payment.class</literal> が 上記" +"のクエリ中で全く異なるデータベースカラムの値を参照するということに注意してく" +"ださい。" -#: index.docbook:508 +#. Tag: title +#: query_hql.xml:508 +#, no-c-format msgid "Expressions" -msgstr "グループ分けを表す括弧：<literal>( )</literal>" +msgstr "Expressions 式" -#: index.docbook:510 -msgid "Expressions allowed in the <literal>where</literal> clause include most of the kind of things you could write in SQL:" -msgstr "<literal>in</literal>, <literal>not in</literal>, <literal>between</literal>, <literal>is null</literal>, <literal>is not null</literal>, <literal>is empty</literal>, <literal>is not empty</literal>, <literal>member of</literal> and <literal>not member of</literal>" +#. Tag: para +#: query_hql.xml:510 +#, no-c-format +msgid "" +"Expressions allowed in the <literal>where</literal> clause include most of " +"the kind of things you could write in SQL:" +msgstr "" +"SQLの <literal>where</literal> 節で記述することが出来る式のほとんどをHQLでも" +"記述できます。:" -#: index.docbook:517 +#. Tag: para +#: query_hql.xml:517 +#, no-c-format msgid "mathematical operators <literal>+, -, *, /</literal>" -msgstr "\"シンプル\"なcase <literal>case ... when ... then ... else ... end</literal>、 \"探索的\"なcase <literal>case when ... then ... else ... end</literal>" +msgstr "算術演算子：<literal>+, -, *, /</literal>" -#: index.docbook:522 -msgid "binary comparison operators <literal>=, &gt;=, &lt;=, &lt;&gt;, !=, like</literal>" -msgstr "ストリングの連結 <literal>...||...</literal> または <literal>concat(...,...)</literal>" +#. Tag: para +#: query_hql.xml:522 +#, no-c-format +msgid "" +"binary comparison operators <literal>=, &gt;=, &lt;=, &lt;&gt;, !=, like</" +"literal>" +msgstr "2項比較演算子：<literal>=, &gt;=, &lt;=, &lt;&gt;, !=, like</literal>" -#: index.docbook:527 +#. Tag: para +#: query_hql.xml:527 +#, no-c-format msgid "logical operations <literal>and, or, not</literal>" -msgstr "<literal>current_date()</literal>, <literal>current_time()</literal>, <literal>current_timestamp()</literal>" +msgstr "論理演算子：<literal>and, or, not</literal>" -#: index.docbook:532 +#. Tag: para +#: query_hql.xml:532 +#, no-c-format msgid "Parentheses <literal>( )</literal>, indicating grouping" -msgstr "<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, <literal>year(...)</literal>," +msgstr "グループ分けを表す括弧：<literal>( )</literal>" -#: index.docbook:537 -msgid "<literal>in</literal>, <literal>not in</literal>, <literal>between</literal>, <literal>is null</literal>, <literal>is not null</literal>, <literal>is empty</literal>, <literal>is not empty</literal>, <literal>member of</literal> and <literal>not member of</literal>" -msgstr "EJB-QL 3.0で定義されている関数や演算子: <literal>substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length()</literal>" +#. Tag: para +#: query_hql.xml:537 +#, no-c-format +msgid "" +"<literal>in</literal>, <literal>not in</literal>, <literal>between</" +"literal>, <literal>is null</literal>, <literal>is not null</literal>, " +"<literal>is empty</literal>, <literal>is not empty</literal>, " +"<literal>member of</literal> and <literal>not member of</literal>" +msgstr "" +"<literal>in</literal>, <literal>not in</literal>, <literal>between</" +"literal>, <literal>is null</literal>, <literal>is not null</literal>, " +"<literal>is empty</literal>, <literal>is not empty</literal>, " +"<literal>member of</literal> and <literal>not member of</literal>" -#: index.docbook:550 -msgid "\"Simple\" case, <literal>case ... when ... then ... else ... end</literal>, and \"searched\" case, <literal>case when ... then ... else ... end</literal>" -msgstr "<literal>coalesce()</literal> と <literal>nullif()</literal>" +#. Tag: para +#: query_hql.xml:550 +#, no-c-format +msgid "" +"\"Simple\" case, <literal>case ... when ... then ... else ... end</literal>, " +"and \"searched\" case, <literal>case when ... then ... else ... end</literal>" +msgstr "" +"\"シンプル\"なcase <literal>case ... when ... then ... else ... end</" +"literal>、 \"探索的\"なcase <literal>case when ... then ... else ... end</" +"literal>" -#: index.docbook:556 -msgid "string concatenation <literal>...||...</literal> or <literal>concat(...,...)</literal>" -msgstr "数字や時間の値をStringにコンバートする <literal>str()</literal>）" +#. Tag: para +#: query_hql.xml:556 +#, no-c-format +msgid "" +"string concatenation <literal>...||...</literal> or <literal>concat(...,...)" +"</literal>" +msgstr "" +"ストリングの連結 <literal>...||...</literal> または <literal>concat(...,...)" +"</literal>" -#: index.docbook:561 -msgid "<literal>current_date()</literal>, <literal>current_time()</literal>, <literal>current_timestamp()</literal>" -msgstr "2番目の引数がHibernate型の名前である <literal>cast(... as ...)</literal> と <literal>extract(... from ...)</literal>。 ただし使用するデータベースがANSI <literal>cast()</literal> と <literal>extract()</literal> をサポートする場合に限ります。" +#. Tag: para +#: query_hql.xml:561 +#, no-c-format +msgid "" +"<literal>current_date()</literal>, <literal>current_time()</literal>, " +"<literal>current_timestamp()</literal>" +msgstr "" +"<literal>current_date()</literal>, <literal>current_time()</literal>, " +"<literal>current_timestamp()</literal>" -#: index.docbook:567 -msgid "<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, <literal>year(...)</literal>," -msgstr "結合したインデックス付きのコレクションの別名に適用されるHQLの <literal>index()</literal> 関数。" +#. Tag: para +#: query_hql.xml:567 +#, no-c-format +msgid "" +"<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour" +"(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, " +"<literal>year(...)</literal>," +msgstr "" +"<literal>second(...)</literal>, <literal>minute(...)</literal>, <literal>hour" +"(...)</literal>, <literal>day(...)</literal>, <literal>month(...)</literal>, " +"<literal>year(...)</literal>," -#: index.docbook:574 -msgid "Any function or operator defined by EJB-QL 3.0: <literal>substring(), trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()</literal>" -msgstr "コレクション値のパス式を取るHQL関数： <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal> 。 <literal>some, all, exists, any, in</literal> を使って修飾することができる特別な <literal>elements()</literal> と <literal>indices</literal> 関数と一緒に使います。" +#. Tag: para +#: query_hql.xml:574 +#, no-c-format +msgid "" +"Any function or operator defined by EJB-QL 3.0: <literal>substring(), trim" +"(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), mod()" +"</literal>" +msgstr "" +"EJB-QL 3.0で定義されている関数や演算子: <literal>substring(), trim(), lower" +"(), upper(), length(), locate(), abs(), sqrt(), bit_length()</literal>" -#: index.docbook:580 +#. Tag: para +#: query_hql.xml:580 +#, no-c-format msgid "<literal>coalesce()</literal> and <literal>nullif()</literal>" -msgstr "<literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</literal> のようなデータベースがサポートするSQLスカラ関数。" +msgstr "<literal>coalesce()</literal> と <literal>nullif()</literal>" -#: index.docbook:585 -msgid "<literal>str()</literal> for converting numeric or temporal values to a readable string" -msgstr "JDBCスタイルの位置パラメータ <literal>?</literal>" +#. Tag: para +#: query_hql.xml:585 +#, no-c-format +msgid "" +"<literal>str()</literal> for converting numeric or temporal values to a " +"readable string" +msgstr "数字や時間の値をStringにコンバートする <literal>str()</literal>）" -#: index.docbook:591 -msgid "<literal>cast(... as ...)</literal>, where the second argument is the name of a Hibernate type, and <literal>extract(... from ...)</literal> if ANSI <literal>cast()</literal> and <literal>extract()</literal> is supported by the underlying database" -msgstr "名前付きパラメータ: <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal>" +#. Tag: para +#: query_hql.xml:591 +#, no-c-format +msgid "" +"<literal>cast(... as ...)</literal>, where the second argument is the name " +"of a Hibernate type, and <literal>extract(... from ...)</literal> if ANSI " +"<literal>cast()</literal> and <literal>extract()</literal> is supported by " +"the underlying database" +msgstr "" +"2番目の引数がHibernate型の名前である <literal>cast(... as ...)</literal> と " +"<literal>extract(... from ...)</literal>。 ただし使用するデータベースがANSI " +"<literal>cast()</literal> と <literal>extract()</literal> をサポートする場合" +"に限ります。" -#: index.docbook:599 -msgid "the HQL <literal>index()</literal> function, that applies to aliases of a joined indexed collection" -msgstr "SQLリテラル：<literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" +#. Tag: para +#: query_hql.xml:599 +#, no-c-format +msgid "" +"the HQL <literal>index()</literal> function, that applies to aliases of a " +"joined indexed collection" +msgstr "" +"結合したインデックス付きのコレクションの別名に適用されるHQLの <literal>index" +"()</literal> 関数。" -#: index.docbook:605 -msgid "HQL functions that take collection-valued path expressions: <literal>size(), minelement(), maxelement(), minindex(), maxindex()</literal>, along with the special <literal>elements()</literal> and <literal>indices</literal> functions which may be quantified using <literal>some, all, exists, any, in</literal>." -msgstr "Javaの <literal>public static final</literal> 定数：<literal>eg.Color.TABBY</literal>" +#. Tag: para +#: query_hql.xml:605 +#, no-c-format +msgid "" +"HQL functions that take collection-valued path expressions: <literal>size(), " +"minelement(), maxelement(), minindex(), maxindex()</literal>, along with the " +"special <literal>elements()</literal> and <literal>indices</literal> " +"functions which may be quantified using <literal>some, all, exists, any, in</" +"literal>." +msgstr "" +"コレクション値のパス式を取るHQL関数： <literal>size(), minelement(), " +"maxelement(), minindex(), maxindex()</literal> 。 <literal>some, all, " +"exists, any, in</literal> を使って修飾することができる特別な " +"<literal>elements()</literal> と <literal>indices</literal> 関数と一緒に使い" +"ます。" -#: index.docbook:613 -msgid "Any database-supported SQL scalar function like <literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</literal>" -msgstr "<literal>in</literal> と <literal>between</literal> は以下のように使用できます。:" +#. Tag: para +#: query_hql.xml:613 +#, no-c-format +msgid "" +"Any database-supported SQL scalar function like <literal>sign()</literal>, " +"<literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</" +"literal>" +msgstr "" +"<literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</" +"literal>, <literal>sin()</literal> のようなデータベースがサポートするSQLスカ" +"ラ関数。" -#: index.docbook:619 +#. Tag: para +#: query_hql.xml:619 +#, no-c-format msgid "JDBC-style positional parameters <literal>?</literal>" -msgstr "<![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]>" +msgstr "JDBCスタイルの位置パラメータ <literal>?</literal>" -#: index.docbook:624 -msgid "named parameters <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal>" -msgstr "<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>" +#. Tag: para +#: query_hql.xml:624 +#, no-c-format +msgid "" +"named parameters <literal>:name</literal>, <literal>:start_date</literal>, " +"<literal>:x1</literal>" +msgstr "" +"名前付きパラメータ: <literal>:name</literal>, <literal>:start_date</" +"literal>, <literal>:x1</literal>" -#: index.docbook:629 -msgid "SQL literals <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" -msgstr "また、否定形で記述することもできます。" +#. Tag: para +#: query_hql.xml:629 +#, no-c-format +msgid "" +"SQL literals <literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E" +"+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" +msgstr "" +"SQLリテラル：<literal>'foo'</literal>, <literal>69</literal>, <literal>6.66E" +"+2</literal>, <literal>'1970-01-01 10:00:01.0'</literal>" -#: index.docbook:635 -msgid "Java <literal>public static final</literal> constants <literal>eg.Color.TABBY</literal>" -msgstr "<![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]>" +#. Tag: para +#: query_hql.xml:635 +#, no-c-format +msgid "" +"Java <literal>public static final</literal> constants <literal>eg.Color." +"TABBY</literal>" +msgstr "" +"Javaの <literal>public static final</literal> 定数：<literal>eg.Color.TABBY</" +"literal>" -#: index.docbook:641 -msgid "<literal>in</literal> and <literal>between</literal> may be used as follows:" -msgstr "<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]>" +#. Tag: para +#: query_hql.xml:641 +#, no-c-format +msgid "" +"<literal>in</literal> and <literal>between</literal> may be used as follows:" +msgstr "" +"<literal>in</literal> と <literal>between</literal> は以下のように使用できま" +"す。:" -#: index.docbook:645 +#. Tag: programlisting +#: query_hql.xml:645 +#, no-c-format msgid "<![CDATA[from DomesticCat cat where cat.name between 'A' and 'B']]>" -msgstr "同様に <literal>is null</literal> や <literal>is not null</literal> はnull値をテストするために使用できます。" +msgstr "" -#: index.docbook:647 -msgid "<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>" -msgstr "Hibernate設定ファイルでHQL query substitutionsを定義すれば、boolean値を式の中で簡単に使用できま。：" +#. Tag: programlisting +#: query_hql.xml:647 +#, no-c-format +msgid "" +"<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>" +msgstr "" -#: index.docbook:649 +#. Tag: para +#: query_hql.xml:649 +#, no-c-format msgid "and the negated forms may be written" -msgstr "<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false 0</property>]]>" +msgstr "また、否定形で記述することもできます。" -#: index.docbook:653 +#. Tag: programlisting +#: query_hql.xml:653 +#, no-c-format msgid "<![CDATA[from DomesticCat cat where cat.name not between 'A' and 'B']]>" -msgstr "こうすることで下記のHQLをSQLに変換するときに <literal>true</literal> , <literal>false</literal> キーワードは <literal>1</literal> , <literal>0</literal> に置き換えられます。:" +msgstr "" -#: index.docbook:655 -msgid "<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]>" -msgstr "<![CDATA[from Cat cat where cat.alive = true]]>" +#. Tag: programlisting +#: query_hql.xml:655 +#, no-c-format +msgid "" +"<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]" +">" +msgstr "" -#: index.docbook:657 -msgid "Likewise, <literal>is null</literal> and <literal>is not null</literal> may be used to test for null values." -msgstr "特別なプロパティ <literal>size</literal>、または特別な関数 <literal>size()</literal> を使ってコレクションのサイズをテストできます。:" +#. Tag: para +#: query_hql.xml:657 +#, no-c-format +msgid "" +"Likewise, <literal>is null</literal> and <literal>is not null</literal> may " +"be used to test for null values." +msgstr "" +"同様に <literal>is null</literal> や <literal>is not null</literal> はnull値" +"をテストするために使用できます。" -#: index.docbook:662 -msgid "Booleans may be easily used in expressions by declaring HQL query substitutions in Hibernate configuration:" -msgstr "<![CDATA[from Cat cat where cat.kittens.size > 0]]>" +#. Tag: para +#: query_hql.xml:662 +#, no-c-format +msgid "" +"Booleans may be easily used in expressions by declaring HQL query " +"substitutions in Hibernate configuration:" +msgstr "" +"Hibernate設定ファイルでHQL query substitutionsを定義すれば、boolean値を式の中" +"で簡単に使用できま。：" -#: index.docbook:667 -msgid "<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false 0</property>]]>" -msgstr "<![CDATA[from Cat cat where size(cat.kittens) > 0]]>" +#. Tag: programlisting +#: query_hql.xml:667 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false 0</" +"property>]]>" +msgstr "" -#: index.docbook:669 -msgid "This will replace the keywords <literal>true</literal> and <literal>false</literal> with the literals <literal>1</literal> and <literal>0</literal> in the translated SQL from this HQL:" -msgstr "インデックス付きのコレクションでは、<literal>minindex</literal> と <literal>maxindex</literal> 関数を使って、インデックスの最小値と最大値を参照できます。 同様に、<literal>minelement</literal> と <literal>maxelement</literal> を使って、 基本型のコレクション要素の最小値と最大値を参照できます。" +#. Tag: para +#: query_hql.xml:669 +#, no-c-format +msgid "" +"This will replace the keywords <literal>true</literal> and <literal>false</" +"literal> with the literals <literal>1</literal> and <literal>0</literal> in " +"the translated SQL from this HQL:" +msgstr "" +"こうすることで下記のHQLをSQLに変換するときに <literal>true</literal> , " +"<literal>false</literal> キーワードは <literal>1</literal> , <literal>0</" +"literal> に置き換えられます。:" -#: index.docbook:674 +#. Tag: programlisting +#: query_hql.xml:674 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.alive = true]]>" -msgstr "<![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]>" +msgstr "" -#: index.docbook:676 -msgid "You may test the size of a collection with the special property <literal>size</literal>, or the special <literal>size()</literal> function." -msgstr "<![CDATA[from Order order where maxindex(order.items) > 100]]>" +#. Tag: para +#: query_hql.xml:676 +#, no-c-format +msgid "" +"You may test the size of a collection with the special property " +"<literal>size</literal>, or the special <literal>size()</literal> function." +msgstr "" +"特別なプロパティ <literal>size</literal>、または特別な関数 <literal>size()</" +"literal> を使ってコレクションのサイズをテストできます。:" -#: index.docbook:681 +#. Tag: programlisting +#: query_hql.xml:681 +#, no-c-format msgid "<![CDATA[from Cat cat where cat.kittens.size > 0]]>" -msgstr "<![CDATA[from Order order where minelement(order.items) > 10000]]>" +msgstr "" -#: index.docbook:683 +#. Tag: programlisting +#: query_hql.xml:683 +#, no-c-format msgid "<![CDATA[from Cat cat where size(cat.kittens) > 0]]>" -msgstr "コレクションの要素やインデックスのセット（<literal>elements</literal> と <literal>indices</literal> 関数）、または副問い合わせ（後述）の結果が受け取れるときは、 SQL関数 <literal>any, some, all, exists, in</literal> がサポートされます。" +msgstr "" -#: index.docbook:685 -msgid "For indexed collections, you may refer to the minimum and maximum indices using <literal>minindex</literal> and <literal>maxindex</literal> functions. Similarly, you may refer to the minimum and maximum elements of a collection of basic type using the <literal>minelement</literal> and <literal>maxelement</literal> functions." +#. Tag: para +#: query_hql.xml:685 +#, no-c-format +msgid "" +"For indexed collections, you may refer to the minimum and maximum indices " +"using <literal>minindex</literal> and <literal>maxindex</literal> functions. " +"Similarly, you may refer to the minimum and maximum elements of a collection " +"of basic type using the <literal>minelement</literal> and " +"<literal>maxelement</literal> functions." msgstr "" - "<![CDATA[select mother from Cat as mother, Cat as kit -\n" - "where kit in elements(foo.kittens)]]>" +"インデックス付きのコレクションでは、<literal>minindex</literal> と " +"<literal>maxindex</literal> 関数を使って、インデックスの最小値と最大値を参照" +"できます。 同様に、<literal>minelement</literal> と <literal>maxelement</" +"literal> を使って、 基本型のコレクション要素の最小値と最大値を参照できます。" -#: index.docbook:693 -msgid "<![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]>" +#. Tag: programlisting +#: query_hql.xml:693 +#, no-c-format +msgid "" +"<![CDATA[from Calendar cal where maxelement(cal.holidays) > current_date]]>" msgstr "" - "<![CDATA[select p from NameList list, Person p -\n" - "where p.name = some elements(list.names)]]>" -#: index.docbook:695 +#. Tag: programlisting +#: query_hql.xml:695 +#, no-c-format msgid "<![CDATA[from Order order where maxindex(order.items) > 100]]>" -msgstr "<![CDATA[from Cat cat where exists elements(cat.kittens)]]>" +msgstr "" -#: index.docbook:697 +#. Tag: programlisting +#: query_hql.xml:697 +#, no-c-format msgid "<![CDATA[from Order order where minelement(order.items) > 10000]]>" -msgstr "<![CDATA[from Player p where 3 > all elements(p.scores)]]>" +msgstr "" -#: index.docbook:699 -msgid "The SQL functions <literal>any, some, all, exists, in</literal> are supported when passed the element or index set of a collection (<literal>elements</literal> and <literal>indices</literal> functions) or the result of a subquery (see below)." -msgstr "<![CDATA[from Show show where 'fizard' in indices(show.acts)]]>" +#. Tag: para +#: query_hql.xml:699 +#, no-c-format +msgid "" +"The SQL functions <literal>any, some, all, exists, in</literal> are " +"supported when passed the element or index set of a collection " +"(<literal>elements</literal> and <literal>indices</literal> functions) or " +"the result of a subquery (see below)." +msgstr "" +"コレクションの要素やインデックスのセット（<literal>elements</literal> と " +"<literal>indices</literal> 関数）、または副問い合わせ（後述）の結果が受け取れ" +"るときは、 SQL関数 <literal>any, some, all, exists, in</literal> がサポートさ" +"れます。" -#: index.docbook:705 +#. Tag: programlisting +#: query_hql.xml:705 +#, no-c-format msgid "" - "<![CDATA[select mother from Cat as mother, Cat as kit\n" - "where kit in elements(foo.kittens)]]>" -msgstr "<literal>size</literal>, <literal>elements</literal>, <literal>indices</literal>, <literal>minindex</literal>, <literal>maxindex</literal>, <literal>minelement</literal>, <literal>maxelement</literal> はHibernate3のwhere節だけで利用可能であることに注意してください。" +"<![CDATA[select mother from Cat as mother, Cat as kit\n" +"where kit in elements(foo.kittens)]]>" +msgstr "" -#: index.docbook:707 +#. Tag: programlisting +#: query_hql.xml:707 +#, no-c-format msgid "" - "<![CDATA[select p from NameList list, Person p\n" - "where p.name = some elements(list.names)]]>" -msgstr "インデックス付きのコレクション（arrays, lists, maps）の要素は、 インデックスで参照できます（where節内でのみ）。" +"<![CDATA[select p from NameList list, Person p\n" +"where p.name = some elements(list.names)]]>" +msgstr "" -#: index.docbook:709 +#. Tag: programlisting +#: query_hql.xml:709 +#, no-c-format msgid "<![CDATA[from Cat cat where exists elements(cat.kittens)]]>" -msgstr "<![CDATA[from Order order where order.items[0].id = 1234]]>" +msgstr "" -#: index.docbook:711 +#. Tag: programlisting +#: query_hql.xml:711 +#, no-c-format msgid "<![CDATA[from Player p where 3 > all elements(p.scores)]]>" msgstr "" - "<![CDATA[select person from Person person, Calendar calendar -\n" - "where calendar.holidays['national day'] = person.birthDay -\n" - " and person.nationality.calendar = calendar]]>" -#: index.docbook:713 +#. Tag: programlisting +#: query_hql.xml:713 +#, no-c-format msgid "<![CDATA[from Show show where 'fizard' in indices(show.acts)]]>" msgstr "" - "<![CDATA[select item from Item item, Order order -\n" - "where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]>" -#: index.docbook:715 -msgid "Note that these constructs - <literal>size</literal>, <literal>elements</literal>, <literal>indices</literal>, <literal>minindex</literal>, <literal>maxindex</literal>, <literal>minelement</literal>, <literal>maxelement</literal> - may only be used in the where clause in Hibernate3." +#. Tag: para +#: query_hql.xml:715 +#, no-c-format +msgid "" +"Note that these constructs - <literal>size</literal>, <literal>elements</" +"literal>, <literal>indices</literal>, <literal>minindex</literal>, " +"<literal>maxindex</literal>, <literal>minelement</literal>, " +"<literal>maxelement</literal> - may only be used in the where clause in " +"Hibernate3." msgstr "" - "<![CDATA[select item from Item item, Order order -\n" - "where order.items[ maxindex(order.items) ] = item and order.id = 11]]>" +"<literal>size</literal>, <literal>elements</literal>, <literal>indices</" +"literal>, <literal>minindex</literal>, <literal>maxindex</literal>, " +"<literal>minelement</literal>, <literal>maxelement</literal> はHibernate3の" +"where節だけで利用可能であることに注意してください。" -#: index.docbook:722 -msgid "Elements of indexed collections (arrays, lists, maps) may be referred to by index (in a where clause only):" -msgstr "<literal>[]</literal> 内部の式は、算術式でも構いません。" +#. Tag: para +#: query_hql.xml:722 +#, no-c-format +msgid "" +"Elements of indexed collections (arrays, lists, maps) may be referred to by " +"index (in a where clause only):" +msgstr "" +"インデックス付きのコレクション（arrays, lists, maps）の要素は、 インデックス" +"で参照できます（where節内でのみ）。" -#: index.docbook:727 +#. Tag: programlisting +#: query_hql.xml:727 +#, no-c-format msgid "<![CDATA[from Order order where order.items[0].id = 1234]]>" msgstr "" - "<![CDATA[select item from Item item, Order order -\n" - "where order.items[ size(order.items) - 1 ] = item]]>" -#: index.docbook:729 +#. Tag: programlisting +#: query_hql.xml:729 +#, no-c-format msgid "" - "<![CDATA[select person from Person person, Calendar calendar\n" - "where calendar.holidays['national day'] = person.birthDay\n" - " and person.nationality.calendar = calendar]]>" -msgstr "一対多関連や値のコレクションの要素に対しては、HQLは組み込みの <literal>index()</literal> 関数も用意しています。" +"<![CDATA[select person from Person person, Calendar calendar\n" +"where calendar.holidays['national day'] = person.birthDay\n" +" and person.nationality.calendar = calendar]]>" +msgstr "" -#: index.docbook:731 +#. Tag: programlisting +#: query_hql.xml:731 +#, no-c-format msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]>" +"<![CDATA[select item from Item item, Order order\n" +"where order.items[ order.deliveredItemIndices[0] ] = item and order.id = 11]]" +">" msgstr "" - "<![CDATA[select item, index(item) from Order order -\n" - " join order.items item -\n" - "where index(item) < 5]]>" -#: index.docbook:733 +#. Tag: programlisting +#: query_hql.xml:733 +#, no-c-format msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ maxindex(order.items) ] = item and order.id = 11]]>" -msgstr "ベースとなるデータベースがサポートしているスカラーSQL関数が使用できます" +"<![CDATA[select item from Item item, Order order\n" +"where order.items[ maxindex(order.items) ] = item and order.id = 11]]>" +msgstr "" -#: index.docbook:735 -msgid "The expression inside <literal>[]</literal> may even be an arithmetic expression." -msgstr "<![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]>" +#. Tag: para +#: query_hql.xml:735 +#, no-c-format +msgid "" +"The expression inside <literal>[]</literal> may even be an arithmetic " +"expression." +msgstr "<literal>[]</literal> 内部の式は、算術式でも構いません。" -#: index.docbook:739 +#. Tag: programlisting +#: query_hql.xml:739 +#, no-c-format msgid "" - "<![CDATA[select item from Item item, Order order\n" - "where order.items[ size(order.items) - 1 ] = item]]>" -msgstr "もしまだ全てを理解していないなら、下のクエリをSQLでどれだけ長く、読みづらく出来るか考えてください。:" +"<![CDATA[select item from Item item, Order order\n" +"where order.items[ size(order.items) - 1 ] = item]]>" +msgstr "" -#: index.docbook:741 -msgid "HQL also provides the built-in <literal>index()</literal> function, for elements of a one-to-many association or collection of values." +#. Tag: para +#: query_hql.xml:741 +#, no-c-format +msgid "" +"HQL also provides the built-in <literal>index()</literal> function, for " +"elements of a one-to-many association or collection of values." msgstr "" - "<![CDATA[select cust -\n" - "from Product prod, -\n" - " Store store -\n" - " inner join store.customers cust -\n" - "where prod.name = 'widget' -\n" - " and store.location.name in ( 'Melbourne', 'Sydney' ) -\n" - " and prod = all elements(cust.currentOrder.lineItems)]]>" +"一対多関連や値のコレクションの要素に対しては、HQLは組み込みの <literal>index" +"()</literal> 関数も用意しています。" -#: index.docbook:746 +#. Tag: programlisting +#: query_hql.xml:746 +#, no-c-format msgid "" - "<![CDATA[select item, index(item) from Order order\n" - " join order.items item\n" - "where index(item) < 5]]>" -msgstr "<emphasis>ヒント:</emphasis> 例えばこのように出来ます。" +"<![CDATA[select item, index(item) from Order order\n" +" join order.items item\n" +"where index(item) < 5]]>" +msgstr "" -#: index.docbook:748 +#. Tag: para +#: query_hql.xml:748 +#, no-c-format msgid "Scalar SQL functions supported by the underlying database may be used" msgstr "" - "<![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order -\n" - "FROM customers cust, -\n" - " stores store, -\n" - " locations loc, -\n" - " store_customers sc, -\n" - " product prod -\n" - "WHERE prod.name = 'widget' -\n" - " AND store.loc_id = loc.id -\n" - " AND loc.name IN ( 'Melbourne', 'Sydney' ) -\n" - " AND sc.store_id = store.id -\n" - " AND sc.cust_id = cust.id -\n" - " AND prod.id = ALL( -\n" - " SELECT item.prod_id -\n" - " FROM line_items item, orders o -\n" - " WHERE item.order_id = o.id -\n" - " AND cust.current_order = o.id -\n" - " )]]>" +"ベースとなるデータベースがサポートしているスカラーSQL関数が使用できます" -#: index.docbook:752 +#. Tag: programlisting +#: query_hql.xml:752 +#, no-c-format msgid "<![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]>" -msgstr "order by節" +msgstr "" -#: index.docbook:754 -msgid "If you are not yet convinced by all this, think how much longer and less readable the following query would be in SQL:" -msgstr "クエリが返すlistは、返されるクラスやコンポーネントの任意の属性によって並べ替えられます。：" +#. Tag: para +#: query_hql.xml:754 +#, no-c-format +msgid "" +"If you are not yet convinced by all this, think how much longer and less " +"readable the following query would be in SQL:" +msgstr "" +"もしまだ全てを理解していないなら、下のクエリをSQLでどれだけ長く、読みづらく出" +"来るか考えてください。:" -#: index.docbook:759 +#. Tag: programlisting +#: query_hql.xml:759 +#, no-c-format msgid "" - "<![CDATA[select cust\n" - "from Product prod,\n" - " Store store\n" - " inner join store.customers cust\n" - "where prod.name = 'widget'\n" - " and store.location.name in ( 'Melbourne', 'Sydney' )\n" - " and prod = all elements(cust.currentOrder.lineItems)]]>" +"<![CDATA[select cust\n" +"from Product prod,\n" +" Store store\n" +" inner join store.customers cust\n" +"where prod.name = 'widget'\n" +" and store.location.name in ( 'Melbourne', 'Sydney' )\n" +" and prod = all elements(cust.currentOrder.lineItems)]]>" msgstr "" - "<![CDATA[from DomesticCat cat -\n" - "order by cat.name asc, cat.weight desc, cat.birthdate]]>" -#: index.docbook:761 +#. Tag: para +#: query_hql.xml:761 +#, no-c-format msgid "<emphasis>Hint:</emphasis> something like" -msgstr "オプションの <literal>asc</literal> と <literal>desc</literal> はそれぞれ昇順か降順の整列を示します。" +msgstr "<emphasis>ヒント:</emphasis> 例えばこのように出来ます。" -#: index.docbook:765 +#. Tag: programlisting +#: query_hql.xml:765 +#, no-c-format msgid "" - "<![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust.current_order\n" - "FROM customers cust,\n" - " stores store,\n" - " locations loc,\n" - " store_customers sc,\n" - " product prod\n" - "WHERE prod.name = 'widget'\n" - " AND store.loc_id = loc.id\n" - " AND loc.name IN ( 'Melbourne', 'Sydney' )\n" - " AND sc.store_id = store.id\n" - " AND sc.cust_id = cust.id\n" - " AND prod.id = ALL(\n" - " SELECT item.prod_id\n" - " FROM line_items item, orders o\n" - " WHERE item.order_id = o.id\n" - " AND cust.current_order = o.id\n" - " )]]>" -msgstr "group by節" +"<![CDATA[SELECT cust.name, cust.address, cust.phone, cust.id, cust." +"current_order\n" +"FROM customers cust,\n" +" stores store,\n" +" locations loc,\n" +" store_customers sc,\n" +" product prod\n" +"WHERE prod.name = 'widget'\n" +" AND store.loc_id = loc.id\n" +" AND loc.name IN ( 'Melbourne', 'Sydney' )\n" +" AND sc.store_id = store.id\n" +" AND sc.cust_id = cust.id\n" +" AND prod.id = ALL(\n" +" SELECT item.prod_id\n" +" FROM line_items item, orders o\n" +" WHERE item.order_id = o.id\n" +" AND cust.current_order = o.id\n" +" )]]>" +msgstr "" -#: index.docbook:770 +#. Tag: title +#: query_hql.xml:770 +#, no-c-format msgid "The order by clause" -msgstr "集約値を返すクエリは、返されるクラスやコンポーネントの任意のプロパティによってグループ化できます。:" +msgstr "order by節" -#: index.docbook:772 -msgid "The list returned by a query may be ordered by any property of a returned class or components:" +#. Tag: para +#: query_hql.xml:772 +#, no-c-format +msgid "" +"The list returned by a query may be ordered by any property of a returned " +"class or components:" msgstr "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat) -\n" - "from Cat cat -\n" - "group by cat.color]]>" +"クエリが返すlistは、返されるクラスやコンポーネントの任意の属性によって並べ替" +"えられます。：" -#: index.docbook:776 +#. Tag: programlisting +#: query_hql.xml:776 +#, no-c-format msgid "" - "<![CDATA[from DomesticCat cat\n" - "order by cat.name asc, cat.weight desc, cat.birthdate]]>" +"<![CDATA[from DomesticCat cat\n" +"order by cat.name asc, cat.weight desc, cat.birthdate]]>" msgstr "" - "<![CDATA[select foo.id, avg(name), max(name) -\n" - "from Foo foo join foo.names name -\n" - "group by foo.id]]>" -#: index.docbook:778 -msgid "The optional <literal>asc</literal> or <literal>desc</literal> indicate ascending or descending order respectively." -msgstr "<literal>having</literal> 節も使えます。" +#. Tag: para +#: query_hql.xml:778 +#, no-c-format +msgid "" +"The optional <literal>asc</literal> or <literal>desc</literal> indicate " +"ascending or descending order respectively." +msgstr "" +"オプションの <literal>asc</literal> と <literal>desc</literal> はそれぞれ昇順" +"か降順の整列を示します。" -#: index.docbook:785 +#. Tag: title +#: query_hql.xml:785 +#, no-c-format msgid "The group by clause" +msgstr "group by節" + +#. Tag: para +#: query_hql.xml:787 +#, no-c-format +msgid "" +"A query that returns aggregate values may be grouped by any property of a " +"returned class or components:" msgstr "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat) -\n" - "from Cat cat -\n" - "group by cat.color -\n" - "having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]>" +"集約値を返すクエリは、返されるクラスやコンポーネントの任意のプロパティによっ" +"てグループ化できます。:" -#: index.docbook:787 -msgid "A query that returns aggregate values may be grouped by any property of a returned class or components:" -msgstr "もし使用するデータベースがサポートしているなら、 <literal>having</literal> と <literal>order by</literal> 節でSQL関数と集約関数が使えます （例えばMySQLにはありません）。" - -#: index.docbook:791 +#. Tag: programlisting +#: query_hql.xml:791 +#, no-c-format msgid "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" - "from Cat cat\n" - "group by cat.color]]>" +"<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" +"from Cat cat\n" +"group by cat.color]]>" msgstr "" - "<![CDATA[select cat -\n" - "from Cat cat -\n" - " join cat.kittens kitten -\n" - "group by cat -\n" - "having avg(kitten.weight) > 100 -\n" - "order by count(kitten) asc, sum(kitten.weight) desc]]>" -#: index.docbook:793 +#. Tag: programlisting +#: query_hql.xml:793 +#, no-c-format msgid "" - "<![CDATA[select foo.id, avg(name), max(name)\n" - "from Foo foo join foo.names name\n" - "group by foo.id]]>" -msgstr "<literal>group by</literal> 節や <literal>order by</literal> 節に 算術式を含むことができないことに注意してください。" +"<![CDATA[select foo.id, avg(name), max(name)\n" +"from Foo foo join foo.names name\n" +"group by foo.id]]>" +msgstr "" -#: index.docbook:795 +#. Tag: para +#: query_hql.xml:795 +#, no-c-format msgid "A <literal>having</literal> clause is also allowed." -msgstr "副問い合わせ" +msgstr "<literal>having</literal> 節も使えます。" -#: index.docbook:799 +#. Tag: programlisting +#: query_hql.xml:799 +#, no-c-format msgid "" - "<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" - "from Cat cat\n" - "group by cat.color\n" - "having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]>" -msgstr "サブセレクトをサポートするデータベースのため、Hibernateは副問い合わせをサポートしています。 副問い合わせは括弧で囲まなければなりません（SQLの集約関数呼び出しによる事が多いです）。 関連副問い合わせ(外部クエリ中の別名を参照する副問い合わせのこと)さえ許可されます。" +"<![CDATA[select cat.color, sum(cat.weight), count(cat)\n" +"from Cat cat\n" +"group by cat.color\n" +"having cat.color in (eg.Color.TABBY, eg.Color.BLACK)]]>" +msgstr "" -#: index.docbook:801 -msgid "SQL functions and aggregate functions are allowed in the <literal>having</literal> and <literal>order by</literal> clauses, if supported by the underlying database (eg. not in MySQL)." +#. Tag: para +#: query_hql.xml:801 +#, no-c-format +msgid "" +"SQL functions and aggregate functions are allowed in the <literal>having</" +"literal> and <literal>order by</literal> clauses, if supported by the " +"underlying database (eg. not in MySQL)." msgstr "" - "<![CDATA[from Cat as fatcat -\n" - "where fatcat.weight > ( -\n" - " select avg(cat.weight) from DomesticCat cat -\n" - ")]]>" +"もし使用するデータベースがサポートしているなら、 <literal>having</literal> " +"と <literal>order by</literal> 節でSQL関数と集約関数が使えます （例えばMySQL" +"にはありません）。" -#: index.docbook:807 +#. Tag: programlisting +#: query_hql.xml:807 +#, no-c-format msgid "" - "<![CDATA[select cat\n" - "from Cat cat\n" - " join cat.kittens kitten\n" - "group by cat.id, cat.name, cat.other, cat.properties\n" - "having avg(kitten.weight) > 100\n" - "order by count(kitten) asc, sum(kitten.weight) desc]]>" +"<![CDATA[select cat\n" +"from Cat cat\n" +" join cat.kittens kitten\n" +"group by cat.id, cat.name, cat.other, cat.properties\n" +"having avg(kitten.weight) > 100\n" +"order by count(kitten) asc, sum(kitten.weight) desc]]>" msgstr "" - "<![CDATA[from DomesticCat as cat -\n" - "where cat.name = some ( -\n" - " select name.nickName from Name as name -\n" - ")]]>" -#: index.docbook:809 -msgid "Note that neither the <literal>group by</literal> clause nor the <literal>order by</literal> clause may contain arithmetic expressions. Also note that Hibernate currently does not expand a grouped entity, so you can't write <literal>group by cat</literal> if all properties of <literal>cat</literal> are non-aggregated. You have to list all non-aggregated properties explicitly." +#. Tag: para +#: query_hql.xml:809 +#, no-c-format +msgid "" +"Note that neither the <literal>group by</literal> clause nor the " +"<literal>order by</literal> clause may contain arithmetic expressions. Also " +"note that Hibernate currently does not expand a grouped entity, so you can't " +"write <literal>group by cat</literal> if all properties of <literal>cat</" +"literal> are non-aggregated. You have to list all non-aggregated properties " +"explicitly." msgstr "" - "<![CDATA[from Cat as cat -\n" - "where not exists ( -\n" - " from Cat as mate where mate.mate = cat -\n" - ")]]>" +"Note that neither the <literal>group by</literal> clause nor the " +"<literal>order by</literal> clause may contain arithmetic expressions. Also " +"note that Hibernate currently does not expand a grouped entity, so you can't " +"write <literal>group by cat</literal> if all properties of <literal>cat</" +"literal> are non-aggregated. You have to list all non-aggregated properties " +"explicitly." -#: index.docbook:821 +#. Tag: title +#: query_hql.xml:821 +#, no-c-format msgid "Subqueries" -msgstr "" - "<![CDATA[from DomesticCat as cat -\n" - "where cat.name not in ( -\n" - " select name.nickName from Name as name -\n" - ")]]>" +msgstr "副問い合わせ" -#: index.docbook:823 -msgid "For databases that support subselects, Hibernate supports subqueries within queries. A subquery must be surrounded by parentheses (often by an SQL aggregate function call). Even correlated subqueries (subqueries that refer to an alias in the outer query) are allowed." +#. Tag: para +#: query_hql.xml:823 +#, no-c-format +msgid "" +"For databases that support subselects, Hibernate supports subqueries within " +"queries. A subquery must be surrounded by parentheses (often by an SQL " +"aggregate function call). Even correlated subqueries (subqueries that refer " +"to an alias in the outer query) are allowed." msgstr "" - "<![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit) -\n" - "from Cat as cat]]>" +"サブセレクトをサポートするデータベースのため、Hibernateは副問い合わせをサポー" +"トしています。 副問い合わせは括弧で囲まなければなりません（SQLの集約関数呼び" +"出しによる事が多いです）。 関連副問い合わせ(外部クエリ中の別名を参照する副問" +"い合わせのこと)さえ許可されます。" -#: index.docbook:829 +#. Tag: programlisting +#: query_hql.xml:829 +#, no-c-format msgid "" - "<![CDATA[from Cat as fatcat\n" - "where fatcat.weight > (\n" - " select avg(cat.weight) from DomesticCat cat\n" - ")]]>" -msgstr "HQL副問い合わせは、selectまたはwhere節だけで使われることに注意してください。" +"<![CDATA[from Cat as fatcat\n" +"where fatcat.weight > (\n" +" select avg(cat.weight) from DomesticCat cat\n" +")]]>" +msgstr "" -#: index.docbook:831 +#. Tag: programlisting +#: query_hql.xml:831 +#, no-c-format msgid "" - "<![CDATA[from DomesticCat as cat\n" - "where cat.name = some (\n" - " select name.nickName from Name as name\n" - ")]]>" -msgstr "selectリストに複数の式を持つ副問い合わせには、タプルを使うことができます。" +"<![CDATA[from DomesticCat as cat\n" +"where cat.name = some (\n" +" select name.nickName from Name as name\n" +")]]>" +msgstr "" -#: index.docbook:833 +#. Tag: programlisting +#: query_hql.xml:833 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - "where not exists (\n" - " from Cat as mate where mate.mate = cat\n" - ")]]>" +"<![CDATA[from Cat as cat\n" +"where not exists (\n" +" from Cat as mate where mate.mate = cat\n" +")]]>" msgstr "" - "<![CDATA[from Cat as cat -\n" - "where not ( cat.name, cat.color ) in ( -\n" - " select cat.name, cat.color from DomesticCat cat -\n" - ")]]>" -#: index.docbook:835 +#. Tag: programlisting +#: query_hql.xml:835 +#, no-c-format msgid "" - "<![CDATA[from DomesticCat as cat\n" - "where cat.name not in (\n" - " select name.nickName from Name as name\n" - ")]]>" -msgstr "いくつかのデータベース（OracleやHSQLにはありません）では、 他のコンテキストでもタプルが使えます。 例えば、クエリコンポーネントや複合ユーザ型においてです。" +"<![CDATA[from DomesticCat as cat\n" +"where cat.name not in (\n" +" select name.nickName from Name as name\n" +")]]>" +msgstr "" -#: index.docbook:837 +#. Tag: programlisting +#: query_hql.xml:837 +#, no-c-format msgid "" - "<![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit)\n" - "from Cat as cat]]>" -msgstr "<![CDATA[from Person where name = ('Gavin', 'A', 'King')]]>" +"<![CDATA[select cat.id, (select max(kit.weight) from cat.kitten kit)\n" +"from Cat as cat]]>" +msgstr "" -#: index.docbook:839 +#. Tag: para +#: query_hql.xml:839 +#, no-c-format msgid "Note that HQL subqueries may occur only in the select or where clauses." -msgstr "同等ですが、より冗長なクエリです：" +msgstr "" +"HQL副問い合わせは、selectまたはwhere節だけで使われることに注意してください。" -#: index.docbook:843 -msgid "Note that subqueries can also utilize <literal>row value constructor</literal> syntax. See <xref linkend=\"queryhql-tuple\"/> for more details." -msgstr "<![CDATA[from Person where name.first = 'Gavin' and name.initial = 'A' and name.last = 'King')]]>" +#. Tag: para +#: query_hql.xml:843 +#, no-c-format +msgid "" +"Note that subqueries can also utilize <literal>row value constructor</" +"literal> syntax. See <xref linkend=\"queryhql-tuple\"/> for more details." +msgstr "" +"Note that subqueries can also utilize <literal>row value constructor</" +"literal> syntax. See <xref linkend=\"queryhql-tuple\"/> for more details." -#: index.docbook:851 +#. Tag: title +#: query_hql.xml:851 +#, no-c-format msgid "HQL examples" -msgstr "このようなことをしたくないのには2つの理由があります： 1つ目は、データベースプラットフォーム間で完全な互換性はないからです。 2つ目は、クエリがマッピングドキュメントのプロパティの順序に依存するからです。" - -#: index.docbook:853 -msgid "Hibernate queries can be quite powerful and complex. In fact, the power of the query language is one of Hibernate's main selling points. Here are some example queries very similar to queries that I used on a recent project. Note that most queries you will write are much simpler than these!" msgstr "HQLの例" -#: index.docbook:859 -msgid "The following query returns the order id, number of items and total value of the order for all unpaid orders for a particular customer and given minimum total value, ordering the results by total value. In determining the prices, it uses the current catalog. The resulting SQL query, against the <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, <literal>CATALOG</literal> and <literal>PRICE</literal> tables has four inner joins and an (uncorrelated) subselect." -msgstr "Hibernateクエリは非常に強力で複雑にできます。実際、クエリ言語の威力はHibernateの主要なセールスポイントの一つです。 ここに最近のプロジェクトで使用したクエリと非常によく似た例があります。 ほとんどのクエリはこれらの例より簡単に記述できることに注意してください!" +#. Tag: para +#: query_hql.xml:853 +#, no-c-format +msgid "" +"Hibernate queries can be quite powerful and complex. In fact, the power of " +"the query language is one of Hibernate's main selling points. Here are some " +"example queries very similar to queries that I used on a recent project. " +"Note that most queries you will write are much simpler than these!" +msgstr "" +"Hibernateクエリは非常に強力で複雑にできます。実際、クエリ言語の威力は" +"Hibernateの主要なセールスポイントの一つです。 ここに最近のプロジェクトで使用" +"したクエリと非常によく似た例があります。 ほとんどのクエリはこれらの例より簡単" +"に記述できることに注意してください!" -#: index.docbook:868 +#. Tag: para +#: query_hql.xml:859 +#, no-c-format msgid "" - "<![CDATA[select order.id, sum(price.amount), count(item)\n" - "from Order as order\n" - " join order.lineItems as item\n" - " join item.product as product,\n" - " Catalog as catalog\n" - " join catalog.prices as price\n" - "where order.paid = false\n" - " and order.customer = :customer\n" - " and price.product = product\n" - " and catalog.effectiveDate < sysdate\n" - " and catalog.effectiveDate >= all (\n" - " select cat.effectiveDate\n" - " from Catalog as cat\n" - " where cat.effectiveDate < sysdate\n" - " )\n" - "group by order\n" - "having sum(price.amount) > :minAmount\n" - "order by sum(price.amount) desc]]>" -msgstr "以下のクエリは特定の顧客と与えられた最小の合計値に対する未払い注文の注文ID、 商品の数、注文の合計を合計値で整列して返します。 価格を決定する際、現在のカタログを使います。結果として返されるSQLクエリは <literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, <literal>CATALOG</literal> および <literal>PRICE</literal> テーブルに対し4つの内部結合と (関連しない)副問い合わせを持ちます。" +"The following query returns the order id, number of items and total value of " +"the order for all unpaid orders for a particular customer and given minimum " +"total value, ordering the results by total value. In determining the prices, " +"it uses the current catalog. The resulting SQL query, against the " +"<literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</" +"literal>, <literal>CATALOG</literal> and <literal>PRICE</literal> tables has " +"four inner joins and an (uncorrelated) subselect." +msgstr "" +"以下のクエリは特定の顧客と与えられた最小の合計値に対する未払い注文の注文ID、 " +"商品の数、注文の合計を合計値で整列して返します。 価格を決定する際、現在のカタ" +"ログを使います。結果として返されるSQLクエリは <literal>ORDER</literal>, " +"<literal>ORDER_LINE</literal>, <literal>PRODUCT</literal>, <literal>CATALOG</" +"literal> および <literal>PRICE</literal> テーブルに対し4つの内部結合と (関連" +"しない)副問い合わせを持ちます。" -#: index.docbook:870 -msgid "What a monster! Actually, in real life, I'm not very keen on subqueries, so my query was really more like this:" +#. Tag: programlisting +#: query_hql.xml:868 +#, no-c-format +msgid "" +"<![CDATA[select order.id, sum(price.amount), count(item)\n" +"from Order as order\n" +" join order.lineItems as item\n" +" join item.product as product,\n" +" Catalog as catalog\n" +" join catalog.prices as price\n" +"where order.paid = false\n" +" and order.customer = :customer\n" +" and price.product = product\n" +" and catalog.effectiveDate < sysdate\n" +" and catalog.effectiveDate >= all (\n" +" select cat.effectiveDate\n" +" from Catalog as cat\n" +" where cat.effectiveDate < sysdate\n" +" )\n" +"group by order\n" +"having sum(price.amount) > :minAmount\n" +"order by sum(price.amount) desc]]>" msgstr "" - "<![CDATA[select order.id, sum(price.amount), count(item) -\n" - "from Order as order -\n" - " join order.lineItems as item -\n" - " join item.product as product, -\n" - " Catalog as catalog -\n" - " join catalog.prices as price -\n" - "where order.paid = false -\n" - " and order.customer = :customer -\n" - " and price.product = product -\n" - " and catalog.effectiveDate < sysdate -\n" - " and catalog.effectiveDate >= all ( -\n" - " select cat.effectiveDate -\n" - " from Catalog as cat -\n" - " where cat.effectiveDate < sysdate -\n" - " ) -\n" - "group by order -\n" - "having sum(price.amount) > :minAmount -\n" - "order by sum(price.amount) desc]]>" -#: index.docbook:875 +#. Tag: para +#: query_hql.xml:870 +#, no-c-format msgid "" - "<![CDATA[select order.id, sum(price.amount), count(item)\n" - "from Order as order\n" - " join order.lineItems as item\n" - " join item.product as product,\n" - " Catalog as catalog\n" - " join catalog.prices as price\n" - "where order.paid = false\n" - " and order.customer = :customer\n" - " and price.product = product\n" - " and catalog = :currentCatalog\n" - "group by order\n" - "having sum(price.amount) > :minAmount\n" - "order by sum(price.amount) desc]]>" -msgstr "何て巨大なクエリなのでしょう! 普段私は副問い合わせをあまり使いません。したがって私のクエリは実際には以下のようになります。:" +"What a monster! Actually, in real life, I'm not very keen on subqueries, so " +"my query was really more like this:" +msgstr "" +"何て巨大なクエリなのでしょう! 普段私は副問い合わせをあまり使いません。した" +"がって私のクエリは実際には以下のようになります。:" -#: index.docbook:877 -msgid "The next query counts the number of payments in each status, excluding all payments in the <literal>AWAITING_APPROVAL</literal> status where the most recent status change was made by the current user. It translates to an SQL query with two inner joins and a correlated subselect against the <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> and <literal>PAYMENT_STATUS_CHANGE</literal> tables." +#. Tag: programlisting +#: query_hql.xml:875 +#, no-c-format +msgid "" +"<![CDATA[select order.id, sum(price.amount), count(item)\n" +"from Order as order\n" +" join order.lineItems as item\n" +" join item.product as product,\n" +" Catalog as catalog\n" +" join catalog.prices as price\n" +"where order.paid = false\n" +" and order.customer = :customer\n" +" and price.product = product\n" +" and catalog = :currentCatalog\n" +"group by order\n" +"having sum(price.amount) > :minAmount\n" +"order by sum(price.amount) desc]]>" msgstr "" - "<![CDATA[select order.id, sum(price.amount), count(item) -\n" - "from Order as order -\n" - " join order.lineItems as item -\n" - " join item.product as product, -\n" - " Catalog as catalog -\n" - " join catalog.prices as price -\n" - "where order.paid = false -\n" - " and order.customer = :customer -\n" - " and price.product = product -\n" - " and catalog = :currentCatalog -\n" - "group by order -\n" - "having sum(price.amount) > :minAmount -\n" - "order by sum(price.amount) desc]]>" -#: index.docbook:885 +#. Tag: para +#: query_hql.xml:877 +#, no-c-format msgid "" - "<![CDATA[select count(payment), status.name\n" - "from Payment as payment\n" - " join payment.currentStatus as status\n" - " join payment.statusChanges as statusChange\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" - " or (\n" - " statusChange.timeStamp = (\n" - " select max(change.timeStamp)\n" - " from PaymentStatusChange change\n" - " where change.payment = payment\n" - " )\n" - " and statusChange.user <> :currentUser\n" - " )\n" - "group by status.name, status.sortOrder\n" - "order by status.sortOrder]]>" -msgstr "次のクエリは各ステータスの支払い数を数えます。ただしすべての支払いが現在の利用者による 最新のステータス変更である <literal>AWAITING_APPROVAL</literal> である場合を除きます。 このクエリは2つの内部結合と <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> および <literal>PAYMENT_STATUS_CHANGE</literal> テーブルに対する関連副問い合わせを備えたSQLクエリに変換されます。" +"The next query counts the number of payments in each status, excluding all " +"payments in the <literal>AWAITING_APPROVAL</literal> status where the most " +"recent status change was made by the current user. It translates to an SQL " +"query with two inner joins and a correlated subselect against the " +"<literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal> and " +"<literal>PAYMENT_STATUS_CHANGE</literal> tables." +msgstr "" +"次のクエリは各ステータスの支払い数を数えます。ただしすべての支払いが現在の利" +"用者による 最新のステータス変更である <literal>AWAITING_APPROVAL</literal> で" +"ある場合を除きます。 このクエリは2つの内部結合と <literal>PAYMENT</literal>, " +"<literal>PAYMENT_STATUS</literal> および <literal>PAYMENT_STATUS_CHANGE</" +"literal> テーブルに対する関連副問い合わせを備えたSQLクエリに変換されます。" -#: index.docbook:887 -msgid "If I would have mapped the <literal>statusChanges</literal> collection as a list, instead of a set, the query would have been much simpler to write." +#. Tag: programlisting +#: query_hql.xml:885 +#, no-c-format +msgid "" +"<![CDATA[select count(payment), status.name\n" +"from Payment as payment\n" +" join payment.currentStatus as status\n" +" join payment.statusChanges as statusChange\n" +"where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +" or (\n" +" statusChange.timeStamp = (\n" +" select max(change.timeStamp)\n" +" from PaymentStatusChange change\n" +" where change.payment = payment\n" +" )\n" +" and statusChange.user <> :currentUser\n" +" )\n" +"group by status.name, status.sortOrder\n" +"order by status.sortOrder]]>" msgstr "" - "<![CDATA[select count(payment), status.name -\n" - "from Payment as payment -\n" - " join payment.currentStatus as status -\n" - " join payment.statusChanges as statusChange -\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL -\n" - " or ( -\n" - " statusChange.timeStamp = ( -\n" - " select max(change.timeStamp) -\n" - " from PaymentStatusChange change -\n" - " where change.payment = payment -\n" - " ) -\n" - " and statusChange.user <> :currentUser -\n" - " ) -\n" - "group by status.name, status.sortOrder -\n" - "order by status.sortOrder]]>" -#: index.docbook:892 +#. Tag: para +#: query_hql.xml:887 +#, no-c-format msgid "" - "<![CDATA[select count(payment), status.name\n" - "from Payment as payment\n" - " join payment.currentStatus as status\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" - " or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :currentUser\n" - "group by status.name, status.sortOrder\n" - "order by status.sortOrder]]>" -msgstr "もし私がsetの代わりにlistとして <literal>statusChanges</literal> コレクションを マッピングしたならば、はるかに簡単にクエリを記述できるでしょう。" +"If I would have mapped the <literal>statusChanges</literal> collection as a " +"list, instead of a set, the query would have been much simpler to write." +msgstr "" +"もし私がsetの代わりにlistとして <literal>statusChanges</literal> コレクション" +"を マッピングしたならば、はるかに簡単にクエリを記述できるでしょう。" -#: index.docbook:894 -msgid "The next query uses the MS SQL Server <literal>isNull()</literal> function to return all the accounts and unpaid payments for the organization to which the current user belongs. It translates to an SQL query with three inner joins, an outer join and a subselect against the <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, <literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> and <literal>ORG_USER</literal> tables." +#. Tag: programlisting +#: query_hql.xml:892 +#, no-c-format +msgid "" +"<![CDATA[select count(payment), status.name\n" +"from Payment as payment\n" +" join payment.currentStatus as status\n" +"where payment.status.name <> PaymentStatus.AWAITING_APPROVAL\n" +" or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :" +"currentUser\n" +"group by status.name, status.sortOrder\n" +"order by status.sortOrder]]>" msgstr "" - "<![CDATA[select count(payment), status.name -\n" - "from Payment as payment -\n" - " join payment.currentStatus as status -\n" - "where payment.status.name <> PaymentStatus.AWAITING_APPROVAL -\n" - " or payment.statusChanges[ maxIndex(payment.statusChanges) ].user <> :currentUser -\n" - "group by status.name, status.sortOrder -\n" - "order by status.sortOrder]]>" -#: index.docbook:903 +#. Tag: para +#: query_hql.xml:894 +#, no-c-format msgid "" - "<![CDATA[select account, payment\n" - "from Account as account\n" - " left outer join account.payments as payment\n" - "where :currentUser in elements(account.holder.users)\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" -msgstr "次のクエリは現在のユーザが所属する組織に対するアカウントおよび未払いの支払いを すべて返すMS SQL Server の <literal>isNull()</literal> 関数を使用しています。 このクエリは3つの内部結合と1つの外部結合 、 そして <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, <literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> および <literal>ORG_USER</literal> テーブルに対する副問い合わせ持ったSQLに変換されます。" +"The next query uses the MS SQL Server <literal>isNull()</literal> function " +"to return all the accounts and unpaid payments for the organization to which " +"the current user belongs. It translates to an SQL query with three inner " +"joins, an outer join and a subselect against the <literal>ACCOUNT</literal>, " +"<literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, " +"<literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> and " +"<literal>ORG_USER</literal> tables." +msgstr "" +"次のクエリは現在のユーザが所属する組織に対するアカウントおよび未払いの支払い" +"を すべて返すMS SQL Server の <literal>isNull()</literal> 関数を使用していま" +"す。 このクエリは3つの内部結合と1つの外部結合 、 そして <literal>ACCOUNT</" +"literal>, <literal>PAYMENT</literal>, <literal>PAYMENT_STATUS</literal>, " +"<literal>ACCOUNT_TYPE</literal>, <literal>ORGANIZATION</literal> および " +"<literal>ORG_USER</literal> テーブルに対する副問い合わせ持ったSQLに変換されま" +"す。" -#: index.docbook:905 -msgid "For some databases, we would need to do away with the (correlated) subselect." +#. Tag: programlisting +#: query_hql.xml:903 +#, no-c-format +msgid "" +"<![CDATA[select account, payment\n" +"from Account as account\n" +" left outer join account.payments as payment\n" +"where :currentUser in elements(account.holder.users)\n" +" and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +"PaymentStatus.UNPAID)\n" +"order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" msgstr "" - "<![CDATA[select account, payment -\n" - "from Account as account -\n" - " left outer join account.payments as payment -\n" - "where :currentUser in elements(account.holder.users) -\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID) -\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" -#: index.docbook:909 +#. Tag: para +#: query_hql.xml:905 +#, no-c-format msgid "" - "<![CDATA[select account, payment\n" - "from Account as account\n" - " join account.holder.users as user\n" - " left outer join account.payments as payment\n" - "where :currentUser = user\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID)\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" -msgstr "いくつかのデータベースについては、(関連させられた)副問い合わせの使用を避ける必要があるでしょう。" +"For some databases, we would need to do away with the (correlated) subselect." +msgstr "" +"いくつかのデータベースについては、(関連させられた)副問い合わせの使用を避ける" +"必要があるでしょう。" -#: index.docbook:914 -msgid "Bulk update and delete" +#. Tag: programlisting +#: query_hql.xml:909 +#, no-c-format +msgid "" +"<![CDATA[select account, payment\n" +"from Account as account\n" +" join account.holder.users as user\n" +" left outer join account.payments as payment\n" +"where :currentUser = user\n" +" and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, " +"PaymentStatus.UNPAID)\n" +"order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" msgstr "" - "<![CDATA[select account, payment -\n" - "from Account as account -\n" - " join account.holder.users as user -\n" - " left outer join account.payments as payment -\n" - "where :currentUser = user -\n" - " and PaymentStatus.UNPAID = isNull(payment.currentStatus.name, PaymentStatus.UNPAID) -\n" - "order by account.type.sortOrder, account.accountNumber, payment.dueDate]]>" -#: index.docbook:916 -msgid "HQL now supports <literal>update</literal>, <literal>delete</literal> and <literal>insert ... select ...</literal> statements. See <xref linkend=\"batch-direct\"/> for details." +#. Tag: title +#: query_hql.xml:914 +#, no-c-format +msgid "Bulk update and delete" msgstr "大量のUPDATEとDELETE" -#: index.docbook:924 +#. Tag: para +#: query_hql.xml:916 +#, no-c-format +msgid "" +"HQL now supports <literal>update</literal>, <literal>delete</literal> and " +"<literal>insert ... select ...</literal> statements. See <xref linkend=" +"\"batch-direct\"/> for details." +msgstr "" +"HQLは今は <literal>update</literal> と <literal>delete</literal>、" +"<literal>insert ... select ...</literal> ステートメントをHQLに入れることをサ" +"ポートしています。 <xref linkend=\"batch-direct\"/> に詳細があります。" + +#. Tag: title +#: query_hql.xml:924 +#, no-c-format msgid "Tips &amp; Tricks" -msgstr "HQLは今は <literal>update</literal> と <literal>delete</literal>、<literal>insert ... select ...</literal> ステートメントをHQLに入れることをサポートしています。 <xref linkend=\"batch-direct\"/> に詳細があります。" - -#: index.docbook:926 -msgid "You can count the number of query results without actually returning them:" msgstr "Tips &amp; Tricks" -#: index.docbook:930 -msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue()]]>" +#. Tag: para +#: query_hql.xml:926 +#, no-c-format +msgid "" +"You can count the number of query results without actually returning them:" msgstr "実際に結果を返さなくてもクエリの結果数を数えることができます。:" -#: index.docbook:932 +#. Tag: programlisting +#: query_hql.xml:930 +#, no-c-format +msgid "" +"<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\")." +"iterate().next() ).intValue()]]>" +msgstr "" + +#. Tag: para +#: query_hql.xml:932 +#, no-c-format msgid "To order a result by the size of a collection, use the following query:" -msgstr "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue()]]>" +msgstr "" +"コレクションのサイズにより結果を並べ替えるためには以下のクエリを使用します。:" -#: index.docbook:936 +#. Tag: programlisting +#: query_hql.xml:936 +#, no-c-format msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User as usr\n" - " left join usr.messages as msg\n" - "group by usr.id, usr.name\n" - "order by count(msg)]]>" -msgstr "コレクションのサイズにより結果を並べ替えるためには以下のクエリを使用します。:" +"<![CDATA[select usr.id, usr.name\n" +"from User as usr\n" +" left join usr.messages as msg\n" +"group by usr.id, usr.name\n" +"order by count(msg)]]>" +msgstr "" -#: index.docbook:938 -msgid "If your database supports subselects, you can place a condition upon selection size in the where clause of your query:" +#. Tag: para +#: query_hql.xml:938 +#, no-c-format +msgid "" +"If your database supports subselects, you can place a condition upon " +"selection size in the where clause of your query:" msgstr "" - "<![CDATA[select usr.id, usr.name -\n" - "from User as usr -\n" - " left join usr.messages as msg -\n" - "group by usr.id, usr.name -\n" - "order by count(msg)]]>" +"使用しているデータベースがサブセレクトをサポートする場合、クエリのwhere節でサ" +"イズによる選択条件を設定できます:" -#: index.docbook:943 +#. Tag: programlisting +#: query_hql.xml:943 +#, no-c-format msgid "<![CDATA[from User usr where size(usr.messages) >= 1]]>" -msgstr "使用しているデータベースがサブセレクトをサポートする場合、クエリのwhere節でサイズによる選択条件を設定できます:" +msgstr "" -#: index.docbook:945 +#. Tag: para +#: query_hql.xml:945 +#, no-c-format msgid "If your database doesn't support subselects, use the following query:" -msgstr "<![CDATA[from User usr where size(usr.messages) >= 1]]>" +msgstr "" +"使用しているデータベースがサブセレクトをサポートしない場合は、次のクエリを使" +"用してください:" -#: index.docbook:949 +#. Tag: programlisting +#: query_hql.xml:949 +#, no-c-format msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User usr.name\n" - " join usr.messages msg\n" - "group by usr.id, usr.name\n" - "having count(msg) >= 1]]>" -msgstr "使用しているデータベースがサブセレクトをサポートしない場合は、次のクエリを使用してください:" +"<![CDATA[select usr.id, usr.name\n" +"from User usr.name\n" +" join usr.messages msg\n" +"group by usr.id, usr.name\n" +"having count(msg) >= 1]]>" +msgstr "" -#: index.docbook:951 -msgid "As this solution can't return a <literal>User</literal> with zero messages because of the inner join, the following form is also useful:" +#. Tag: para +#: query_hql.xml:951 +#, no-c-format +msgid "" +"As this solution can't return a <literal>User</literal> with zero messages " +"because of the inner join, the following form is also useful:" msgstr "" - "<![CDATA[select usr.id, usr.name -\n" - "from User usr.name -\n" - " join usr.messages msg -\n" - "group by usr.id, usr.name -\n" - "having count(msg) >= 1]]>" +"内部結合をしているせいで上の解決法がmessageの件数が ゼロの <literal>User</" +"literal> を返すことができないならば、以下の形式が使えます。" -#: index.docbook:956 +#. Tag: programlisting +#: query_hql.xml:956 +#, no-c-format msgid "" - "<![CDATA[select usr.id, usr.name\n" - "from User as usr\n" - " left join usr.messages as msg\n" - "group by usr.id, usr.name\n" - "having count(msg) = 0]]>" -msgstr "内部結合をしているせいで上の解決法がmessageの件数が ゼロの <literal>User</literal> を返すことができないならば、以下の形式が使えます。" +"<![CDATA[select usr.id, usr.name\n" +"from User as usr\n" +" left join usr.messages as msg\n" +"group by usr.id, usr.name\n" +"having count(msg) = 0]]>" +msgstr "" -#: index.docbook:958 +#. Tag: para +#: query_hql.xml:958 +#, no-c-format msgid "Properties of a JavaBean can be bound to named query parameters:" msgstr "" - "<![CDATA[select usr.id, usr.name -\n" - "from User as usr -\n" - " left join usr.messages as msg -\n" - "group by usr.id, usr.name -\n" - "having count(msg) = 0]]>" +"JavaBeanのプロパティは、名前付きのクエリパラメータに結びつけることが出来ま" +"す。：" -#: index.docbook:962 +#. Tag: programlisting +#: query_hql.xml:962 +#, no-c-format msgid "" - "<![CDATA[Query q = s.createQuery(\"from foo Foo as foo where foo.name=:name and foo.size=:size\");\n" - "q.setProperties(fooBean); // fooBean has getName() and getSize()\n" - "List foos = q.list();]]>" -msgstr "JavaBeanのプロパティは、名前付きのクエリパラメータに結びつけることが出来ます。：" +"<![CDATA[Query q = s.createQuery(\"from foo Foo as foo where foo.name=:name " +"and foo.size=:size\");\n" +"q.setProperties(fooBean); // fooBean has getName() and getSize()\n" +"List foos = q.list();]]>" +msgstr "" -#: index.docbook:964 -msgid "Collections are pageable by using the <literal>Query</literal> interface with a filter:" +#. Tag: para +#: query_hql.xml:964 +#, no-c-format +msgid "" +"Collections are pageable by using the <literal>Query</literal> interface " +"with a filter:" msgstr "" - "<![CDATA[Query q = s.createQuery(\"from foo Foo as foo where foo.name=:name and foo.size=:size\"); -\n" - "q.setProperties(fooBean); // fooBean has getName() and getSize() -\n" - "List foos = q.list();]]>" +"コレクションはフィルタ付き <literal>Query</literal> インターフェイスを使用す" +"ることでページをつけることができます。:" -#: index.docbook:968 +#. Tag: programlisting +#: query_hql.xml:968 +#, no-c-format msgid "" - "<![CDATA[Query q = s.createFilter( collection, \"\" ); // the trivial filter\n" - "q.setMaxResults(PAGE_SIZE);\n" - "q.setFirstResult(PAGE_SIZE * pageNumber);\n" - "List page = q.list();]]>" -msgstr "コレクションはフィルタ付き <literal>Query</literal> インターフェイスを使用することでページをつけることができます。:" +"<![CDATA[Query q = s.createFilter( collection, \"\" ); // the trivial " +"filter\n" +"q.setMaxResults(PAGE_SIZE);\n" +"q.setFirstResult(PAGE_SIZE * pageNumber);\n" +"List page = q.list();]]>" +msgstr "" -#: index.docbook:970 +#. Tag: para +#: query_hql.xml:970 +#, no-c-format msgid "Collection elements may be ordered or grouped using a query filter:" msgstr "" - "<![CDATA[Query q = s.createFilter( collection, \"\" ); // the trivial filter -\n" - "q.setMaxResults(PAGE_SIZE); -\n" - "q.setFirstResult(PAGE_SIZE * pageNumber); -\n" - "List page = q.list();]]>" +"コレクションの要素はクエリフィルタを使って、並べ替えやグループ分けが出来ま" +"す。:" -#: index.docbook:974 +#. Tag: programlisting +#: query_hql.xml:974 +#, no-c-format msgid "" - "<![CDATA[Collection orderedCollection = s.filter( collection, \"order by this.amount\" );\n" - "Collection counts = s.filter( collection, \"select this.type, count(this) group by this.type\" );]]>" -msgstr "コレクションの要素はクエリフィルタを使って、並べ替えやグループ分けが出来ます。:" +"<![CDATA[Collection orderedCollection = s.filter( collection, \"order by " +"this.amount\" );\n" +"Collection counts = s.filter( collection, \"select this.type, count(this) " +"group by this.type\" );]]>" +msgstr "" -#: index.docbook:976 +#. Tag: para +#: query_hql.xml:976 +#, no-c-format msgid "You can find the size of a collection without initializing it:" +msgstr "コレクションを初期化せずにコレクションのサイズを得ることができます。:" + +#. Tag: programlisting +#: query_hql.xml:980 +#, no-c-format +msgid "" +"<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\")." +"iterate().next() ).intValue();]]>" msgstr "" - "<![CDATA[Collection orderedCollection = s.filter( collection, \"order by this.amount\" ); -\n" - "Collection counts = s.filter( collection, \"select this.type, count(this) group by this.type\" );]]>" -#: index.docbook:980 -msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue();]]>" -msgstr "コレクションを初期化せずにコレクションのサイズを得ることができます。:" - -#: index.docbook:985 +#. Tag: title +#: query_hql.xml:985 +#, no-c-format msgid "Components" -msgstr "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue();]]>" +msgstr "translator-credits" -#: index.docbook:987 -msgid "Components might be used in just about every way that simple value types can be used in HQL queries. They can appear in the <literal>select</literal> clause:" +#. Tag: para +#: query_hql.xml:987 +#, no-c-format +msgid "" +"Components might be used in just about every way that simple value types can " +"be used in HQL queries. They can appear in the <literal>select</literal> " +"clause:" msgstr "" -#: index.docbook:992, index.docbook:1038 +#. Tag: programlisting +#: query_hql.xml:992 query_hql.xml:1038 +#, no-c-format msgid "<![CDATA[select p.name from from Person p]]>" msgstr "" -#: index.docbook:993 +#. Tag: programlisting +#: query_hql.xml:993 +#, no-c-format msgid "<![CDATA[select p.name.first from from Person p]]>" msgstr "" -#: index.docbook:995 -msgid "where the Person's name property is a component. Components can also be used in the <literal>where</literal> clause:" +#. Tag: para +#: query_hql.xml:995 +#, no-c-format +msgid "" +"where the Person's name property is a component. Components can also be used " +"in the <literal>where</literal> clause:" msgstr "" -#: index.docbook:1000 +#. Tag: programlisting +#: query_hql.xml:1000 +#, no-c-format msgid "<![CDATA[from from Person p where p.name = :name]]>" msgstr "" -#: index.docbook:1001 +#. Tag: programlisting +#: query_hql.xml:1001 +#, no-c-format msgid "<![CDATA[from from Person p where p.name.first = :firstName]]>" msgstr "" -#: index.docbook:1003 +#. Tag: para +#: query_hql.xml:1003 +#, no-c-format msgid "Components can also be used in the <literal>order by</literal> clause:" msgstr "" -#: index.docbook:1007 +#. Tag: programlisting +#: query_hql.xml:1007 +#, no-c-format msgid "<![CDATA[from from Person p order by p.name]]>" msgstr "" -#: index.docbook:1008 +#. Tag: programlisting +#: query_hql.xml:1008 +#, no-c-format msgid "<![CDATA[from from Person p order by p.name.first]]>" msgstr "" -#: index.docbook:1010 -msgid "Another common use of components is in <xref linkend=\"queryhql-tuple\"/>row value constructors." +#. Tag: para +#: query_hql.xml:1010 +#, no-c-format +msgid "" +"Another common use of components is in <link linkend=\"queryhql-tuple\">row " +"value constructors</link>." msgstr "" -#: index.docbook:1016 +#. Tag: title +#: query_hql.xml:1016 +#, no-c-format msgid "Row value constructor syntax" msgstr "" -#: index.docbook:1018 -msgid "HQL supports the use of ANSI SQL <literal>row value constructor</literal> syntax (sometimes called <literal>tuple</literal> syntax), even though the underlying database may not support that notion. Here we are generally referring to multi-valued comparisons, typically associated with components. Consider an entity Person which defines a name component:" +#. Tag: para +#: query_hql.xml:1018 +#, no-c-format +msgid "" +"HQL supports the use of ANSI SQL <literal>row value constructor</literal> " +"syntax (sometimes called <literal>tuple</literal> syntax), even though the " +"underlying database may not support that notion. Here we are generally " +"referring to multi-valued comparisons, typically associated with components. " +"Consider an entity Person which defines a name component:" msgstr "" -#: index.docbook:1025 -msgid "<![CDATA[from Person p where p.name.first='John' and p.name.last='Jingleheimer-Schmidt']]>" +#. Tag: programlisting +#: query_hql.xml:1025 +#, no-c-format +msgid "" +"<![CDATA[from Person p where p.name.first='John' and p.name." +"last='Jingleheimer-Schmidt']]>" msgstr "" -#: index.docbook:1027 -msgid "That's valid syntax, although a little verbose. It be nice to make this a bit more concise and use <literal>row value constructor</literal> syntax:" +#. Tag: para +#: query_hql.xml:1027 +#, no-c-format +msgid "" +"That's valid syntax, although a little verbose. It be nice to make this a " +"bit more concise and use <literal>row value constructor</literal> syntax:" msgstr "" -#: index.docbook:1032 +#. Tag: programlisting +#: query_hql.xml:1032 +#, no-c-format msgid "<![CDATA[from Person p where p.name=('John', 'Jingleheimer-Schmidt')]]>" msgstr "" -#: index.docbook:1034 -msgid "It can also be useful to specify this in the <literal>select</literal> clause:" +#. Tag: para +#: query_hql.xml:1034 +#, no-c-format +msgid "" +"It can also be useful to specify this in the <literal>select</literal> " +"clause:" msgstr "" -#: index.docbook:1040 -msgid "Another time using <literal>row value constructor</literal> syntax can be beneficial is when using subqueries needing to compare against multiple values:" +#. Tag: para +#: query_hql.xml:1040 +#, no-c-format +msgid "" +"Another time using <literal>row value constructor</literal> syntax can be " +"beneficial is when using subqueries needing to compare against multiple " +"values:" msgstr "" -#: index.docbook:1045 +#. Tag: programlisting +#: query_hql.xml:1045 +#, no-c-format msgid "" - "<![CDATA[from Cat as cat\n" - "where not ( cat.name, cat.color ) in (\n" - " select cat.name, cat.color from DomesticCat cat\n" - ")]]>" +"<![CDATA[from Cat as cat\n" +"where not ( cat.name, cat.color ) in (\n" +" select cat.name, cat.color from DomesticCat cat\n" +")]]>" msgstr "" -#: index.docbook:1047 -msgid "One thing to consider when deciding if you want to use this syntax is that the query will be dependent upon the ordering of the component sub-properties in the metadata." +#. Tag: para +#: query_hql.xml:1047 +#, no-c-format +msgid "" +"One thing to consider when deciding if you want to use this syntax is that " +"the query will be dependent upon the ordering of the component sub-" +"properties in the metadata." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - Modified: core/trunk/documentation/manual/translations/ja-JP/content/query_sql.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/query_sql.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/query_sql.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1044 +1,1470 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: query_sql.xml:5 +#, no-c-format msgid "Native SQL" msgstr "ネイティブSQL" -#: index.docbook:7 -msgid "You may 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</literal> keyword in Oracle. It also provides a clean migration path from a direct SQL/JDBC based application to Hibernate." -msgstr "データベースのネイティブSQL方言を使ってクエリを表現することもできます。 クエリヒントやOracleの <literal>CONNECT</literal> キーワードのように、 データベース独自の機能を利用したいときに使えます。 SQL/JDBCを直接使用しているアプリケーションからHibernateへの移行も容易にしています。" +#. Tag: para +#: query_sql.xml:7 +#, no-c-format +msgid "" +"You may 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</literal> keyword in Oracle. It also " +"provides a clean migration path from a direct SQL/JDBC based application to " +"Hibernate." +msgstr "" +"データベースのネイティブSQL方言を使ってクエリを表現することもできます。 クエ" +"リヒントやOracleの <literal>CONNECT</literal> キーワードのように、 データベー" +"ス独自の機能を利用したいときに使えます。 SQL/JDBCを直接使用しているアプリケー" +"ションからHibernateへの移行も容易にしています。" -#: index.docbook:13 -msgid "Hibernate3 allows you to specify handwritten SQL (including stored procedures) for all create, update, delete, and load operations." -msgstr "Hibernate3では、生成、更新、削除、読み込み処理のようなすべての SQL（ストアドプロシージャを含む）を手書きできます。" +#. Tag: para +#: query_sql.xml:13 +#, no-c-format +msgid "" +"Hibernate3 allows you to specify handwritten SQL (including stored " +"procedures) for all create, update, delete, and load operations." +msgstr "" +"Hibernate3では、生成、更新、削除、読み込み処理のようなすべての SQL（ストアド" +"プロシージャを含む）を手書きできます。" -#: index.docbook:17 +#. Tag: title +#: query_sql.xml:17 +#, no-c-format msgid "Using a <literal>SQLQuery</literal>" msgstr "<literal>SQLQuery</literal> の使用" -#: index.docbook:19 -msgid "Execution of native SQL queries is controlled via the <literal>SQLQuery</literal> interface, which is obtained by calling <literal>Session.createSQLQuery()</literal>. The following describes how to use this API for querying." -msgstr "ネイティブなSQLクエリの実行は <literal>SQLQuery</literal> インターフェイスを通して制御します。 <literal>SQLQuery</literal> インターフェイスは <literal>Session.createSQLQuery()</literal> を呼び出して取得します。 このAPIを使って問い合わせする方法を以下で説明します。" +#. Tag: para +#: query_sql.xml:19 +#, no-c-format +msgid "" +"Execution of native SQL queries is controlled via the <literal>SQLQuery</" +"literal> interface, which is obtained by calling <literal>Session." +"createSQLQuery()</literal>. The following describes how to use this API for " +"querying." +msgstr "" +"ネイティブなSQLクエリの実行は <literal>SQLQuery</literal> インターフェイスを" +"通して制御します。 <literal>SQLQuery</literal> インターフェイスは " +"<literal>Session.createSQLQuery()</literal> を呼び出して取得します。 このAPI" +"を使って問い合わせする方法を以下で説明します。" -#: index.docbook:25 +#. Tag: title +#: query_sql.xml:25 +#, no-c-format msgid "Scalar queries" msgstr "スカラーのクエリ" -#: index.docbook:27 +#. Tag: para +#: query_sql.xml:27 +#, no-c-format msgid "The most basic SQL query is to get a list of scalars (values)." msgstr "最も基本的なSQLクエリはスカラー（値）のリストを得ることです。" -#: index.docbook:30 +#. Tag: programlisting +#: query_sql.xml:30 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" +"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").list();\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").list();\n" - "]]>" -#: index.docbook:32 -msgid "These will both 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 "これらはどちらも、CATSテーブルの各カラムのスカラー値を含む Object配列（Object[]）のリストを返します。 返すスカラー値の実際の順番と型を推定するために、 HibernateはResultSetMetadataを使用します。" +#. Tag: para +#: query_sql.xml:32 +#, no-c-format +msgid "" +"These will both 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 "" +"これらはどちらも、CATSテーブルの各カラムのスカラー値を含む Object配列（Object" +"[]）のリストを返します。 返すスカラー値の実際の順番と型を推定するために、 " +"HibernateはResultSetMetadataを使用します。" -#: index.docbook:37 -msgid "To avoid the overhead of using <literal>ResultSetMetadata</literal> or simply to be more explicit in what is returned one can use <literal>addScalar()</literal>." -msgstr "<literal>ResultSetMetadata</literal> を使用するオーバーヘッドを避けるため、 もしくは単に何が返されるか明確にするため、<literal>addScalar()</literal> を使えます。" +#. Tag: para +#: query_sql.xml:37 +#, no-c-format +msgid "" +"To avoid the overhead of using <literal>ResultSetMetadata</literal> or " +"simply to be more explicit in what is returned one can use <literal>addScalar" +"()</literal>." +msgstr "" +"<literal>ResultSetMetadata</literal> を使用するオーバーヘッドを避けるため、 " +"もしくは単に何が返されるか明確にするため、<literal>addScalar()</literal> を使" +"えます。" -#: index.docbook:41 +#. Tag: programlisting +#: query_sql.xml:41 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\", Hibernate.STRING)\n" - " .addScalar(\"BIRTHDATE\", Hibernate.DATE)\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +" .addScalar(\"ID\", Hibernate.LONG)\n" +" .addScalar(\"NAME\", Hibernate.STRING)\n" +" .addScalar(\"BIRTHDATE\", Hibernate.DATE)\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\", Hibernate.STRING)\n" - " .addScalar(\"BIRTHDATE\", Hibernate.DATE)\n" - "]]>" -#: index.docbook:43, index.docbook:89, index.docbook:170, index.docbook:321 +#. Tag: para +#: query_sql.xml:43 query_sql.xml:89 query_sql.xml:170 query_sql.xml:321 +#, no-c-format msgid "This query specified:" msgstr "このクエリで指定されているものを下記に示します。" -#: index.docbook:47, index.docbook:93, index.docbook:325 +#. Tag: para +#: query_sql.xml:47 query_sql.xml:93 query_sql.xml:325 +#, no-c-format msgid "the SQL query string" msgstr "SQLクエリ文字列" -#: index.docbook:51 +#. Tag: para +#: query_sql.xml:51 +#, no-c-format msgid "the columns and types to return" msgstr "返されるカラムと型" -#: index.docbook:55 -msgid "This will still return Object arrays, but now it will not use <literal>ResultSetMetdata</literal> 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>*</literal> and could return more than the three listed columns." -msgstr "これはまだObject配列を返しますが、 <literal>ResultSetMetdata</literal> を使用しません。 ただし、その代わりに基礎にあるリザルトセットから ID、NAME、BIRTHDATE カラムをそれぞれ Long、String、Short として明示的に取得します。 これは３つのカラムを返すのみであることも意味します。 たとえ、クエリが <literal>*</literal> を使用し、 列挙した３つより多くのカラムを返せるとしてもです。" +#. Tag: para +#: query_sql.xml:55 +#, no-c-format +msgid "" +"This will still return Object arrays, but now it will not use " +"<literal>ResultSetMetdata</literal> 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>*</literal> and could " +"return more than the three listed columns." +msgstr "" +"これはまだObject配列を返しますが、 <literal>ResultSetMetdata</literal> を使用" +"しません。 ただし、その代わりに基礎にあるリザルトセットから ID、NAME、" +"BIRTHDATE カラムをそれぞれ Long、String、Short として明示的に取得します。 こ" +"れは３つのカラムを返すのみであることも意味します。 たとえ、クエリが " +"<literal>*</literal> を使用し、 列挙した３つより多くのカラムを返せるとしても" +"です。" -#: index.docbook:63 -msgid "It is possible to leave out the type information for all or some of the scalars." +#. Tag: para +#: query_sql.xml:63 +#, no-c-format +msgid "" +"It is possible to leave out the type information for all or some of the " +"scalars." msgstr "スカラーの型情報を省くこともできます。" -#: index.docbook:66 +#. Tag: programlisting +#: query_sql.xml:66 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\")\n" - " .addScalar(\"BIRTHDATE\")\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" +" .addScalar(\"ID\", Hibernate.LONG)\n" +" .addScalar(\"NAME\")\n" +" .addScalar(\"BIRTHDATE\")\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\")\n" - " .addScalar(\"ID\", Hibernate.LONG)\n" - " .addScalar(\"NAME\")\n" - " .addScalar(\"BIRTHDATE\")\n" - "]]>" -#: index.docbook:68 -msgid "This is essentially the same query as before, but now <literal>ResultSetMetaData</literal> is used to decide the type of NAME and BIRTHDATE where as the type of ID is explicitly specified." -msgstr "これは本質的に前と同じクエリですが、、 NAME と BIRTHDATE の型を決めるために <literal>ResultSetMetaData</literal> を使用します。一方、ID の型は明示的に指定されています。" +#. Tag: para +#: query_sql.xml:68 +#, no-c-format +msgid "" +"This is essentially the same query as before, but now " +"<literal>ResultSetMetaData</literal> is used to decide the type of NAME and " +"BIRTHDATE where as the type of ID is explicitly specified." +msgstr "" +"これは本質的に前と同じクエリですが、、 NAME と BIRTHDATE の型を決めるために " +"<literal>ResultSetMetaData</literal> を使用します。一方、ID の型は明示的に指" +"定されています。" -#: index.docbook:72 -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</literal> in the Dialect." -msgstr "ResultSetMetaData から返される java.sql.Types を Hibernate の型に マッピングすることは、Dialect が制御します。 明示された型がマッピングされていないか、結果の型が期待したものと異なる場合、 Dialect の <literal>registerHibernateType</literal> を呼び出し、 カスタマイズできます。" +#. Tag: para +#: query_sql.xml:72 +#, 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</literal> in the Dialect." +msgstr "" +"ResultSetMetaData から返される java.sql.Types を Hibernate の型に マッピング" +"することは、Dialect が制御します。 明示された型がマッピングされていないか、結" +"果の型が期待したものと異なる場合、 Dialect の " +"<literal>registerHibernateType</literal> を呼び出し、 カスタマイズできます。" -#: index.docbook:80 +#. Tag: title +#: query_sql.xml:80 +#, no-c-format msgid "Entity queries" msgstr "エンティティのクエリ" -#: index.docbook:82 -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()</literal>." -msgstr "ここまでのクエリは、すべてスカラー値を返すものでした。 基本的に、リザルトセットから「未加工」の値を返します。 以降では、<literal>addEntity()</literal> により、ネイティブSQLクエリから エンティティオブジェクトを取得する方法を示します。" +#. Tag: para +#: query_sql.xml:82 +#, 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()</" +"literal>." +msgstr "" +"ここまでのクエリは、すべてスカラー値を返すものでした。 基本的に、リザルトセッ" +"トから「未加工」の値を返します。 以降では、<literal>addEntity()</literal> に" +"より、ネイティブSQLクエリから エンティティオブジェクトを取得する方法を示しま" +"す。" -#: index.docbook:87 +#. Tag: programlisting +#: query_sql.xml:87 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity(Cat.class);\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n" +"sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity(Cat." +"class);\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT * FROM CATS\").addEntity(Cat.class);\n" - "sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE FROM CATS\").addEntity(Cat.class);\n" - "]]>" -#: index.docbook:97 +#. Tag: para +#: query_sql.xml:97 +#, no-c-format msgid "the entity returned by the query" msgstr "クエリが返すエンティティとSQLテーブルの別名" -#: index.docbook:101 -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 "CatがID, NAME, BIRTHDATEのカラムを使ってクラスにマッピングされる場合、 上記のクエリはどちらも、要素がCatエンティティであるリストを返します。" +#. Tag: para +#: query_sql.xml:101 +#, 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 "" +"CatがID, NAME, BIRTHDATEのカラムを使ってクラスにマッピングされる場合、 上記の" +"クエリはどちらも、要素がCatエンティティであるリストを返します。" -#: index.docbook:105 -msgid "If the entity is mapped with a <literal>many-to-one</literal> 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 <literal>Dog</literal>:" -msgstr "エンティティを別のエンティティに <literal>多対一</literal> でマッピングしている場合は、 ネイティブクエリを実行する際に、この別のエンティティを返すことも要求します。 さもなければ、データベース固有の「column not found(カラムが見つかりません)」エラーが発生します。 * 表記を使用した際は、追加のカラムが自動的に返されますが、 次の例のように、<literal>Dog</literal> に <literal>多対一</literal> であることを 明示することを私たちは好みます。" +#. Tag: para +#: query_sql.xml:105 +#, no-c-format +msgid "" +"If the entity is mapped with a <literal>many-to-one</literal> 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 <literal>Dog</literal>:" +msgstr "" +"エンティティを別のエンティティに <literal>多対一</literal> でマッピングしてい" +"る場合は、 ネイティブクエリを実行する際に、この別のエンティティを返すことも要" +"求します。 さもなければ、データベース固有の「column not found(カラムが見つか" +"りません)」エラーが発生します。 * 表記を使用した際は、追加のカラムが自動的に" +"返されますが、 次の例のように、<literal>Dog</literal> に <literal>多対一</" +"literal> であることを 明示することを私たちは好みます。" -#: index.docbook:113 +#. Tag: programlisting +#: query_sql.xml:113 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS\").addEntity(Cat.class);\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS" +"\").addEntity(Cat.class);\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT ID, NAME, BIRTHDATE, DOG_ID FROM CATS\").addEntity(Cat.class);\n" - "]]>" -#: index.docbook:115 +#. Tag: para +#: query_sql.xml:115 +#, no-c-format msgid "This will allow cat.getDog() to function properly." msgstr "これにより cat.getDog() が正しく機能します。" -#: index.docbook:119 +#. Tag: title +#: query_sql.xml:119 +#, no-c-format msgid "Handling associations and collections" msgstr "関連とコレクションの操作" -#: index.docbook:121 -msgid "It is possible to eagerly join in the <literal>Dog</literal> to avoid the possible extra roundtrip for initializing the proxy. This is done via the <literal>addJoin()</literal> method, which allows you to join in an association or collection." -msgstr "プロキシを初期化するための余分な処理を避けるため、 <literal>Dog</literal> の中で即時結合できます。 これは <literal>addJoin()</literal> メソッドにより行います。 関連もしくはコレクションに結合できます。" +#. Tag: para +#: query_sql.xml:121 +#, no-c-format +msgid "" +"It is possible to eagerly join in the <literal>Dog</literal> to avoid the " +"possible extra roundtrip for initializing the proxy. This is done via the " +"<literal>addJoin()</literal> method, which allows you to join in an " +"association or collection." +msgstr "" +"プロキシを初期化するための余分な処理を避けるため、 <literal>Dog</literal> の" +"中で即時結合できます。 これは <literal>addJoin()</literal> メソッドにより行い" +"ます。 関連もしくはコレクションに結合できます。" -#: index.docbook:126 +#. Tag: programlisting +#: query_sql.xml:126 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, D_NAME FROM CATS c, DOGS d WHERE c.DOG_ID = d.D_ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addJoin(\"cat.dog\");\n" - "]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, " +"D_NAME FROM CATS c, DOGS d WHERE c.DOG_ID = d.D_ID\")\n" +" .addEntity(\"cat\", Cat.class)\n" +" .addJoin(\"cat.dog\");\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT c.ID, NAME, BIRTHDATE, DOG_ID, D_ID, D_NAME FROM CATS c, DOGS d WHERE c.DOG_ID = d.D_ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addJoin(\"cat.dog\");\n" - "]]>" -#: index.docbook:128 -msgid "In this example the returned <literal>Cat</literal>'s will have their <literal>dog</literal> property fully initialized without any extra roundtrip to the database. Notice that we added a 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>Cat</literal> had a one-to-many to <literal>Dog</literal> instead." -msgstr "この例の中で、返される <literal>Cat</literal> は、 データベースへの余分処理なしで、 完全に初期化された <literal>dog</literal> プロパティを持ちます。 結合対象のプロパティへのパスを指定できるように、 別名（「cat」）を追加したことに注意してください。 コレクションの即時結合も同じようにできます。 たとえば、<literal>Cat</literal> が一対多で <literal>Dog</literal> を持っていた場合、次のようになります。" +#. Tag: para +#: query_sql.xml:128 +#, no-c-format +msgid "" +"In this example the returned <literal>Cat</literal>'s will have their " +"<literal>dog</literal> property fully initialized without any extra " +"roundtrip to the database. Notice that we added a 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>Cat</literal> " +"had a one-to-many to <literal>Dog</literal> instead." +msgstr "" +"この例の中で、返される <literal>Cat</literal> は、 データベースへの余分処理な" +"しで、 完全に初期化された <literal>dog</literal> プロパティを持ちます。 結合" +"対象のプロパティへのパスを指定できるように、 別名（「cat」）を追加したことに" +"注意してください。 コレクションの即時結合も同じようにできます。 たとえば、" +"<literal>Cat</literal> が一対多で <literal>Dog</literal> を持っていた場合、次" +"のようになります。" -#: index.docbook:136 +#. Tag: programlisting +#: query_sql.xml:136 +#, no-c-format msgid "" - "<![CDATA[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\");\n" - "]]>" +"<![CDATA[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\");\n" +"]]>" msgstr "" - "<![CDATA[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\");\n" - "]]>" -#: index.docbook:138 -msgid "At this stage we are reaching the limits of what is possible with native queries without starting to enhance the sql queries to make them usable in Hibernate; the problems starts to arise when returning multiple entities of the same type or when the default alias/column names are not enough." -msgstr "現在のところ、 Hibernateで使いやすくするためのSQLクエリの拡張なしに、 ネイティブクエリで何かを可能にする限界に来ています。 同じ型のエンティティを複数返す際や、デフォルトの別名や列名で十分ではない場合に、 問題は起こり始めます。" +#. Tag: para +#: query_sql.xml:138 +#, no-c-format +msgid "" +"At this stage we are reaching the limits of what is possible with native " +"queries without starting to enhance the sql queries to make them usable in " +"Hibernate; the problems starts to arise when returning multiple entities of " +"the same type or when the default alias/column names are not enough." +msgstr "" +"現在のところ、 Hibernateで使いやすくするためのSQLクエリの拡張なしに、 ネイ" +"ティブクエリで何かを可能にする限界に来ています。 同じ型のエンティティを複数返" +"す際や、デフォルトの別名や列名で十分ではない場合に、 問題は起こり始めます。" -#: index.docbook:146 +#. Tag: title +#: query_sql.xml:146 +#, no-c-format msgid "Returning multiple entities" msgstr "複数エンティティの取得" -#: index.docbook:148 -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 which join multiple tables, since the same column names may appear in more than one table." -msgstr "ここまでは、リザルトセットのカラム名は、 マッピングファイルで指定されたカラム名と同じであると仮定していました。 複数のテーブルが同じカラム名を持つ場合があるため、 複数テーブルを結合するSQLクエリで問題となる場合があります。" +#. Tag: para +#: query_sql.xml:148 +#, 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 which join multiple tables, since the same column names may " +"appear in more than one table." +msgstr "" +"ここまでは、リザルトセットのカラム名は、 マッピングファイルで指定されたカラム" +"名と同じであると仮定していました。 複数のテーブルが同じカラム名を持つ場合があ" +"るため、 複数テーブルを結合するSQLクエリで問題となる場合があります。" -#: index.docbook:153 -msgid "Column alias injection is needed in the following query (which most likely will fail):" -msgstr "下記のような（失敗しそうな）クエリでは、 カラム別名インジェクション（column alias injection）が必要です。" +#. Tag: para +#: query_sql.xml:153 +#, no-c-format +msgid "" +"Column alias injection is needed in the following query (which most likely " +"will fail):" +msgstr "" +"下記のような（失敗しそうな）クエリでは、 カラム別名インジェクション（column " +"alias injection）が必要です。" -#: index.docbook:156 +#. Tag: programlisting +#: query_sql.xml:156 +#, no-c-format msgid "" - "<![CDATA[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)\n" - "]]>" +"<![CDATA[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)\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT c.*, m.* FROM CATS c, CATS m WHERE c.MOTHER_ID = m.ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class)\n" - "]]>" -#: index.docbook:158 -msgid "The intention for this query is to return two Cat instances per row, a cat and its mother. This will fail since there is a conflict of names since they are mapped to the same column names and 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 specificed in the mappings (\"ID\" and \"NAME\")." -msgstr "このクエリの意図は、 １行ごとに２つのCatインスタンス、つまり猫とその母親を返すということです。 同じカラム名にマッピングすることにより名前が衝突するため、このクエリは失敗します。 ベータベースによっては、返されるカラムの別名が \"c.ID\"、\"c.NAME\" などの形式であり、 マッピングで指定されたカラム（\"ID\" と \"NAME\"）と等しくないため、失敗します。" +#. Tag: para +#: query_sql.xml:158 +#, no-c-format +msgid "" +"The intention for this query is to return two Cat instances per row, a cat " +"and its mother. This will fail since there is a conflict of names since they " +"are mapped to the same column names and 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 specificed in the mappings (\"ID\" and " +"\"NAME\")." +msgstr "" +"このクエリの意図は、 １行ごとに２つのCatインスタンス、つまり猫とその母親を返" +"すということです。 同じカラム名にマッピングすることにより名前が衝突するため、" +"このクエリは失敗します。 ベータベースによっては、返されるカラムの別名が \"c." +"ID\"、\"c.NAME\" などの形式であり、 マッピングで指定されたカラム（\"ID\" と " +"\"NAME\"）と等しくないため、失敗します。" -#: index.docbook:165 +#. Tag: para +#: query_sql.xml:165 +#, no-c-format msgid "The following form is not vulnerable to column name duplication:" msgstr "下記の形式は、カラム名が重複しても大丈夫です。" -#: index.docbook:168 +#. Tag: programlisting +#: query_sql.xml:168 +#, no-c-format msgid "" - "<![CDATA[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)\n" - "]]>" +"<![CDATA[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)\n" +"]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT {cat.*}, {mother.*} FROM CATS c, CATS m WHERE c.MOTHER_ID = m.ID\")\n" - " .addEntity(\"cat\", Cat.class)\n" - " .addEntity(\"mother\", Cat.class)\n" - "]]>" -#: index.docbook:174 -msgid "the SQL query string, with placeholders for Hibernate to inject column aliases" -msgstr "SQLクエリ文字列 （Hibernateがカラムの別名を挿入するためのプレースホルダを含む）" +#. Tag: para +#: query_sql.xml:174 +#, no-c-format +msgid "" +"the SQL query string, with placeholders for Hibernate to inject column " +"aliases" +msgstr "" +"SQLクエリ文字列 （Hibernateがカラムの別名を挿入するためのプレースホルダを含" +"む）" -#: index.docbook:179 +#. Tag: para +#: query_sql.xml:179 +#, no-c-format msgid "the entities returned by the query" msgstr "クエリによって返されるエンティティ" -#: index.docbook:183 -msgid "The {cat.*} and {mother.*} notation used above is a shorthand for \"all properties\". Alternatively, you may list the columns explicity, but even in this case we let Hibernate inject 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, we retrieve Cats and their mothers from a different table (cat_log) to the one declared in the mapping metadata. Notice that we may even use the property aliases in the where clause if we like." -msgstr "上記で使用している {cat.*} と {mother.*} という表記は、 「すべてのプロパティ」を表す省略形です。 代わりに、明示的にカラムを列挙してもよいですが、 その場合は、Hibernateに各プロパティに対応するSQLカラムの別名を挿入させるべきでしょう。 カラムの別名のためのプレースホルダは、テーブルの別名によって修飾されたプロパティ名です。 下記の例では、別のテーブル cat_log から マッピングメタデータで定義された Cat とその母親を復元します。 もし好むなら、where節の中でも、プロパティの別名を使えます。" +#. Tag: para +#: query_sql.xml:183 +#, no-c-format +msgid "" +"The {cat.*} and {mother.*} notation used above is a shorthand for \"all " +"properties\". Alternatively, you may list the columns explicity, but even in " +"this case we let Hibernate inject 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, we retrieve Cats and their " +"mothers from a different table (cat_log) to the one declared in the mapping " +"metadata. Notice that we may even use the property aliases in the where " +"clause if we like." +msgstr "" +"上記で使用している {cat.*} と {mother.*} という表記は、 「すべてのプロパ" +"ティ」を表す省略形です。 代わりに、明示的にカラムを列挙してもよいですが、 そ" +"の場合は、Hibernateに各プロパティに対応するSQLカラムの別名を挿入させるべきで" +"しょう。 カラムの別名のためのプレースホルダは、テーブルの別名によって修飾され" +"たプロパティ名です。 下記の例では、別のテーブル cat_log から マッピングメタ" +"データで定義された Cat とその母親を復元します。 もし好むなら、where節の中で" +"も、プロパティの別名を使えます。" -#: index.docbook:192 +#. Tag: programlisting +#: query_sql.xml:192 +#, no-c-format msgid "" - "<![CDATA[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()\n" - "]]>" +"<![CDATA[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()\n" +"]]>" msgstr "" - "<![CDATA[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()\n" - "]]>" -#: index.docbook:195 +#. Tag: title +#: query_sql.xml:195 +#, no-c-format msgid "Alias and property references" msgstr "別名とプロパティのリファレンス" -#: index.docbook:197 -msgid "For most cases the above alias injection is needed, but for queries relating to more complex mappings like composite properties, inheritance discriminators, collections etc. there are some specific aliases to use to allow Hibernate to inject the proper aliases." -msgstr "多くの場合、上記のような別名インジェクションが必要です。 ただし、複合プロパティ、継承識別子、コレクションなどのような より複雑なマッピングと関連するクエリがなければです。 ある特定の別名を使用することにより、Hibernateは適切な別名を挿入できます。" +#. Tag: para +#: query_sql.xml:197 +#, no-c-format +msgid "" +"For most cases the above alias injection is needed, but for queries relating " +"to more complex mappings like composite properties, inheritance " +"discriminators, collections etc. there are some specific aliases to use to " +"allow Hibernate to inject the proper aliases." +msgstr "" +"多くの場合、上記のような別名インジェクションが必要です。 ただし、複合プロパ" +"ティ、継承識別子、コレクションなどのような より複雑なマッピングと関連するクエ" +"リがなければです。 ある特定の別名を使用することにより、Hibernateは適切な別名" +"を挿入できます。" -#: index.docbook:202 -msgid "The following table shows the different possibilities of using the alias injection. Note: the alias names in the result are examples, each alias will have a unique and probably different name when used." -msgstr "別名インジェクションとして使用できるものを下表に示します。 注意：下表の別名は一例です。 それぞれの別名は一意であり、使用する際にはおそらく異なる名前を持ちます。" +#. Tag: para +#: query_sql.xml:202 +#, no-c-format +msgid "" +"The following table shows the different possibilities of using the alias " +"injection. Note: the alias names in the result are examples, each alias will " +"have a unique and probably different name when used." +msgstr "" +"別名インジェクションとして使用できるものを下表に示します。 注意：下表の別名は" +"一例です。 それぞれの別名は一意であり、使用する際にはおそらく異なる名前を持ち" +"ます。" -#: index.docbook:208 +#. Tag: title +#: query_sql.xml:208 +#, no-c-format msgid "Alias injection names" msgstr "別名に挿入する名前" -#: index.docbook:219 +#. Tag: entry +#: query_sql.xml:219 +#, no-c-format msgid "Description" -msgstr "<entry>説明</entry>" +msgstr "説明" -#: index.docbook:221 +#. Tag: entry +#: query_sql.xml:221 +#, no-c-format msgid "Syntax" -msgstr "<entry>構文</entry>" +msgstr "構文" -#: index.docbook:223 +#. Tag: entry +#: query_sql.xml:223 +#, no-c-format msgid "Example" -msgstr "<entry>例</entry>" +msgstr "例" -#: index.docbook:229 +#. Tag: entry +#: query_sql.xml:229 +#, no-c-format msgid "A simple property" msgstr "単純なプロパティ" -#: index.docbook:231 +#. Tag: literal +#: query_sql.xml:231 +#, no-c-format msgid "{[aliasname].[propertyname]" msgstr "{[aliasname].[propertyname]}" -#: index.docbook:233 +#. Tag: literal +#: query_sql.xml:233 +#, no-c-format msgid "A_NAME as {item.name}" msgstr "A_NAME as {item.name}" -#: index.docbook:237 +#. Tag: entry +#: query_sql.xml:237 +#, no-c-format msgid "A composite property" msgstr "複合プロパティ" -#: index.docbook:239 +#. Tag: literal +#: query_sql.xml:239 +#, no-c-format msgid "{[aliasname].[componentname].[propertyname]}" msgstr "{[aliasname].[componentname].[propertyname]}" -#: index.docbook:241 +#. Tag: literal +#: query_sql.xml:241 +#, no-c-format msgid "CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}" msgstr "CURRENCY as {item.amount.currency}, VALUE as {item.amount.value}" -#: index.docbook:246 +#. Tag: entry +#: query_sql.xml:246 +#, no-c-format msgid "Discriminator of an entity" msgstr "エンティティのクラスを識別する値" -#: index.docbook:248 +#. Tag: literal +#: query_sql.xml:248 +#, no-c-format msgid "{[aliasname].class}" msgstr "{[aliasname].class}" -#: index.docbook:250 +#. Tag: literal +#: query_sql.xml:250 +#, no-c-format msgid "DISC as {item.class}" msgstr "DISC as {item.class}" -#: index.docbook:254 +#. Tag: entry +#: query_sql.xml:254 +#, no-c-format msgid "All properties of an entity" msgstr "エンティティの全プロパティ" -#: index.docbook:256, index.docbook:304 +#. Tag: literal +#: query_sql.xml:256 query_sql.xml:304 +#, no-c-format msgid "{[aliasname].*}" msgstr "{[aliasname].*}" -#: index.docbook:258 +#. Tag: literal +#: query_sql.xml:258 +#, no-c-format msgid "{item.*}" msgstr "{item.*}" -#: index.docbook:262 +#. Tag: entry +#: query_sql.xml:262 +#, no-c-format msgid "A collection key" msgstr "コレクションのキー" -#: index.docbook:264 +#. Tag: literal +#: query_sql.xml:264 +#, no-c-format msgid "{[aliasname].key}" msgstr "{[aliasname].key}" -#: index.docbook:266 +#. Tag: literal +#: query_sql.xml:266 +#, no-c-format msgid "ORGID as {coll.key}" msgstr "ORGID as {coll.key}" -#: index.docbook:270 +#. Tag: entry +#: query_sql.xml:270 +#, no-c-format msgid "The id of an collection" msgstr "コレクションのID" -#: index.docbook:272 +#. Tag: literal +#: query_sql.xml:272 +#, no-c-format msgid "{[aliasname].id}" msgstr "{[aliasname].id}" -#: index.docbook:274 +#. Tag: literal +#: query_sql.xml:274 +#, no-c-format msgid "EMPID as {coll.id}" msgstr "EMPID as {coll.id}" -#: index.docbook:278 +#. Tag: entry +#: query_sql.xml:278 +#, no-c-format msgid "The element of an collection" msgstr "コレクションの要素" -#: index.docbook:280 +#. Tag: literal +#: query_sql.xml:280 +#, no-c-format msgid "{[aliasname].element}" msgstr "{[aliasname].element}" -#: index.docbook:282 +#. Tag: literal +#: query_sql.xml:282 +#, no-c-format msgid "XID as {coll.element}" msgstr "XID as {coll.element}" -#: index.docbook:286 +#. Tag: entry +#: query_sql.xml:286 +#, no-c-format msgid "roperty of the element in the collection" msgstr "コレクションの要素のプロパティ" -#: index.docbook:288 +#. Tag: literal +#: query_sql.xml:288 +#, no-c-format msgid "{[aliasname].element.[propertyname]}" msgstr "{[aliasname].element.[propertyname]}" -#: index.docbook:290 +#. Tag: literal +#: query_sql.xml:290 +#, no-c-format msgid "NAME as {coll.element.name}" msgstr "NAME as {coll.element.name}" -#: index.docbook:294 +#. Tag: entry +#: query_sql.xml:294 +#, no-c-format msgid "All properties of the element in the collection" msgstr "コレクションの要素の全プロパティ" -#: index.docbook:296 +#. Tag: literal +#: query_sql.xml:296 +#, no-c-format msgid "{[aliasname].element.*}" msgstr "{[aliasname].element.*}" -#: index.docbook:298 +#. Tag: literal +#: query_sql.xml:298 +#, no-c-format msgid "{coll.element.*}" msgstr "{coll.element.*}" -#: index.docbook:302 +#. Tag: entry +#: query_sql.xml:302 +#, no-c-format msgid "All properties of the the collection" msgstr "コレクションの全プロパティ" -#: index.docbook:306 +#. Tag: literal +#: query_sql.xml:306 +#, no-c-format msgid "{coll.*}" msgstr "{coll.*}" -#: index.docbook:315 +#. Tag: title +#: query_sql.xml:315 +#, no-c-format msgid "Returning non-managed entities" msgstr "管理されていないエンティティの取得" -#: index.docbook:317 -msgid "It is possible to apply a ResultTransformer to native sql queries. Allowing it to e.g. return non-managed entities." -msgstr "ネイティブSQLクエリに ResultTransformer を適用できます。 下記のように、例えば、管理されていないエンティティを返します。" +#. Tag: para +#: query_sql.xml:317 +#, no-c-format +msgid "" +"It is possible to apply a ResultTransformer to native sql queries. Allowing " +"it to e.g. return non-managed entities." +msgstr "" +"ネイティブSQLクエリに ResultTransformer を適用できます。 下記のように、例え" +"ば、管理されていないエンティティを返します。" -#: index.docbook:319 +#. Tag: programlisting +#: query_sql.xml:319 +#, no-c-format msgid "" - "<![CDATA[sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" - " .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]>" +"<![CDATA[sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" +" .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]>" msgstr "" - "<![CDATA[sess.createSQLQuery(\"SELECT NAME, BIRTHDATE FROM CATS\")\n" - " .setResultTransformer(Transformers.aliasToBean(CatDTO.class))]]>" -#: index.docbook:329 +#. Tag: para +#: query_sql.xml:329 +#, no-c-format msgid "a result transformer" msgstr "結果を変換したもの" -#: index.docbook:333 -msgid "The above query will return a list of <literal>CatDTO</literal> which has been instantiated and injected the values of NAME and BIRTHNAME into its corresponding properties or fields." -msgstr "上記のクエリは、インスタンス化し、NAME と BIRTHDATE の値を 対応するプロパティもしくはフィールドに挿入した <literal>CatDTO</literal> のリストを返します。" +#. Tag: para +#: query_sql.xml:333 +#, no-c-format +msgid "" +"The above query will return a list of <literal>CatDTO</literal> which has " +"been instantiated and injected the values of NAME and BIRTHNAME into its " +"corresponding properties or fields." +msgstr "" +"上記のクエリは、インスタンス化し、NAME と BIRTHDATE の値を 対応するプロパティ" +"もしくはフィールドに挿入した <literal>CatDTO</literal> のリストを返します。" -#: index.docbook:340 +#. Tag: title +#: query_sql.xml:340 +#, no-c-format msgid "Handling inheritance" msgstr "継承の制御" -#: index.docbook:342 -msgid "Native sql queries which query for entities that is mapped as part of an inheritance must include all properties for the baseclass and all it subclasses." -msgstr "継承の一部としてマッピングされたエンティティを問い合わせるネイティブSQLクエリは、 ベースのクラスとそのすべてのサブクラスのプロパティすべてを含まなければなりません。" +#. Tag: para +#: query_sql.xml:342 +#, no-c-format +msgid "" +"Native sql queries which query for entities that is mapped as part of an " +"inheritance must include all properties for the baseclass and all it " +"subclasses." +msgstr "" +"継承の一部としてマッピングされたエンティティを問い合わせるネイティブSQLクエリ" +"は、 ベースのクラスとそのすべてのサブクラスのプロパティすべてを含まなければな" +"りません。" -#: index.docbook:348 +#. Tag: title +#: query_sql.xml:348 +#, no-c-format msgid "Parameters" msgstr "パラメータ" -#: index.docbook:350 +#. Tag: para +#: query_sql.xml:350 +#, no-c-format msgid "Native sql queries support positional as well as named parameters:" -msgstr "ネイティブSQLクエリは、以下のように、 名前付きパラメータ（:name）と同様に位置パラメータをサポートします。" +msgstr "" +"ネイティブSQLクエリは、以下のように、 名前付きパラメータ（:name）と同様に位置" +"パラメータをサポートします。" -#: index.docbook:353 +#. Tag: programlisting +#: query_sql.xml:353 +#, no-c-format msgid "" - "<![CDATA[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(); ]]>" +"<![CDATA[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 "" - "<![CDATA[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(); ]]>" -#: index.docbook:361 +#. Tag: title +#: query_sql.xml:361 +#, no-c-format msgid "Named SQL queries" msgstr "名前付きSQLクエリ" -#: index.docbook:363 -msgid "Named SQL queries may be defined in the mapping document and called in exactly the same way as a named HQL query. In this case, we do <emphasis>not</emphasis> need to call <literal>addEntity()</literal>." -msgstr "名前付きSQLクエリはマッピングドキュメントで定義することができ、 名前付きHQLクエリと全く同じ方法で呼ぶことができます。 この場合、<literal>addEntity()</literal> を呼び出す必要は <emphasis>ない</emphasis> です。" +#. Tag: para +#: query_sql.xml:363 +#, no-c-format +msgid "" +"Named SQL queries may be defined in the mapping document and called in " +"exactly the same way as a named HQL query. In this case, we do " +"<emphasis>not</emphasis> need to call <literal>addEntity()</literal>." +msgstr "" +"名前付きSQLクエリはマッピングドキュメントで定義することができ、 名前付きHQLク" +"エリと全く同じ方法で呼ぶことができます。 この場合、<literal>addEntity()</" +"literal> を呼び出す必要は <emphasis>ない</emphasis> です。" -#: index.docbook:368 +#. Tag: programlisting +#: query_sql.xml:368 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:370 +#. Tag: programlisting +#: query_sql.xml:370 +#, no-c-format msgid "" - "<![CDATA[List people = sess.getNamedQuery(\"persons\")\n" - " .setString(\"namePattern\", namePattern)\n" - " .setMaxResults(50)\n" - " .list();]]>" +"<![CDATA[List people = sess.getNamedQuery(\"persons\")\n" +" .setString(\"namePattern\", namePattern)\n" +" .setMaxResults(50)\n" +" .list();]]>" msgstr "" - "<![CDATA[List people = sess.getNamedQuery(\"persons\")\n" - " .setString(\"namePattern\", namePattern)\n" - " .setMaxResults(50)\n" - " .list();]]>" -#: index.docbook:372 -msgid "The <literal>&lt;return-join&gt;</literal> and <literal>&lt;load-collection&gt;</literal> elements are used to join associations and define queries which initialize collections, respectively." -msgstr "関連を結合するためとコレクションを初期化するクエリを定義するために、それぞれ <literal>&lt;return-join&gt;</literal> と <literal>&lt;load-collection&gt;</literal> 要素を使います。" +#. Tag: para +#: query_sql.xml:372 +#, no-c-format +msgid "" +"The <literal>&lt;return-join&gt;</literal> and <literal>&lt;load-" +"collection&gt;</literal> elements are used to join associations and define " +"queries which initialize collections, respectively." +msgstr "" +"関連を結合するためとコレクションを初期化するクエリを定義するために、それぞれ " +"<literal>&lt;return-join&gt;</literal> と <literal>&lt;load-collection&gt;</" +"literal> 要素を使います。" -#: index.docbook:377 +#. Tag: programlisting +#: query_sql.xml:377 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:379 -msgid "A named SQL query may return a scalar value. You must declare the column alias and Hibernate type using the <literal>&lt;return-scalar&gt;</literal> element:" -msgstr "名前付きSQLクエリはスカラ値を返すこともできます。 <literal>&lt;return-scalar&gt;</literal> 要素を使って、 列の別名とHibernateの型を宣言しなければなりません。" +#. Tag: para +#: query_sql.xml:379 +#, 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>&lt;return-scalar&gt;</literal> " +"element:" +msgstr "" +"名前付きSQLクエリはスカラ値を返すこともできます。 <literal>&lt;return-" +"scalar&gt;</literal> 要素を使って、 列の別名とHibernateの型を宣言しなければな" +"りません。" -#: index.docbook:383 +#. Tag: programlisting +#: query_sql.xml:383 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:385 -msgid "You can externalize the resultset mapping informations in a <literal>&lt;resultset&gt;</literal> element to either reuse them accross several named queries or through the <literal>setResultSetMapping()</literal> API." -msgstr "リザルトセットのマッピング情報を <literal>&lt;resultset&gt;</literal> に外出しすることができます。 複数の名前付きクエリで再利用したり、<literal>setResultSetMapping()</literal> APIを通して再利用したりできます。" +#. Tag: para +#: query_sql.xml:385 +#, no-c-format +msgid "" +"You can externalize the resultset mapping informations in a <literal>&lt;" +"resultset&gt;</literal> element to either reuse them accross several named " +"queries or through the <literal>setResultSetMapping()</literal> API." +msgstr "" +"リザルトセットのマッピング情報を <literal>&lt;resultset&gt;</literal> に外出" +"しすることができます。 複数の名前付きクエリで再利用したり、" +"<literal>setResultSetMapping()</literal> APIを通して再利用したりできます。" -#: index.docbook:390 +#. Tag: programlisting +#: query_sql.xml:390 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:392 -msgid "You can alternatively use the resultset mapping information in your hbm files directly in java code." -msgstr "代わりに、hbmファイル内のリザルトセットのマッピング情報を 直接Javaコードの中で使用できます。" +#. Tag: para +#: query_sql.xml:392 +#, no-c-format +msgid "" +"You can alternatively use the resultset mapping information in your hbm " +"files directly in java code." +msgstr "" +"代わりに、hbmファイル内のリザルトセットのマッピング情報を 直接Javaコードの中" +"で使用できます。" -#: index.docbook:395 +#. Tag: programlisting +#: query_sql.xml:395 +#, no-c-format msgid "" - "<![CDATA[List cats = sess.createSQLQuery(\n" - " \"select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id\"\n" - " )\n" - " .setResultSetMapping(\"catAndKitten\")\n" - " .list();]]>" +"<![CDATA[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 "" - "<![CDATA[List cats = sess.createSQLQuery(\n" - " \"select {cat.*}, {kitten.*} from cats cat, cats kitten where kitten.mother = cat.id\"\n" - " )\n" - " .setResultSetMapping(\"catAndKitten\")\n" - " .list();]]>" -#: index.docbook:398 +#. Tag: title +#: query_sql.xml:398 +#, no-c-format msgid "Using return-property to explicitly specify column/alias names" msgstr "列と列の別名を明示的に指定するために return-property を使う" -#: index.docbook:401 -msgid "With <literal>&lt;return-property&gt;</literal> you can explicitly tell Hibernate what column aliases to use, instead of using the <literal>{}</literal>-syntax to let Hibernate inject its own aliases." -msgstr "別名を挿入するために <literal>{}</literal> 構文を使う代わりに、 <literal>&lt;return-property&gt;</literal> を使い、 どの列の別名を使うのかを明示できます。" +#. Tag: para +#: query_sql.xml:401 +#, no-c-format +msgid "" +"With <literal>&lt;return-property&gt;</literal> you can explicitly tell " +"Hibernate what column aliases to use, instead of using the <literal>{}</" +"literal>-syntax to let Hibernate inject its own aliases." +msgstr "" +"別名を挿入するために <literal>{}</literal> 構文を使う代わりに、 <literal>&lt;" +"return-property&gt;</literal> を使い、 どの列の別名を使うのかを明示できます。" -#: index.docbook:406 +#. Tag: programlisting +#: query_sql.xml:406 +#, no-c-format msgid "" - "<![CDATA[<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>\n" - "]]>" +"<![CDATA[<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>\n" +"]]>" msgstr "" - "<![CDATA[<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>\n" - "]]>" -#: index.docbook:408 -msgid "<literal>&lt;return-property&gt;</literal> also works with multiple columns. This solves a limitation with the <literal>{}</literal>-syntax which can not allow fine grained control of multi-column properties." -msgstr "<literal>&lt;return-property&gt;</literal> は複数の列も扱えます。 これは、複数列のプロパティをきめ細かく制御できないという、 <literal>{}</literal> 構文の制限を解決します。" +#. Tag: para +#: query_sql.xml:408 +#, no-c-format +msgid "" +"<literal>&lt;return-property&gt;</literal> also works with multiple columns. " +"This solves a limitation with the <literal>{}</literal>-syntax which can not " +"allow fine grained control of multi-column properties." +msgstr "" +"<literal>&lt;return-property&gt;</literal> は複数の列も扱えます。 これは、複" +"数列のプロパティをきめ細かく制御できないという、 <literal>{}</literal> 構文の" +"制限を解決します。" -#: index.docbook:413 +#. Tag: programlisting +#: query_sql.xml:413 +#, no-c-format msgid "" - "<![CDATA[<sql-query name=\"organizationCurrentEmployments\">\n" - " <return alias=\"emp\" class=\"Employment\">\n" - " <return-property name=\"salary\">\n" - " <return-column name=\"VALUE\"/>\n" - " <return-column name=\"CURRENCY\"/>\n" - " </return-property>\n" - " <return-property name=\"endDate\" column=\"myEndDate\"/>\n" - " </return>\n" - " SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" - " STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" - " REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" - " FROM EMPLOYMENT\n" - " WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" - " ORDER BY STARTDATE ASC\n" - "</sql-query>]]>" +"<![CDATA[<sql-query name=\"organizationCurrentEmployments\">\n" +" <return alias=\"emp\" class=\"Employment\">\n" +" <return-property name=\"salary\">\n" +" <return-column name=\"VALUE\"/>\n" +" <return-column name=\"CURRENCY\"/>\n" +" </return-property>\n" +" <return-property name=\"endDate\" column=\"myEndDate\"/>\n" +" </return>\n" +" SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" +" STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" +" REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" +" FROM EMPLOYMENT\n" +" WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" +" ORDER BY STARTDATE ASC\n" +"</sql-query>]]>" msgstr "" - "<![CDATA[<sql-query name=\"organizationCurrentEmployments\">\n" - " <return alias=\"emp\" class=\"Employment\">\n" - " <return-property name=\"salary\">\n" - " <return-column name=\"VALUE\"/>\n" - " <return-column name=\"CURRENCY\"/>\n" - " </return-property>\n" - " <return-property name=\"endDate\" column=\"myEndDate\"/>\n" - " </return>\n" - " SELECT EMPLOYEE AS {emp.employee}, EMPLOYER AS {emp.employer},\n" - " STARTDATE AS {emp.startDate}, ENDDATE AS {emp.endDate},\n" - " REGIONCODE as {emp.regionCode}, EID AS {emp.id}, VALUE, CURRENCY\n" - " FROM EMPLOYMENT\n" - " WHERE EMPLOYER = :id AND ENDDATE IS NULL\n" - " ORDER BY STARTDATE ASC\n" - "</sql-query>]]>" -#: index.docbook:415 -msgid "Notice that in this example we used <literal>&lt;return-property&gt;</literal> in combination with the <literal>{}</literal>-syntax for injection. Allowing users to choose how they want to refer column and properties." -msgstr "この例では、挿入のための <literal>{}</literal> 構文といっしょに、 <literal>&lt;return-property&gt;</literal> を使っていることに注意してください。 列とプロパティをどのように参照するかを選べます。" +#. Tag: para +#: query_sql.xml:415 +#, no-c-format +msgid "" +"Notice that in this example we used <literal>&lt;return-property&gt;</" +"literal> in combination with the <literal>{}</literal>-syntax for injection. " +"Allowing users to choose how they want to refer column and properties." +msgstr "" +"この例では、挿入のための <literal>{}</literal> 構文といっしょに、 " +"<literal>&lt;return-property&gt;</literal> を使っていることに注意してくださ" +"い。 列とプロパティをどのように参照するかを選べます。" -#: index.docbook:420 -msgid "If your mapping has a discriminator you must use <literal>&lt;return-discriminator&gt;</literal> to specify the discriminator column." -msgstr "マッピングに discriminator が含まれている場合、 discriminator の列を指定するために、&lt;return-discriminator&gt; を使わなければなりません。" +#. Tag: para +#: query_sql.xml:420 +#, no-c-format +msgid "" +"If your mapping has a discriminator you must use <literal>&lt;return-" +"discriminator&gt;</literal> to specify the discriminator column." +msgstr "" +"マッピングに discriminator が含まれている場合、 discriminator の列を指定する" +"ために、&lt;return-discriminator&gt; を使わなければなりません。" -#: index.docbook:426 +#. Tag: title +#: query_sql.xml:426 +#, no-c-format msgid "Using stored procedures for querying" msgstr "問い合わせするためにストアドプロシージャを使う" -#: index.docbook:428 -msgid "Hibernate 3 introduces 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から、ストアドプロシージャとストアド関数経由の問い合わせが サポートされました。 以降の文書の多くは、両方に当てはまります。 ストアドプロシージャやストアド関数をHibernateで使うためには、 1番目の出力パラメータとしてリザルトセットを返さなければなりません。 Oracle 9（もしくはそれ以上のバージョン）のストアドプロシージャの例を以下に示します。" +#. Tag: para +#: query_sql.xml:428 +#, no-c-format +msgid "" +"Hibernate 3 introduces 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から、ストアドプロシージャとストアド関数経由の問い合わ" +"せが サポートされました。 以降の文書の多くは、両方に当てはまります。 ストアド" +"プロシージャやストアド関数をHibernateで使うためには、 1番目の出力パラメータと" +"してリザルトセットを返さなければなりません。 Oracle 9（もしくはそれ以上のバー" +"ジョン）のストアドプロシージャの例を以下に示します。" -#: index.docbook:434 +#. Tag: programlisting +#: query_sql.xml:434 +#, no-c-format msgid "" - "<![CDATA[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;]]>" +"<![CDATA[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 "" - "<![CDATA[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;]]>" -#: index.docbook:436 +#. Tag: para +#: query_sql.xml:436 +#, no-c-format msgid "To use this query in Hibernate you need to map it via a named query." -msgstr "Hibernateでこのクエリを使うためには、 名前付きクエリでマッピングする必要があります。" +msgstr "" +"Hibernateでこのクエリを使うためには、 名前付きクエリでマッピングする必要があ" +"ります。" -#: index.docbook:439 +#. Tag: programlisting +#: query_sql.xml:439 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:441 -msgid "Notice stored procedures currently only return scalars and entities. <literal>&lt;return-join&gt;</literal> and <literal>&lt;load-collection&gt;</literal> are not supported." -msgstr "注意：今のところ、ストアドプロシージャはスカラとエンティティを返すのみです。 <literal>&lt;return-join&gt;</literal> と <literal>&lt;load-collection&gt;</literal> はサポートされていません。" +#. Tag: para +#: query_sql.xml:441 +#, no-c-format +msgid "" +"Notice stored procedures currently only return scalars and entities. " +"<literal>&lt;return-join&gt;</literal> and <literal>&lt;load-collection&gt;</" +"literal> are not supported." +msgstr "" +"注意：今のところ、ストアドプロシージャはスカラとエンティティを返すのみです。 " +"<literal>&lt;return-join&gt;</literal> と <literal>&lt;load-collection&gt;</" +"literal> はサポートされていません。" -#: index.docbook:446 +#. Tag: title +#: query_sql.xml:446 +#, no-c-format msgid "Rules/limitations for using stored procedures" msgstr "ストアドプロシージャを使う上でのルールと制限" -#: index.docbook:448 -msgid "To use stored procedures with Hibernate the procedures/functions have to follow some 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()</literal>. The rules are different for each database, since database vendors have different stored procedure semantics/syntax." -msgstr "Hibernateでストアドプロシージャや関数を使うためには、 そのプロシージャはいくつかのルールに準拠する必要があります。 ルールに準拠していないプロシージャは、Hibernateで使うことはできません。 それでも、準拠していないプロシージャを使いたいのであれば、 <literal>session.connection()</literal> を通じて実行しなければなりません。 ルールはデータベースごとに異なります。 ストアドプロシージャのセマンティックスとシンタックスは、 データベースベンダごとに異なるためです。" +#. Tag: para +#: query_sql.xml:448 +#, no-c-format +msgid "" +"To use stored procedures with Hibernate the procedures/functions have to " +"follow some 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()</literal>. The rules are " +"different for each database, since database vendors have different stored " +"procedure semantics/syntax." +msgstr "" +"Hibernateでストアドプロシージャや関数を使うためには、 そのプロシージャはいく" +"つかのルールに準拠する必要があります。 ルールに準拠していないプロシージャは、" +"Hibernateで使うことはできません。 それでも、準拠していないプロシージャを使い" +"たいのであれば、 <literal>session.connection()</literal> を通じて実行しなけれ" +"ばなりません。 ルールはデータベースごとに異なります。 ストアドプロシージャの" +"セマンティックスとシンタックスは、 データベースベンダごとに異なるためです。" -#: index.docbook:455 -msgid "Stored procedure queries can't be paged with <literal>setFirstResult()/setMaxResults()</literal>." -msgstr "<literal>setFirstResult()/setMaxResults()</literal> を使って、 ストアドプロシージャクエリをページ分けすることはできません。" +#. Tag: para +#: query_sql.xml:455 +#, no-c-format +msgid "" +"Stored procedure queries can't be paged with <literal>setFirstResult()/" +"setMaxResults()</literal>." +msgstr "" +"<literal>setFirstResult()/setMaxResults()</literal> を使って、 ストアドプロ" +"シージャクエリをページ分けすることはできません。" -#: index.docbook:458 -msgid "Recommended call form is standard SQL92: <literal>{ ? = call functionName(&lt;parameters&gt;) }</literal> or <literal>{ ? = call procedureName(&lt;parameters&gt;}</literal>. Native call syntax is not supported." -msgstr "推奨する呼び出し方は、標準であるSQL92に従うことです。 <literal>{ ? = call functionName(&lt;parameters&gt;) }</literal> や <literal>{ ? = call procedureName(&lt;parameters&gt;) }</literal> です。 ネイティブな呼び出し構文はサポートされていません。" +#. Tag: para +#: query_sql.xml:458 +#, no-c-format +msgid "" +"Recommended call form is standard SQL92: <literal>{ ? = call functionName" +"(&lt;parameters&gt;) }</literal> or <literal>{ ? = call procedureName(&lt;" +"parameters&gt;}</literal>. Native call syntax is not supported." +msgstr "" +"推奨する呼び出し方は、標準であるSQL92に従うことです。 <literal>{ ? = call " +"functionName(&lt;parameters&gt;) }</literal> や <literal>{ ? = call " +"procedureName(&lt;parameters&gt;) }</literal> です。 ネイティブな呼び出し構文" +"はサポートされていません。" -#: index.docbook:463 +#. Tag: para +#: query_sql.xml:463 +#, no-c-format msgid "For Oracle the following rules apply:" msgstr "Oracleには下記のルールが適用されます。" -#: index.docbook:467 -msgid "A function must return a result set. The first parameter of a procedure must be an <literal>OUT</literal> that returns a result set. This is done by using a <literal>SYS_REFCURSOR</literal> type in Oracle 9 or 10. In Oracle you need to define a <literal>REF CURSOR</literal> type, see Oracle literature." -msgstr "関数はリザルトセットを返さなければなりません。 プロシージャの第一引数はリザルトセットを返すため、 <literal>OUT</literal> でなければなりません。 Oracle 9と10では、<literal>SYS_REFCURSOR</literal> を使うことによってできます。 Oracleでは <literal>REF CURSOR</literal> 型を定義する必要があります。 Oracleの文献を参照してください。" +#. Tag: para +#: query_sql.xml:467 +#, no-c-format +msgid "" +"A function must return a result set. The first parameter of a procedure must " +"be an <literal>OUT</literal> that returns a result set. This is done by " +"using a <literal>SYS_REFCURSOR</literal> type in Oracle 9 or 10. In Oracle " +"you need to define a <literal>REF CURSOR</literal> type, see Oracle " +"literature." +msgstr "" +"関数はリザルトセットを返さなければなりません。 プロシージャの第一引数はリザル" +"トセットを返すため、 <literal>OUT</literal> でなければなりません。 Oracle 9と" +"10では、<literal>SYS_REFCURSOR</literal> を使うことによってできます。 Oracle" +"では <literal>REF CURSOR</literal> 型を定義する必要があります。 Oracleの文献" +"を参照してください。" -#: index.docbook:476 +#. Tag: para +#: query_sql.xml:476 +#, no-c-format msgid "For Sybase or MS SQL server the following rules apply:" msgstr "SybaseとMS SQLサーバーに適用されるルールを下記に示します。" -#: index.docbook:480 -msgid "The procedure must return a result set. Note that since these servers can/will 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 "プロシージャはリザルトセットを返さなければなりません。 サーバーは複数のリザルトセットと更新カウントを返しますが、 Hibernateは1つ目のリザルトセットだけを返すことに注意してください。 その他はすべて捨てられます。" +#. Tag: para +#: query_sql.xml:480 +#, no-c-format +msgid "" +"The procedure must return a result set. Note that since these servers can/" +"will 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 "" +"プロシージャはリザルトセットを返さなければなりません。 サーバーは複数のリザル" +"トセットと更新カウントを返しますが、 Hibernateは1つ目のリザルトセットだけを返" +"すことに注意してください。 その他はすべて捨てられます。" -#: index.docbook:488 -msgid "If you can enable <literal>SET NOCOUNT ON</literal> in your procedure it will probably be more efficient, but this is not a requirement." -msgstr "プロシージャの中で <literal>SET NOCOUNT ON</literal> を有効にできれば、 おそらく効率がよくなるでしょう。 しかし、これは必要条件ではありません。" +#. Tag: para +#: query_sql.xml:488 +#, no-c-format +msgid "" +"If you can enable <literal>SET NOCOUNT ON</literal> in your procedure it " +"will probably be more efficient, but this is not a requirement." +msgstr "" +"プロシージャの中で <literal>SET NOCOUNT ON</literal> を有効にできれば、 おそ" +"らく効率がよくなるでしょう。 しかし、これは必要条件ではありません。" -#: index.docbook:498 +#. Tag: title +#: query_sql.xml:498 +#, no-c-format msgid "Custom SQL for create, update and delete" msgstr "作成、更新、削除のためのカスタムSQL" -#: index.docbook:500 -msgid "Hibernate3 can use custom SQL statements for create, update, and delete operations. The class and collection persisters in Hibernate already contain a set of configuration time generated strings (insertsql, deletesql, updatesql etc.). The mapping tags <literal>&lt;sql-insert&gt;</literal>, <literal>&lt;sql-delete&gt;</literal>, and <literal>&lt;sql-update&gt;</literal> override these strings:" -msgstr "Hibernate3は作成、更新、削除処理のためのカスタムSQL文を使用できます。 クラスとコレクションの永続化機構は、コンフィグレーション時に生成された文字列 （insertsql、deletesql、updatesqlなど）のセットをすでに保持しています。 これらの文字列より、 <literal>&lt;sql-insert&gt;</literal>、 <literal>&lt;sql-delete&gt;</literal>、 <literal>&lt;sql-update&gt;</literal> というマッピングタグが優先されます。" +#. Tag: para +#: query_sql.xml:500 +#, no-c-format +msgid "" +"Hibernate3 can use custom SQL statements for create, update, and delete " +"operations. The class and collection persisters in Hibernate already contain " +"a set of configuration time generated strings (insertsql, deletesql, " +"updatesql etc.). The mapping tags <literal>&lt;sql-insert&gt;</literal>, " +"<literal>&lt;sql-delete&gt;</literal>, and <literal>&lt;sql-update&gt;</" +"literal> override these strings:" +msgstr "" +"Hibernate3は作成、更新、削除処理のためのカスタムSQL文を使用できます。 クラス" +"とコレクションの永続化機構は、コンフィグレーション時に生成された文字列 " +"（insertsql、deletesql、updatesqlなど）のセットをすでに保持しています。 これ" +"らの文字列より、 <literal>&lt;sql-insert&gt;</literal>、 <literal>&lt;sql-" +"delete&gt;</literal>、 <literal>&lt;sql-update&gt;</literal> というマッピング" +"タグが優先されます。" -#: index.docbook:508 +#. Tag: programlisting +#: query_sql.xml:508 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-insert>\n" - " <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update>\n" - " <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\">\n" +" <generator class=\"increment\"/>\n" +" </id>\n" +" <property name=\"name\" not-null=\"true\"/>\n" +" <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-" +"insert>\n" +" <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update>\n" +" <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert>INSERT INTO PERSON (NAME, ID) VALUES ( UPPER(?), ? )</sql-insert>\n" - " <sql-update>UPDATE PERSON SET NAME=UPPER(?) WHERE ID=?</sql-update>\n" - " <sql-delete>DELETE FROM PERSON WHERE ID=?</sql-delete>\n" - "</class>]]>" -#: index.docbook:510 -msgid "The SQL is directly executed in your database, so you are free to use any dialect you like. This will of course reduce the portability of your mapping if you use database specific SQL." -msgstr "SQLを直接データベースで実行するため、好みの方言を自由に使用できます。 データベース独自のSQLを使えば、当然マッピングのポータビリティが下がります。" +#. Tag: para +#: query_sql.xml:510 +#, no-c-format +msgid "" +"The SQL is directly executed in your database, so you are free to use any " +"dialect you like. This will of course reduce the portability of your mapping " +"if you use database specific SQL." +msgstr "" +"SQLを直接データベースで実行するため、好みの方言を自由に使用できます。 データ" +"ベース独自のSQLを使えば、当然マッピングのポータビリティが下がります。" -#: index.docbook:514 -msgid "Stored procedures are supported if the <literal>callable</literal> attribute is set:" -msgstr "<literal>callable</literal> 属性をセットすれば、 ストアドプロシージャを使用できます。" +#. Tag: para +#: query_sql.xml:514 +#, no-c-format +msgid "" +"Stored procedures are supported if the <literal>callable</literal> attribute " +"is set:" +msgstr "" +"<literal>callable</literal> 属性をセットすれば、 ストアドプロシージャを使用で" +"きます。" -#: index.docbook:517 +#. Tag: programlisting +#: query_sql.xml:517 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert callable=\"true\">{call createPerson (?, ?)}</sql-insert>\n" - " <sql-delete callable=\"true\">{? = call deletePerson (?)}</sql-delete>\n" - " <sql-update callable=\"true\">{? = call updatePerson (?, ?)}</sql-update>\n" - "</class>]]>" +"<![CDATA[<class name=\"Person\">\n" +" <id name=\"id\">\n" +" <generator class=\"increment\"/>\n" +" </id>\n" +" <property name=\"name\" not-null=\"true\"/>\n" +" <sql-insert callable=\"true\">{call createPerson (?, ?)}</sql-insert>\n" +" <sql-delete callable=\"true\">{? = call deletePerson (?)}</sql-delete>\n" +" <sql-update callable=\"true\">{? = call updatePerson (?, ?)}</sql-" +"update>\n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Person\">\n" - " <id name=\"id\">\n" - " <generator class=\"increment\"/>\n" - " </id>\n" - " <property name=\"name\" not-null=\"true\"/>\n" - " <sql-insert callable=\"true\">{call createPerson (?, ?)}</sql-insert>\n" - " <sql-delete callable=\"true\">{? = call deletePerson (?)}</sql-delete>\n" - " <sql-update callable=\"true\">{? = call updatePerson (?, ?)}</sql-update>\n" - "</class>]]>" -#: index.docbook:519 -msgid "The order of the positional parameters are currently vital, as they must be in the same sequence as Hibernate expects them." -msgstr "今のところ、位置パラメータの順番はとても重要です。 すなわち、Hibernateが期待する順序でなければなりません。" +#. Tag: para +#: query_sql.xml:519 +#, no-c-format +msgid "" +"The order of the positional parameters are currently vital, as they must be " +"in the same sequence as Hibernate expects them." +msgstr "" +"今のところ、位置パラメータの順番はとても重要です。 すなわち、Hibernateが期待" +"する順序でなければなりません。" -#: index.docbook:522 -msgid "You can see the expected order by enabling debug logging for the <literal>org.hibernate.persister.entity</literal> 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 in the mapping files as that will override the Hibernate generated static sql.)" -msgstr "<literal>org.hiberante.persister.entity</literal> レベルのデバッグログを 有効にすることによって、期待される順番を確かめられます。 このレベルを有効にすることにより、エンティティの作成、更新、削除などで 使用される静的なSQLが出力されます。 （期待される順序を確認するためには、Hibernateが生成する静的なSQLをオーバーライドする カスタムSQLをマッピングファイルに含めないことを忘れないでください。）" +#. Tag: para +#: query_sql.xml:522 +#, no-c-format +msgid "" +"You can see the expected order by enabling debug logging for the " +"<literal>org.hibernate.persister.entity</literal> 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 in the mapping files as that will override the " +"Hibernate generated static sql.)" +msgstr "" +"<literal>org.hiberante.persister.entity</literal> レベルのデバッグログを 有効" +"にすることによって、期待される順番を確かめられます。 このレベルを有効にするこ" +"とにより、エンティティの作成、更新、削除などで 使用される静的なSQLが出力され" +"ます。 （期待される順序を確認するためには、Hibernateが生成する静的なSQLをオー" +"バーライドする カスタムSQLをマッピングファイルに含めないことを忘れないでくだ" +"さい。）" -#: index.docbook:529 -msgid "The stored procedures are in most cases (read: better do it than not) required to return the number of rows inserted/updated/deleted, as Hibernate has some runtime checks for the success of the statement. Hibernate always registers the first statement parameter as a numeric output parameter for the CUD operations:" -msgstr "ストアドプロシージャは挿入/更新/削除された行数を返す必要があります （読み込みの場合は、返さないよりは返す方がよいです）。 実行時にHibernateがSQL文の成功をチェックするからです。 Hibernateは、CUD処理のための数値の出力パラメータとして、 SQL文の最初のパラメータをいつも記録します。" +#. Tag: para +#: query_sql.xml:529 +#, no-c-format +msgid "" +"The stored procedures are in most cases (read: better do it than not) " +"required to return the number of rows inserted/updated/deleted, as Hibernate " +"has some runtime checks for the success of the statement. Hibernate always " +"registers the first statement parameter as a numeric output parameter for " +"the CUD operations:" +msgstr "" +"ストアドプロシージャは挿入/更新/削除された行数を返す必要があります （読み込み" +"の場合は、返さないよりは返す方がよいです）。 実行時にHibernateがSQL文の成功を" +"チェックするからです。 Hibernateは、CUD処理のための数値の出力パラメータとし" +"て、 SQL文の最初のパラメータをいつも記録します。" -#: index.docbook:535 +#. Tag: programlisting +#: query_sql.xml:535 +#, no-c-format msgid "" - "<![CDATA[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;]]>" +"<![CDATA[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 "" - "<![CDATA[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;]]>" -#: index.docbook:539 +#. Tag: title +#: query_sql.xml:539 +#, no-c-format msgid "Custom SQL for loading" msgstr "ロードのためのカスタムSQL" -#: index.docbook:541 +#. Tag: para +#: query_sql.xml:541 +#, no-c-format msgid "You may also declare your own SQL (or HQL) queries for entity loading:" -msgstr "エンティティを読み込むための独自のSQL（もしくはHQL）クエリも宣言できます。" +msgstr "" +"エンティティを読み込むための独自のSQL（もしくはHQL）クエリも宣言できます。" -#: index.docbook:544 +#. Tag: programlisting +#: query_sql.xml:544 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:546 -msgid "This is just a named query declaration, as discussed earlier. You may reference this named query in a class mapping:" -msgstr "これは、まさに（以前議論した）名前付きクエリの宣言です。 この名前付きクエリをクラスのマッピングから参照できます。" +#. Tag: para +#: query_sql.xml:546 +#, no-c-format +msgid "" +"This is just a named query declaration, as discussed earlier. You may " +"reference this named query in a class mapping:" +msgstr "" +"これは、まさに（以前議論した）名前付きクエリの宣言です。 この名前付きクエリを" +"クラスのマッピングから参照できます。" -#: index.docbook:549 +#. Tag: programlisting +#: query_sql.xml:549 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:551 +#. Tag: para +#: query_sql.xml:551 +#, no-c-format msgid "This even works with stored procedures." msgstr "これはストアドプロシージャでさえも動作します。" -#: index.docbook:553 +#. Tag: para +#: query_sql.xml:553 +#, no-c-format msgid "You may even define a query for collection loading:" msgstr "次のように、コレクションをロードするためのクエリさえ定義してよいです。" -#: index.docbook:555 +#. Tag: programlisting +#: query_sql.xml:555 +#, no-c-format msgid "" - "<![CDATA[<set name=\"employments\" inverse=\"true\">\n" - " <key/>\n" - " <one-to-many class=\"Employment\"/>\n" - " <loader query-ref=\"employments\"/>\n" - "</set>]]>" +"<![CDATA[<set name=\"employments\" inverse=\"true\">\n" +" <key/>\n" +" <one-to-many class=\"Employment\"/>\n" +" <loader query-ref=\"employments\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"employments\" inverse=\"true\">\n" - " <key/>\n" - " <one-to-many class=\"Employment\"/>\n" - " <loader query-ref=\"employments\"/>\n" - "</set>]]>" -#: index.docbook:557 +#. Tag: programlisting +#: query_sql.xml:557 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" -#: index.docbook:559 -msgid "You could even define an entity loader that loads a collection by join fetching:" -msgstr "次のように、結合フェッチによりコレクションをロードする エンティティローダーを定義できます。" +#. Tag: para +#: query_sql.xml:559 +#, no-c-format +msgid "" +"You could even define an entity loader that loads a collection by join " +"fetching:" +msgstr "" +"次のように、結合フェッチによりコレクションをロードする エンティティローダーを" +"定義できます。" -#: index.docbook:562 +#. Tag: programlisting +#: query_sql.xml:562 +#, no-c-format msgid "" - "<![CDATA[<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>]]>" +"<![CDATA[<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 "" - "<![CDATA[<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>]]>" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - Modified: core/trunk/documentation/manual/translations/ja-JP/content/session_api.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/session_api.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/session_api.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,1426 +1,2218 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: session_api.xml:5 +#, no-c-format msgid "Working with objects" msgstr "オブジェクトを扱う" -#: index.docbook:7 -msgid "Hibernate is a full object/relational mapping solution that not only shields the developer from the details of the underlying database management system, but also offers <emphasis>state management</emphasis> of objects. This is, contrary to the management of SQL <literal>statements</literal> in common JDBC/SQL persistence layers, a very natural object-oriented view of persistence in Java applications." -msgstr "Hibernate は完全なオブジェクト/リレーショナルマッピングソリューションであり、 データベース管理システムの詳細を開発者から隠蔽するだけでなく、 オブジェクトの <emphasis>状態管理</emphasis> も行います。 これは、JDBC/SQL永続層と同じようなSQL <literal>文</literal> の管理とは異なり、 Javaアプリケーションにおける永続化に対する、とても自然なオブジェクト指向の考え方を提供します。" +#. Tag: para +#: session_api.xml:7 +#, no-c-format +msgid "" +"Hibernate is a full object/relational mapping solution that not only shields " +"the developer from the details of the underlying database management system, " +"but also offers <emphasis>state management</emphasis> of objects. This is, " +"contrary to the management of SQL <literal>statements</literal> in common " +"JDBC/SQL persistence layers, a very natural object-oriented view of " +"persistence in Java applications." +msgstr "" +"Hibernate は完全なオブジェクト/リレーショナルマッピングソリューションであ" +"り、 データベース管理システムの詳細を開発者から隠蔽するだけでなく、 オブジェ" +"クトの <emphasis>状態管理</emphasis> も行います。 これは、JDBC/SQL永続層と同" +"じようなSQL <literal>文</literal> の管理とは異なり、 Javaアプリケーションにお" +"ける永続化に対する、とても自然なオブジェクト指向の考え方を提供します。" -#: index.docbook:16 -msgid "In other words, Hibernate application developers should always think about the <emphasis>state</emphasis> of their objects, and not necessarily about the execution of SQL statements. This part is taken care of by Hibernate and is only relevant for the application developer when tuning the performance of the system." -msgstr "言いかえれば、Hibernateを用いるアプリケーション開発者は、オブジェクトの <emphasis>状態</emphasis> については 常に意識すべきであり、SQL文の実行については必ずしもそうではありません。 この部分は、通常、Hibernateが処理し、システムのパフォーマンスをチューニングするときにだけ、 問題になってきます。" +#. Tag: para +#: session_api.xml:16 +#, no-c-format +msgid "" +"In other words, Hibernate application developers should always think about " +"the <emphasis>state</emphasis> of their objects, and not necessarily about " +"the execution of SQL statements. This part is taken care of by Hibernate and " +"is only relevant for the application developer when tuning the performance " +"of the system." +msgstr "" +"言いかえれば、Hibernateを用いるアプリケーション開発者は、オブジェクトの " +"<emphasis>状態</emphasis> については 常に意識すべきであり、SQL文の実行につい" +"ては必ずしもそうではありません。 この部分は、通常、Hibernateが処理し、システ" +"ムのパフォーマンスをチューニングするときにだけ、 問題になってきます。" -#: index.docbook:24 +#. Tag: title +#: session_api.xml:24 +#, no-c-format msgid "Hibernate object states" msgstr "Hibernateにおけるオブジェクトの状態" -#: index.docbook:26 +#. Tag: para +#: session_api.xml:26 +#, no-c-format msgid "Hibernate defines and supports the following object states:" msgstr "Hibernateは次のようなオブジェクトの状態を定義し、サポートしています。" -#: index.docbook:32 -msgid "<emphasis>Transient</emphasis> - an object is transient if it has just been instantiated using the <literal>new</literal> operator, and it is not associated with a Hibernate <literal>Session</literal>. It has no persistent representation in the database and no identifier value has been assigned. Transient instances will be destroyed by the garbage collector if the application doesn't hold a reference anymore. Use the Hibernate <literal>Session</literal> to make an object persistent (and let Hibernate take care of the SQL statements that need to be executed for this transition)." -msgstr "<emphasis> 一時的(Transient) </emphasis> - <literal>new</literal> 演算子を使って インスタンス化されただけで、 Hibernateの <literal>Session</literal> に関連付けられていないオブジェクトは、 一時的(transient)です。 それは、データベースに永続的な表現を持たず、識別子となる値は割り当てられていません。 一時的なインスタンスは、アプリケーションがその参照をどこにも保持しない場合に、 ガベージコレクタによって破棄されます。 オブジェクトを永続的(persistent)な状態にするためには、Hibernateの <literal>Session</literal> を使いましょう。 （この状態遷移に必要となるSQL文の発行は、Hibernateに任せましょう。）" +#. Tag: para +#: session_api.xml:32 +#, no-c-format +msgid "" +"<emphasis>Transient</emphasis> - an object is transient if it has just been " +"instantiated using the <literal>new</literal> operator, and it is not " +"associated with a Hibernate <literal>Session</literal>. It has no persistent " +"representation in the database and no identifier value has been assigned. " +"Transient instances will be destroyed by the garbage collector if the " +"application doesn't hold a reference anymore. Use the Hibernate " +"<literal>Session</literal> to make an object persistent (and let Hibernate " +"take care of the SQL statements that need to be executed for this " +"transition)." +msgstr "" +"<emphasis> 一時的(Transient) </emphasis> - <literal>new</literal> 演算子を" +"使って インスタンス化されただけで、 Hibernateの <literal>Session</literal> に" +"関連付けられていないオブジェクトは、 一時的(transient)です。 それは、データ" +"ベースに永続的な表現を持たず、識別子となる値は割り当てられていません。 一時的" +"なインスタンスは、アプリケーションがその参照をどこにも保持しない場合に、 ガ" +"ベージコレクタによって破棄されます。 オブジェクトを永続的(persistent)な状態に" +"するためには、Hibernateの <literal>Session</literal> を使いましょう。 （この" +"状態遷移に必要となるSQL文の発行は、Hibernateに任せましょう。）" -#: index.docbook:44 -msgid "<emphasis>Persistent</emphasis> - a persistent instance has a representation in the database and an identifier value. It might just have been saved or loaded, however, it is by definition in the scope of a <literal>Session</literal>. Hibernate will detect any changes made to an object in persistent state and synchronize the state with the database when the unit of work completes. Developers don't execute manual <literal>UPDATE</literal> statements, or <literal>DELETE</literal> statements when an object should be made transient." -msgstr "<emphasis>永続的(Persistent)</emphasis> - 永続的なインスタンスはデータベースに 永続的な表現を持ち、識別子となる値を持っています。 それは、セーブされたり、ロードされたりするかもしれませんが、 定義上は、 <literal>Session</literal> のスコープの中に存在しています。 Hibernateは、作業単位（Unit of work）が完了したときに、 永続状態のオブジェクトに加えられた変更を検出し、 オブジェクトの状態とデータベースを同期します。 オブジェクトを一時的(transient)にするときは、開発者は、手作業で <literal>UPDATE</literal> 文や <literal>DELETE</literal> 文を実行しません。" +#. Tag: para +#: session_api.xml:44 +#, no-c-format +msgid "" +"<emphasis>Persistent</emphasis> - a persistent instance has a representation " +"in the database and an identifier value. It might just have been saved or " +"loaded, however, it is by definition in the scope of a <literal>Session</" +"literal>. Hibernate will detect any changes made to an object in persistent " +"state and synchronize the state with the database when the unit of work " +"completes. Developers don't execute manual <literal>UPDATE</literal> " +"statements, or <literal>DELETE</literal> statements when an object should be " +"made transient." +msgstr "" +"<emphasis>永続的(Persistent)</emphasis> - 永続的なインスタンスはデータベース" +"に 永続的な表現を持ち、識別子となる値を持っています。 それは、セーブされた" +"り、ロードされたりするかもしれませんが、 定義上は、 <literal>Session</" +"literal> のスコープの中に存在しています。 Hibernateは、作業単位（Unit of " +"work）が完了したときに、 永続状態のオブジェクトに加えられた変更を検出し、 オ" +"ブジェクトの状態とデータベースを同期します。 オブジェクトを一時的(transient)" +"にするときは、開発者は、手作業で <literal>UPDATE</literal> 文や " +"<literal>DELETE</literal> 文を実行しません。" -#: index.docbook:55 -msgid "<emphasis>Detached</emphasis> - a detached instance is an object that has been persistent, but its <literal>Session</literal> has been closed. The reference to the object is still valid, of course, and the detached instance might even be modified in this state. A detached instance can be reattached to a new <literal>Session</literal> at a later point in time, making it (and all the modifications) persistent again. This feature enables a programming model for long running units of work that require user think-time. We call them <emphasis>application transactions</emphasis>, i.e. a unit of work from the point of view of the user." -msgstr "<emphasis>分離(Detached)</emphasis> - 分離されたインスタンスとは、永続化されているが、 それと関連付いていた <literal>Session</literal> がクローズされているオブジェクトのことです。 そのオブジェクトへの参照は、依然として有効です。 そして、もちろん、分離された状態にあるオブジェクトは、修正することさえできます。 分離されたインスタンスは、もう一度永続化したい（そして、すべての変更を永続化したい）ときに、 新しい <literal>Session</literal> に再追加できます。 この機能は、ユーザが考える時間を必要とするような、長期間に及ぶ作業単位に対する プログラミングモデルを可能にします。 我々は、これを <emphasis>アプリケーションのトランザクション（application transactions）</emphasis> と呼んでいます。 すなわち、ユー! ザから見た作業単位だということです。" +#. Tag: para +#: session_api.xml:55 +#, no-c-format +msgid "" +"<emphasis>Detached</emphasis> - a detached instance is an object that has " +"been persistent, but its <literal>Session</literal> has been closed. The " +"reference to the object is still valid, of course, and the detached instance " +"might even be modified in this state. A detached instance can be reattached " +"to a new <literal>Session</literal> at a later point in time, making it (and " +"all the modifications) persistent again. This feature enables a programming " +"model for long running units of work that require user think-time. We call " +"them <emphasis>application transactions</emphasis>, i.e. a unit of work from " +"the point of view of the user." +msgstr "" +"<emphasis>分離(Detached)</emphasis> - 分離されたインスタンスとは、永続化され" +"ているが、 それと関連付いていた <literal>Session</literal> がクローズされてい" +"るオブジェクトのことです。 そのオブジェクトへの参照は、依然として有効です。 " +"そして、もちろん、分離された状態にあるオブジェクトは、修正することさえできま" +"す。 分離されたインスタンスは、もう一度永続化したい（そして、すべての変更を永" +"続化したい）ときに、 新しい <literal>Session</literal> に再追加できます。 こ" +"の機能は、ユーザが考える時間を必要とするような、長期間に及ぶ作業単位に対する " +"プログラミングモデルを可能にします。 我々は、これを <emphasis>アプリケーショ" +"ンのトランザクション（application transactions）</emphasis> と呼んでいます。 " +"すなわち、ユーザから見た作業単位だということです。" -#: index.docbook:69 -msgid "We'll now discuss the states and state transitions (and the Hibernate methods that trigger a transition) in more detail." -msgstr "これから、状態と状態遷移（そして、遷移のきっかけとなるHibernateのメソッド）について 、詳細に述べます。" +#. Tag: para +#: session_api.xml:69 +#, no-c-format +msgid "" +"We'll now discuss the states and state transitions (and the Hibernate " +"methods that trigger a transition) in more detail." +msgstr "" +"これから、状態と状態遷移（そして、遷移のきっかけとなるHibernateのメソッド）に" +"ついて 、詳細に述べます。" -#: index.docbook:77 +#. Tag: title +#: session_api.xml:77 +#, no-c-format msgid "Making objects persistent" msgstr "オブジェクトを永続状態にする" -#: index.docbook:79 -msgid "Newly instantiated instances of a a persistent class are considered <emphasis>transient</emphasis> by Hibernate. We can make a transient instance <emphasis>persistent</emphasis> by associating it with a session:" -msgstr "新しくインスタンス化された永続クラスのインスタンスは、 Hibernateでは <emphasis>一時的(transient)</emphasis> と見なされます。 以下のように、セッションと関連づけることで、一時的なインスタンスを <emphasis>永続状態(persistent)</emphasis> にできます。" +#. Tag: para +#: session_api.xml:79 +#, no-c-format +msgid "" +"Newly instantiated instances of a a persistent class are considered " +"<emphasis>transient</emphasis> by Hibernate. We can make a transient " +"instance <emphasis>persistent</emphasis> by associating it with a session:" +msgstr "" +"新しくインスタンス化された永続クラスのインスタンスは、 Hibernateでは " +"<emphasis>一時的(transient)</emphasis> と見なされます。 以下のように、セッ" +"ションと関連づけることで、一時的なインスタンスを <emphasis>永続状態" +"(persistent)</emphasis> にできます。" -#: index.docbook:86 +#. Tag: programlisting +#: session_api.xml:86 +#, no-c-format msgid "" - "<![CDATA[DomesticCat fritz = new DomesticCat();\n" - "fritz.setColor(Color.GINGER);\n" - "fritz.setSex('M');\n" - "fritz.setName(\"Fritz\");\n" - "Long generatedId = (Long) sess.save(fritz);]]>" +"<![CDATA[DomesticCat fritz = new DomesticCat();\n" +"fritz.setColor(Color.GINGER);\n" +"fritz.setSex('M');\n" +"fritz.setName(\"Fritz\");\n" +"Long generatedId = (Long) sess.save(fritz);]]>" msgstr "" - "<![CDATA[DomesticCat fritz = new DomesticCat(); -\n" - "fritz.setColor(Color.GINGER); -\n" - "fritz.setSex('M'); -\n" - "fritz.setName(\"Fritz\"); -\n" - "Long generatedId = (Long) sess.save(fritz);]]>" -#: index.docbook:88 -msgid "If <literal>Cat</literal> has a generated identifier, the identifier is generated and assigned to the <literal>cat</literal> when <literal>save()</literal> is called. If <literal>Cat</literal> has an <literal>assigned</literal> identifier, or a composite key, the identifier should be assigned to the <literal>cat</literal> instance before calling <literal>save()</literal>. You may also use <literal>persist()</literal> instead of <literal>save()</literal>, with the semantics defined in the EJB3 early draft." -msgstr "<literal>Cat</literal> クラスの識別子が自動生成されるのであれば、 <literal>save()</literal> が呼ばれるときに、 識別子が生成され、 <literal>cat</literal> インスタンスに割り当てられます。 <literal>Cat</literal> の識別子が他から割り当てられる（ <literal>assigned</literal> 識別子を持つ）か、複合キーであるなら、 <literal>save()</literal> を呼び出す前に、識別子を割り当てなければなりません。 <literal>save()</literal> の代わりに、EJB3 の初期ドラフトで定義された <literal>persist()</literal> を使うことも可能です。" +#. Tag: para +#: session_api.xml:88 +#, no-c-format +msgid "" +"If <literal>Cat</literal> has a generated identifier, the identifier is " +"generated and assigned to the <literal>cat</literal> when <literal>save()</" +"literal> is called. If <literal>Cat</literal> has an <literal>assigned</" +"literal> identifier, or a composite key, the identifier should be assigned " +"to the <literal>cat</literal> instance before calling <literal>save()</" +"literal>. You may also use <literal>persist()</literal> instead of " +"<literal>save()</literal>, with the semantics defined in the EJB3 early " +"draft." +msgstr "" +"<literal>Cat</literal> クラスの識別子が自動生成されるのであれば、 " +"<literal>save()</literal> が呼ばれるときに、 識別子が生成され、 " +"<literal>cat</literal> インスタンスに割り当てられます。 <literal>Cat</" +"literal> の識別子が他から割り当てられる（ <literal>assigned</literal> 識別子" +"を持つ）か、複合キーであるなら、 <literal>save()</literal> を呼び出す前に、識" +"別子を割り当てなければなりません。 <literal>save()</literal> の代わりに、" +"EJB3 の初期ドラフトで定義された <literal>persist()</literal> を使うことも可能" +"です。" -#: index.docbook:100 -msgid "<literal>persist()</literal> makes a transient instance persistent. However, it doesn't guarantee that the identifier value will be assigned to the persistent instance immediately, the assignment might happen at flush time. <literal>persist()</literal> also guarantees that it will not execute an <literal>INSERT</literal> statement if it is called outside of transaction boundaries. This is useful in long-running conversations with an extended Session/persistence context." -msgstr "代わりに、識別子を引数にとる <literal>save()</literal> メソッドを使って、 識別子を割り当てることもできます。" +#. Tag: para +#: session_api.xml:100 +#, no-c-format +msgid "" +"<literal>persist()</literal> makes a transient instance persistent. However, " +"it doesn't guarantee that the identifier value will be assigned to the " +"persistent instance immediately, the assignment might happen at flush time. " +"<literal>persist()</literal> also guarantees that it will not execute an " +"<literal>INSERT</literal> statement if it is called outside of transaction " +"boundaries. This is useful in long-running conversations with an extended " +"Session/persistence context." +msgstr "" +"<literal>persist()</literal> makes a transient instance persistent. However, " +"it doesn't guarantee that the identifier value will be assigned to the " +"persistent instance immediately, the assignment might happen at flush time. " +"<literal>persist()</literal> also guarantees that it will not execute an " +"<literal>INSERT</literal> statement if it is called outside of transaction " +"boundaries. This is useful in long-running conversations with an extended " +"Session/persistence context." -#: index.docbook:111 -msgid "<literal>save()</literal> does guarantee to return an identifier. If an INSERT has to be executed to get the identifier ( e.g. \"identity\" generator, not \"sequence\"), this INSERT happens immediately, no matter if you are inside or outside of a transaction. This is problematic in a long-running conversation with an extended Session/persistence context." +#. Tag: para +#: session_api.xml:111 +#, no-c-format +msgid "" +"<literal>save()</literal> does guarantee to return an identifier. If an " +"INSERT has to be executed to get the identifier ( e.g. \"identity\" " +"generator, not \"sequence\"), this INSERT happens immediately, no matter if " +"you are inside or outside of a transaction. This is problematic in a long-" +"running conversation with an extended Session/persistence context." msgstr "" - "<![CDATA[DomesticCat pk = new DomesticCat(); -\n" - "pk.setColor(Color.TABBY); -\n" - "pk.setSex('F'); -\n" - "pk.setName(\"PK\"); -\n" - "pk.setKittens( new HashSet() ); -\n" - "pk.addKitten(fritz); -\n" - "sess.save( pk, new Long(1234) );]]>" +"<literal>save()</literal> does guarantee to return an identifier. If an " +"INSERT has to be executed to get the identifier ( e.g. \"identity\" " +"generator, not \"sequence\"), this INSERT happens immediately, no matter if " +"you are inside or outside of a transaction. This is problematic in a long-" +"running conversation with an extended Session/persistence context." -#: index.docbook:121 -msgid "Alternatively, you may assign the identifier using an overloaded version of <literal>save()</literal>." -msgstr "永続化するオブジェクトが関連オブジェクトを持っている場合 （例えば、前の例における <literal>kittens</literal> コレクションのように）、 外部キーカラムに、 <literal>NOT NULL</literal> 制約をつけない限りは、 これらの一連のオブジェクトをどんな順番で永続化してもかまいません。 外部キー制約を違反する恐れはありません。 しかし、 <literal>NOT NULL</literal> 制約がある場合、間違った順番でオブジェクトを <literal>save()</literal> してしまうと、 制約に違反するかもしれません。" +#. Tag: para +#: session_api.xml:121 +#, no-c-format +msgid "" +"Alternatively, you may assign the identifier using an overloaded version of " +"<literal>save()</literal>." +msgstr "" +"代わりに、識別子を引数にとる <literal>save()</literal> メソッドを使って、 識" +"別子を割り当てることもできます。" -#: index.docbook:126 +#. Tag: programlisting +#: session_api.xml:126 +#, no-c-format msgid "" - "<![CDATA[DomesticCat pk = new DomesticCat();\n" - "pk.setColor(Color.TABBY);\n" - "pk.setSex('F');\n" - "pk.setName(\"PK\");\n" - "pk.setKittens( new HashSet() );\n" - "pk.addKitten(fritz);\n" - "sess.save( pk, new Long(1234) );]]>" -msgstr "関連するオブジェクトを自動的に保存する、 Hibernateの <emphasis>遷移的な永続化(transitive persistence)</emphasis> 機能を 使うつもりならば、そのような詳細を気にする必要はありません。 そして、 <literal>NOT NULL</literal> 制約の違反すら起こりません。 Hibernateがすべて面倒をみてくれます。遷移的な永続化は、この章の後半に書かれています。" +"<![CDATA[DomesticCat pk = new DomesticCat();\n" +"pk.setColor(Color.TABBY);\n" +"pk.setSex('F');\n" +"pk.setName(\"PK\");\n" +"pk.setKittens( new HashSet() );\n" +"pk.addKitten(fritz);\n" +"sess.save( pk, new Long(1234) );]]>" +msgstr "" -#: index.docbook:128 -msgid "If the object you make persistent has associated objects (e.g. the <literal>kittens</literal> collection in the previous example), these objects may be made persistent in any order you like unless you have a <literal>NOT NULL</literal> constraint upon a foreign key column. There is never a risk of violating foreign key constraints. However, you might violate a <literal>NOT NULL</literal> constraint if you <literal>save()</literal> the objects in the wrong order." -msgstr "オブジェクトのロード" +#. Tag: para +#: session_api.xml:128 +#, no-c-format +msgid "" +"If the object you make persistent has associated objects (e.g. the " +"<literal>kittens</literal> collection in the previous example), these " +"objects may be made persistent in any order you like unless you have a " +"<literal>NOT NULL</literal> constraint upon a foreign key column. There is " +"never a risk of violating foreign key constraints. However, you might " +"violate a <literal>NOT NULL</literal> constraint if you <literal>save()</" +"literal> the objects in the wrong order." +msgstr "" +"永続化するオブジェクトが関連オブジェクトを持っている場合 （例えば、前の例にお" +"ける <literal>kittens</literal> コレクションのように）、 外部キーカラムに、 " +"<literal>NOT NULL</literal> 制約をつけない限りは、 これらの一連のオブジェクト" +"をどんな順番で永続化してもかまいません。 外部キー制約を違反する恐れはありませ" +"ん。 しかし、 <literal>NOT NULL</literal> 制約がある場合、間違った順番でオブ" +"ジェクトを <literal>save()</literal> してしまうと、 制約に違反するかもしれま" +"せん。" -#: index.docbook:138 -msgid "Usually you don't bother with this detail, as you'll very likely use Hibernate's <emphasis>transitive persistence</emphasis> feature to save the associated objects automatically. Then, even <literal>NOT NULL</literal> constraint violations don't occur - Hibernate will take care of everything. Transitive persistence is discussed later in this chapter." -msgstr "永続化されたインスタンスの識別子があらかじめ分かっているなら、 <literal>Session</literal> の <literal>load()</literal> メソッドを使って、復元できます。 <literal>load()</literal> は、Class オブジェクトを引数にとり、 そのクラスのインスタンスを新たに生成し、状態をロードします。 そのインスタンスの状態は、永続(persistent)状態です。" +#. Tag: para +#: session_api.xml:138 +#, no-c-format +msgid "" +"Usually you don't bother with this detail, as you'll very likely use " +"Hibernate's <emphasis>transitive persistence</emphasis> feature to save the " +"associated objects automatically. Then, even <literal>NOT NULL</literal> " +"constraint violations don't occur - Hibernate will take care of everything. " +"Transitive persistence is discussed later in this chapter." +msgstr "" +"関連するオブジェクトを自動的に保存する、 Hibernateの <emphasis>遷移的な永続化" +"(transitive persistence)</emphasis> 機能を 使うつもりならば、そのような詳細を" +"気にする必要はありません。 そして、 <literal>NOT NULL</literal> 制約の違反す" +"ら起こりません。 Hibernateがすべて面倒をみてくれます。遷移的な永続化は、この" +"章の後半に書かれています。" -#: index.docbook:149 +#. Tag: title +#: session_api.xml:149 +#, no-c-format msgid "Loading an object" -msgstr "<![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]>" +msgstr "オブジェクトのロード" -#: index.docbook:151 -msgid "The <literal>load()</literal> methods of <literal>Session</literal> gives you a way to retrieve a persistent instance if you already know its identifier. <literal>load()</literal> takes a class object and will load the state into a newly instantiated instance of that class, in persistent state." +#. Tag: para +#: session_api.xml:151 +#, no-c-format +msgid "" +"The <literal>load()</literal> methods of <literal>Session</literal> gives " +"you a way to retrieve a persistent instance if you already know its " +"identifier. <literal>load()</literal> takes a class object and will load the " +"state into a newly instantiated instance of that class, in persistent state." msgstr "" - "<![CDATA[// you need to wrap primitive identifiers -\n" - "long id = 1234; -\n" - "DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long(id) );]]>" +"永続化されたインスタンスの識別子があらかじめ分かっているなら、 " +"<literal>Session</literal> の <literal>load()</literal> メソッドを使って、復" +"元できます。 <literal>load()</literal> は、Class オブジェクトを引数にとり、 " +"そのクラスのインスタンスを新たに生成し、状態をロードします。 そのインスタンス" +"の状態は、永続(persistent)状態です。" -#: index.docbook:158 +#. Tag: programlisting +#: session_api.xml:158 +#, no-c-format msgid "<![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]>" -msgstr "あるいは、以下のように、既存のインスタンスに状態をロードすることもできます。" +msgstr "" -#: index.docbook:160 +#. Tag: programlisting +#: session_api.xml:160 +#, no-c-format msgid "" - "<![CDATA[// you need to wrap primitive identifiers\n" - "long id = 1234;\n" - "DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long(id) );]]>" +"<![CDATA[// you need to wrap primitive identifiers\n" +"long id = 1234;\n" +"DomesticCat pk = (DomesticCat) sess.load( DomesticCat.class, new Long" +"(id) );]]>" msgstr "" - "<![CDATA[Cat cat = new DomesticCat(); -\n" - "// load pk's state into cat -\n" - "sess.load( cat, new Long(pkId) ); -\n" - "Set kittens = cat.getKittens();]]>" -#: index.docbook:162 +#. Tag: para +#: session_api.xml:162 +#, no-c-format msgid "Alternatively, you can load state into a given instance:" -msgstr "DBに該当する行が無い場合、 <literal>load()</literal> は回復不可能な例外を 投げることに注意しましょう。 そのクラスがプロキシを使ってマッピングされている場合、 <literal>load()</literal> は初期化されていないプロキシを返し、プロキシのメソッドが呼ばれるまで実際には データベースにアクセスしません。 もし、実際にデータベースからロードせずに、オブジェクトに対する関連を作りたい場合、 この振る舞いはとても役立ちます。 <literal>batch-size</literal> がクラスマッピングに定義されているならば、 複数のインスタンスを一括でロードすることが可能です。" +msgstr "" +"あるいは、以下のように、既存のインスタンスに状態をロードすることもできます。" -#: index.docbook:166 +#. Tag: programlisting +#: session_api.xml:166 +#, no-c-format msgid "" - "<![CDATA[Cat cat = new DomesticCat();\n" - "// load pk's state into cat\n" - "sess.load( cat, new Long(pkId) );\n" - "Set kittens = cat.getKittens();]]>" -msgstr "該当する行が存在することを確信できない場合は、 <literal>get()</literal> メソッドを使うべきです。 それは、データベースにすぐにアクセスし、該当する行が無い場合はnullを返します。" +"<![CDATA[Cat cat = new DomesticCat();\n" +"// load pk's state into cat\n" +"sess.load( cat, new Long(pkId) );\n" +"Set kittens = cat.getKittens();]]>" +msgstr "" -#: index.docbook:168 -msgid "Note that <literal>load()</literal> will throw an unrecoverable exception if there is no matching database row. If the class is mapped with a proxy, <literal>load()</literal> just returns an uninitialized proxy and does not actually hit the database until you invoke a method of the proxy. This behaviour is very useful if you wish to create an association to an object without actually loading it from the database. It also allows multiple instances to be loaded as a batch if <literal>batch-size</literal> is defined for the class mapping." +#. Tag: para +#: session_api.xml:168 +#, no-c-format +msgid "" +"Note that <literal>load()</literal> will throw an unrecoverable exception if " +"there is no matching database row. If the class is mapped with a proxy, " +"<literal>load()</literal> just returns an uninitialized proxy and does not " +"actually hit the database until you invoke a method of the proxy. This " +"behaviour is very useful if you wish to create an association to an object " +"without actually loading it from the database. It also allows multiple " +"instances to be loaded as a batch if <literal>batch-size</literal> is " +"defined for the class mapping." msgstr "" - "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id); -\n" - "if (cat==null) { -\n" - " cat = new Cat(); -\n" - " sess.save(cat, id); -\n" - "} -\n" - "return cat;]]>" +"DBに該当する行が無い場合、 <literal>load()</literal> は回復不可能な例外を 投" +"げることに注意しましょう。 そのクラスがプロキシを使ってマッピングされている場" +"合、 <literal>load()</literal> は初期化されていないプロキシを返し、プロキシの" +"メソッドが呼ばれるまで実際には データベースにアクセスしません。 もし、実際に" +"データベースからロードせずに、オブジェクトに対する関連を作りたい場合、 この振" +"る舞いはとても役立ちます。 <literal>batch-size</literal> がクラスマッピングに" +"定義されているならば、 複数のインスタンスを一括でロードすることが可能です。" -#: index.docbook:179 -msgid "If you are not certain that a matching row exists, you should use the <literal>get()</literal> method, which hits the database immediately and returns null if there is no matching row." -msgstr "<literal>LockMode</literal> を使えば、 <literal>SELECT ... FOR UPDATE</literal>というSQLを 使ってオブジェクトをロードすることができます。 詳細な情報は、APIドキュメントを参照してください。" +#. Tag: para +#: session_api.xml:179 +#, no-c-format +msgid "" +"If you are not certain that a matching row exists, you should use the " +"<literal>get()</literal> method, which hits the database immediately and " +"returns null if there is no matching row." +msgstr "" +"該当する行が存在することを確信できない場合は、 <literal>get()</literal> メ" +"ソッドを使うべきです。 それは、データベースにすぐにアクセスし、該当する行が無" +"い場合はnullを返します。" -#: index.docbook:185 +#. Tag: programlisting +#: session_api.xml:185 +#, no-c-format msgid "" - "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id);\n" - "if (cat==null) {\n" - " cat = new Cat();\n" - " sess.save(cat, id);\n" - "}\n" - "return cat;]]>" -msgstr "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]>" +"<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id);\n" +"if (cat==null) {\n" +" cat = new Cat();\n" +" sess.save(cat, id);\n" +"}\n" +"return cat;]]>" +msgstr "" -#: index.docbook:187 -msgid "You may even load an object using an SQL <literal>SELECT ... FOR UPDATE</literal>, using a <literal>LockMode</literal>. See the API documentation for more information." -msgstr "関連に対するカスケード方法として <literal>lock</literal> や <literal>all</literal> を 指定しない限り、関連するインスタンスや含まれるコレクションは <literal>FOR UPDATE</literal> で復元 <emphasis>されない</emphasis> ことに注意しましょう。" +#. Tag: para +#: session_api.xml:187 +#, no-c-format +msgid "" +"You may even load an object using an SQL <literal>SELECT ... FOR UPDATE</" +"literal>, using a <literal>LockMode</literal>. See the API documentation for " +"more information." +msgstr "" +"<literal>LockMode</literal> を使えば、 <literal>SELECT ... FOR UPDATE</" +"literal>というSQLを 使ってオブジェクトをロードすることができます。 詳細な情報" +"は、APIドキュメントを参照してください。" -#: index.docbook:192 +#. Tag: programlisting +#: session_api.xml:192 +#, no-c-format msgid "<![CDATA[Cat cat = (Cat) sess.get(Cat.class, id, LockMode.UPGRADE);]]>" -msgstr "<literal>refresh()</literal> メソッドを使うことで、どんなときでも、オブジェクトやそのコレクションを リロードすることができます。 データベースのトリガがテーブルを更新した際に、 そのテーブルに対応するオブジェクトのプロパティを同期する場合、このメソッドが役に立ちます。" +msgstr "" -#: index.docbook:194 -msgid "Note that any associated instances or contained collections are <emphasis>not</emphasis> selected <literal>FOR UPDATE</literal>, unless you decide to specify <literal>lock</literal> or <literal>all</literal> as a cascade style for the association." +#. Tag: para +#: session_api.xml:194 +#, no-c-format +msgid "" +"Note that any associated instances or contained collections are " +"<emphasis>not</emphasis> selected <literal>FOR UPDATE</literal>, unless you " +"decide to specify <literal>lock</literal> or <literal>all</literal> as a " +"cascade style for the association." msgstr "" - "<![CDATA[sess.save(cat); -\n" - "sess.flush(); //force the SQL INSERT -\n" - "sess.refresh(cat); //re-read the state (after the trigger executes)]]>" +"関連に対するカスケード方法として <literal>lock</literal> や <literal>all</" +"literal> を 指定しない限り、関連するインスタンスや含まれるコレクションは " +"<literal>FOR UPDATE</literal> で復元 <emphasis>されない</emphasis> ことに注意" +"しましょう。" -#: index.docbook:201 -msgid "It is possible to re-load an object and all its collections at any time, using the <literal>refresh()</literal> method. This is useful when database triggers are used to initialize some of the properties of the object." -msgstr "大切な問題は、いつも次の点に関するものです。それは、Hibernateがデータベースから、 どのくらいの量を復元するのかと、どのくらいの数のSQLの <literal>SELECT</literal> 文が使われるのかです。 これは、 <emphasis>フェッチの戦略</emphasis> によります。これについては、<xref linkend=\"performance-fetching\"/> で説明しています。" +#. Tag: para +#: session_api.xml:201 +#, no-c-format +msgid "" +"It is possible to re-load an object and all its collections at any time, " +"using the <literal>refresh()</literal> method. This is useful when database " +"triggers are used to initialize some of the properties of the object." +msgstr "" +"<literal>refresh()</literal> メソッドを使うことで、どんなときでも、オブジェク" +"トやそのコレクションを リロードすることができます。 データベースのトリガが" +"テーブルを更新した際に、 そのテーブルに対応するオブジェクトのプロパティを同期" +"する場合、このメソッドが役に立ちます。" -#: index.docbook:207 +#. Tag: programlisting +#: session_api.xml:207 +#, no-c-format msgid "" - "<![CDATA[sess.save(cat);\n" - "sess.flush(); //force the SQL INSERT\n" - "sess.refresh(cat); //re-read the state (after the trigger executes)]]>" -msgstr "<title>クエリ</title>" +"<![CDATA[sess.save(cat);\n" +"sess.flush(); //force the SQL INSERT\n" +"sess.refresh(cat); //re-read the state (after the trigger executes)]]>" +msgstr "" -#: index.docbook:209 -msgid "An important question usually appears at this point: How much does Hibernate load from the database and how many SQL <literal>SELECT</literal>s will it use? This depends on the <emphasis>fetching strategy</emphasis> and is explained in <xref linkend=\"performance-fetching\"/>." -msgstr "探したいオブジェクトの識別子が分からない場合は、クエリが必要になります。 Hibernateは使いやすくて強力なオブジェクト指向のクエリ言語 (HQL)をサポートしています。 プログラムによってクエリが作成できるように、Hibernateは洗練されたCriteriaとExampleクエリ機能(QBCとQBE）を サポートしています。ResultSetをオブジェクトに変換するHibernateのオプション機能を使うことで、 データベースのネイティブなSQLでクエリを表現することもできます。" +#. Tag: para +#: session_api.xml:209 +#, no-c-format +msgid "" +"An important question usually appears at this point: How much does Hibernate " +"load from the database and how many SQL <literal>SELECT</literal>s will it " +"use? This depends on the <emphasis>fetching strategy</emphasis> and is " +"explained in <xref linkend=\"performance-fetching\"/>." +msgstr "" +"大切な問題は、いつも次の点に関するものです。それは、Hibernateがデータベースか" +"ら、 どのくらいの量を復元するのかと、どのくらいの数のSQLの <literal>SELECT</" +"literal> 文が使われるのかです。 これは、 <emphasis>フェッチの戦略</emphasis> " +"によります。これについては、<xref linkend=\"performance-fetching\"/> で説明し" +"ています。" -#: index.docbook:219 +#. Tag: title +#: session_api.xml:219 +#, no-c-format msgid "Querying" -msgstr "クエリの実行" +msgstr "クエリ" -#: index.docbook:221 -msgid "If you don't know the identifiers of the objects you are looking for, you need a query. Hibernate supports an easy-to-use but powerful object oriented query language (HQL). For programmatic query creation, Hibernate supports a sophisticated Criteria and Example query feature (QBC and QBE). You may also express your query in the native SQL of your database, with optional support from Hibernate for result set conversion into objects." -msgstr "HQLやネイティブなSQLクエリは、 <literal>org.hibernate.Query</literal> のインスタンスとして表現されます。 このインタフェースは、パラメータバインディングやResultSetのハンドリングや クエリの実行を行うメソッドを用意しています。 通常、 <literal>Query</literal> は、以下に示すように、 その時点の <literal>Session</literal> を使って取得します。" +#. Tag: para +#: session_api.xml:221 +#, no-c-format +msgid "" +"If you don't know the identifiers of the objects you are looking for, you " +"need a query. Hibernate supports an easy-to-use but powerful object oriented " +"query language (HQL). For programmatic query creation, Hibernate supports a " +"sophisticated Criteria and Example query feature (QBC and QBE). You may also " +"express your query in the native SQL of your database, with optional support " +"from Hibernate for result set conversion into objects." +msgstr "" +"探したいオブジェクトの識別子が分からない場合は、クエリが必要になります。 " +"Hibernateは使いやすくて強力なオブジェクト指向のクエリ言語 (HQL)をサポートして" +"います。 プログラムによってクエリが作成できるように、Hibernateは洗練された" +"CriteriaとExampleクエリ機能(QBCとQBE）を サポートしています。ResultSetをオブ" +"ジェクトに変換するHibernateのオプション機能を使うことで、 データベースのネイ" +"ティブなSQLでクエリを表現することもできます。" -#: index.docbook:231 +#. Tag: title +#: session_api.xml:231 +#, no-c-format msgid "Executing queries" +msgstr "クエリの実行" + +#. Tag: para +#: session_api.xml:233 +#, no-c-format +msgid "" +"HQL and native SQL queries are represented with an instance of <literal>org." +"hibernate.Query</literal>. This interface offers methods for parameter " +"binding, result set handling, and for the execution of the actual query. You " +"always obtain a <literal>Query</literal> using the current <literal>Session</" +"literal>:" msgstr "" - "<![CDATA[List cats = session.createQuery( -\n" - " \"from Cat as cat where cat.birthdate < ?\") -\n" - " .setDate(0, date) -\n" - " .list(); -\n" - " -\n" - "List mothers = session.createQuery( -\n" - " \"select mother from Cat as cat join cat.mother as mother where cat.name = ?\") -\n" - " .setString(0, name) -\n" - " .list(); -\n" - " -\n" - "List kittens = session.createQuery( -\n" - " \"from Cat as cat where cat.mother = ?\") -\n" - " .setEntity(0, pk) -\n" - " .list(); -\n" - " -\n" - "Cat mother = (Cat) session.createQuery( -\n" - " \"select cat.mother from Cat as cat where cat = ?\") -\n" - " .setEntity(0, izi) -\n" - " .uniqueResult();]] -\n" - " -\n" - "Query mothersWithKittens = (Cat) session.createQuery( -\n" - " \"select mother from Cat as mother left join fetch mother.kittens\"); -\n" - "Set uniqueMothers = new HashSet(mothersWithKittens.list()); -\n" - " -\n" - " ]]>" +"HQLやネイティブなSQLクエリは、 <literal>org.hibernate.Query</literal> のイン" +"スタンスとして表現されます。 このインタフェースは、パラメータバインディングや" +"ResultSetのハンドリングや クエリの実行を行うメソッドを用意しています。 通" +"常、 <literal>Query</literal> は、以下に示すように、 その時点の " +"<literal>Session</literal> を使って取得します。" -#: index.docbook:233 -msgid "HQL and native SQL queries are represented with an instance of <literal>org.hibernate.Query</literal>. This interface offers methods for parameter binding, result set handling, and for the execution of the actual query. You always obtain a <literal>Query</literal> using the current <literal>Session</literal>:" -msgstr "クエリは、普通、 <literal>list()</literal> を呼び出すことによって実行されます。 クエリの結果は、メモリ上にあるコレクションにすべてロードされます。 クエリによって復元されたエンティティのインスタンスは、永続状態です。 もし、クエリがたった1個のインスタンスを返すと分かっているなら、 <literal>uniqueResult()</literal> メソッドが手っ取り早い方法です。 即時フェッチを利用したクエリの場合、ふつう、得られたコレクションには、 ルートのオブジェクトが重複して含まれています （しかし、ルートが持つコレクションは初期化(ロード）されています）。 この重複は <literal>Set</literal> を使って取り除くことができます。" +#. Tag: programlisting +#: session_api.xml:240 +#, no-c-format +msgid "" +"<![CDATA[List cats = session.createQuery(\n" +" \"from Cat as cat where cat.birthdate < ?\")\n" +" .setDate(0, date)\n" +" .list();\n" +"\n" +"List mothers = session.createQuery(\n" +" \"select mother from Cat as cat join cat.mother as mother where cat.name " +"= ?\")\n" +" .setString(0, name)\n" +" .list();\n" +"\n" +"List kittens = session.createQuery(\n" +" \"from Cat as cat where cat.mother = ?\")\n" +" .setEntity(0, pk)\n" +" .list();\n" +"\n" +"Cat mother = (Cat) session.createQuery(\n" +" \"select cat.mother from Cat as cat where cat = ?\")\n" +" .setEntity(0, izi)\n" +" .uniqueResult();]]\n" +"\n" +"Query mothersWithKittens = (Cat) session.createQuery(\n" +" \"select mother from Cat as mother left join fetch mother.kittens\");\n" +"Set uniqueMothers = new HashSet(mothersWithKittens.list());]]>" +msgstr "" -#: index.docbook:240 +#. Tag: para +#: session_api.xml:242 +#, no-c-format msgid "" - "<![CDATA[List cats = session.createQuery(\n" - " \"from Cat as cat where cat.birthdate < ?\")\n" - " .setDate(0, date)\n" - " .list();\n" - "\n" - "List mothers = session.createQuery(\n" - " \"select mother from Cat as cat join cat.mother as mother where cat.name = ?\")\n" - " .setString(0, name)\n" - " .list();\n" - "\n" - "List kittens = session.createQuery(\n" - " \"from Cat as cat where cat.mother = ?\")\n" - " .setEntity(0, pk)\n" - " .list();\n" - "\n" - "Cat mother = (Cat) session.createQuery(\n" - " \"select cat.mother from Cat as cat where cat = ?\")\n" - " .setEntity(0, izi)\n" - " .uniqueResult();]]\n" - "\n" - "Query mothersWithKittens = (Cat) session.createQuery(\n" - " \"select mother from Cat as mother left join fetch mother.kittens\");\n" - "Set uniqueMothers = new HashSet(mothersWithKittens.list());]]>" +"A query is usually executed by invoking <literal>list()</literal>, the " +"result of the query will be loaded completely into a collection in memory. " +"Entity instances retrieved by a query are in persistent state. The " +"<literal>uniqueResult()</literal> method offers a shortcut if you know your " +"query will only return a single object. Note that queries that make use of " +"eager fetching of collections usually return duplicates of the root objects " +"(but with their collections initialized). You can filter these duplicates " +"simply through a <literal>Set</literal>." +msgstr "" +"クエリは、普通、 <literal>list()</literal> を呼び出すことによって実行されま" +"す。 クエリの結果は、メモリ上にあるコレクションにすべてロードされます。 クエ" +"リによって復元されたエンティティのインスタンスは、永続状態です。 もし、クエリ" +"がたった1個のインスタンスを返すと分かっているなら、 <literal>uniqueResult()</" +"literal> メソッドが手っ取り早い方法です。 即時フェッチを利用したクエリの場" +"合、ふつう、得られたコレクションには、 ルートのオブジェクトが重複して含まれて" +"います （しかし、ルートが持つコレクションは初期化(ロード）されています）。 こ" +"の重複は <literal>Set</literal> を使って取り除くことができます。" + +#. Tag: title +#: session_api.xml:254 +#, no-c-format +msgid "Iterating results" msgstr "結果をイテレートする" -#: index.docbook:242 -msgid "A query is usually executed by invoking <literal>list()</literal>, the result of the query will be loaded completely into a collection in memory. Entity instances retrieved by a query are in persistent state. The <literal>uniqueResult()</literal> method offers a shortcut if you know your query will only return a single object. Note that queries that make use of eager fetching of collections usually return duplicates of the root objects (but with their collections initialized). You can filter these duplicates simply through a <literal>Set</literal>." -msgstr "時々、 <literal>iterate()</literal> メソッドを使ってクエリを実行することで、 より良いパフォーマンスを得ることができます。 これは、通常、クエリによって得られた実際のエンティティのインスタンスが、 すでにセッションまたは二次キャッシュに存在することが期待できる場合だけです。 それらが、まだキャッシュされていないなら、 <literal>iterate()</literal> は、 <literal>list()</literal> よりも遅く、簡単なクエリに対しても多くのデータベースアクセスを 必要とします。そのアクセスとは、識別子だけを取得するための最初のselect１回と、 実際のインスタンスを初期化するために後から行うn回のselectのことです。" +#. Tag: para +#: session_api.xml:256 +#, no-c-format +msgid "" +"Occasionally, you might be able to achieve better performance by executing " +"the query using the <literal>iterate()</literal> method. This will only " +"usually be the case if you expect that the actual entity instances returned " +"by the query will already be in the session or second-level cache. If they " +"are not already cached, <literal>iterate()</literal> will be slower than " +"<literal>list()</literal> and might require many database hits for a simple " +"query, usually <emphasis>1</emphasis> for the initial select which only " +"returns identifiers, and <emphasis>n</emphasis> additional selects to " +"initialize the actual instances." +msgstr "" +"時々、 <literal>iterate()</literal> メソッドを使ってクエリを実行することで、 " +"より良いパフォーマンスを得ることができます。 これは、通常、クエリによって得ら" +"れた実際のエンティティのインスタンスが、 すでにセッションまたは二次キャッシュ" +"に存在することが期待できる場合だけです。 それらが、まだキャッシュされていない" +"なら、 <literal>iterate()</literal> は、 <literal>list()</literal> よりも遅" +"く、簡単なクエリに対しても多くのデータベースアクセスを 必要とします。そのアク" +"セスとは、識別子だけを取得するための最初のselect１回と、 実際のインスタンスを" +"初期化するために後から行うn回のselectのことです。" -#: index.docbook:254 -msgid "Iterating results" +#. Tag: programlisting +#: session_api.xml:268 +#, no-c-format +msgid "" +"<![CDATA[// fetch ids\n" +"Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\")." +"iterate();\n" +"while ( iter.hasNext() ) {\n" +" Qux qux = (Qux) iter.next(); // fetch the object\n" +" // something we couldnt express in the query\n" +" if ( qux.calculateComplicatedAlgorithm() ) {\n" +" // delete the current instance\n" +" iter.remove();\n" +" // dont need to process the rest\n" +" break;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[// fetch ids -\n" - "Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\").iterate(); -\n" - "while ( iter.hasNext() ) { -\n" - " Qux qux = (Qux) iter.next(); // fetch the object -\n" - " // something we couldnt express in the query -\n" - " if ( qux.calculateComplicatedAlgorithm() ) { -\n" - " // delete the current instance -\n" - " iter.remove(); -\n" - " // dont need to process the rest -\n" - " break; -\n" - " } -\n" - "}]]>" -#: index.docbook:256 -msgid "Occasionally, you might be able to achieve better performance by executing the query using the <literal>iterate()</literal> method. This will only usually be the case if you expect that the actual entity instances returned by the query will already be in the session or second-level cache. If they are not already cached, <literal>iterate()</literal> will be slower than <literal>list()</literal> and might require many database hits for a simple query, usually <emphasis>1</emphasis> for the initial select which only returns identifiers, and <emphasis>n</emphasis> additional selects to initialize the actual instances." +#. Tag: title +#: session_api.xml:272 +#, no-c-format +msgid "Queries that return tuples" msgstr "オブジェクトの組（tuple）を返すクエリ" -#: index.docbook:268 +#. Tag: para +#: session_api.xml:274 +#, no-c-format msgid "" - "<![CDATA[// fetch ids\n" - "Iterator iter = sess.createQuery(\"from eg.Qux q order by q.likeliness\").iterate();\n" - "while ( iter.hasNext() ) {\n" - " Qux qux = (Qux) iter.next(); // fetch the object\n" - " // something we couldnt express in the query\n" - " if ( qux.calculateComplicatedAlgorithm() ) {\n" - " // delete the current instance\n" - " iter.remove();\n" - " // dont need to process the rest\n" - " break;\n" - " }\n" - "}]]>" -msgstr "Hibernateのクエリでは、時々、オブジェクトの組を返すことがあります。 その場合は、各タプルは配列として返されます。" +"Hibernate queries sometimes return tuples of objects, in which case each " +"tuple is returned as an array:" +msgstr "" +"Hibernateのクエリでは、時々、オブジェクトの組を返すことがあります。 その場合" +"は、各タプルは配列として返されます。" -#: index.docbook:272 -msgid "Queries that return tuples" +#. Tag: programlisting +#: session_api.xml:279 +#, no-c-format +msgid "" +"<![CDATA[Iterator kittensAndMothers = sess.createQuery(\n" +" \"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 "" - "<![CDATA[Iterator kittensAndMothers = sess.createQuery( -\n" - " \"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" - "}]]>" -#: index.docbook:274 -msgid "Hibernate queries sometimes return tuples of objects, in which case each tuple is returned as an array:" +#. Tag: title +#: session_api.xml:284 +#, no-c-format +msgid "Scalar results" msgstr "スカラーの結果" -#: index.docbook:279 +#. Tag: para +#: session_api.xml:286 +#, no-c-format msgid "" - "<![CDATA[Iterator kittensAndMothers = sess.createQuery(\n" - " \"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 "クエリでは、 <literal>select</literal> 節でクラスのプロパティを指定できます。 SQLの集合関数を呼ぶこともできます。プロパティや集合関数は、 （永続状態のエンティティではなく）「スカラー値」であると見なされます。" +"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の集合関数を呼ぶこともできます。プロパティや集合関数は、 （永続状態の" +"エンティティではなく）「スカラー値」であると見なされます。" -#: index.docbook:284 -msgid "Scalar results" +#. 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 "" - "<![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" - "}]]>" -#: index.docbook:286 -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)." +#. Tag: title +#: session_api.xml:297 +#, no-c-format +msgid "Bind parameters" msgstr "パラメータのバインド" -#: index.docbook:292 +#. Tag: para +#: session_api.xml:299 +#, 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 "<literal>Query</literal> は、名前付きのパラメータやJDBCスタイルの <literal>?</literal> パラメータに値をバインドするためのメソッドを持っています。 <emphasis>JDBCとは違い、Hibernateはパラメータにゼロから番号を振っていきます。</emphasis> 名前付きのパラメータとは、クエリ文字列のなかにある <literal>:name</literal> 形式の識別子です。 名前付きパラメータの利点は次の通りです。" +"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> 形式の識別子です。 名前付きパラメータの利点は次の通りです。" -#: index.docbook:297 -msgid "Bind parameters" +#. Tag: para +#: session_api.xml:309 +#, no-c-format +msgid "" +"named parameters are insensitive to the order they occur in the query string" msgstr "名前付きパラメータは、クエリ文字列に登場する順番と無関係です" -#: index.docbook:299 -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:" +#. Tag: para +#: session_api.xml:315 +#, no-c-format +msgid "they may occur multiple times in the same query" msgstr "同じクエリ内に複数回登場することができます" -#: index.docbook:309 -msgid "named parameters are insensitive to the order they occur in the query string" +#. Tag: para +#: session_api.xml:320 +#, no-c-format +msgid "they are self-documenting" msgstr "自分自身を説明します" -#: index.docbook:315 -msgid "they may occur multiple times in the same query" +#. 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 "" - "<![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();]]>" -#: index.docbook:320 -msgid "they are self-documenting" +#. 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 "" - "<![CDATA[//positional parameter -\n" - "Query q = sess.createQuery(\"from DomesticCat cat where cat.name = ?\"); -\n" - "q.setString(0, \"Izi\"); -\n" - "Iterator cats = q.iterate();]]>" -#: index.docbook:326 +#. Tag: programlisting +#: session_api.xml:330 +#, 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();]]>" +"<![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 "" - "<![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();]]>" -#: index.docbook:328 -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();]]>" +#. Tag: title +#: session_api.xml:335 +#, no-c-format +msgid "Pagination" msgstr "ページ分け" -#: index.docbook:330 +#. Tag: para +#: session_api.xml:337 +#, 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 "ResultSetに制限（復元したい最大行数や復元したい最初の行）を加える必要があれば、 以下のように、 <literal>Query</literal> インターフェイスのメソッドを使います。" +"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> インターフェイスのメソッドを使い" +"ます。" -#: index.docbook:335 -msgid "Pagination" +#. 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 "" - "<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\"); -\n" - "q.setFirstResult(20); -\n" - "q.setMaxResults(10); -\n" - "List cats = q.list();]]>" -#: index.docbook:337 -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 "制限付きのクエリをDBMSのネイティブなSQLに変換する方法を、Hibernateは知っています。" +#. 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は知ってい" +"ます。" -#: index.docbook:343 -msgid "" - "<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\");\n" - "q.setFirstResult(20);\n" - "q.setMaxResults(10);\n" - "List cats = q.list();]]>" +#. Tag: title +#: session_api.xml:353 +#, no-c-format +msgid "Scrollable iteration" msgstr "スクロール可能なイテレーション" -#: index.docbook:345 -msgid "Hibernate knows how to translate this limit query into the native SQL of your DBMS." -msgstr "JDBCドライバがスクロール可能な <literal>ResultSet</literal> をサポートしていれば、 <literal>Query</literal> インターフェイスを使って、 <literal>ScrollableResults</literal> オブジェクトを 取得できます。それを使うと、クエリの結果に対して柔軟にナビゲーションできます。" +#. 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> オブジェクトを 取得できます。それを使う" +"と、クエリの結果に対して柔軟にナビゲーションできます。" -#: index.docbook:353 -msgid "Scrollable iteration" +#. 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 "" - "<![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()]]>" -#: index.docbook:355 -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 "この機能にはオープン状態のデータベースコネクションが必要であることに注意してください。 もし、オフラインのページ分け機能が必要であれば、 <literal>setMaxResult()</literal> / <literal>setFirstResult()</literal> を使いましょう。" +#. 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> を使" +"いましょう。" -#: index.docbook:362 -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()]]>" +#. Tag: title +#: session_api.xml:373 +#, no-c-format +msgid "Externalizing named queries" msgstr "名前付きクエリの外出し" -#: index.docbook:364 -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>CDATA</literal> セクションを 使うことを忘れないようにしましょう。）" +#. 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> セク" +"ションを 使うことを忘れないようにしましょう。）" -#: index.docbook:373 -msgid "Externalizing named queries" +#. 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 "" - "<![CDATA[<query name=\"ByNameAndMaximumWeight\"><![CDATA[ -\n" - " from eg.DomesticCat as cat -\n" - " where cat.name = ? -\n" - " and cat.weight > ? -\n" - "] ]></query>]]>" -#: index.docbook:375 -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 "パラメータのバインディングと実行は、以下のようなプログラムで行われます。" +#. Tag: para +#: session_api.xml:383 +#, no-c-format +msgid "Parameter binding and executing is done programatically:" +msgstr "" +"パラメータのバインディングと実行は、以下のようなプログラムで行われます。" -#: index.docbook:381 +#. Tag: programlisting +#: session_api.xml:387 +#, 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>]]>" +"<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n" +"q.setString(0, name);\n" +"q.setInt(1, minWeight);\n" +"List cats = q.list();]]>" msgstr "" - "<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\"); -\n" - "q.setString(0, name); -\n" - "q.setInt(1, minWeight); -\n" - "List cats = q.list();]]>" -#: index.docbook:383 -msgid "Parameter binding and executing is done programatically:" -msgstr "実際のプログラムコードは、使われるクエリ言語に依存していないことに注意しましょう。 メタデータには、ネイティブSQLクエリを定義することもできます。 また、既存のクエリをマッピングファイルに移すことで、 Hibernateに移行することもできます。" +#. 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に移行することもでき" +"ます。" -#: index.docbook:387 +#. Tag: para +#: session_api.xml:395 +#, 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 "<literal>&lt;hibernate-mapping&gt;</literal> の中のクエリ定義は、クエリに対する ユニークな名前が必要なことにも注意してください。それに対して、 <literal>&lt;class&gt;</literal> の中の クエリ定義は、クラスの完全限定名が前に付けられるので、自動的にユニークな名前になります。 例： <literal>eg.Cat.ByNameAndMaximumWeight</literal>" +"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>" -#: index.docbook:389 -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." +#. Tag: title +#: session_api.xml:408 +#, no-c-format +msgid "Filtering collections" msgstr "コレクションのフィルタリング" -#: index.docbook:395 -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 "コレクション <emphasis>フィルタ</emphasis> は、永続化されているコレクションや配列に適用される 特殊なタイプのクエリです。そのクエリ文字列では、コレクションのその時点での要素を意味する <literal>this</literal> を使います。" +#. Tag: para +#: session_api.xml:409 +#, 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 "" +"コレクション <emphasis>フィルタ</emphasis> は、永続化されているコレクションや" +"配列に適用される 特殊なタイプのクエリです。そのクエリ文字列では、コレクション" +"のその時点での要素を意味する <literal>this</literal> を使います。" -#: index.docbook:408 -msgid "Filtering collections" +#. Tag: programlisting +#: session_api.xml:415 +#, 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 "" - "<![CDATA[Collection blackKittens = session.createFilter( -\n" - " pk.getKittens(), -\n" - " \"where this.color = ?\") -\n" - " .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) ) -\n" - " .list() -\n" - ");]]>" -#: index.docbook:409 -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 "返されるコレクションはBagとみなされます。そして、それはもとのコレクションのコピーになります。 元のコレクションは修正されません（これは、\"filter\"という名前の意味とは異なりますが、 期待される動きとは一致しています）。" +#. Tag: para +#: session_api.xml:417 +#, 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 "" +"返されるコレクションはBagとみなされます。そして、それはもとのコレクションのコ" +"ピーになります。 元のコレクションは修正されません（これは、\"filter\"という名" +"前の意味とは異なりますが、 期待される動きとは一致しています）。" -#: index.docbook:415 +#. Tag: para +#: session_api.xml:423 +#, 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 "フィルタには <literal>from</literal> 節が不要であることに気づくでしょう（必要なら、持つことも可能ですが）。 フィルタは、コレクションの要素自体を返して構いません。" +"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 "" +"フィルタには <literal>from</literal> 節が不要であることに気づくでしょう（必要" +"なら、持つことも可能ですが）。 フィルタは、コレクションの要素自体を返して構い" +"ません。" -#: index.docbook:417 -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)." +#. Tag: programlisting +#: session_api.xml:428 +#, 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 "" - "<![CDATA[Collection blackKittenMates = session.createFilter( -\n" - " pk.getKittens(), -\n" - " \"select this.mate where this.color = eg.Color.BLACK.intValue\") -\n" - " .list();]]>" -#: index.docbook:423 -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 "クエリを含まないフィルタも役に立ちます。 例えば、非常に大きなコレクションの部分集合をロードするために使えます。" +#. Tag: para +#: session_api.xml:430 +#, no-c-format +msgid "" +"Even an empty filter query is useful, e.g. to load a subset of elements in a " +"huge collection:" +msgstr "" +"クエリを含まないフィルタも役に立ちます。 例えば、非常に大きなコレクションの部" +"分集合をロードするために使えます。" -#: index.docbook:428 +#. Tag: programlisting +#: session_api.xml:435 +#, 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();]]>" +"<![CDATA[Collection tenKittens = session.createFilter(\n" +" mother.getKittens(), \"\")\n" +" .setFirstResult(0).setMaxResults(10)\n" +" .list();]]>" msgstr "" - "<![CDATA[Collection tenKittens = session.createFilter( -\n" - " mother.getKittens(), \"\") -\n" - " .setFirstResult(0).setMaxResults(10) -\n" - " .list();]]>" -#: index.docbook:430 -msgid "Even an empty filter query is useful, e.g. to load a subset of elements in a huge collection:" +#. Tag: title +#: session_api.xml:440 +#, no-c-format +msgid "Criteria queries" msgstr "クライテリアのクエリ" -#: index.docbook:435 +#. Tag: para +#: session_api.xml:442 +#, no-c-format msgid "" - "<![CDATA[Collection tenKittens = session.createFilter(\n" - " mother.getKittens(), \"\")\n" - " .setFirstResult(0).setMaxResults(10)\n" - " .list();]]>" -msgstr "HQLは非常に強力ですが、クエリ文字列を作るよりも、オブジェクト指向のAPIを使って 動的にクエリを作る方を好む開発者もいます。 こういった場合のために、Hibernateは直感的な <literal>Criteria</literal> クエリAPIを提供しています。" +"HQL is extremely powerful but some developers prefer to build queries " +"dynamically, using an object-oriented API, rather than building query " +"strings. Hibernate provides an intuitive <literal>Criteria</literal> query " +"API for these cases:" +msgstr "" +"HQLは非常に強力ですが、クエリ文字列を作るよりも、オブジェクト指向のAPIを使っ" +"て 動的にクエリを作る方を好む開発者もいます。 こういった場合のために、" +"Hibernateは直感的な <literal>Criteria</literal> クエリAPIを提供しています。" -#: index.docbook:440 -msgid "Criteria queries" +#. Tag: programlisting +#: session_api.xml:448 +#, no-c-format +msgid "" +"<![CDATA[Criteria crit = session.createCriteria(Cat.class);\n" +"crit.add( Restrictions.eq( \"color\", eg.Color.BLACK ) );\n" +"crit.setMaxResults(10);\n" +"List cats = crit.list();]]>" msgstr "" - "<![CDATA[Criteria crit = session.createCriteria(Cat.class); -\n" - "crit.add( Restrictions.eq( \"color\", eg.Color.BLACK ) ); -\n" - "crit.setMaxResults(10); -\n" - "List cats = crit.list();]]>" -#: index.docbook:442 -msgid "HQL is extremely powerful but some developers prefer to build queries dynamically, using an object-oriented API, rather than building query strings. Hibernate provides an intuitive <literal>Criteria</literal> query API for these cases:" -msgstr "<literal>Criteria</literal> と <literal>Example</literal> APIの詳細は、 <xref linkend=\"querycriteria\"/> に述べられています。" +#. Tag: para +#: session_api.xml:450 +#, no-c-format +msgid "" +"The <literal>Criteria</literal> and the associated <literal>Example</" +"literal> API are discussed in more detail in <xref linkend=\"querycriteria\"/" +">." +msgstr "" +"<literal>Criteria</literal> と <literal>Example</literal> APIの詳細は、 " +"<xref linkend=\"querycriteria\"/> に述べられています。" -#: index.docbook:448 -msgid "" - "<![CDATA[Criteria crit = session.createCriteria(Cat.class);\n" - "crit.add( Restrictions.eq( \"color\", eg.Color.BLACK ) );\n" - "crit.setMaxResults(10);\n" - "List cats = crit.list();]]>" +#. Tag: title +#: session_api.xml:458 +#, no-c-format +msgid "Queries in native SQL" msgstr "ネイティブSQLのクエリ" -#: index.docbook:450 -msgid "The <literal>Criteria</literal> and the associated <literal>Example</literal> API are discussed in more detail in <xref linkend=\"querycriteria\"/>." -msgstr "<literal>createSQLQuery()</literal> を使って、SQLでクエリを表現することもできます。 そして、Hibernateに、ResultSet からオブジェクトへのマッピングをまかせます。 <literal>session.connection()</literal> を呼べばどんなときでも、直接、JDBC <literal>Connection</literal> を使用できることを覚えておきましょう。 もし、Hibernate APIを使うのであれば、下記のようにSQLの別名を括弧でくくらなければなりません。" +#. Tag: para +#: session_api.xml:460 +#, no-c-format +msgid "" +"You may express a query in SQL, using <literal>createSQLQuery()</literal> " +"and let Hibernate take care of the mapping from result sets to objects. Note " +"that you may at any time call <literal>session.connection()</literal> and " +"use the JDBC <literal>Connection</literal> directly. If you chose to use the " +"Hibernate API, you must enclose SQL aliases in braces:" +msgstr "" +"<literal>createSQLQuery()</literal> を使って、SQLでクエリを表現することもでき" +"ます。 そして、Hibernateに、ResultSet からオブジェクトへのマッピングをまかせ" +"ます。 <literal>session.connection()</literal> を呼べばどんなときでも、直接、" +"JDBC <literal>Connection</literal> を使用できることを覚えておきましょう。 も" +"し、Hibernate APIを使うのであれば、下記のようにSQLの別名を括弧でくくらなけれ" +"ばなりません。" -#: index.docbook:458 -msgid "Queries in native SQL" +#. Tag: programlisting +#: session_api.xml:468 +#, no-c-format +msgid "" +"<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT {cat} " +"WHERE ROWNUM<10\")\n" +" .addEntity(\"cat\", Cat.class)\n" +".list();]]>" msgstr "" - "<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10\") -\n" - " .addEntity(\"cat\", Cat.class) -\n" - ".list();]]>" -#: index.docbook:460 -msgid "You may express a query in SQL, using <literal>createSQLQuery()</literal> and let Hibernate take care of the mapping from result sets to objects. Note that you may at any time call <literal>session.connection()</literal> and use the JDBC <literal>Connection</literal> directly. If you chose to use the Hibernate API, you must enclose SQL aliases in braces:" +#. Tag: programlisting +#: session_api.xml:470 +#, no-c-format +msgid "" +"<![CDATA[List cats = session.createSQLQuery(\n" +" \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" +\n" +" \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... \" " +"+\n" +" \"FROM CAT {cat} WHERE ROWNUM<10\")\n" +" .addEntity(\"cat\", Cat.class)\n" +".list()]]>" msgstr "" - "<![CDATA[List cats = session.createSQLQuery( -\n" - " \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" + -\n" - " \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... \" + -\n" - " \"FROM CAT {cat} WHERE ROWNUM<10\") -\n" - " .addEntity(\"cat\", Cat.class) -\n" - ".list()]]>" -#: index.docbook:468 +#. Tag: para +#: session_api.xml:472 +#, no-c-format msgid "" - "<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT {cat} WHERE ROWNUM<10\")\n" - " .addEntity(\"cat\", Cat.class)\n" - ".list();]]>" -msgstr "SQLクエリは、Hibernateクエリと同じように、名前付きのパラメータと位置パラメータを持つことができます。 HibernateにおけるネイティブなSQLクエリの詳細については、 <xref linkend=\"querysql\"/> を参照してください。" +"SQL queries may contain named and positional parameters, just like Hibernate " +"queries. More information about native SQL queries in Hibernate can be found " +"in <xref linkend=\"querysql\"/>." +msgstr "" +"SQLクエリは、Hibernateクエリと同じように、名前付きのパラメータと位置パラメー" +"タを持つことができます。 HibernateにおけるネイティブなSQLクエリの詳細について" +"は、 <xref linkend=\"querysql\"/> を参照してください。" -#: index.docbook:470 -msgid "" - "<![CDATA[List cats = session.createSQLQuery(\n" - " \"SELECT {cat}.ID AS {cat.id}, {cat}.SEX AS {cat.sex}, \" +\n" - " \"{cat}.MATE AS {cat.mate}, {cat}.SUBCLASS AS {cat.class}, ... \" +\n" - " \"FROM CAT {cat} WHERE ROWNUM<10\")\n" - " .addEntity(\"cat\", Cat.class)\n" - ".list()]]>" +#. Tag: title +#: session_api.xml:483 +#, no-c-format +msgid "Modifying persistent objects" msgstr "永続オブジェクトの修正" -#: index.docbook:472 -msgid "SQL queries may contain named and positional parameters, just like Hibernate queries. More information about native SQL queries in Hibernate can be found in <xref linkend=\"querysql\"/>." -msgstr "<emphasis>処理中の永続インスタンス</emphasis> （例： <literal>Session</literal> によって、 ロード、セーブ、作成、クエリされたオブジェクト）は、アプリケーションに操作されます。 その際に変更された永続状態は、 <literal>Session</literal> が <emphasis>フラッシュ</emphasis> されるときに、永続化されます（これは、この章の後半で述べています）。 変更を永続化するために、特殊なメソッド（ <literal>update()</literal> のようなもの。これは、別の目的で使用します）を 呼ぶ必要はありません。 オブジェクトの状態を更新する一番簡単な方法は、オブジェクトを <literal>load()</literal> し、 <literal>Session</literal> をオープンにしている間に、直接操作することです。" +#. Tag: para +#: session_api.xml:485 +#, no-c-format +msgid "" +"<emphasis>Transactional persistent instances</emphasis> (ie. objects loaded, " +"saved, created or queried by the <literal>Session</literal>) may be " +"manipulated by the application and any changes to persistent state will be " +"persisted when the <literal>Session</literal> is <emphasis>flushed</" +"emphasis> (discussed later in this chapter). There is no need to call a " +"particular method (like <literal>update()</literal>, which has a different " +"purpose) to make your modifications persistent. So the most straightforward " +"way to update the state of an object is to <literal>load()</literal> it, and " +"then manipulate it directly, while the <literal>Session</literal> is open:" +msgstr "" +"<emphasis>処理中の永続インスタンス</emphasis> （例： <literal>Session</" +"literal> によって、 ロード、セーブ、作成、クエリされたオブジェクト）は、アプ" +"リケーションに操作されます。 その際に変更された永続状態は、 " +"<literal>Session</literal> が <emphasis>フラッシュ</emphasis> されるときに、" +"永続化されます（これは、この章の後半で述べています）。 変更を永続化するため" +"に、特殊なメソッド（ <literal>update()</literal> のようなもの。これは、別の目" +"的で使用します）を 呼ぶ必要はありません。 オブジェクトの状態を更新する一番簡" +"単な方法は、オブジェクトを <literal>load()</literal> し、 <literal>Session</" +"literal> をオープンにしている間に、直接操作することです。" -#: index.docbook:483 -msgid "Modifying persistent objects" +#. Tag: programlisting +#: session_api.xml:496 +#, no-c-format +msgid "" +"<![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long" +"(69) );\n" +"cat.setName(\"PK\");\n" +"sess.flush(); // changes to cat are automatically detected and persisted]]>" msgstr "" - "<![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) ); -\n" - "cat.setName(\"PK\"); -\n" - "sess.flush(); // changes to cat are automatically detected and persisted -\n" - "]]>" -#: index.docbook:485 -msgid "<emphasis>Transactional persistent instances</emphasis> (ie. objects loaded, saved, created or queried by the <literal>Session</literal>) may be manipulated by the application and any changes to persistent state will be persisted when the <literal>Session</literal> is <emphasis>flushed</emphasis> (discussed later in this chapter). There is no need to call a particular method (like <literal>update()</literal>, which has a different purpose) to make your modifications persistent. So the most straightforward way to update the state of an object is to <literal>load()</literal> it, and then manipulate it directly, while the <literal>Session</literal> is open:" -msgstr "（オブジェクトをロードするための）SQLの <literal>SELECT</literal> と（更新された状態を永続化するための） SQLの <literal>UPDATE</literal> が同じセッションで必要となるので、このプログラミングモデルは、 効率が悪くなる場合があります。 そのため、Hibernateは別の方法を用意しています。それは、インスタンスを分離する（detached）方法です。" +#. Tag: para +#: session_api.xml:498 +#, no-c-format +msgid "" +"Sometimes this programming model is inefficient since it would require both " +"an SQL <literal>SELECT</literal> (to load an object) and an SQL " +"<literal>UPDATE</literal> (to persist its updated state) in the same " +"session. Therefore Hibernate offers an alternate approach, using detached " +"instances." +msgstr "" +"（オブジェクトをロードするための）SQLの <literal>SELECT</literal> と（更新さ" +"れた状態を永続化するための） SQLの <literal>UPDATE</literal> が同じセッション" +"で必要となるので、このプログラミングモデルは、 効率が悪くなる場合がありま" +"す。 そのため、Hibernateは別の方法を用意しています。それは、インスタンスを分" +"離する（detached）方法です。" -#: index.docbook:496 +#. Tag: emphasis +#: session_api.xml:506 +#, fuzzy, no-c-format msgid "" - "<![CDATA[DomesticCat cat = (DomesticCat) sess.load( Cat.class, new Long(69) );\n" - "cat.setName(\"PK\");\n" - "sess.flush(); // changes to cat are automatically detected and persisted]]>" -msgstr "Hibernateは、 <literal>UPDATE</literal> 文や <literal>DELETE</literal> 文を直接実行するAPIを用意していません。 Hibernateは、 <emphasis>状態管理</emphasis> サービスであり、使われるSQL <emphasis>文</emphasis> のことを開発者が考える必要はありません。 JDBCはSQL文を実行する完璧なAPIであり、 <literal>session.connection()</literal> を呼ぶことで いつでも、JDBC <literal>Connection</literal> を開発者は取得できます。 さらに、大量のデータ操作の考え方は、オンライントランザクション処理向きアプリケーションの オブジェクト/リレーショナルマッピングと衝突します。 しかし、Hibernateの今後のバージョンでは、大量データを処理する特別な機能を提供するかもしれません。 バッチ操作に利用できるいくつかの工夫については、 <xref linkend=\"batch\"/> を参照してくだ! さい。" +"Note that Hibernate does not offer its own API for direct execution of " +"<literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate " +"is a <emphasis>state management</emphasis> service, you don't have to think " +"in <emphasis>statements</emphasis> to use it. JDBC is a perfect API for " +"executing SQL statements, you can get a JDBC <literal>Connection</literal> " +"at any time by calling <literal>session.connection()</literal>. Furthermore, " +"the notion of mass operations conflicts with object/relational mapping for " +"online transaction processing-oriented applications. Future versions of " +"Hibernate may however provide special mass operation functions. See <xref " +"linkend=\"batch\"/> for some possible batch operation tricks." +msgstr "" +"Hibernateは、 <placeholder-1/> 文や <placeholder-2/> 文を直接実行するAPIを用" +"意していません。 Hibernateは、 <placeholder-3/> サービスであり、使われるSQL " +"<placeholder-4/> のことを開発者が考える必要はありません。 JDBCはSQL文を実行す" +"る完璧なAPIであり、 <placeholder-5/> を呼ぶことで いつでも、JDBC " +"<placeholder-6/> を開発者は取得できます。 さらに、大量のデータ操作の考え方" +"は、オンライントランザクション処理向きアプリケーションの オブジェクト/リレー" +"ショナルマッピングと衝突します。 しかし、Hibernateの今後のバージョンでは、大" +"量データを処理する特別な機能を提供するかもしれません。 バッチ操作に利用できる" +"いくつかの工夫については、 <xref linkend=\"batch\"/> を参照してください。" -#: index.docbook:498 -msgid "Sometimes this programming model is inefficient since it would require both an SQL <literal>SELECT</literal> (to load an object) and an SQL <literal>UPDATE</literal> (to persist its updated state) in the same session. Therefore Hibernate offers an alternate approach, using detached instances." +#. Tag: title +#: session_api.xml:521 +#, no-c-format +msgid "Modifying detached objects" msgstr "分離オブジェクトの修正" -#: index.docbook:506 -msgid "Note that Hibernate does not offer its own API for direct execution of <literal>UPDATE</literal> or <literal>DELETE</literal> statements. Hibernate is a <emphasis>state management</emphasis> service, you don't have to think in <emphasis>statements</emphasis> to use it. JDBC is a perfect API for executing SQL statements, you can get a JDBC <literal>Connection</literal> at any time by calling <literal>session.connection()</literal>. Furthermore, the notion of mass operations conflicts with object/relational mapping for online transaction processing-oriented applications. Future versions of Hibernate may however provide special mass operation functions. See <xref linkend=\"batch\"/> for some possible batch operation tricks." -msgstr "多くのアプリケーションでは次のことが必要になります。 それは、あるトランザクションでオブジェクトを復元し、操作するためにそれをUI層に送り、 その後に、新しいトランザクションで変更をセーブするといったことです。 並行性の高い環境で、このタイプのアプローチを使うアプリケーションでは、 \"期間の長い\" 作業単位の隔離性を保証するために、バージョンデータが通常使われます。" +#. Tag: para +#: session_api.xml:523 +#, no-c-format +msgid "" +"Many applications need to retrieve an object in one transaction, send it to " +"the UI layer for manipulation, then save the changes in a new transaction. " +"Applications that use this kind of approach in a high-concurrency " +"environment usually use versioned data to ensure isolation for the \"long\" " +"unit of work." +msgstr "" +"多くのアプリケーションでは次のことが必要になります。 それは、あるトランザク" +"ションでオブジェクトを復元し、操作するためにそれをUI層に送り、 その後に、新し" +"いトランザクションで変更をセーブするといったことです。 並行性の高い環境で、こ" +"のタイプのアプローチを使うアプリケーションでは、 \"期間の長い\" 作業単位の隔" +"離性を保証するために、バージョンデータが通常使われます。" -#: index.docbook:521 -msgid "Modifying detached objects" -msgstr "Hibernateは、 <literal>Session.update()</literal> や <literal>Session.merge()</literal> メソッドを 使って、分離インスタンスを再追加することで、このモデルに対応します。" +#. Tag: para +#: session_api.xml:530 +#, no-c-format +msgid "" +"Hibernate supports this model by providing for reattachment of detached " +"instances using the <literal>Session.update()</literal> or <literal>Session." +"merge()</literal> methods:" +msgstr "" +"Hibernateは、 <literal>Session.update()</literal> や <literal>Session.merge()" +"</literal> メソッドを 使って、分離インスタンスを再追加することで、このモデル" +"に対応します。" -#: index.docbook:523 -msgid "Many applications need to retrieve an object in one transaction, send it to the UI layer for manipulation, then save the changes in a new transaction. Applications that use this kind of approach in a high-concurrency environment usually use versioned data to ensure isolation for the \"long\" unit of work." +#. Tag: programlisting +#: session_api.xml:536 +#, no-c-format +msgid "" +"<![CDATA[// in the first session\n" +"Cat cat = (Cat) firstSession.load(Cat.class, catId);\n" +"Cat potentialMate = new Cat();\n" +"firstSession.save(potentialMate);\n" +"\n" +"// in a higher layer of the application\n" +"cat.setMate(potentialMate);\n" +"\n" +"// later, in a new session\n" +"secondSession.update(cat); // update cat\n" +"secondSession.update(mate); // update mate]]>" msgstr "" - "<![CDATA[// in the first session -\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catId); -\n" - "Cat potentialMate = new Cat(); -\n" - "firstSession.save(potentialMate); -\n" - " -\n" - "// in a higher layer of the application -\n" - "cat.setMate(potentialMate); -\n" - " -\n" - "// later, in a new session -\n" - "secondSession.update(cat); // update cat -\n" - "secondSession.update(mate); // update mate]]>" -#: index.docbook:530 -msgid "Hibernate supports this model by providing for reattachment of detached instances using the <literal>Session.update()</literal> or <literal>Session.merge()</literal> methods:" -msgstr "識別子<literal>catId</literal> を持つ <literal>Cat</literal> が、既に <literal>secondSession</literal> でロードされていた場合は、再追加しようとしたときに、例外が投げられます。" +#. Tag: para +#: session_api.xml:538 +#, no-c-format +msgid "" +"If the <literal>Cat</literal> with identifier <literal>catId</literal> had " +"already been loaded by <literal>secondSession</literal> when the application " +"tried to reattach it, an exception would have been thrown." +msgstr "" +"識別子<literal>catId</literal> を持つ <literal>Cat</literal> が、既に " +"<literal>secondSession</literal> でロードされていた場合は、再追加しようとした" +"ときに、例外が投げられます。" -#: index.docbook:536 +#. Tag: para +#: session_api.xml:544 +#, no-c-format msgid "" - "<![CDATA[// in the first session\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catId);\n" - "Cat potentialMate = new Cat();\n" - "firstSession.save(potentialMate);\n" - "\n" - "// in a higher layer of the application\n" - "cat.setMate(potentialMate);\n" - "\n" - "// later, in a new session\n" - "secondSession.update(cat); // update cat\n" - "secondSession.update(mate); // update mate]]>" -msgstr "同じ識別子を持つ永続インスタンスをセッションが既に保持していないことを 確信できるなら <literal>update()</literal> を使いましょう。 そして、セッションの状態を考えずに、どんな場合でも変更をマージしたい場合は、 <literal>merge()</literal> を使いましょう。 すなわち、分離オブジェクトの再追加操作が、最初に実行されることを確実にするために、 通常は <literal>update()</literal> が新しいセッションのなかで最初に呼ばれるメソッドになります。" +"Use <literal>update()</literal> if you are sure that the session does not " +"contain an already persistent instance with the same identifier, and " +"<literal>merge()</literal> if you want to merge your modifications at any " +"time without consideration of the state of the session. In other words, " +"<literal>update()</literal> is usually the first method you would call in a " +"fresh session, ensuring that reattachment of your detached instances is the " +"first operation that is executed." +msgstr "" +"同じ識別子を持つ永続インスタンスをセッションが既に保持していないことを 確信で" +"きるなら <literal>update()</literal> を使いましょう。 そして、セッションの状" +"態を考えずに、どんな場合でも変更をマージしたい場合は、 <literal>merge()</" +"literal> を使いましょう。 すなわち、分離オブジェクトの再追加操作が、最初に実" +"行されることを確実にするために、 通常は <literal>update()</literal> が新しい" +"セッションのなかで最初に呼ばれるメソッドになります。" -#: index.docbook:538 -msgid "If the <literal>Cat</literal> with identifier <literal>catId</literal> had already been loaded by <literal>secondSession</literal> when the application tried to reattach it, an exception would have been thrown." -msgstr "分離インスタンスから到達可能な、分離インスタンスをアプリケーションは個別に <literal>update()</literal> すべきです。それは、その状態を更新したい場合に <emphasis>限り</emphasis> ます。 <emphasis>遷移的な永続化</emphasis> を使えば、もちろん自動化できます。 <xref linkend=\"objectstate-transitive\"/> を参照してください。" +#. Tag: para +#: session_api.xml:553 +#, no-c-format +msgid "" +"The application should individually <literal>update()</literal> detached " +"instances reachable from the given detached instance if and <emphasis>only</" +"emphasis> if it wants their state also updated. This can be automated of " +"course, using <emphasis>transitive persistence</emphasis>, see <xref linkend=" +"\"objectstate-transitive\"/>." +msgstr "" +"分離インスタンスから到達可能な、分離インスタンスをアプリケーションは個別に " +"<literal>update()</literal> すべきです。それは、その状態を更新したい場合に " +"<emphasis>限り</emphasis> ます。 <emphasis>遷移的な永続化</emphasis> を使え" +"ば、もちろん自動化できます。 <xref linkend=\"objectstate-transitive\"/> を参" +"照してください。" -#: index.docbook:544 -msgid "Use <literal>update()</literal> if you are sure that the session does not contain an already persistent instance with the same identifier, and <literal>merge()</literal> if you want to merge your modifications at any time without consideration of the state of the session. In other words, <literal>update()</literal> is usually the first method you would call in a fresh session, ensuring that reattachment of your detached instances is the first operation that is executed." -msgstr "メソッドでもまた、新しいセッションにオブジェクトを再関連付けできます。 しかし、分離インスタンスは無修正でなければなりません。" +#. Tag: para +#: session_api.xml:560 +#, no-c-format +msgid "" +"The <literal>lock()</literal> method also allows an application to " +"reassociate an object with a new session. However, the detached instance has " +"to be unmodified!" +msgstr "" +"メソッドでもまた、新しいセッションにオブジェクトを再関連付けできます。 しか" +"し、分離インスタンスは無修正でなければなりません。" -#: index.docbook:553 -msgid "The application should individually <literal>update()</literal> detached instances reachable from the given detached instance if and <emphasis>only</emphasis> if it wants their state also updated. This can be automated of course, using <emphasis>transitive persistence</emphasis>, see <xref linkend=\"objectstate-transitive\"/>." +#. Tag: programlisting +#: session_api.xml:565 +#, no-c-format +msgid "" +"<![CDATA[//just reassociate:\n" +"sess.lock(fritz, LockMode.NONE);\n" +"//do a version check, then reassociate:\n" +"sess.lock(izi, LockMode.READ);\n" +"//do a version check, using SELECT ... FOR UPDATE, then reassociate:\n" +"sess.lock(pk, LockMode.UPGRADE);]]>" msgstr "" - "<![CDATA[//just reassociate: -\n" - "sess.lock(fritz, LockMode.NONE); -\n" - "//do a version check, then reassociate: -\n" - "sess.lock(izi, LockMode.READ); -\n" - "//do a version check, using SELECT ... FOR UPDATE, then reassociate: -\n" - "sess.lock(pk, LockMode.UPGRADE);]]>" -#: index.docbook:560 -msgid "The <literal>lock()</literal> method also allows an application to reassociate an object with a new session. However, the detached instance has to be unmodified!" -msgstr "<literal>lock()</literal> は、さまざまな <literal>LockMode</literal> とともに使うことができます。 詳細は、APIドキュメントとトランザクション処理の章を参照してください。 再追加のときにだけ、 <literal>lock()</literal> が使われるわけではありません。" +#. Tag: para +#: session_api.xml:567 +#, no-c-format +msgid "" +"Note that <literal>lock()</literal> can be used with various " +"<literal>LockMode</literal>s, see the API documentation and the chapter on " +"transaction handling for more information. Reattachment is not the only " +"usecase for <literal>lock()</literal>." +msgstr "" +"<literal>lock()</literal> は、さまざまな <literal>LockMode</literal> とともに" +"使うことができます。 詳細は、APIドキュメントとトランザクション処理の章を参照" +"してください。 再追加のときにだけ、 <literal>lock()</literal> が使われるわけ" +"ではありません。" -#: index.docbook:565 +#. Tag: para +#: session_api.xml:574 +#, no-c-format msgid "" - "<![CDATA[//just reassociate:\n" - "sess.lock(fritz, LockMode.NONE);\n" - "//do a version check, then reassociate:\n" - "sess.lock(izi, LockMode.READ);\n" - "//do a version check, using SELECT ... FOR UPDATE, then reassociate:\n" - "sess.lock(pk, LockMode.UPGRADE);]]>" -msgstr "期間の長い作業単位の、その他のモデルは、<xref linked=\"transactions-optimistic\"/> で述べています。" +"Other models for long units of work are discussed in <xref linkend=" +"\"transactions-optimistic\"/>." +msgstr "" +"期間の長い作業単位の、その他のモデルは、<xref linked=\"transactions-" +"optimistic\"/> で述べています。" -#: index.docbook:567 -msgid "Note that <literal>lock()</literal> can be used with various <literal>LockMode</literal>s, see the API documentation and the chapter on transaction handling for more information. Reattachment is not the only usecase for <literal>lock()</literal>." +#. Tag: title +#: session_api.xml:581 +#, no-c-format +msgid "Automatic state detection" msgstr "自動的な状態検出" -#: index.docbook:574 -msgid "Other models for long units of work are discussed in <xref linkend=\"transactions-optimistic\"/>." -msgstr "Hibernateのユーザは次の2つのケースのどちらにも使える汎用的なメソッドを要求していました。 それは、新しい識別子を生成して一時的なインスタンスをセーブすることと、 その時点の識別子と関連づいている分離インスタンスを更新/再追加することのできるメソッドです。 <literal>saveOrUpdate()</literal> はこのような機能を実現したメソッドです。" +#. Tag: para +#: session_api.xml:583 +#, no-c-format +msgid "" +"Hibernate users have requested a general purpose method that either saves a " +"transient instance by generating a new identifier or updates/reattaches the " +"detached instances associated with its current identifier. The " +"<literal>saveOrUpdate()</literal> method implements this functionality." +msgstr "" +"Hibernateのユーザは次の2つのケースのどちらにも使える汎用的なメソッドを要求し" +"ていました。 それは、新しい識別子を生成して一時的なインスタンスをセーブするこ" +"とと、 その時点の識別子と関連づいている分離インスタンスを更新/再追加すること" +"のできるメソッドです。 <literal>saveOrUpdate()</literal> はこのような機能を実" +"現したメソッドです。" -#: index.docbook:581 -msgid "Automatic state detection" +#. Tag: programlisting +#: session_api.xml:590 +#, no-c-format +msgid "" +"<![CDATA[// in the first session\n" +"Cat cat = (Cat) firstSession.load(Cat.class, catID);\n" +"\n" +"// in a higher tier of the application\n" +"Cat mate = new Cat();\n" +"cat.setMate(mate);\n" +"\n" +"// later, in a new session\n" +"secondSession.saveOrUpdate(cat); // update existing state (cat has a non-" +"null id)\n" +"secondSession.saveOrUpdate(mate); // save the new instance (mate has a null " +"id)]]>" msgstr "" - "<![CDATA[// in the first session -\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catID); -\n" - " -\n" - "// in a higher tier of the application -\n" - "Cat mate = new Cat(); -\n" - "cat.setMate(mate); -\n" - " -\n" - "// later, in a new session -\n" - "secondSession.saveOrUpdate(cat); // update existing state (cat has a non-null id) -\n" - "secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)]]>" -#: index.docbook:583 -msgid "Hibernate users have requested a general purpose method that either saves a transient instance by generating a new identifier or updates/reattaches the detached instances associated with its current identifier. The <literal>saveOrUpdate()</literal> method implements this functionality." -msgstr "<literal>saveOrUpdate()</literal> の使用方法と意味は、 新しいユーザにとって混乱を招くかもしれません。 まず第一に、あるセッションで使用したインスタンスを別の新しいセッションで使おうとしない限り、 <literal>update()</literal> や <literal>saveOrUpdate()</literal> や <literal>merge()</literal> を使う必要はありません。 アプリケーション全体を通じて、これらのメソッドを全く使わないこともあります。" +#. Tag: para +#: session_api.xml:592 +#, no-c-format +msgid "" +"The usage and semantics of <literal>saveOrUpdate()</literal> seems to be " +"confusing for new users. Firstly, so long as you are not trying to use " +"instances from one session in another new session, you should not need to " +"use <literal>update()</literal>, <literal>saveOrUpdate()</literal>, or " +"<literal>merge()</literal>. Some whole applications will never use either of " +"these methods." +msgstr "" +"<literal>saveOrUpdate()</literal> の使用方法と意味は、 新しいユーザにとって混" +"乱を招くかもしれません。 まず第一に、あるセッションで使用したインスタンスを別" +"の新しいセッションで使おうとしない限り、 <literal>update()</literal> や " +"<literal>saveOrUpdate()</literal> や <literal>merge()</literal> を使う必要は" +"ありません。 アプリケーション全体を通じて、これらのメソッドを全く使わないこと" +"もあります。" -#: index.docbook:590 +#. Tag: para +#: session_api.xml:600 +#, no-c-format msgid "" - "<![CDATA[// in the first session\n" - "Cat cat = (Cat) firstSession.load(Cat.class, catID);\n" - "\n" - "// in a higher tier of the application\n" - "Cat mate = new Cat();\n" - "cat.setMate(mate);\n" - "\n" - "// later, in a new session\n" - "secondSession.saveOrUpdate(cat); // update existing state (cat has a non-null id)\n" - "secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)]]>" -msgstr "通常、 <literal>update()</literal> や <literal>saveOrUpdate()</literal> は次のシナリオで 使われます。" +"Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are " +"used in the following scenario:" +msgstr "" +"通常、 <literal>update()</literal> や <literal>saveOrUpdate()</literal> は次" +"のシナリオで 使われます。" -#: index.docbook:592 -msgid "The usage and semantics of <literal>saveOrUpdate()</literal> seems to be confusing for new users. Firstly, so long as you are not trying to use instances from one session in another new session, you should not need to use <literal>update()</literal>, <literal>saveOrUpdate()</literal>, or <literal>merge()</literal>. Some whole applications will never use either of these methods." +#. Tag: para +#: session_api.xml:607 +#, no-c-format +msgid "the application loads an object in the first session" msgstr "アプリケーションが最初のセッションでオブジェクトをロードします。" -#: index.docbook:600 -msgid "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are used in the following scenario:" +#. Tag: para +#: session_api.xml:612 +#, no-c-format +msgid "the object is passed up to the UI tier" msgstr "オブジェクトがUI層に送られます。" -#: index.docbook:607 -msgid "the application loads an object in the first session" +#. Tag: para +#: session_api.xml:617 +#, no-c-format +msgid "some modifications are made to the object" msgstr "オブジェクトに対して変更が加えられます。" -#: index.docbook:612 -msgid "the object is passed up to the UI tier" +#. Tag: para +#: session_api.xml:622 +#, no-c-format +msgid "the object is passed back down to the business logic tier" msgstr "オブジェクトがビジネスロジック層に送られます。" -#: index.docbook:617 -msgid "some modifications are made to the object" -msgstr "アプリケーションは、2番目のセッションで <literal>update()</literal> を呼ぶことで、これらの変更を永続化します。" +#. Tag: para +#: session_api.xml:627 +#, no-c-format +msgid "" +"the application persists these modifications by calling <literal>update()</" +"literal> in a second session" +msgstr "" +"アプリケーションは、2番目のセッションで <literal>update()</literal> を呼ぶこ" +"とで、これらの変更を永続化します。" -#: index.docbook:622 -msgid "the object is passed back down to the business logic tier" +#. Tag: para +#: session_api.xml:634 +#, no-c-format +msgid "<literal>saveOrUpdate()</literal> does the following:" msgstr "<literal>saveOrUpdate()</literal> は以下のことを行います。" -#: index.docbook:627 -msgid "the application persists these modifications by calling <literal>update()</literal> in a second session" -msgstr "オブジェクトがこのセッションで、すでに永続化されていれば、何もしません。" - -#: index.docbook:634 -msgid "<literal>saveOrUpdate()</literal> does the following:" -msgstr "そのセッションに関連づいている別のオブジェクトが同じ識別子を持っているなら、 例外を投げます。" - -#: index.docbook:640 +#. Tag: para +#: session_api.xml:640 +#, no-c-format msgid "if the object is already persistent in this session, do nothing" -msgstr "オブジェクトの識別子が値を持たないならば、 <literal>save()</literal> します。" +msgstr "" +"オブジェクトがこのセッションで、すでに永続化されていれば、何もしません。" -#: index.docbook:645 -msgid "if another object associated with the session has the same identifier, throw an exception" -msgstr "オブジェクトの識別子が値を持ち、その値が新たにインスタンス化されたオブジェクトのための値である場合、 そのオブジェクトを <literal>save()</literal> します。" +#. Tag: para +#: session_api.xml:645 +#, no-c-format +msgid "" +"if another object associated with the session has the same identifier, throw " +"an exception" +msgstr "" +"そのセッションに関連づいている別のオブジェクトが同じ識別子を持っているなら、 " +"例外を投げます。" -#: index.docbook:651 +#. Tag: para +#: session_api.xml:651 +#, no-c-format msgid "if the object has no identifier property, <literal>save()</literal> it" -msgstr "オブジェクトが（ <literal>&lt;version&gt;</literal> や <literal>&lt;timestamp&gt;</literal> によって） バージョンづけされていて、バージョンのプロパティが値を持ち、 その値が新しくインスタンス化されたオブジェクトのための値である場合、 そのオブジェクトを <literal>save()</literal> します。" +msgstr "" +"オブジェクトの識別子が値を持たないならば、 <literal>save()</literal> します。" -#: index.docbook:656 -msgid "if the object's identifier has the value assigned to a newly instantiated object, <literal>save()</literal> it" -msgstr "そうでない場合は、そのオブジェクトを <literal>update()</literal> します。" +#. Tag: para +#: session_api.xml:656 +#, no-c-format +msgid "" +"if the object's identifier has the value assigned to a newly instantiated " +"object, <literal>save()</literal> it" +msgstr "" +"オブジェクトの識別子が値を持ち、その値が新たにインスタンス化されたオブジェク" +"トのための値である場合、 そのオブジェクトを <literal>save()</literal> しま" +"す。" -#: index.docbook:662 -msgid "if the object is versioned (by a <literal>&lt;version&gt;</literal> or <literal>&lt;timestamp&gt;</literal>), and the version property value is the same value assigned to a newly instantiated object, <literal>save()</literal> it" -msgstr "そして、 <literal>merge()</literal> は以下のようにとても異なります。" +#. Tag: para +#: session_api.xml:662 +#, no-c-format +msgid "" +"if the object is versioned (by a <literal>&lt;version&gt;</literal> or " +"<literal>&lt;timestamp&gt;</literal>), and the version property value is the " +"same value assigned to a newly instantiated object, <literal>save()</" +"literal> it" +msgstr "" +"オブジェクトが（ <literal>&lt;version&gt;</literal> や <literal>&lt;" +"timestamp&gt;</literal> によって） バージョンづけされていて、バージョンのプロ" +"パティが値を持ち、 その値が新しくインスタンス化されたオブジェクトのための値で" +"ある場合、 そのオブジェクトを <literal>save()</literal> します。" -#: index.docbook:670 +#. Tag: para +#: session_api.xml:670 +#, no-c-format msgid "otherwise <literal>update()</literal> the object" -msgstr "同じ識別子を持つ永続化インスタンスがその時点でセッションと関連付いているならば、 引数で受け取ったオブジェクトの状態を永続化インスタンスにコピーします。" +msgstr "" +"そうでない場合は、そのオブジェクトを <literal>update()</literal> します。" -#: index.docbook:676 +#. Tag: para +#: session_api.xml:676 +#, no-c-format msgid "and <literal>merge()</literal> is very different:" -msgstr "永続化インスタンスがその時点でセッションに関連付いていないなら、 データベースからそれをロードするか、あるいは、新しい永続化インスタンスを作成します。" +msgstr "そして、 <literal>merge()</literal> は以下のようにとても異なります。" -#: index.docbook:682 -msgid "if there is a persistent instance with the same identifier currently associated with the session, copy the state of the given object onto the persistent instance" -msgstr "永続化インスタンスが返されます。" +#. Tag: para +#: session_api.xml:682 +#, no-c-format +msgid "" +"if there is a persistent instance with the same identifier currently " +"associated with the session, copy the state of the given object onto the " +"persistent instance" +msgstr "" +"同じ識別子を持つ永続化インスタンスがその時点でセッションと関連付いているなら" +"ば、 引数で受け取ったオブジェクトの状態を永続化インスタンスにコピーします。" -#: index.docbook:689 -msgid "if there is no persistent instance currently associated with the session, try to load it from the database, or create a new persistent instance" -msgstr "引数として与えたインスタンスはセッションと関連を持ちません。 それは、分離状態のままです。" +#. Tag: para +#: session_api.xml:689 +#, no-c-format +msgid "" +"if there is no persistent instance currently associated with the session, " +"try to load it from the database, or create a new persistent instance" +msgstr "" +"永続化インスタンスがその時点でセッションに関連付いていないなら、 データベース" +"からそれをロードするか、あるいは、新しい永続化インスタンスを作成します。" -#: index.docbook:695 +#. Tag: para +#: session_api.xml:695 +#, no-c-format msgid "the persistent instance is returned" -msgstr "永続オブジェクトの削除" +msgstr "永続化インスタンスが返されます。" -#: index.docbook:700 -msgid "the given instance does not become associated with the session, it remains detached" -msgstr "<literal>Session.delete()</literal> はオブジェクトの状態をデータベースから削除します。 もちろん、削除したオブジェクトをアプリケーションが保持したままでもよいです。 そのため、 <literal>delete()</literal> は永続インスタンスを一時的にするものと考えるのが一番です。" +#. Tag: para +#: session_api.xml:700 +#, no-c-format +msgid "" +"the given instance does not become associated with the session, it remains " +"detached" +msgstr "" +"引数として与えたインスタンスはセッションと関連を持ちません。 それは、分離状態" +"のままです。" -#: index.docbook:710 +#. Tag: title +#: session_api.xml:710 +#, no-c-format msgid "Deleting persistent objects" -msgstr "<![CDATA[sess.delete(cat);]]>" +msgstr "永続オブジェクトの削除" -#: index.docbook:712 -msgid "<literal>Session.delete()</literal> will remove an object's state from the database. Of course, your application might still hold a reference to a deleted object. It's best to think of <literal>delete()</literal> as making a persistent instance transient." -msgstr "外部キー制約に違反するリスクもなく、好きな順番でオブジェクトを削除することができます。 ただし、間違った順番でオブジェクトを削除すると、外部キーカラムの <literal>NOT NULL</literal> 制約に違反する可能性があります。 例えば、親オブジェクトを削除したときに、子供オブジェクトを削除し忘れた場合です。" +#. Tag: para +#: session_api.xml:712 +#, no-c-format +msgid "" +"<literal>Session.delete()</literal> will remove an object's state from the " +"database. Of course, your application might still hold a reference to a " +"deleted object. It's best to think of <literal>delete()</literal> as making " +"a persistent instance transient." +msgstr "" +"<literal>Session.delete()</literal> はオブジェクトの状態をデータベースから削" +"除します。 もちろん、削除したオブジェクトをアプリケーションが保持したままでも" +"よいです。 そのため、 <literal>delete()</literal> は永続インスタンスを一時的" +"にするものと考えるのが一番です。" -#: index.docbook:719 +#. Tag: programlisting +#: session_api.xml:719 +#, no-c-format msgid "<![CDATA[sess.delete(cat);]]>" -msgstr "異なる二つのデータストア間でのオブジェクトのレプリケーション" +msgstr "" -#: index.docbook:721 -msgid "You may delete objects in any order you like, without risk of foreign key constraint violations. It is still possible to violate a <literal>NOT NULL</literal> constraint on a foreign key column by deleting objects in the wrong order, e.g. if you delete the parent, but forget to delete the children." -msgstr "永続インスタンスのグラフを別のデータストアに永続化する場合に、 識別子の値を再生成せずにすむと便利な場合があります。" +#. Tag: para +#: session_api.xml:721 +#, no-c-format +msgid "" +"You may delete objects in any order you like, without risk of foreign key " +"constraint violations. It is still possible to violate a <literal>NOT NULL</" +"literal> constraint on a foreign key column by deleting objects in the wrong " +"order, e.g. if you delete the parent, but forget to delete the children." +msgstr "" +"外部キー制約に違反するリスクもなく、好きな順番でオブジェクトを削除することが" +"できます。 ただし、間違った順番でオブジェクトを削除すると、外部キーカラムの " +"<literal>NOT NULL</literal> 制約に違反する可能性があります。 例えば、親オブ" +"ジェクトを削除したときに、子供オブジェクトを削除し忘れた場合です。" -#: index.docbook:732 +#. Tag: title +#: session_api.xml:732 +#, no-c-format msgid "Replicating object between two different datastores" +msgstr "異なる二つのデータストア間でのオブジェクトのレプリケーション" + +#. Tag: para +#: session_api.xml:734 +#, no-c-format +msgid "" +"It is occasionally useful to be able to take a graph of persistent instances " +"and make them persistent in a different datastore, without regenerating " +"identifier values." msgstr "" - "<![CDATA[//retrieve a cat from one database -\n" - "Session session1 = factory1.openSession(); -\n" - "Transaction tx1 = session1.beginTransaction(); -\n" - "Cat cat = session1.get(Cat.class, catId); -\n" - "tx1.commit(); -\n" - "session1.close(); -\n" - " -\n" - "//reconcile with a second database -\n" - "Session session2 = factory2.openSession(); -\n" - "Transaction tx2 = session2.beginTransaction(); -\n" - "session2.replicate(cat, ReplicationMode.LATEST_VERSION); -\n" - "tx2.commit(); -\n" - "session2.close();]]>" +"永続インスタンスのグラフを別のデータストアに永続化する場合に、 識別子の値を再" +"生成せずにすむと便利な場合があります。" -#: index.docbook:734 -msgid "It is occasionally useful to be able to take a graph of persistent instances and make them persistent in a different datastore, without regenerating identifier values." -msgstr "レプリケーション先のデータベースに行が既にある場合、 <literal>replicate()</literal> が衝突をどのように扱うかを <literal>ReplicationMode</literal> で指定します。" +#. Tag: programlisting +#: session_api.xml:740 +#, no-c-format +msgid "" +"<![CDATA[//retrieve a cat from one database\n" +"Session session1 = factory1.openSession();\n" +"Transaction tx1 = session1.beginTransaction();\n" +"Cat cat = session1.get(Cat.class, catId);\n" +"tx1.commit();\n" +"session1.close();\n" +"\n" +"//reconcile with a second database\n" +"Session session2 = factory2.openSession();\n" +"Transaction tx2 = session2.beginTransaction();\n" +"session2.replicate(cat, ReplicationMode.LATEST_VERSION);\n" +"tx2.commit();\n" +"session2.close();]]>" +msgstr "" -#: index.docbook:740 +#. Tag: para +#: session_api.xml:742 +#, no-c-format msgid "" - "<![CDATA[//retrieve a cat from one database\n" - "Session session1 = factory1.openSession();\n" - "Transaction tx1 = session1.beginTransaction();\n" - "Cat cat = session1.get(Cat.class, catId);\n" - "tx1.commit();\n" - "session1.close();\n" - "\n" - "//reconcile with a second database\n" - "Session session2 = factory2.openSession();\n" - "Transaction tx2 = session2.beginTransaction();\n" - "session2.replicate(cat, ReplicationMode.LATEST_VERSION);\n" - "tx2.commit();\n" - "session2.close();]]>" -msgstr "<literal>ReplicationMode.IGNORE</literal> - 同じ識別子を持つ行がデータベースに存在するなら、 そのオブジェクトを無視します。" +"The <literal>ReplicationMode</literal> determines how <literal>replicate()</" +"literal> will deal with conflicts with existing rows in the database." +msgstr "" +"レプリケーション先のデータベースに行が既にある場合、 <literal>replicate()</" +"literal> が衝突をどのように扱うかを <literal>ReplicationMode</literal> で指定" +"します。" -#: index.docbook:742 -msgid "The <literal>ReplicationMode</literal> determines how <literal>replicate()</literal> will deal with conflicts with existing rows in the database." -msgstr "<literal>ReplicationMode.OVERWRITE</literal> - 同じ識別子を持つ既存の行を すべて上書きします。" +#. Tag: para +#: session_api.xml:749 +#, no-c-format +msgid "" +"<literal>ReplicationMode.IGNORE</literal> - ignore the object when there is " +"an existing database row with the same identifier" +msgstr "" +"<literal>ReplicationMode.IGNORE</literal> - 同じ識別子を持つ行がデータベース" +"に存在するなら、 そのオブジェクトを無視します。" -#: index.docbook:749 -msgid "<literal>ReplicationMode.IGNORE</literal> - ignore the object when there is an existing database row with the same identifier" -msgstr "<literal>ReplicationMode.EXCEPTION</literal> - 同じ識別子を持つ行がデータベースに存在するなら、 例外を投げます。" +#. Tag: para +#: session_api.xml:755 +#, no-c-format +msgid "" +"<literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing " +"database row with the same identifier" +msgstr "" +"<literal>ReplicationMode.OVERWRITE</literal> - 同じ識別子を持つ既存の行を す" +"べて上書きします。" -#: index.docbook:755 -msgid "<literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing database row with the same identifier" -msgstr "<literal>ReplicationMode.LATEST_VERSION</literal> - 行に保存されているバージョン番号が、 引数のオブジェクトのバージョン番号より古いならば、その行を上書きします。" +#. Tag: para +#: session_api.xml:761 +#, no-c-format +msgid "" +"<literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there " +"is an existing database row with the same identifier" +msgstr "" +"<literal>ReplicationMode.EXCEPTION</literal> - 同じ識別子を持つ行がデータベー" +"スに存在するなら、 例外を投げます。" -#: index.docbook:761 -msgid "<literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there is an existing database row with the same identifier" -msgstr "次のようなケースで、この機能を使用します。 異なるデータベースインスタンスに入れられたデータの同期、 製品更新時におけるシステム設定情報の更新、非ACIDトランザクションのなかで加えられた変更のロールバックなどです。" +#. Tag: para +#: session_api.xml:767 +#, no-c-format +msgid "" +"<literal>ReplicationMode.LATEST_VERSION</literal> - overwrite the row if its " +"version number is earlier than the version number of the object, or ignore " +"the object otherwise" +msgstr "" +"<literal>ReplicationMode.LATEST_VERSION</literal> - 行に保存されているバー" +"ジョン番号が、 引数のオブジェクトのバージョン番号より古いならば、その行を上書" +"きします。" -#: index.docbook:767 -msgid "<literal>ReplicationMode.LATEST_VERSION</literal> - overwrite the row if its version number is earlier than the version number of the object, or ignore the object otherwise" -msgstr "セッションのフラッシュ" +#. Tag: para +#: session_api.xml:775 +#, no-c-format +msgid "" +"Usecases for this feature include reconciling data entered into different " +"database instances, upgrading system configuration information during " +"product upgrades, rolling back changes made during non-ACID transactions and " +"more." +msgstr "" +"次のようなケースで、この機能を使用します。 異なるデータベースインスタンスに入" +"れられたデータの同期、 製品更新時におけるシステム設定情報の更新、非ACIDトラン" +"ザクションのなかで加えられた変更のロールバックなどです。" -#: index.docbook:775 -msgid "Usecases for this feature include reconciling data entered into different database instances, upgrading system configuration information during product upgrades, rolling back changes made during non-ACID transactions and more." -msgstr "JDBCコネクションの状態とメモリ上のオブジェクトの状態を同期させるために必要な SQL文を <literal>Session</literal> が実行することがときどきあります。 この処理 <emphasis>flush</emphasis> は、デフォルトでは次のときに起こります。" - -#: index.docbook:784 +#. Tag: title +#: session_api.xml:784 +#, no-c-format msgid "Flushing the Session" -msgstr "クエリを実行する前" +msgstr "セッションのフラッシュ" -#: index.docbook:786 -msgid "From time to time the <literal>Session</literal> will execute the SQL statements needed to synchronize the JDBC connection's state with the state of objects held in memory. This process, <emphasis>flush</emphasis>, occurs by default at the following points" -msgstr "<literal>org.hibernate.Transaction.commit()</literal> を実行したとき" +#. Tag: para +#: session_api.xml:786 +#, no-c-format +msgid "" +"From time to time the <literal>Session</literal> will execute the SQL " +"statements needed to synchronize the JDBC connection's state with the state " +"of objects held in memory. This process, <emphasis>flush</emphasis>, occurs " +"by default at the following points" +msgstr "" +"JDBCコネクションの状態とメモリ上のオブジェクトの状態を同期させるために必要な " +"SQL文を <literal>Session</literal> が実行することがときどきあります。 この処" +"理 <emphasis>flush</emphasis> は、デフォルトでは次のときに起こります。" -#: index.docbook:795 +#. Tag: para +#: session_api.xml:795 +#, no-c-format msgid "before some query executions" -msgstr "<literal>Session.flush()</literal> を実行したとき" +msgstr "クエリを実行する前" -#: index.docbook:800 +#. Tag: para +#: session_api.xml:800 +#, no-c-format msgid "from <literal>org.hibernate.Transaction.commit()</literal>" -msgstr "SQL文は以下の順番で発行されます。" +msgstr "<literal>org.hibernate.Transaction.commit()</literal> を実行したとき" -#: index.docbook:805 +#. Tag: para +#: session_api.xml:805 +#, no-c-format msgid "from <literal>Session.flush()</literal>" -msgstr "すべてのエンティティの挿入。これは、 <literal>Session.save()</literal> を使ってセーブした オブジェクトの順に実行していきます。" +msgstr "<literal>Session.flush()</literal> を実行したとき" -#: index.docbook:811 +#. Tag: para +#: session_api.xml:811 +#, no-c-format msgid "The SQL statements are issued in the following order" -msgstr "すべてのエンティティの更新" +msgstr "SQL文は以下の順番で発行されます。" -#: index.docbook:817 -msgid "all entity insertions, in the same order the corresponding objects were saved using <literal>Session.save()</literal>" -msgstr "すべてのコレクションの削除" +#. Tag: para +#: session_api.xml:817 +#, no-c-format +msgid "" +"all entity insertions, in the same order the corresponding objects were " +"saved using <literal>Session.save()</literal>" +msgstr "" +"すべてのエンティティの挿入。これは、 <literal>Session.save()</literal> を使っ" +"てセーブした オブジェクトの順に実行していきます。" -#: index.docbook:823 +#. Tag: para +#: session_api.xml:823 +#, no-c-format msgid "all entity updates" -msgstr "すべてのコレクションの要素に対する削除、更新、挿入" +msgstr "すべてのエンティティの更新" -#: index.docbook:828 +#. Tag: para +#: session_api.xml:828 +#, no-c-format msgid "all collection deletions" -msgstr "すべてのコレクションの挿入" +msgstr "すべてのコレクションの削除" -#: index.docbook:833 +#. Tag: para +#: session_api.xml:833 +#, no-c-format msgid "all collection element deletions, updates and insertions" -msgstr "すべてのエンティティの削除。これは、<literal>Session.delete()</literal> を使って 削除したオブジェクトの順に実行していきます。" +msgstr "すべてのコレクションの要素に対する削除、更新、挿入" -#: index.docbook:838 +#. Tag: para +#: session_api.xml:838 +#, no-c-format msgid "all collection insertions" -msgstr "(１つ例外があります。 <literal>native</literal> ID 生成を使ったオブジェクトは、 それらがセーブされたときに挿入されます。）" +msgstr "すべてのコレクションの挿入" -#: index.docbook:843 -msgid "all entity deletions, in the same order the corresponding objects were deleted using <literal>Session.delete()</literal>" -msgstr "明示的に <literal>flush()</literal> するときを除いて、 <emphasis>いつ</emphasis> <literal>Session</literal> がJDBCをコールするのかについて 絶対的な保証はありません。ただし、それらが実行される <emphasis>順番</emphasis> だけは 保証されます。 また、Hibernate は、 <literal>Query.list(..)</literal> が古いデータや間違ったデータ返さないことを 保証しています。" +#. Tag: para +#: session_api.xml:843 +#, no-c-format +msgid "" +"all entity deletions, in the same order the corresponding objects were " +"deleted using <literal>Session.delete()</literal>" +msgstr "" +"すべてのエンティティの削除。これは、<literal>Session.delete()</literal> を" +"使って 削除したオブジェクトの順に実行していきます。" -#: index.docbook:850 -msgid "(An exception is that objects using <literal>native</literal> ID generation are inserted when they are saved.)" -msgstr "フラッシュが頻繁に起こらないようにデフォルトの振る舞いを変えることができます。 <literal>FlushMode</literal> クラスは3つの異なるモードを定義します。 それは、コミット時にだけフラッシュするモード （Hibernateの <literal>Transaction</literal> APIが使われる場合だけです）、 説明のあった処理順に基づいて自動でフラッシュするモード、 <literal>flush()</literal> が明示的に呼ばれない限りフラッシュしないモードの３つです。 最後のモードは、作業単位が長期間に及ぶ場合に役に立ちます ( <xref linkend=\"transactions-optimistic-longsession\"/> を参照してください)。" +#. Tag: para +#: session_api.xml:850 +#, no-c-format +msgid "" +"(An exception is that objects using <literal>native</literal> ID generation " +"are inserted when they are saved.)" +msgstr "" +"(１つ例外があります。 <literal>native</literal> ID 生成を使ったオブジェクト" +"は、 それらがセーブされたときに挿入されます。）" -#: index.docbook:855 -msgid "Except when you explicity <literal>flush()</literal>, there are absolutely no guarantees about <emphasis>when</emphasis> the <literal>Session</literal> executes the JDBC calls, only the <emphasis>order</emphasis> in which they are executed. However, Hibernate does guarantee that the <literal>Query.list(..)</literal> will never return stale data; nor will they return the wrong data." +#. Tag: para +#: session_api.xml:855 +#, no-c-format +msgid "" +"Except when you explicity <literal>flush()</literal>, there are absolutely " +"no guarantees about <emphasis>when</emphasis> the <literal>Session</literal> " +"executes the JDBC calls, only the <emphasis>order</emphasis> in which they " +"are executed. However, Hibernate does guarantee that the <literal>Query.list" +"(..)</literal> will never return stale data; nor will they return the wrong " +"data." msgstr "" - "<![CDATA[sess = sf.openSession(); -\n" - "Transaction tx = sess.beginTransaction(); -\n" - "sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state -\n" - " -\n" - "Cat izi = (Cat) sess.load(Cat.class, id); -\n" - "izi.setName(iznizi); -\n" - " -\n" - "// might return stale data -\n" - "sess.find(\"from Cat as cat left outer join cat.kittens kitten\"); -\n" - " -\n" - "// change to izi is not flushed! -\n" - "... -\n" - "tx.commit(); // flush occurs -\n" - "sess.close();]]>" +"明示的に <literal>flush()</literal> するときを除いて、 <emphasis>いつ</" +"emphasis><literal>Session</literal> がJDBCをコールするのかについて 絶対的な保" +"証はありません。ただし、それらが実行される <emphasis>順番</emphasis> だけは " +"保証されます。 また、Hibernate は、 <literal>Query.list(..)</literal> が古い" +"データや間違ったデータ返さないことを 保証しています。" -#: index.docbook:863 -msgid "It is possible to change the default behavior so that flush occurs less frequently. The <literal>FlushMode</literal> class defines three different modes: only flush at commit time (and only when the Hibernate <literal>Transaction</literal> API is used), flush automatically using the explained routine, or never flush unless <literal>flush()</literal> is called explicitly. The last mode is useful for long running units of work, where a <literal>Session</literal> is kept open and disconnected for a long time (see <xref linkend=\"transactions-optimistic-longsession\"/>)." -msgstr "フラッシュのとき、例外が発生するかもしれません。 （例えば、DML操作が制約を違反するような場合です。） 例外処理を理解するためには、Hibernateのトランザクションの振る舞いを理解する必要があるため、 <xref linkend=\"transactions\"/> で説明します。" +#. Tag: para +#: session_api.xml:863 +#, no-c-format +msgid "" +"It is possible to change the default behavior so that flush occurs less " +"frequently. The <literal>FlushMode</literal> class defines three different " +"modes: only flush at commit time (and only when the Hibernate " +"<literal>Transaction</literal> API is used), flush automatically using the " +"explained routine, or never flush unless <literal>flush()</literal> is " +"called explicitly. The last mode is useful for long running units of work, " +"where a <literal>Session</literal> is kept open and disconnected for a long " +"time (see <xref linkend=\"transactions-optimistic-longsession\"/>)." +msgstr "" +"フラッシュが頻繁に起こらないようにデフォルトの振る舞いを変えることができま" +"す。 <literal>FlushMode</literal> クラスは3つの異なるモードを定義します。 そ" +"れは、コミット時にだけフラッシュするモード （Hibernateの " +"<literal>Transaction</literal> APIが使われる場合だけです）、 説明のあった処理" +"順に基づいて自動でフラッシュするモード、 <literal>flush()</literal> が明示的" +"に呼ばれない限りフラッシュしないモードの３つです。 最後のモードは、作業単位が" +"長期間に及ぶ場合に役に立ちます ( <xref linkend=\"transactions-optimistic-" +"longsession\"/> を参照してください)。" -#: index.docbook:873 +#. Tag: programlisting +#: session_api.xml:873 +#, no-c-format msgid "" - "<![CDATA[sess = sf.openSession();\n" - "Transaction tx = sess.beginTransaction();\n" - "sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state\n" - "\n" - "Cat izi = (Cat) sess.load(Cat.class, id);\n" - "izi.setName(iznizi);\n" - "\n" - "// might return stale data\n" - "sess.find(\"from Cat as cat left outer join cat.kittens kitten\");\n" - "\n" - "// change to izi is not flushed!\n" - "...\n" - "tx.commit(); // flush occurs\n" - "sess.close();]]>" -msgstr "連鎖的な永続化" +"<![CDATA[sess = sf.openSession();\n" +"Transaction tx = sess.beginTransaction();\n" +"sess.setFlushMode(FlushMode.COMMIT); // allow queries to return stale state\n" +"\n" +"Cat izi = (Cat) sess.load(Cat.class, id);\n" +"izi.setName(iznizi);\n" +"\n" +"// might return stale data\n" +"sess.find(\"from Cat as cat left outer join cat.kittens kitten\");\n" +"\n" +"// change to izi is not flushed!\n" +"...\n" +"tx.commit(); // flush occurs\n" +"sess.close();]]>" +msgstr "" -#: index.docbook:875 -msgid "During flush, an exception might occur (e.g. if a DML operation violates a constraint). Since handling exceptions involves some understanding of Hibernate's transactional behavior, we discuss it in <xref linkend=\"transactions\"/>." -msgstr "個々のオブジェクトをセーブしたり、削除したり、再追加したりすることは かなり面倒です。特に、関連するオブジェクトを扱うような場合には際立ちます。 よくあるのは、親子関係を扱うケースです。 以下の例を考えてみましょう。" +#. Tag: para +#: session_api.xml:875 +#, no-c-format +msgid "" +"During flush, an exception might occur (e.g. if a DML operation violates a " +"constraint). Since handling exceptions involves some understanding of " +"Hibernate's transactional behavior, we discuss it in <xref linkend=" +"\"transactions\"/>." +msgstr "" +"フラッシュのとき、例外が発生するかもしれません。 （例えば、DML操作が制約を違" +"反するような場合です。） 例外処理を理解するためには、Hibernateのトランザク" +"ションの振る舞いを理解する必要があるため、 <xref linkend=\"transactions\"/> " +"で説明します。" -#: index.docbook:884 +#. Tag: title +#: session_api.xml:884 +#, no-c-format msgid "Transitive persistence" -msgstr "もし、親子関係の子が値型なら（例えば、住所や文字列のコレクション）、 それらのライフサイクルは親に依存しており、便利な状態変化の\"カスケード\"を使うために、 追加の作業は必要はありません。 親がセーブされたとき、値型の子オブジェクトも同じようにセーブされますし、 親が削除されたときは、子も削除されます。その他の操作も同じです。 コレクションから1つの子を削除するような操作でもうまくいきます。 すなわち、Hibernateはこの削除操作を検出すると、 値型のオブジェクトは参照を共有できないので、データベースからその子供を削除します。" +msgstr "連鎖的な永続化" -#: index.docbook:886 -msgid "It is quite cumbersome to save, delete, or reattach individual objects, especially if you deal with a graph of associated objects. A common case is a parent/child relationship. Consider the following example:" -msgstr "ここで、親と子が値型でなくエンティティであるとして同じシナリオを考えてみましょう。 （例えば、カテゴリーと品目の関係や親と子の猫の関係です。） エンティティは、それ自身がライフサイクルを持ち、参照の共有をサポートします。 （そのため、コレクションからエンティティを削除することは、 エンティティ自身の削除を意味しません。） また、エンティティは、デフォルトでは、関連する他のエンティティへ 状態をカスケードすることはありません。 Hibernateは <emphasis>到達可能性による永続化</emphasis> をデフォルトでは実行しません。" +#. Tag: para +#: session_api.xml:886 +#, no-c-format +msgid "" +"It is quite cumbersome to save, delete, or reattach individual objects, " +"especially if you deal with a graph of associated objects. A common case is " +"a parent/child relationship. Consider the following example:" +msgstr "" +"個々のオブジェクトをセーブしたり、削除したり、再追加したりすることは かなり面" +"倒です。特に、関連するオブジェクトを扱うような場合には際立ちます。 よくあるの" +"は、親子関係を扱うケースです。 以下の例を考えてみましょう。" -#: index.docbook:892 -msgid "If the children in a parent/child relationship would be value typed (e.g. a collection of addresses or strings), their life cycle would depend on the parent and no further action would be required for convenient \"cascading\" of state changes. When the parent is saved, the value-typed child objects are saved as well, when the parent is deleted, the children will be deleted, etc. This even works for operations such as the removal of a child from the collection; Hibernate will detect this and, since value-typed objects can't have shared references, delete the child from the database." -msgstr "HibernateのSessionの基本操作（ <literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), evict(), replicate()</literal> が含まれます）に対して、 それぞれに対応するカスケードスタイルがあります。 それぞれのカスケードスタイルには、 <literal>create, merge, save-update, delete, lock, refresh, evict, replicate</literal> という名前がついています。 もし、関連に沿ってカスケードさせたい操作があるなら、マッピングファイルにそう指定しなければなりません。 例えば、以下のようにします。" +#. Tag: para +#: session_api.xml:892 +#, no-c-format +msgid "" +"If the children in a parent/child relationship would be value typed (e.g. a " +"collection of addresses or strings), their life cycle would depend on the " +"parent and no further action would be required for convenient \"cascading\" " +"of state changes. When the parent is saved, the value-typed child objects " +"are saved as well, when the parent is deleted, the children will be deleted, " +"etc. This even works for operations such as the removal of a child from the " +"collection; Hibernate will detect this and, since value-typed objects can't " +"have shared references, delete the child from the database." +msgstr "" +"もし、親子関係の子が値型なら（例えば、住所や文字列のコレクション）、 それらの" +"ライフサイクルは親に依存しており、便利な状態変化の\"カスケード\"を使うため" +"に、 追加の作業は必要はありません。 親がセーブされたとき、値型の子オブジェク" +"トも同じようにセーブされますし、 親が削除されたときは、子も削除されます。その" +"他の操作も同じです。 コレクションから1つの子を削除するような操作でもうまくい" +"きます。 すなわち、Hibernateはこの削除操作を検出すると、 値型のオブジェクトは" +"参照を共有できないので、データベースからその子供を削除します。" -#: index.docbook:903 -msgid "Now consider the same scenario with parent and child objects being entities, not value-types (e.g. categories and items, or parent and child cats). Entities have their own life cycle, support shared references (so removing an entity from the collection does not mean it can be deleted), and there is by default no cascading of state from one entity to any other associated entities. Hibernate does not implement <emphasis>persistence by reachability</emphasis> by default." -msgstr "<![CDATA[<one-to-one name=\"person\" cascade=\"persist\"/>]]>" +#. Tag: para +#: session_api.xml:903 +#, no-c-format +msgid "" +"Now consider the same scenario with parent and child objects being entities, " +"not value-types (e.g. categories and items, or parent and child cats). " +"Entities have their own life cycle, support shared references (so removing " +"an entity from the collection does not mean it can be deleted), and there is " +"by default no cascading of state from one entity to any other associated " +"entities. Hibernate does not implement <emphasis>persistence by " +"reachability</emphasis> by default." +msgstr "" +"ここで、親と子が値型でなくエンティティであるとして同じシナリオを考えてみま" +"しょう。 （例えば、カテゴリーと品目の関係や親と子の猫の関係です。） エンティ" +"ティは、それ自身がライフサイクルを持ち、参照の共有をサポートします。 （そのた" +"め、コレクションからエンティティを削除することは、 エンティティ自身の削除を意" +"味しません。） また、エンティティは、デフォルトでは、関連する他のエンティティ" +"へ 状態をカスケードすることはありません。 Hibernateは <emphasis>到達可能性に" +"よる永続化</emphasis> をデフォルトでは実行しません。" -#: index.docbook:912 -msgid "For each basic operation of the Hibernate session - including <literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), evict(), replicate()</literal> - there is a corresponding cascade style. Respectively, the cascade styles are named <literal>create, merge, save-update, delete, lock, refresh, evict, replicate</literal>. If you want an operation to be cascaded along an association, you must indicate that in the mapping document. For example:" -msgstr "カスケードスタイルは、組み合わせることができます。" +#. Tag: para +#: session_api.xml:912 +#, no-c-format +msgid "" +"For each basic operation of the Hibernate session - including " +"<literal>persist(), merge(), saveOrUpdate(), delete(), lock(), refresh(), " +"evict(), replicate()</literal> - there is a corresponding cascade style. " +"Respectively, the cascade styles are named <literal>create, merge, save-" +"update, delete, lock, refresh, evict, replicate</literal>. If you want an " +"operation to be cascaded along an association, you must indicate that in the " +"mapping document. For example:" +msgstr "" +"HibernateのSessionの基本操作（ <literal>persist(), merge(), saveOrUpdate(), " +"delete(), lock(), refresh(), evict(), replicate()</literal> が含まれます）に" +"対して、 それぞれに対応するカスケードスタイルがあります。 それぞれのカスケー" +"ドスタイルには、 <literal>create, merge, save-update, delete, lock, refresh, " +"evict, replicate</literal> という名前がついています。 もし、関連に沿ってカス" +"ケードさせたい操作があるなら、マッピングファイルにそう指定しなければなりませ" +"ん。 例えば、以下のようにします。" -#: index.docbook:921 +#. Tag: programlisting +#: session_api.xml:921 +#, no-c-format msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist\"/>]]>" -msgstr "<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" +msgstr "" -#: index.docbook:923 +#. Tag: para +#: session_api.xml:923 +#, no-c-format msgid "Cascade styles my be combined:" -msgstr "<emphasis>すべての</emphasis> 操作を関連に沿ってカスケードするよう指定するときは、 <literal>cascade=\"all\"</literal> を使います。 デフォルトの <literal>cascade=\"none\"</literal> は、どの操作もカスケードしないことを意味します。" +msgstr "カスケードスタイルは、組み合わせることができます。" -#: index.docbook:927 -msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" -msgstr "特殊なカスケードスタイル <literal>delete-orphan</literal> は、一対多関連にだけ 適用できます。 これは、関連から削除された子供のオブジェクトに対して、 <literal>delete()</literal> 操作が適用されることを意味します。" +#. Tag: programlisting +#: session_api.xml:927 +#, no-c-format +msgid "" +"<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>" +msgstr "" -#: index.docbook:929 -msgid "You may even use <literal>cascade=\"all\"</literal> to specify that <emphasis>all</emphasis> operations should be cascaded along the association. The default <literal>cascade=\"none\"</literal> specifies that no operations are to be cascaded." -msgstr "おすすめ：" +#. Tag: para +#: session_api.xml:929 +#, no-c-format +msgid "" +"You may even use <literal>cascade=\"all\"</literal> to specify that " +"<emphasis>all</emphasis> operations should be cascaded along the " +"association. The default <literal>cascade=\"none\"</literal> specifies that " +"no operations are to be cascaded." +msgstr "" +"<emphasis>すべての</emphasis> 操作を関連に沿ってカスケードするよう指定すると" +"きは、 <literal>cascade=\"all\"</literal> を使います。 デフォルトの " +"<literal>cascade=\"none\"</literal> は、どの操作もカスケードしないことを意味" +"します。" -#: index.docbook:935 -msgid "A special cascade style, <literal>delete-orphan</literal>, applies only to one-to-many associations, and indicates that the <literal>delete()</literal> operation should be applied to any child object that is removed from the association." -msgstr "普通、 <literal>&lt;many-to-one&gt;</literal> や <literal>&lt;many-to-many&gt;</literal> 関連に対しては、 カスケードを設定する意味はありません。 <literal>&lt;one-to-one&gt;</literal> と <literal>&lt;one-to-many&gt;</literal> 関連に対しては、 カスケードが役に立つことがあります。" +#. Tag: para +#: session_api.xml:935 +#, no-c-format +msgid "" +"A special cascade style, <literal>delete-orphan</literal>, applies only to " +"one-to-many associations, and indicates that the <literal>delete()</literal> " +"operation should be applied to any child object that is removed from the " +"association." +msgstr "" +"特殊なカスケードスタイル <literal>delete-orphan</literal> は、一対多関連にだ" +"け 適用できます。 これは、関連から削除された子供のオブジェクトに対して、 " +"<literal>delete()</literal> 操作が適用されることを意味します。" -#: index.docbook:942 +#. Tag: para +#: session_api.xml:942 +#, no-c-format msgid "Recommendations:" -msgstr "子供オブジェクトの寿命が親オブジェクトの寿命に制限を受けるならば、 <literal>cascade=\"all,delete-orphan\"</literal> を指定し、 子供オブジェクトを <emphasis>ライフサイクルオブジェクト</emphasis> にします。" +msgstr "おすすめ：" -#: index.docbook:948 -msgid "It doesn't usually make sense to enable cascade on a <literal>&lt;many-to-one&gt;</literal> or <literal>&lt;many-to-many&gt;</literal> association. Cascade is often useful for <literal>&lt;one-to-one&gt;</literal> and <literal>&lt;one-to-many&gt;</literal> associations." -msgstr ". それ以外の場合は、カスケードはほとんど必要ないでしょう。 しかし、同じトランザクションのなかで親と子が一緒に動作することが多いと思い、 いくらかのコードを書く手間を省きたいのであれば、 <literal>cascade=\"persist,merge,save-update\"</literal> を使うことを考えましょう。" +#. Tag: para +#: session_api.xml:948 +#, no-c-format +msgid "" +"It doesn't usually make sense to enable cascade on a <literal>&lt;many-to-" +"one&gt;</literal> or <literal>&lt;many-to-many&gt;</literal> association. " +"Cascade is often useful for <literal>&lt;one-to-one&gt;</literal> and " +"<literal>&lt;one-to-many&gt;</literal> associations." +msgstr "" +"普通、 <literal>&lt;many-to-one&gt;</literal> や <literal>&lt;many-to-" +"many&gt;</literal> 関連に対しては、 カスケードを設定する意味はありません。 " +"<literal>&lt;one-to-one&gt;</literal> と <literal>&lt;one-to-many&gt;</" +"literal> 関連に対しては、 カスケードが役に立つことがあります。" -#: index.docbook:956 -msgid "If the child object's lifespan is bounded by the lifespan of the parent object, make it a <emphasis>life cycle object</emphasis> by specifying <literal>cascade=\"all,delete-orphan\"</literal>." -msgstr "<literal>cascade=\"all\"</literal> でマッピングした関連（単値関連やコレクション）は、 <emphasis>親子</emphasis> スタイルの関連とマークされます。 それは、親のセーブ/更新/削除が、子のセーブ/更新/削除を引き起こす関係のことです。" +#. Tag: para +#: session_api.xml:956 +#, no-c-format +msgid "" +"If the child object's lifespan is bounded by the lifespan of the parent " +"object, make it a <emphasis>life cycle object</emphasis> by specifying " +"<literal>cascade=\"all,delete-orphan\"</literal>." +msgstr "" +"子供オブジェクトの寿命が親オブジェクトの寿命に制限を受けるならば、 " +"<literal>cascade=\"all,delete-orphan\"</literal> を指定し、 子供オブジェクト" +"を <emphasis>ライフサイクルオブジェクト</emphasis> にします。" -#: index.docbook:963 -msgid "Otherwise, you might not need cascade at all. But if you think that you will often be working with the parent and children together in the same transaction, and you want to save yourself some typing, consider using <literal>cascade=\"persist,merge,save-update\"</literal>." -msgstr "さらに、永続化された親が子を単に参照しているだけで、子のセーブ/更新を引き起こします。 しかし、このメタファーは不完全です。親から参照されなくなった子は、自動的に削除 <emphasis>されません</emphasis> 。 ただし、 <literal>cascade=\"delete-orphan\"</literal> でマッピングされた <literal>&lt;one-to-many&gt;</literal> 関連を 除いてです。 親子関係のカスケード操作の正確な意味は以下のようになります。" +#. Tag: para +#: session_api.xml:963 +#, no-c-format +msgid "" +"Otherwise, you might not need cascade at all. But if you think that you will " +"often be working with the parent and children together in the same " +"transaction, and you want to save yourself some typing, consider using " +"<literal>cascade=\"persist,merge,save-update\"</literal>." +msgstr "" +". それ以外の場合は、カスケードはほとんど必要ないでしょう。 しかし、同じトラン" +"ザクションのなかで親と子が一緒に動作することが多いと思い、 いくらかのコードを" +"書く手間を省きたいのであれば、 <literal>cascade=\"persist,merge,save-update" +"\"</literal> を使うことを考えましょう。" -#: index.docbook:971 -msgid "Mapping an association (either a single valued association, or a collection) with <literal>cascade=\"all\"</literal> marks the association as a <emphasis>parent/child</emphasis> style relationship where save/update/delete of the parent results in save/update/delete of the child or children." -msgstr "親が <literal>persist()</literal> に渡されたならば、 すべての子は <literal>persist()</literal> に渡されます。" +#. Tag: para +#: session_api.xml:971 +#, no-c-format +msgid "" +"Mapping an association (either a single valued association, or a collection) " +"with <literal>cascade=\"all\"</literal> marks the association as a " +"<emphasis>parent/child</emphasis> style relationship where save/update/" +"delete of the parent results in save/update/delete of the child or children." +msgstr "" +"<literal>cascade=\"all\"</literal> でマッピングした関連（単値関連やコレクショ" +"ン）は、 <emphasis>親子</emphasis> スタイルの関連とマークされます。 それは、" +"親のセーブ/更新/削除が、子のセーブ/更新/削除を引き起こす関係のことです。" -#: index.docbook:977 -msgid "Futhermore, a mere reference to a child from a persistent parent will result in save/update of the child. This metaphor is incomplete, however. A child which becomes unreferenced by its parent is <emphasis>not</emphasis> automatically deleted, except in the case of a <literal>&lt;one-to-many&gt;</literal> association mapped with <literal>cascade=\"delete-orphan\"</literal>. The precise semantics of cascading operations for a parent/child relationship are as follows:" -msgstr "<literal>merge()</literal> に渡されたならば、 すべての子は <literal>merge()</literal> に渡されます。" +#. Tag: para +#: session_api.xml:977 +#, no-c-format +msgid "" +"Futhermore, a mere reference to a child from a persistent parent will result " +"in save/update of the child. This metaphor is incomplete, however. A child " +"which becomes unreferenced by its parent is <emphasis>not</emphasis> " +"automatically deleted, except in the case of a <literal>&lt;one-to-many&gt;</" +"literal> association mapped with <literal>cascade=\"delete-orphan\"</" +"literal>. The precise semantics of cascading operations for a parent/child " +"relationship are as follows:" +msgstr "" +"さらに、永続化された親が子を単に参照しているだけで、子のセーブ/更新を引き起こ" +"します。 しかし、このメタファーは不完全です。親から参照されなくなった子は、自" +"動的に削除 <emphasis>されません</emphasis> 。 ただし、 <literal>cascade=" +"\"delete-orphan\"</literal> でマッピングされた <literal>&lt;one-to-many&gt;</" +"literal> 関連を 除いてです。 親子関係のカスケード操作の正確な意味は以下のよう" +"になります。" -#: index.docbook:988 -msgid "If a parent is passed to <literal>persist()</literal>, all children are passed to <literal>persist()</literal>" -msgstr "親が <literal>save()</literal> 、 <literal>update()</literal> 、 <literal>saveOrUpdate()</literal> に渡されたならば、すべての子は <literal>saveOrUpdate()</literal> に渡されます。" +#. Tag: para +#: session_api.xml:988 +#, no-c-format +msgid "" +"If a parent is passed to <literal>persist()</literal>, all children are " +"passed to <literal>persist()</literal>" +msgstr "" +"親が <literal>persist()</literal> に渡されたならば、 すべての子は " +"<literal>persist()</literal> に渡されます。" -#: index.docbook:994 -msgid "If a parent is passed to <literal>merge()</literal>, all children are passed to <literal>merge()</literal>" -msgstr "一時的または分離状態の子が、永続化された親に参照されたならば、 <literal>saveOrUpdate()</literal> に渡されます。" +#. Tag: para +#: session_api.xml:994 +#, no-c-format +msgid "" +"If a parent is passed to <literal>merge()</literal>, all children are passed " +"to <literal>merge()</literal>" +msgstr "" +"<literal>merge()</literal> に渡されたならば、 すべての子は <literal>merge()</" +"literal> に渡されます。" -#: index.docbook:1000 -msgid "If a parent is passed to <literal>save()</literal>, <literal>update()</literal> or <literal>saveOrUpdate()</literal>, all children are passed to <literal>saveOrUpdate()</literal>" -msgstr "親が削除されたならば、すべての子は、 <literal>delete()</literal> に渡されます。" +#. Tag: para +#: session_api.xml:1000 +#, no-c-format +msgid "" +"If a parent is passed to <literal>save()</literal>, <literal>update()</" +"literal> or <literal>saveOrUpdate()</literal>, all children are passed to " +"<literal>saveOrUpdate()</literal>" +msgstr "" +"親が <literal>save()</literal> 、 <literal>update()</literal> 、 " +"<literal>saveOrUpdate()</literal> に渡されたならば、すべての子は " +"<literal>saveOrUpdate()</literal> に渡されます。" -#: index.docbook:1006 -msgid "If a transient or detached child becomes referenced by a persistent parent, it is passed to <literal>saveOrUpdate()</literal>" -msgstr "子が永続化された親から参照されなくなったときは、 <emphasis>特に何も起こりません</emphasis> 。 よって、アプリケーションが必要であれば、明示的に削除する必要があります。 ただし、 <literal>cascade=\"delete-orphan\"</literal> の場合を除きます。 この場合、「親のない」子は削除されます。" +#. Tag: para +#: session_api.xml:1006 +#, no-c-format +msgid "" +"If a transient or detached child becomes referenced by a persistent parent, " +"it is passed to <literal>saveOrUpdate()</literal>" +msgstr "" +"一時的または分離状態の子が、永続化された親に参照されたならば、 " +"<literal>saveOrUpdate()</literal> に渡されます。" -#: index.docbook:1012 -msgid "If a parent is deleted, all children are passed to <literal>delete()</literal>" -msgstr "最後に、操作のカスケードがオブジェクトグラフに適用されるのは、 <emphasis>コールした時</emphasis> あるいは、 <emphasis>flushした時</emphasis> であることに注意してください。 すべての操作は、その操作が実行されたときに、到達可能な関連するエンティティに対して カスケードが可能ならカスケードします。 しかし、 <literal>save-upate</literal> と <literal>delete-orphan</literal> は、 <literal>Session</literal> がflushしている間に、 すべての到達可能な関連するエンティティに伝播します。" +#. Tag: para +#: session_api.xml:1012 +#, no-c-format +msgid "" +"If a parent is deleted, all children are passed to <literal>delete()</" +"literal>" +msgstr "" +"親が削除されたならば、すべての子は、 <literal>delete()</literal> に渡されま" +"す。" -#: index.docbook:1017 -msgid "If a child is dereferenced by a persistent parent, <emphasis>nothing special happens</emphasis> - the application should explicitly delete the child if necessary - unless <literal>cascade=\"delete-orphan\"</literal>, in which case the \"orphaned\" child is deleted." -msgstr "メタデータの使用" +#. Tag: para +#: session_api.xml:1017 +#, no-c-format +msgid "" +"If a child is dereferenced by a persistent parent, <emphasis>nothing special " +"happens</emphasis> - the application should explicitly delete the child if " +"necessary - unless <literal>cascade=\"delete-orphan\"</literal>, in which " +"case the \"orphaned\" child is deleted." +msgstr "" +"子が永続化された親から参照されなくなったときは、 <emphasis>特に何も起こりませ" +"ん</emphasis> 。 よって、アプリケーションが必要であれば、明示的に削除する必要" +"があります。 ただし、 <literal>cascade=\"delete-orphan\"</literal> の場合を除" +"きます。 この場合、「親のない」子は削除されます。" -#: index.docbook:1026 -msgid "Finally, note that cascading of operations can be applied to an object graph at <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All operations, if enabled, are cascaded to associated entities reachable when the operation is executed. However, <literal>save-upate</literal> and <literal>delete-orphan</literal> are transitive for all associated entities reachable during flush of the <literal>Session</literal>." -msgstr "Hibernateは、すべてのエンティティと値型の非常にリッチなメタレベルのモデルを必要とします。 ときどき、このモデルはアプリケーションにとってとても役に立ちます。 例えば、アプリケーションは、Hibernateのメタデータを使って、\"賢い\" ディープコピーアルゴリズムを 実装できるかもしません。そのアルゴリズムとは、どのオブジェクトがコピーされるべきか（例：可変の値型）や どのオブジェクトはコピーされないべきか（例：不変な値型や可能なら関連するエンティティ）を 判断できるものです。" +#. Tag: para +#: session_api.xml:1026 +#, no-c-format +msgid "" +"Finally, note that cascading of operations can be applied to an object graph " +"at <emphasis>call time</emphasis> or at <emphasis>flush time</emphasis>. All " +"operations, if enabled, are cascaded to associated entities reachable when " +"the operation is executed. However, <literal>save-upate</literal> and " +"<literal>delete-orphan</literal> are transitive for all associated entities " +"reachable during flush of the <literal>Session</literal>." +msgstr "" +"最後に、操作のカスケードがオブジェクトグラフに適用されるのは、 <emphasis>コー" +"ルした時</emphasis> あるいは、 <emphasis>flushした時</emphasis> であることに" +"注意してください。 すべての操作は、その操作が実行されたときに、到達可能な関連" +"するエンティティに対して カスケードが可能ならカスケードします。 しかし、 " +"<literal>save-upate</literal> と <literal>delete-orphan</literal> は、 " +"<literal>Session</literal> がflushしている間に、 すべての到達可能な関連するエ" +"ンティティに伝播します。" -#: index.docbook:1038 +#. Tag: title +#: session_api.xml:1038 +#, no-c-format msgid "Using metadata" -msgstr "Hibernateは<literal>ClassMetadata</literal> と<literal>CollectionMetadata</literal> インタフェースと <literal>Type</literal> 階層を通してメタデータを公開します。 メタデータインターフェイスのインスタンスは、 <literal>SessionFactory</literal> から得られます。" +msgstr "メタデータの使用" -#: index.docbook:1040 -msgid "Hibernate requires a very rich meta-level model of all entity and value types. From time to time, this model is very useful to the application itself. For example, the application might use Hibernate's metadata to implement a \"smart\" deep-copy algorithm that understands which objects should be copied (eg. mutable value types) and which should not (eg. immutable value types and, possibly, associated entities)." +#. Tag: para +#: session_api.xml:1040 +#, no-c-format +msgid "" +"Hibernate requires a very rich meta-level model of all entity and value " +"types. From time to time, this model is very useful to the application " +"itself. For example, the application might use Hibernate's metadata to " +"implement a \"smart\" deep-copy algorithm that understands which objects " +"should be copied (eg. mutable value types) and which should not (eg. " +"immutable value types and, possibly, associated entities)." msgstr "" - "<![CDATA[Cat fritz = ......; -\n" - "ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class); -\n" - " -\n" - "Object[] propertyValues = catMeta.getPropertyValues(fritz); -\n" - "String[] propertyNames = catMeta.getPropertyNames(); -\n" - "Type[] propertyTypes = catMeta.getPropertyTypes(); -\n" - " -\n" - "// get a Map of all properties which are not collections or associations -\n" - "Map namedValues = new HashMap(); -\n" - "for ( int i=0; i<propertyNames.length; i++ ) { -\n" - " if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCollectionType() ) { -\n" - " namedValues.put( propertyNames[i], propertyValues[i] ); -\n" - " } -\n" - "}]]>" +"Hibernateは、すべてのエンティティと値型の非常にリッチなメタレベルのモデルを必" +"要とします。 ときどき、このモデルはアプリケーションにとってとても役に立ちま" +"す。 例えば、アプリケーションは、Hibernateのメタデータを使って、\"賢い\" " +"ディープコピーアルゴリズムを 実装できるかもしません。そのアルゴリズムとは、ど" +"のオブジェクトがコピーされるべきか（例：可変の値型）や どのオブジェクトはコ" +"ピーされないべきか（例：不変な値型や可能なら関連するエンティティ）を 判断でき" +"るものです。" -#: index.docbook:1047 -msgid "Hibernate exposes metadata via the <literal>ClassMetadata</literal> and <literal>CollectionMetadata</literal> interfaces and the <literal>Type</literal> hierarchy. Instances of the metadata interfaces may be obtained from the <literal>SessionFactory</literal>." +#. Tag: para +#: session_api.xml:1047 +#, no-c-format +msgid "" +"Hibernate exposes metadata via the <literal>ClassMetadata</literal> and " +"<literal>CollectionMetadata</literal> interfaces and the <literal>Type</" +"literal> hierarchy. Instances of the metadata interfaces may be obtained " +"from the <literal>SessionFactory</literal>." msgstr "" +"Hibernateは<literal>ClassMetadata</literal> と<literal>CollectionMetadata</" +"literal> インタフェースと <literal>Type</literal> 階層を通してメタデータを公" +"開します。 メタデータインターフェイスのインスタンスは、 " +"<literal>SessionFactory</literal> から得られます。" -#: index.docbook:1054 +#. Tag: programlisting +#: session_api.xml:1054 +#, no-c-format msgid "" - "<![CDATA[Cat fritz = ......;\n" - "ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class);\n" - "\n" - "Object[] propertyValues = catMeta.getPropertyValues(fritz);\n" - "String[] propertyNames = catMeta.getPropertyNames();\n" - "Type[] propertyTypes = catMeta.getPropertyTypes();\n" - "\n" - "// get a Map of all properties which are not collections or associations\n" - "Map namedValues = new HashMap();\n" - "for ( int i=0; i<propertyNames.length; i++ ) {\n" - " if ( !propertyTypes[i].isEntityType() && !propertyTypes[i].isCollectionType() ) {\n" - " namedValues.put( propertyNames[i], propertyValues[i] );\n" - " }\n" - "}]]>" +"<![CDATA[Cat fritz = ......;\n" +"ClassMetadata catMeta = sessionfactory.getClassMetadata(Cat.class);\n" +"\n" +"Object[] propertyValues = catMeta.getPropertyValues(fritz);\n" +"String[] propertyNames = catMeta.getPropertyNames();\n" +"Type[] propertyTypes = catMeta.getPropertyTypes();\n" +"\n" +"// get a Map of all properties which are not collections or associations\n" +"Map namedValues = new HashMap();\n" +"for ( int i=0; i<propertyNames.length; i++ ) {\n" +" if ( !propertyTypes[i].isEntityType() && !propertyTypes[i]." +"isCollectionType() ) {\n" +" namedValues.put( propertyNames[i], propertyValues[i] );\n" +" }\n" +"}]]>" msgstr "" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" +#~ msgid "UPDATE" +#~ msgstr "UPDATE" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" +#~ msgid "DELETE" +#~ msgstr "DELETE" +#~ msgid "state management" +#~ msgstr "状態管理" + +#~ msgid "statements" +#~ msgstr "文" + +#~ msgid "Connection" +#~ msgstr "session.connection()" + +#~ msgid "session.connection()" +#~ msgstr "Connection" Modified: core/trunk/documentation/manual/translations/ja-JP/content/toolset_guide.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/toolset_guide.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/toolset_guide.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,807 +1,1198 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: toolset_guide.xml:5 +#, no-c-format msgid "Toolset Guide" msgstr "Toolset Guide ツールセットガイド" -#: index.docbook:7 -msgid "Roundtrip engineering with Hibernate is possible using a set of Eclipse plugins, commandline tools, as well as Ant tasks." -msgstr "Hibernateを使ったラウンドトリップエンジニアリングは、 Eclipseプラグインやコマンドラインツール、もちろんAntタスクを使うことで可能です。" +#. Tag: para +#: toolset_guide.xml:7 +#, no-c-format +msgid "" +"Roundtrip engineering with Hibernate is possible using a set of Eclipse " +"plugins, commandline tools, as well as Ant tasks." +msgstr "" +"Hibernateを使ったラウンドトリップエンジニアリングは、 Eclipseプラグインやコマ" +"ンドラインツール、もちろんAntタスクを使うことで可能です。" -#: index.docbook:12 -msgid "The <emphasis>Hibernate Tools</emphasis> currently include plugins for the Eclipse IDE as well as Ant tasks for reverse engineering of existing databases:" -msgstr "<emphasis>Hibernate Tools</emphasis> は現在、既存データベースのリバースエンジニアリングのAntタスクに加えて、EclipseIDEのプラグインを含みます。" +#. Tag: para +#: toolset_guide.xml:12 +#, no-c-format +msgid "" +"The <emphasis>Hibernate Tools</emphasis> currently include plugins for the " +"Eclipse IDE as well as Ant tasks for reverse engineering of existing " +"databases:" +msgstr "" +"<emphasis>Hibernate Tools</emphasis> は現在、既存データベースのリバースエンジ" +"ニアリングのAntタスクに加えて、EclipseIDEのプラグインを含みます。" -#: index.docbook:18 -msgid "<emphasis>Mapping Editor:</emphasis> An editor for Hibernate XML mapping files, supporting auto-completion and syntax highlighting. It also supports semantic auto-completion for class names and property/field names, making it much more versatile than a normal XML editor." -msgstr "<emphasis>マッピングエディタ:</emphasis> HibernateのXMLマッピングファイル用のエディタで、 自動補完と構文強調表示をサポートしています。クラス名やプロパティ/フィールド名に対する自動補完もサポートし、 通常のXMLエディタよりも強力です。" +#. Tag: para +#: toolset_guide.xml:18 +#, no-c-format +msgid "" +"<emphasis>Mapping Editor:</emphasis> An editor for Hibernate XML mapping " +"files, supporting auto-completion and syntax highlighting. It also supports " +"semantic auto-completion for class names and property/field names, making it " +"much more versatile than a normal XML editor." +msgstr "" +"<emphasis>マッピングエディタ:</emphasis> HibernateのXMLマッピングファイル用の" +"エディタで、 自動補完と構文強調表示をサポートしています。クラス名やプロパ" +"ティ/フィールド名に対する自動補完もサポートし、 通常のXMLエディタよりも強力で" +"す。" -#: index.docbook:23 -msgid "<emphasis>Console:</emphasis> The console is a new view in Eclipse. In addition to a tree overview of your console configurations, you also get an interactive view of your persistent classes and their relationships. The console allows you to execute HQL queries against your database and browse the result directly in Eclipse." -msgstr "<emphasis>Console:</emphasis> コンソールはエクリプスの新しいビューです。 コンソールコンフィギュレーションのツリーオーバービューに加えて、永続クラスとその関連の相互作用ビューも得られます。 データベースにHQLを実行し、結果を直接エクリプス上で見ることができます。" +#. Tag: para +#: toolset_guide.xml:23 +#, no-c-format +msgid "" +"<emphasis>Console:</emphasis> The console is a new view in Eclipse. In " +"addition to a tree overview of your console configurations, you also get an " +"interactive view of your persistent classes and their relationships. The " +"console allows you to execute HQL queries against your database and browse " +"the result directly in Eclipse." +msgstr "" +"<emphasis>Console:</emphasis> コンソールはエクリプスの新しいビューです。 コン" +"ソールコンフィギュレーションのツリーオーバービューに加えて、永続クラスとその" +"関連の相互作用ビューも得られます。 データベースにHQLを実行し、結果を直接エク" +"リプス上で見ることができます。" -#: index.docbook:30 -msgid "<emphasis>Development Wizards:</emphasis> Several wizards are provided with the Hibernate Eclipse tools; you can use a wizard to quickly generate Hibernate configuration (cfg.xml) files, or you may even completely reverse engineer an existing database schema into POJO source files and Hibernate mapping files. The reverse engineering wizard supports customizable templates." -msgstr "<emphasis>開発ウィザード</emphasis> HibernateのEclipseツールはいくつかのウィザードを提供します。 ウィザードを使ってHibernateの設定ファイル(cfg.xml)をすばやく生成したり、 既存のデータベーススキーマをPOJOのソースファイルとHibernateのマッピングファイルへと、 完全にリバースエンジニアリングすることができます。 リバースエンジニアリングウィザードはカスタマイズ可能なテンプレートをサポートします。" +#. Tag: para +#: toolset_guide.xml:30 +#, no-c-format +msgid "" +"<emphasis>Development Wizards:</emphasis> Several wizards are provided with " +"the Hibernate Eclipse tools; you can use a wizard to quickly generate " +"Hibernate configuration (cfg.xml) files, or you may even completely reverse " +"engineer an existing database schema into POJO source files and Hibernate " +"mapping files. The reverse engineering wizard supports customizable " +"templates." +msgstr "" +"<emphasis>開発ウィザード</emphasis> HibernateのEclipseツールはいくつかのウィ" +"ザードを提供します。 ウィザードを使ってHibernateの設定ファイル(cfg.xml)をすば" +"やく生成したり、 既存のデータベーススキーマをPOJOのソースファイルとHibernate" +"のマッピングファイルへと、 完全にリバースエンジニアリングすることができま" +"す。 リバースエンジニアリングウィザードはカスタマイズ可能なテンプレートをサ" +"ポートします。" -#: index.docbook:38 +#. Tag: emphasis +#: toolset_guide.xml:38 +#, no-c-format msgid "Ant Tasks:" msgstr "Ant Tasks:" -#: index.docbook:43 -msgid "Please refer to the <emphasis>Hibernate Tools</emphasis> package and it's documentation for more information." -msgstr "より詳しい情報は <emphasis>Hibernate Tools</emphasis> パッケージとそのドキュメントを参照してください。" +#. Tag: para +#: toolset_guide.xml:43 +#, no-c-format +msgid "" +"Please refer to the <emphasis>Hibernate Tools</emphasis> package and it's " +"documentation for more information." +msgstr "" +"より詳しい情報は <emphasis>Hibernate Tools</emphasis> パッケージとそのドキュ" +"メントを参照してください。" -#: index.docbook:48 -msgid "However, the Hibernate main package comes bundled with an integrated tool (it can even be used from \"inside\" Hibernate on-the-fly): <emphasis>SchemaExport</emphasis> aka <literal>hbm2ddl</literal>." -msgstr "しかし、Hibernateのメインパッケージは <emphasis>SchemaExport</emphasis> 、 別名 <literal>hbm2ddl</literal> も含みます(Hibernate内でオンザフライで使用できます)。" +#. Tag: para +#: toolset_guide.xml:48 +#, no-c-format +msgid "" +"However, the Hibernate main package comes bundled with an integrated tool " +"(it can even be used from \"inside\" Hibernate on-the-fly): " +"<emphasis>SchemaExport</emphasis> aka <literal>hbm2ddl</literal>." +msgstr "" +"しかし、Hibernateのメインパッケージは <emphasis>SchemaExport</emphasis> 、 別" +"名 <literal>hbm2ddl</literal> も含みます(Hibernate内でオンザフライで使用でき" +"ます)。" -#: index.docbook:55 +#. Tag: title +#: toolset_guide.xml:55 +#, no-c-format msgid "Automatic schema generation" msgstr "スキーマの自動生成" -#: index.docbook:57 -msgid "DDL may be generated from your mapping files by a Hibernate utility. The generated schema includes referential integrity constraints (primary and foreign keys) for entity and collection tables. Tables and sequences are also created for mapped identifier generators." -msgstr "DDLはHibernateユーティリティによりマッピングファイルから生成することができます。 生成されたスキーマはエンティティやコレクションのテーブルに対する参照整合性制約(主キーと外部キー)を含みます。 テーブルとシーケンスはマッピングする識別子ジェネレータに対して生成されます。" +#. Tag: para +#: toolset_guide.xml:57 +#, no-c-format +msgid "" +"DDL may be generated from your mapping files by a Hibernate utility. The " +"generated schema includes referential integrity constraints (primary and " +"foreign keys) for entity and collection tables. Tables and sequences are " +"also created for mapped identifier generators." +msgstr "" +"DDLはHibernateユーティリティによりマッピングファイルから生成することができま" +"す。 生成されたスキーマはエンティティやコレクションのテーブルに対する参照整合" +"性制約(主キーと外部キー)を含みます。 テーブルとシーケンスはマッピングする識別" +"子ジェネレータに対して生成されます。" -#: index.docbook:64 -msgid "You <emphasis>must</emphasis> specify a SQL <literal>Dialect</literal> via the <literal>hibernate.dialect</literal> property when using this tool, as DDL is highly vendor specific." -msgstr "DDLはベンダー依存なので、このツールを使うときは、<literal>hibernate.dialect</literal> プロパティでSQLの <literal>方言</literal> を指定 <emphasis>しなければなりません</emphasis> 。" +#. Tag: para +#: toolset_guide.xml:64 +#, no-c-format +msgid "" +"You <emphasis>must</emphasis> specify a SQL <literal>Dialect</literal> via " +"the <literal>hibernate.dialect</literal> property when using this tool, as " +"DDL is highly vendor specific." +msgstr "" +"DDLはベンダー依存なので、このツールを使うときは、<literal>hibernate.dialect</" +"literal> プロパティでSQLの <literal>方言</literal> を指定 <emphasis>しなけれ" +"ばなりません</emphasis> 。" -#: index.docbook:70 +#. Tag: para +#: toolset_guide.xml:70 +#, no-c-format msgid "First, customize your mapping files to improve the generated schema." -msgstr "まず、生成されるスキーマを改善するように、マッピングファイルをカスタマイズしてください。" +msgstr "" +"まず、生成されるスキーマを改善するように、マッピングファイルをカスタマイズし" +"てください。" -#: index.docbook:75 +#. Tag: title +#: toolset_guide.xml:75 +#, no-c-format msgid "Customizing the schema" msgstr "スキーマのカスタマイズ" -#: index.docbook:77 -msgid "Many Hibernate mapping elements define optional attributes named <literal>length</literal>, <literal>precision</literal> and <literal>scale</literal>. You may set the length, precision and scale of a column with this attribute." -msgstr "多くのHibernateのマッピング要素では、オプションの <literal>length</literal> という名の属性を定義しています。 この属性でカラム長を設定することができます(またはNUMERIC/DECIMAL型のデータの精度を設定できます)。" +#. Tag: para +#: toolset_guide.xml:77 +#, no-c-format +msgid "" +"Many Hibernate mapping elements define optional attributes named " +"<literal>length</literal>, <literal>precision</literal> and <literal>scale</" +"literal>. You may set the length, precision and scale of a column with this " +"attribute." +msgstr "" +"多くのHibernateのマッピング要素では、オプションの <literal>length</literal> " +"という名の属性を定義しています。 この属性でカラム長を設定することができます" +"(またはNUMERIC/DECIMAL型のデータの精度を設定できます)。" -#: index.docbook:84 +#. Tag: programlisting +#: toolset_guide.xml:84 +#, no-c-format msgid "<![CDATA[<property name=\"zip\" length=\"5\"/>]]>" -msgstr "<literal>not-null</literal> 属性（テーブルのカラムへ <literal>NOT NULL</literal> 制約を生成する）と <literal>unique</literal> 属性（テーブルのカラムへ <literal>UNIQUE</literal> 制約を生成する）が設定できるタグもあります。" +msgstr "" -#: index.docbook:85 +#. Tag: programlisting +#: toolset_guide.xml:85 +#, no-c-format msgid "<![CDATA[<property name=\"balance\" precision=\"12\" scale=\"2\"/>]]>" -msgstr "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>" +msgstr "" -#: index.docbook:87 -msgid "Some tags also accept a <literal>not-null</literal> attribute (for generating a <literal>NOT NULL</literal> constraint on table columns) and a <literal>unique</literal> attribute (for generating <literal>UNIQUE</literal> constraint on table columns)." -msgstr "<![CDATA[<element column=\"serialNumber\" type=\"long\" not-null=\"true\" unique=\"true\"/>]]>" +#. Tag: para +#: toolset_guide.xml:87 +#, no-c-format +msgid "" +"Some tags also accept a <literal>not-null</literal> attribute (for " +"generating a <literal>NOT NULL</literal> constraint on table columns) and a " +"<literal>unique</literal> attribute (for generating <literal>UNIQUE</" +"literal> constraint on table columns)." +msgstr "" +"<literal>not-null</literal> 属性（テーブルのカラムへ <literal>NOT NULL</" +"literal> 制約を生成する）と <literal>unique</literal> 属性（テーブルのカラム" +"へ <literal>UNIQUE</literal> 制約を生成する）が設定できるタグもあります。" -#: index.docbook:93 -msgid "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>" -msgstr "<literal>unique-key</literal> 属性はカラムをグループ化して一つのキー制約にするために使われます。 現在、<literal>unique-key</literal> 属性で指定された値は制約の指定には <emphasis>使われず</emphasis> 、 マッピングファイルでカラムをグループ化することにのみ使われます。" +#. Tag: programlisting +#: toolset_guide.xml:93 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>" +msgstr "" -#: index.docbook:95 -msgid "<![CDATA[<element column=\"serialNumber\" type=\"long\" not-null=\"true\" unique=\"true\"/>]]>" +#. Tag: programlisting +#: toolset_guide.xml:95 +#, no-c-format +msgid "" +"<![CDATA[<element column=\"serialNumber\" type=\"long\" not-null=\"true\" " +"unique=\"true\"/>]]>" msgstr "" - "<![CDATA[<many-to-one name=\"org\" column=\"orgId\" unique-key=\"OrgEmployeeId\"/> -\n" - "<property name=\"employeeId\" unique-key=\"OrgEmployeeId\"/>]]>" -#: index.docbook:97 -msgid "A <literal>unique-key</literal> attribute may be used to group columns in a single unique key constraint. Currently, the specified value of the <literal>unique-key</literal> attribute is <emphasis>not</emphasis> used to name the constraint in the generated DDL, only to group the columns in the mapping file." -msgstr "<literal>index</literal> 属性はマッピングするカラムを使って生成したインデックスの名前を指定します。 複数カラムを１つのインデックスにグループ化できます。単に、同じインデックス名を指定するだけです。" +#. Tag: para +#: toolset_guide.xml:97 +#, no-c-format +msgid "" +"A <literal>unique-key</literal> attribute may be used to group columns in a " +"single unique key constraint. Currently, the specified value of the " +"<literal>unique-key</literal> attribute is <emphasis>not</emphasis> used to " +"name the constraint in the generated DDL, only to group the columns in the " +"mapping file." +msgstr "" +"<literal>unique-key</literal> 属性はカラムをグループ化して一つのキー制約にす" +"るために使われます。 現在、<literal>unique-key</literal> 属性で指定された値は" +"制約の指定には <emphasis>使われず</emphasis> 、 マッピングファイルでカラムを" +"グループ化することにのみ使われます。" -#: index.docbook:105 +#. Tag: programlisting +#: toolset_guide.xml:105 +#, no-c-format msgid "" - "<![CDATA[<many-to-one name=\"org\" column=\"orgId\" unique-key=\"OrgEmployeeId\"/>\n" - "<property name=\"employeeId\" unique-key=\"OrgEmployee\"/>]]>" +"<![CDATA[<many-to-one name=\"org\" column=\"orgId\" unique-key=" +"\"OrgEmployeeId\"/>\n" +"<property name=\"employeeId\" unique-key=\"OrgEmployee\"/>]]>" msgstr "" - "<![CDATA[<property name=\"lastName\" index=\"CustName\"/> -\n" - "<property name=\"firstName\" index=\"CustName\"/>]]>" -#: index.docbook:107 -msgid "An <literal>index</literal> attribute specifies the name of an index that will be created using the mapped column or columns. Multiple columns may be grouped into the same index, simply by specifying the same index name." -msgstr "<literal>foreign-key</literal> 属性は、生成された外部キー制約の名前をオーバーライドするために使用できます。" +#. Tag: para +#: toolset_guide.xml:107 +#, no-c-format +msgid "" +"An <literal>index</literal> attribute specifies the name of an index that " +"will be created using the mapped column or columns. Multiple columns may be " +"grouped into the same index, simply by specifying the same index name." +msgstr "" +"<literal>index</literal> 属性はマッピングするカラムを使って生成したインデック" +"スの名前を指定します。 複数カラムを１つのインデックスにグループ化できます。単" +"に、同じインデックス名を指定するだけです。" -#: index.docbook:113 +#. Tag: programlisting +#: toolset_guide.xml:113 +#, no-c-format msgid "" - "<![CDATA[<property name=\"lastName\" index=\"CustName\"/>\n" - "<property name=\"firstName\" index=\"CustName\"/>]]>" -msgstr "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar\"/>]]>" +"<![CDATA[<property name=\"lastName\" index=\"CustName\"/>\n" +"<property name=\"firstName\" index=\"CustName\"/>]]>" +msgstr "" -#: index.docbook:115 -msgid "A <literal>foreign-key</literal> attribute may be used to override the name of any generated foreign key constraint." -msgstr "多くのマッピング要素は、子 <literal>&lt;column&gt;</literal> 要素を記述できます。これは複数カラム型のマッピングには特に有用です。" +#. Tag: para +#: toolset_guide.xml:115 +#, no-c-format +msgid "" +"A <literal>foreign-key</literal> attribute may be used to override the name " +"of any generated foreign key constraint." +msgstr "" +"<literal>foreign-key</literal> 属性は、生成された外部キー制約の名前をオーバー" +"ライドするために使用できます。" -#: index.docbook:120 -msgid "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar\"/>]]>" +#. Tag: programlisting +#: toolset_guide.xml:120 +#, no-c-format +msgid "" +"<![CDATA[<many-to-one name=\"bar\" column=\"barId\" foreign-key=\"FKFooBar\"/" +">]]>" msgstr "" - "<![CDATA[<property name=\"name\" type=\"my.customtypes.Name\"/> -\n" - " <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=\"30\"/> -\n" - " <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=\"20\"/> -\n" - " <column name=\"initial\"/> -\n" - "</property>]]>" -#: index.docbook:122 -msgid "Many mapping elements also accept a child <literal>&lt;column&gt;</literal> element. This is particularly useful for mapping multi-column types:" -msgstr "<literal>default</literal> 属性はカラムのデフォルト値を指定します (マッピングしたクラスの新しいインスタンスを保存する前に、 マッピングしたプロパティへ同じ値を代入すべきです)。" +#. Tag: para +#: toolset_guide.xml:122 +#, no-c-format +msgid "" +"Many mapping elements also accept a child <literal>&lt;column&gt;</literal> " +"element. This is particularly useful for mapping multi-column types:" +msgstr "" +"多くのマッピング要素は、子 <literal>&lt;column&gt;</literal> 要素を記述できま" +"す。これは複数カラム型のマッピングには特に有用です。" -#: index.docbook:127 +#. Tag: programlisting +#: toolset_guide.xml:127 +#, no-c-format msgid "" - "<![CDATA[<property name=\"name\" type=\"my.customtypes.Name\"/>\n" - " <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=\"30\"/>\n" - " <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=\"20\"/>\n" - " <column name=\"initial\"/>\n" - "</property>]]>" +"<![CDATA[<property name=\"name\" type=\"my.customtypes.Name\"/>\n" +" <column name=\"last\" not-null=\"true\" index=\"bar_idx\" length=\"30\"/" +">\n" +" <column name=\"first\" not-null=\"true\" index=\"bar_idx\" length=\"20\"/" +">\n" +" <column name=\"initial\"/>\n" +"</property>]]>" msgstr "" - "<![CDATA[<property name=\"credits\" type=\"integer\" insert=\"false\"> -\n" - " <column name=\"credits\" default=\"10\"/> -\n" - "</property>]]>" -#: index.docbook:129 -msgid "The <literal>default</literal> attribute lets you specify a default value for a column (you should assign the same value to the mapped property before saving a new instance of the mapped class)." +#. Tag: para +#: toolset_guide.xml:129 +#, no-c-format +msgid "" +"The <literal>default</literal> attribute lets you specify a default value " +"for a column (you should assign the same value to the mapped property before " +"saving a new instance of the mapped class)." msgstr "" - "<![CDATA[<version name=\"version\" type=\"integer\" insert=\"false\"> -\n" - " <column name=\"version\" default=\"0\"/> -\n" - "</property>]]>" +"<literal>default</literal> 属性はカラムのデフォルト値を指定します (マッピング" +"したクラスの新しいインスタンスを保存する前に、 マッピングしたプロパティへ同じ" +"値を代入すべきです)。" -#: index.docbook:135 +#. Tag: programlisting +#: toolset_guide.xml:135 +#, no-c-format msgid "" - "<![CDATA[<property name=\"credits\" type=\"integer\" insert=\"false\">\n" - " <column name=\"credits\" default=\"10\"/>\n" - "</property>]]>" -msgstr "<literal>sql-type</literal> 属性で、デフォルトのHibernate型からSQLのデータ型へのマッピングをオーバーライドできます。" +"<![CDATA[<property name=\"credits\" type=\"integer\" insert=\"false\">\n" +" <column name=\"credits\" default=\"10\"/>\n" +"</property>]]>" +msgstr "" -#: index.docbook:137 +#. Tag: programlisting +#: toolset_guide.xml:137 +#, no-c-format msgid "" - "<![CDATA[<version name=\"version\" type=\"integer\" insert=\"false\">\n" - " <column name=\"version\" default=\"0\"/>\n" - "</property>]]>" +"<![CDATA[<version name=\"version\" type=\"integer\" insert=\"false\">\n" +" <column name=\"version\" default=\"0\"/>\n" +"</property>]]>" msgstr "" - "<![CDATA[<property name=\"balance\" type=\"float\"> -\n" - " <column name=\"balance\" sql-type=\"decimal(13,3)\"/> -\n" - "</property>]]>" -#: index.docbook:139 -msgid "The <literal>sql-type</literal> attribute allows the user to override the default mapping of a Hibernate type to SQL datatype." -msgstr "<literal>check</literal> 属性でチェック制約を指定することができます。" - -#: index.docbook:144 +#. Tag: para +#: toolset_guide.xml:139 +#, no-c-format msgid "" - "<![CDATA[<property name=\"balance\" type=\"float\">\n" - " <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n" - "</property>]]>" +"The <literal>sql-type</literal> attribute allows the user to override the " +"default mapping of a Hibernate type to SQL datatype." msgstr "" - "<![CDATA[<property name=\"foo\" type=\"integer\"> -\n" - " <column name=\"foo\" check=\"foo > 10\"/> -\n" - "</property>]]>" +"<literal>sql-type</literal> 属性で、デフォルトのHibernate型からSQLのデータ型" +"へのマッピングをオーバーライドできます。" -#: index.docbook:146 -msgid "The <literal>check</literal> attribute allows you to specify a check constraint." +#. Tag: programlisting +#: toolset_guide.xml:144 +#, no-c-format +msgid "" +"<![CDATA[<property name=\"balance\" type=\"float\">\n" +" <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n" +"</property>]]>" msgstr "" - "<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\"> -\n" - " ... -\n" - " <property name=\"bar\" type=\"float\"/> -\n" - "</class>]]>" -#: index.docbook:150 +#. Tag: para +#: toolset_guide.xml:146 +#, no-c-format msgid "" - "<![CDATA[<property name=\"foo\" type=\"integer\">\n" - " <column name=\"foo\" check=\"foo > 10\"/>\n" - "</property>]]>" -msgstr "<title>まとめ</title>" +"The <literal>check</literal> attribute allows you to specify a check " +"constraint." +msgstr "<literal>check</literal> 属性でチェック制約を指定することができます。" -#: index.docbook:152 +#. Tag: programlisting +#: toolset_guide.xml:150 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n" - " ...\n" - " <property name=\"bar\" type=\"float\"/>\n" - "</class>]]>" -msgstr "<entry>属性</entry>" +"<![CDATA[<property name=\"foo\" type=\"integer\">\n" +" <column name=\"foo\" check=\"foo > 10\"/>\n" +"</property>]]>" +msgstr "" -#: index.docbook:156 +#. Tag: programlisting +#: toolset_guide.xml:152 +#, no-c-format +msgid "" +"<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n" +" ...\n" +" <property name=\"bar\" type=\"float\"/>\n" +"</class>]]>" +msgstr "" + +#. Tag: title +#: toolset_guide.xml:156 +#, no-c-format msgid "Summary" -msgstr "<entry>値</entry>" +msgstr "まとめ" -#: index.docbook:163 +#. Tag: entry +#: toolset_guide.xml:163 +#, no-c-format msgid "Attribute" -msgstr "<entry>説明</entry>" +msgstr "属性" -#: index.docbook:164 +#. Tag: entry +#: toolset_guide.xml:164 +#, no-c-format msgid "Values" -msgstr "length" +msgstr "値" -#: index.docbook:165 +#. Tag: entry +#: toolset_guide.xml:165 +#, no-c-format msgid "Interpretation" -msgstr "<entry>数値</entry>" +msgstr "説明" -#: index.docbook:170 +#. Tag: literal +#: toolset_guide.xml:170 +#, no-c-format msgid "length" -msgstr "カラムの長さ" +msgstr "length" -#: index.docbook:171, index.docbook:176, index.docbook:181 +#. Tag: entry +#: toolset_guide.xml:171 toolset_guide.xml:176 toolset_guide.xml:181 +#, no-c-format msgid "number" -msgstr "precision" +msgstr "数値" -#: index.docbook:172 +#. Tag: entry +#: toolset_guide.xml:172 +#, no-c-format msgid "column length" -msgstr "<entry>数値</entry>" +msgstr "カラムの長さ" -#: index.docbook:175 +#. Tag: literal +#: toolset_guide.xml:175 +#, no-c-format msgid "precision" -msgstr "カラムのDECIMAL型の精度（precision）" +msgstr "precision" -#: index.docbook:177 +#. Tag: entry +#: toolset_guide.xml:177 +#, no-c-format msgid "column decimal precision" -msgstr "<entry>数値</entry>" +msgstr "カラムのDECIMAL型の精度（precision）" -#: index.docbook:180 +#. Tag: literal +#: toolset_guide.xml:180 +#, no-c-format msgid "scale" -msgstr "カラムのDECIMAL型のスケール（scale）" +msgstr "scale" -#: index.docbook:182 +#. Tag: entry +#: toolset_guide.xml:182 +#, no-c-format msgid "column decimal scale" -msgstr "true|false" +msgstr "カラムのDECIMAL型のスケール（scale）" -#: index.docbook:185 +#. Tag: literal +#: toolset_guide.xml:185 +#, no-c-format msgid "not-null" -msgstr "カラムがnull値を取らないことを指定します" +msgstr "not-null" -#: index.docbook:186, index.docbook:191 +#. Tag: literal +#: toolset_guide.xml:186 toolset_guide.xml:191 +#, no-c-format msgid "true|false" -msgstr "unique" +msgstr "true|false" -#: index.docbook:187 +#. Tag: entry +#: toolset_guide.xml:187 +#, no-c-format msgid "specfies that the column should be non-nullable" -msgstr "true|false" +msgstr "カラムがnull値を取らないことを指定します" -#: index.docbook:190 +#. Tag: literal +#: toolset_guide.xml:190 +#, no-c-format msgid "unique" -msgstr "カラムがユニーク制約を持つことを指定します" +msgstr "unique" -#: index.docbook:192 +#. Tag: entry +#: toolset_guide.xml:192 +#, no-c-format msgid "specifies that the column should have a unique constraint" -msgstr "インデックス名" +msgstr "カラムがユニーク制約を持つことを指定します" -#: index.docbook:195 +#. Tag: literal +#: toolset_guide.xml:195 +#, no-c-format msgid "index" -msgstr "(複数カラムの)インデックスの名前を指定します" +msgstr "index" -#: index.docbook:196 +#. Tag: literal +#: toolset_guide.xml:196 +#, no-c-format msgid "index_name" -msgstr "unique-key" +msgstr "インデックス名" -#: index.docbook:197 +#. Tag: entry +#: toolset_guide.xml:197 +#, no-c-format msgid "specifies the name of a (multi-column) index" -msgstr "ユニークキー名" +msgstr "(複数カラムの)インデックスの名前を指定します" -#: index.docbook:200 +#. Tag: literal +#: toolset_guide.xml:200 +#, no-c-format msgid "unique-key" -msgstr "複数カラムのユニーク制約の名前を指定します" +msgstr "unique-key" -#: index.docbook:201 +#. Tag: literal +#: toolset_guide.xml:201 +#, no-c-format msgid "unique_key_name" -msgstr "foreign-key" +msgstr "ユニークキー名" -#: index.docbook:202 +#. Tag: entry +#: toolset_guide.xml:202 +#, no-c-format msgid "specifies the name of a multi-column unique constraint" -msgstr "外部キー名" +msgstr "複数カラムのユニーク制約の名前を指定します" -#: index.docbook:205 +#. Tag: literal +#: toolset_guide.xml:205 +#, no-c-format msgid "foreign-key" -msgstr "&lt;one-to-one&gt;、&lt;many-to-one&gt;、&lt;many-to-many&gt;マッピング要素を使って、 関連に対し生成された外部キー制約の名前を指定します。 <literal>SchemaExport</literal> は <literal>inverse=\"true\"</literal> 側を考慮しないことに注意してください。" +msgstr "foreign-key" -#: index.docbook:206 +#. Tag: literal +#: toolset_guide.xml:206 +#, no-c-format msgid "foreign_key_name" -msgstr "sql-type" +msgstr "外部キー名" -#: index.docbook:207 -msgid "specifies the name of the foreign key constraint generated for an association, for a <literal>&lt;one-to-one&gt;</literal>, <literal>&lt;many-to-one&gt;</literal>, <literal>&lt;key&gt;</literal>, or <literal>&lt;many-to-many&gt;</literal> mapping element. Note that <literal>inverse=\"true\"</literal> sides will not be considered by <literal>SchemaExport</literal>." -msgstr "SQLのカラム型" +#. Tag: entry +#: toolset_guide.xml:207 +#, fuzzy, no-c-format +msgid "" +"specifies the name of the foreign key constraint generated for an " +"association, for a <literal>&lt;one-to-one&gt;</literal>, <literal>&lt;many-" +"to-one&gt;</literal>, <literal>&lt;key&gt;</literal>, or <literal>&lt;many-" +"to-many&gt;</literal> mapping element. Note that <literal>inverse=\"true\"</" +"literal> sides will not be considered by <literal>SchemaExport</literal>." +msgstr "" +"specifies the name of the foreign key constraint generated for an " +"association, for a <placeholder-1/>, <placeholder-2/>, <placeholder-3/>, or " +"<placeholder-4/> mapping element. Note that <placeholder-5/> sides will not " +"be considered by <placeholder-6/>." -#: index.docbook:217 +#. Tag: literal +#: toolset_guide.xml:217 +#, no-c-format msgid "sql-type" -msgstr "デフォルトのカラム型をオーバーライドします( <literal>&lt;column&gt;</literal> 要素の属性のみ)" +msgstr "sql-type" -#: index.docbook:218 +#. Tag: literal +#: toolset_guide.xml:218 +#, no-c-format msgid "SQL column type" -msgstr "default" +msgstr "SQLのカラム型" -#: index.docbook:219 -msgid "overrides the default column type (attribute of <literal>&lt;column&gt;</literal> element only)" -msgstr "SQL式" +#. Tag: entry +#: toolset_guide.xml:219 +#, fuzzy, no-c-format +msgid "" +"overrides the default column type (attribute of <literal>&lt;column&gt;</" +"literal> element only)" +msgstr "" +"デフォルトのカラム型をオーバーライドします( <placeholder-1/> 要素の属性のみ)" -#: index.docbook:225 +#. Tag: literal +#: toolset_guide.xml:225 +#, no-c-format msgid "default" -msgstr "カラムのデフォルト値を指定します" +msgstr "default" -#: index.docbook:226, index.docbook:233 +#. Tag: entry +#: toolset_guide.xml:226 toolset_guide.xml:233 +#, no-c-format msgid "SQL expression" -msgstr "check" +msgstr "SQL式" -#: index.docbook:227 +#. Tag: entry +#: toolset_guide.xml:227 +#, no-c-format msgid "specify a default value for the column" -msgstr "SQL式" +msgstr "カラムのデフォルト値を指定します" -#: index.docbook:232 +#. Tag: literal +#: toolset_guide.xml:232 +#, no-c-format msgid "check" +msgstr "check" + +#. Tag: entry +#: toolset_guide.xml:234 +#, no-c-format +msgid "create an SQL check constraint on either column or table" msgstr "カラムかテーブルにSQLのチェック制約を作成します" -#: index.docbook:234 -msgid "create an SQL check constraint on either column or table" +#. Tag: para +#: toolset_guide.xml:242 +#, no-c-format +msgid "" +"The <literal>&lt;comment&gt;</literal> element allows you to specify " +"comments for the generated schema." msgstr "" - "<![CDATA[<class name=\"Customer\" table=\"CurCust\"> -\n" - " <comment>Current customers only</comment> -\n" - " ... -\n" - "</class>]]>" +"<literal>&lt;comment&gt;</literal> 要素で生成するスキーマにコメントを指定する" +"ことができます。" -#: index.docbook:242 -msgid "The <literal>&lt;comment&gt;</literal> element allows you to specify comments for the generated schema." +#. Tag: programlisting +#: toolset_guide.xml:247 +#, no-c-format +msgid "" +"<![CDATA[<class name=\"Customer\" table=\"CurCust\">\n" +" <comment>Current customers only</comment>\n" +" ...\n" +"</class>]]>" msgstr "" - "<![CDATA[<property name=\"balance\"> -\n" - " <column name=\"bal\"> -\n" - " <comment>Balance in USD</comment> -\n" - " </column> -\n" - "</property>]]>" -#: index.docbook:247 +#. Tag: programlisting +#: toolset_guide.xml:249 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Customer\" table=\"CurCust\">\n" - " <comment>Current customers only</comment>\n" - " ...\n" - "</class>]]>" -msgstr "これにより、生成したDDLに <literal>comment on table</literal> や <literal>comment on column</literal> 文が書かれます。" +"<![CDATA[<property name=\"balance\">\n" +" <column name=\"bal\">\n" +" <comment>Balance in USD</comment>\n" +" </column>\n" +"</property>]]>" +msgstr "" -#: index.docbook:249 +#. Tag: para +#: toolset_guide.xml:251 +#, no-c-format msgid "" - "<![CDATA[<property name=\"balance\">\n" - " <column name=\"bal\">\n" - " <comment>Balance in USD</comment>\n" - " </column>\n" - "</property>]]>" -msgstr "ツールの実行" +"This results in a <literal>comment on table</literal> or <literal>comment on " +"column</literal> statement in the generated DDL (where supported)." +msgstr "" +"これにより、生成したDDLに <literal>comment on table</literal> や " +"<literal>comment on column</literal> 文が書かれます。" -#: index.docbook:251 -msgid "This results in a <literal>comment on table</literal> or <literal>comment on column</literal> statement in the generated DDL (where supported)." -msgstr "<literal>SchemaExport</literal> は標準出力に対してDDLスクリプトを書き出し、DDL文を実行したりもします。" - -#: index.docbook:260 +#. Tag: title +#: toolset_guide.xml:260 +#, no-c-format msgid "Running the tool" -msgstr "<literal>java -cp </literal> <emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options mapping_files</emphasis>" +msgstr "ツールの実行" -#: index.docbook:262 -msgid "The <literal>SchemaExport</literal> tool writes a DDL script to standard out and/or executes the DDL statements." -msgstr "<literal>SchemaExport</literal> Command Line Options <literal>SchemaExport</literal> のコマンドラインオプション" +#. Tag: para +#: toolset_guide.xml:262 +#, no-c-format +msgid "" +"The <literal>SchemaExport</literal> tool writes a DDL script to standard out " +"and/or executes the DDL statements." +msgstr "" +"<literal>SchemaExport</literal> は標準出力に対してDDLスクリプトを書き出し、" +"DDL文を実行したりもします。" -#: index.docbook:267 -msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options mapping_files</emphasis>" -msgstr "オプション" +#. Tag: para +#: toolset_guide.xml:267 +#, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options " +"mapping_files</emphasis>" +msgstr "" -#: index.docbook:273 +#. Tag: title +#: toolset_guide.xml:273 +#, no-c-format msgid "<literal>SchemaExport</literal> Command Line Options" -msgstr "<entry>説明</entry>" +msgstr "" +"<literal>SchemaExport</literal> Command Line Options <literal>SchemaExport</" +"literal> のコマンドラインオプション" -#: index.docbook:279, index.docbook:429, index.docbook:498 +#. Tag: entry +#: toolset_guide.xml:279 toolset_guide.xml:429 toolset_guide.xml:498 +#, no-c-format msgid "Option" -msgstr "--quiet" +msgstr "オプション" -#: index.docbook:280, index.docbook:367, index.docbook:430, index.docbook:499 +#. Tag: entry +#: toolset_guide.xml:280 toolset_guide.xml:367 toolset_guide.xml:430 +#: toolset_guide.xml:499 +#, no-c-format msgid "Description" -msgstr "スクリプトを標準出力に出力しません" +msgstr "説明" -#: index.docbook:285, index.docbook:435 +#. Tag: literal +#: toolset_guide.xml:285 toolset_guide.xml:435 +#, no-c-format msgid "--quiet" -msgstr "--drop" +msgstr "--quiet" -#: index.docbook:286, index.docbook:436 +#. Tag: entry +#: toolset_guide.xml:286 toolset_guide.xml:436 +#, fuzzy, no-c-format msgid "don't output the script to stdout" -msgstr "テーブルの削除だけを行います" +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"スクリプトを標準出力に出力しません\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"標準出力にスクリプトを出力しません" -#: index.docbook:289 +#. Tag: literal +#: toolset_guide.xml:289 +#, no-c-format msgid "--drop" -msgstr "--create" +msgstr "--drop" -#: index.docbook:290 +#. Tag: entry +#: toolset_guide.xml:290 +#, no-c-format msgid "only drop the tables" -msgstr "テーブルの生成のみを行います。" +msgstr "テーブルの削除だけを行います" -#: index.docbook:293 +#. Tag: literal +#: toolset_guide.xml:293 +#, no-c-format msgid "--create" -msgstr "--text" +msgstr "--create" -#: index.docbook:294 +#. Tag: entry +#: toolset_guide.xml:294 +#, no-c-format msgid "only create the tables" -msgstr "データベースにエクスポートしません" +msgstr "テーブルの生成のみを行います。" -#: index.docbook:297, index.docbook:439 +#. Tag: literal +#: toolset_guide.xml:297 toolset_guide.xml:439 +#, no-c-format msgid "--text" -msgstr "--output=my_schema.ddl" +msgstr "--text" -#: index.docbook:298 +#. Tag: entry +#: toolset_guide.xml:298 +#, no-c-format msgid "don't export to the database" -msgstr "DDLスクリプトをファイルに出力します" +msgstr "データベースにエクスポートしません" -#: index.docbook:301 +#. Tag: literal +#: toolset_guide.xml:301 +#, no-c-format msgid "--output=my_schema.ddl" -msgstr "--naming=eg.MyNamingStrategy" +msgstr "--output=my_schema.ddl" -#: index.docbook:302 +#. Tag: entry +#: toolset_guide.xml:302 +#, no-c-format msgid "output the ddl script to a file" -msgstr "<literal>NamingStrategy</literal> を選択します" +msgstr "DDLスクリプトをファイルに出力します" -#: index.docbook:305, index.docbook:443, index.docbook:504 +#. Tag: literal +#: toolset_guide.xml:305 toolset_guide.xml:443 toolset_guide.xml:504 +#, no-c-format msgid "--naming=eg.MyNamingStrategy" -msgstr "--config=hibernate.cfg.xml" +msgstr "--naming=eg.MyNamingStrategy" -#: index.docbook:306, index.docbook:444, index.docbook:505 +#. Tag: entry +#: toolset_guide.xml:306 toolset_guide.xml:444 toolset_guide.xml:505 +#, fuzzy, no-c-format msgid "select a <literal>NamingStrategy</literal>" -msgstr "XMLファイルからHibernateの定義情報を読み込みます" +msgstr "<literal>hibernate.properties</literal> ファイル内で" -#: index.docbook:309, index.docbook:451, index.docbook:512 +#. Tag: literal +#: toolset_guide.xml:309 toolset_guide.xml:451 toolset_guide.xml:512 +#, no-c-format msgid "--config=hibernate.cfg.xml" -msgstr "--properties=hibernate.properties" +msgstr "--config=hibernate.cfg.xml" -#: index.docbook:310 +#. Tag: entry +#: toolset_guide.xml:310 +#, no-c-format msgid "read Hibernate configuration from an XML file" -msgstr "ファイルからデータベースプロパティを読み込みます" +msgstr "XMLファイルからHibernateの定義情報を読み込みます" -#: index.docbook:313, index.docbook:447, index.docbook:508 +#. Tag: literal +#: toolset_guide.xml:313 toolset_guide.xml:447 toolset_guide.xml:508 +#, no-c-format msgid "--properties=hibernate.properties" -msgstr "--format" +msgstr "--properties=hibernate.properties" -#: index.docbook:314, index.docbook:448, index.docbook:509 +#. Tag: entry +#: toolset_guide.xml:314 toolset_guide.xml:448 toolset_guide.xml:509 +#, fuzzy, no-c-format msgid "read database properties from a file" -msgstr "スクリプト内に生成するSQLを読みやすいようにフォーマットします" +msgstr "" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"ファイルからデータベースプロパティを読み込みます\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"ファイルからデータベースプロパティを読み込みます\n" +"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +"ファイルからデータベースのプロパティを読み込みます" -#: index.docbook:317 +#. Tag: literal +#: toolset_guide.xml:317 +#, no-c-format msgid "--format" -msgstr "--delimiter=x" +msgstr "--format" -#: index.docbook:318 +#. Tag: entry +#: toolset_guide.xml:318 +#, no-c-format msgid "format the generated SQL nicely in the script" -msgstr "スクリプトの行区切り文字を設定します" +msgstr "スクリプト内に生成するSQLを読みやすいようにフォーマットします" -#: index.docbook:321 +#. Tag: literal +#: toolset_guide.xml:321 +#, no-c-format msgid "--delimiter=;" -msgstr "アプリケーションに <literal>SchemaExport</literal> を組み込むこともできます：" +msgstr "--delimiter=x" -#: index.docbook:322 +#. Tag: entry +#: toolset_guide.xml:322 +#, no-c-format msgid "set an end of line delimiter for the script" -msgstr "" - "<![CDATA[Configuration cfg = ....; -\n" - "new SchemaExport(cfg).create(false, true);]]>" +msgstr "スクリプトの行区切り文字を設定します" -#: index.docbook:328 +#. Tag: para +#: toolset_guide.xml:328 +#, no-c-format msgid "You may even embed <literal>SchemaExport</literal> in your application:" -msgstr "プロパティ" +msgstr "" +"アプリケーションに <literal>SchemaExport</literal> を組み込むこともできます：" -#: index.docbook:332 +#. Tag: programlisting +#: toolset_guide.xml:332 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaExport(cfg).create(false, true);]]>" -msgstr "次のように、データベースのプロパティを指定することができます。" +"<![CDATA[Configuration cfg = ....;\n" +"new SchemaExport(cfg).create(false, true);]]>" +msgstr "" -#: index.docbook:337 +#. Tag: title +#: toolset_guide.xml:337 +#, no-c-format msgid "Properties" -msgstr "<literal>-D</literal> <emphasis>&lt;property&gt;</emphasis> を使って、システムプロパティとして" +msgstr "プロパティ" -#: index.docbook:339 +#. Tag: para +#: toolset_guide.xml:339 +#, no-c-format msgid "Database properties may be specified" -msgstr "<literal>hibernate.properties</literal> ファイル内で" +msgstr "次のように、データベースのプロパティを指定することができます。" -#: index.docbook:345 -msgid "as system properties with <literal>-D</literal><emphasis>&lt;property&gt;</emphasis>" -msgstr "<literal>--properties</literal> を使って指定したプロパティファイル内で" +#. Tag: para +#: toolset_guide.xml:345 +#, no-c-format +msgid "" +"as system properties with <literal>-D</literal><emphasis>&lt;property&gt;</" +"emphasis>" +msgstr "" +"<literal>-D</literal><emphasis>&lt;property&gt;</emphasis> を使って、システム" +"プロパティとして" -#: index.docbook:348 +#. Tag: para +#: toolset_guide.xml:348 +#, no-c-format msgid "in <literal>hibernate.properties</literal>" -msgstr "必要なプロパティは以下のものです：" +msgstr "<literal>hibernate.properties</literal> ファイル内で" -#: index.docbook:351 +#. Tag: para +#: toolset_guide.xml:351 +#, no-c-format msgid "in a named properties file with <literal>--properties</literal>" -msgstr "SchemaExportコネクションプロパティ" +msgstr "<literal>--properties</literal> を使って指定したプロパティファイル内で" -#: index.docbook:355 +#. Tag: para +#: toolset_guide.xml:355 +#, no-c-format msgid "The needed properties are:" -msgstr "プロパティ名" +msgstr "必要なプロパティは以下のものです：" -#: index.docbook:360 +#. Tag: title +#: toolset_guide.xml:360 +#, no-c-format msgid "SchemaExport Connection Properties" -msgstr "<entry>説明</entry>" +msgstr "SchemaExportコネクションプロパティ" -#: index.docbook:366 +#. Tag: entry +#: toolset_guide.xml:366 +#, no-c-format msgid "Property Name" -msgstr "hibernate.connection.driver_class" +msgstr "プロパティ名" -#: index.docbook:372 +#. Tag: literal +#: toolset_guide.xml:372 +#, no-c-format msgid "hibernate.connection.driver_class" -msgstr "hibernate.connection.url" +msgstr "hibernate.connection.driver_class" -#: index.docbook:373 +#. Tag: entry +#: toolset_guide.xml:373 +#, no-c-format msgid "jdbc driver class" -msgstr "jdbcのurl" +msgstr "jdbcのドライバークラス" -#: index.docbook:376 +#. Tag: literal +#: toolset_guide.xml:376 +#, no-c-format msgid "hibernate.connection.url" -msgstr "hibernate.connection.username" +msgstr "hibernate.connection.url" -#: index.docbook:377 +#. Tag: entry +#: toolset_guide.xml:377 +#, no-c-format msgid "jdbc url" -msgstr "データベースのユーザ" +msgstr "jdbcのurl" -#: index.docbook:380 +#. Tag: literal +#: toolset_guide.xml:380 +#, no-c-format msgid "hibernate.connection.username" -msgstr "hibernate.connection.password" +msgstr "hibernate.connection.username" -#: index.docbook:381 +#. Tag: entry +#: toolset_guide.xml:381 +#, no-c-format msgid "database user" -msgstr "ユーザパスワード" +msgstr "データベースのユーザ" -#: index.docbook:384 +#. Tag: literal +#: toolset_guide.xml:384 +#, no-c-format msgid "hibernate.connection.password" -msgstr "hibernate.dialect" +msgstr "hibernate.connection.password" -#: index.docbook:385 +#. Tag: entry +#: toolset_guide.xml:385 +#, no-c-format msgid "user password" -msgstr "データベース方言" +msgstr "ユーザパスワード" -#: index.docbook:388 +#. Tag: literal +#: toolset_guide.xml:388 +#, no-c-format msgid "hibernate.dialect" -msgstr "Antを使用する" +msgstr "hibernate.dialect" -#: index.docbook:389 +#. Tag: entry +#: toolset_guide.xml:389 +#, no-c-format msgid "dialect" -msgstr "Antのビルドスクリプトから <literal>SchemaExport</literal> を呼び出すことができます。:" +msgstr "データベース方言" -#: index.docbook:398 +#. Tag: title +#: toolset_guide.xml:398 +#, no-c-format msgid "Using Ant" +msgstr "Antを使用する" + +#. Tag: para +#: toolset_guide.xml:400 +#, no-c-format +msgid "" +"You can call <literal>SchemaExport</literal> from your Ant build script:" msgstr "" - "<![CDATA[<target name=\"schemaexport\"> -\n" - " <taskdef name=\"schemaexport\" -\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\" -\n" - " classpathref=\"class.path\"/> -\n" - " -\n" - " <schemaexport -\n" - " properties=\"hibernate.properties\" -\n" - " quiet=\"no\" -\n" - " text=\"no\" -\n" - " drop=\"no\" -\n" - " delimiter=\";\" -\n" - " output=\"schema-export.sql\"> -\n" - " <fileset dir=\"src\"> -\n" - " <include name=\"**/*.hbm.xml\"/> -\n" - " </fileset> -\n" - " </schemaexport> -\n" - "</target>]]>" +"Antのビルドスクリプトから <literal>SchemaExport</literal> を呼び出すことがで" +"きます。:" -#: index.docbook:400 -msgid "You can call <literal>SchemaExport</literal> from your Ant build script:" -msgstr "インクリメンタルなスキーマ更新" - -#: index.docbook:404 +#. Tag: programlisting +#: toolset_guide.xml:404 +#, no-c-format msgid "" - "<![CDATA[<target name=\"schemaexport\">\n" - " <taskdef name=\"schemaexport\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemaexport\n" - " properties=\"hibernate.properties\"\n" - " quiet=\"no\"\n" - " text=\"no\"\n" - " drop=\"no\"\n" - " delimiter=\";\"\n" - " output=\"schema-export.sql\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemaexport>\n" - "</target>]]>" -msgstr "<literal>SchemaUpdate</literal> ツールは既存のスキーマをインクリメンタルに更新します。 <literal>SchemaUpdate</literal> はJDBCのメタデータAPIに強く依存します。 そのため、すべてのJDBCドライバでうまくいくとは限らないことに注意してください。" +"<![CDATA[<target name=\"schemaexport\">\n" +" <taskdef name=\"schemaexport\"\n" +" classname=\"org.hibernate.tool.hbm2ddl.SchemaExportTask\"\n" +" classpathref=\"class.path\"/>\n" +" \n" +" <schemaexport\n" +" properties=\"hibernate.properties\"\n" +" quiet=\"no\"\n" +" text=\"no\"\n" +" drop=\"no\"\n" +" delimiter=\";\"\n" +" output=\"schema-export.sql\">\n" +" <fileset dir=\"src\">\n" +" <include name=\"**/*.hbm.xml\"/>\n" +" </fileset>\n" +" </schemaexport>\n" +"</target>]]>" +msgstr "" -#: index.docbook:409 +#. Tag: title +#: toolset_guide.xml:409 +#, no-c-format msgid "Incremental schema updates" -msgstr "<literal>java -cp </literal> <emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options mapping_files</emphasis>" +msgstr "インクリメンタルなスキーマ更新" -#: index.docbook:411 -msgid "The <literal>SchemaUpdate</literal> tool will update an existing schema with \"incremental\" changes. Note that <literal>SchemaUpdate</literal> depends heavily upon the JDBC metadata API, so it will not work with all JDBC drivers." -msgstr "<literal>SchemaUpdate</literal> のコマンドライン･オプション" +#. Tag: para +#: toolset_guide.xml:411 +#, no-c-format +msgid "" +"The <literal>SchemaUpdate</literal> tool will update an existing schema with " +"\"incremental\" changes. Note that <literal>SchemaUpdate</literal> depends " +"heavily upon the JDBC metadata API, so it will not work with all JDBC " +"drivers." +msgstr "" +"<literal>SchemaUpdate</literal> ツールは既存のスキーマをインクリメンタルに更" +"新します。 <literal>SchemaUpdate</literal> はJDBCのメタデータAPIに強く依存し" +"ます。 そのため、すべてのJDBCドライバでうまくいくとは限らないことに注意してく" +"ださい。" -#: index.docbook:417 -msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options mapping_files</emphasis>" -msgstr "オプション" +#. Tag: para +#: toolset_guide.xml:417 +#, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options " +"mapping_files</emphasis>" +msgstr "" -#: index.docbook:423 +#. Tag: title +#: toolset_guide.xml:423 +#, no-c-format msgid "<literal>SchemaUpdate</literal> Command Line Options" -msgstr "<entry>説明</entry>" +msgstr "<literal>SchemaUpdate</literal> のコマンドライン･オプション" -#: index.docbook:440 +#. Tag: entry +#: toolset_guide.xml:440 +#, no-c-format msgid "don't export the script to the database" -msgstr "<literal>NamingStrategy</literal> を選択します。" +msgstr "データベースにスクリプトをエクスポートしません" -#: index.docbook:452, index.docbook:513 +#. Tag: entry +#: toolset_guide.xml:452 toolset_guide.xml:513 +#, fuzzy, no-c-format msgid "specify a <literal>.cfg.xml</literal> file" -msgstr "" - "<![CDATA[Configuration cfg = ....; -\n" - "new SchemaUpdate(cfg).execute(false);]]>" +msgstr "<placeholder-1/> ファイルを指定します" -#: index.docbook:458 +#. Tag: para +#: toolset_guide.xml:458 +#, no-c-format msgid "You may embed <literal>SchemaUpdate</literal> in your application:" -msgstr "インクリメンタルなスキーマ更新に対するAntの使用" +msgstr "" +"アプリケーションに <literal>SchemaUpdate</literal> を組み込むことができま" +"す。：" -#: index.docbook:462 +#. Tag: programlisting +#: toolset_guide.xml:462 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaUpdate(cfg).execute(false);]]>" -msgstr "Antスクリプトから <literal>SchemaUpdate</literal> を呼び出すことができます：" +"<![CDATA[Configuration cfg = ....;\n" +"new SchemaUpdate(cfg).execute(false);]]>" +msgstr "" -#: index.docbook:467 +#. Tag: title +#: toolset_guide.xml:467 +#, no-c-format msgid "Using Ant for incremental schema updates" -msgstr "" - "<![CDATA[<target name=\"schemaupdate\"> -\n" - " <taskdef name=\"schemaupdate\" -\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\" -\n" - " classpathref=\"class.path\"/> -\n" - " -\n" - " <schemaupdate -\n" - " properties=\"hibernate.properties\" -\n" - " quiet=\"no\"> -\n" - " <fileset dir=\"src\"> -\n" - " <include name=\"**/*.hbm.xml\"/> -\n" - " </fileset> -\n" - " </schemaupdate> -\n" - "</target>]]>" +msgstr "インクリメンタルなスキーマ更新に対するAntの使用" -#: index.docbook:469 +#. Tag: para +#: toolset_guide.xml:469 +#, no-c-format msgid "You can call <literal>SchemaUpdate</literal> from the Ant script:" -msgstr "Schema validation" +msgstr "" +"Antスクリプトから <literal>SchemaUpdate</literal> を呼び出すことができます：" -#: index.docbook:473 +#. Tag: programlisting +#: toolset_guide.xml:473 +#, no-c-format msgid "" - "<![CDATA[<target name=\"schemaupdate\">\n" - " <taskdef name=\"schemaupdate\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemaupdate\n" - " properties=\"hibernate.properties\"\n" - " quiet=\"no\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemaupdate>\n" - "</target>]]>" -msgstr "<literal>SchemaValidator</literal> ツールは、既存のデータベーススキーマと作成したマッピングドキュメントが\"一致する\"ことを検証します。 <literal>SchemaValidator</literal> はJDBCのメタデータAPIに強く依存することに注意してください。そのため、すべてのJDBCドライバーで作動するものではありません。このツールはテスト時に非常に有用です。" +"<![CDATA[<target name=\"schemaupdate\">\n" +" <taskdef name=\"schemaupdate\"\n" +" classname=\"org.hibernate.tool.hbm2ddl.SchemaUpdateTask\"\n" +" classpathref=\"class.path\"/>\n" +" \n" +" <schemaupdate\n" +" properties=\"hibernate.properties\"\n" +" quiet=\"no\">\n" +" <fileset dir=\"src\">\n" +" <include name=\"**/*.hbm.xml\"/>\n" +" </fileset>\n" +" </schemaupdate>\n" +"</target>]]>" +msgstr "" -#: index.docbook:478 +#. Tag: title +#: toolset_guide.xml:478 +#, no-c-format msgid "Schema validation" -msgstr "<literal>java -cp </literal> <emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> <emphasis>options mapping_files</emphasis>" +msgstr "Schema validation" -#: index.docbook:480 -msgid "The <literal>SchemaValidator</literal> tool will validate that the existing database schema \"matches\" your mapping documents. Note that <literal>SchemaValidator</literal> depends heavily upon the JDBC metadata API, so it will not work with all JDBC drivers. This tool is extremely useful for testing." -msgstr "<literal>SchemaValidator</literal> のコマンドライン・オプション" +#. Tag: para +#: toolset_guide.xml:480 +#, no-c-format +msgid "" +"The <literal>SchemaValidator</literal> tool will validate that the existing " +"database schema \"matches\" your mapping documents. Note that " +"<literal>SchemaValidator</literal> depends heavily upon the JDBC metadata " +"API, so it will not work with all JDBC drivers. This tool is extremely " +"useful for testing." +msgstr "" +"<literal>SchemaValidator</literal> ツールは、既存のデータベーススキーマと作成" +"したマッピングドキュメントが\"一致する\"ことを検証します。 " +"<literal>SchemaValidator</literal> はJDBCのメタデータAPIに強く依存することに" +"注意してください。そのため、すべてのJDBCドライバーで作動するものではありませ" +"ん。このツールはテスト時に非常に有用です。" -#: index.docbook:486 -msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> <emphasis>options mapping_files</emphasis>" -msgstr "オプション" +#. Tag: para +#: toolset_guide.xml:486 +#, no-c-format +msgid "" +"<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> " +"<literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> " +"<emphasis>options mapping_files</emphasis>" +msgstr "" -#: index.docbook:492 +#. Tag: title +#: toolset_guide.xml:492 +#, no-c-format msgid "<literal>SchemaValidator</literal> Command Line Options" -msgstr "<entry>説明</entry>" +msgstr "<literal>SchemaValidator</literal> のコマンドライン・オプション" -#: index.docbook:519 +#. Tag: para +#: toolset_guide.xml:519 +#, no-c-format msgid "You may embed <literal>SchemaValidator</literal> in your application:" -msgstr "スキーマのバリデーションにAntを使用します" +msgstr "" +"<literal>SchemaValidator</literal> をアプリケーションに組み込むことが出来ま" +"す:" -#: index.docbook:523 +#. Tag: programlisting +#: toolset_guide.xml:523 +#, no-c-format msgid "" - "<![CDATA[Configuration cfg = ....;\n" - "new SchemaValidator(cfg).validate();]]>" -msgstr "Antスクリプトから <literal>SchemaValidator</literal> を呼び出せます:" +"<![CDATA[Configuration cfg = ....;\n" +"new SchemaValidator(cfg).validate();]]>" +msgstr "" -#: index.docbook:528 +#. Tag: title +#: toolset_guide.xml:528 +#, no-c-format msgid "Using Ant for schema validation" -msgstr "" - "<![CDATA[<target name=\"schemavalidate\"> -\n" - " <taskdef name=\"schemavalidator\" -\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\" -\n" - " classpathref=\"class.path\"/> -\n" - " -\n" - " <schemavalidator -\n" - " properties=\"hibernate.properties\"> -\n" - " <fileset dir=\"src\"> -\n" - " <include name=\"**/*.hbm.xml\"/> -\n" - " </fileset> -\n" - " </schemavalidator> -\n" - "</target>]]>" +msgstr "スキーマのバリデーションにAntを使用します" -#: index.docbook:530 +#. Tag: para +#: toolset_guide.xml:530 +#, no-c-format msgid "You can call <literal>SchemaValidator</literal> from the Ant script:" -msgstr "" +msgstr "Antスクリプトから <literal>SchemaValidator</literal> を呼び出せます:" -#: index.docbook:534 +#. Tag: programlisting +#: toolset_guide.xml:534 +#, no-c-format msgid "" - "<![CDATA[<target name=\"schemavalidate\">\n" - " <taskdef name=\"schemavalidator\"\n" - " classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\"\n" - " classpathref=\"class.path\"/>\n" - " \n" - " <schemavalidator\n" - " properties=\"hibernate.properties\">\n" - " <fileset dir=\"src\">\n" - " <include name=\"**/*.hbm.xml\"/>\n" - " </fileset>\n" - " </schemavalidator>\n" - "</target>]]>" +"<![CDATA[<target name=\"schemavalidate\">\n" +" <taskdef name=\"schemavalidator\"\n" +" classname=\"org.hibernate.tool.hbm2ddl.SchemaValidatorTask\"\n" +" classpathref=\"class.path\"/>\n" +" \n" +" <schemavalidator\n" +" properties=\"hibernate.properties\">\n" +" <fileset dir=\"src\">\n" +" <include name=\"**/*.hbm.xml\"/>\n" +" </fileset>\n" +" </schemavalidator>\n" +"</target>]]>" msgstr "" -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" +#~ msgid "&lt;one-to-one&gt;" +#~ msgstr "&lt;one-to-one&gt;" -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" +#~ msgid "&lt;many-to-one&gt;" +#~ msgstr "&lt;many-to-one&gt;" +#~ msgid "&lt;key&gt;" +#~ msgstr "&lt;key&gt;" + +#~ msgid "&lt;many-to-many&gt;" +#~ msgstr "&lt;many-to-many&gt;" + +#~ msgid "inverse=\"true\"" +#~ msgstr "inverse=\"true\"" + +#~ msgid "SchemaExport" +#~ msgstr "SchemaExport" + +#~ msgid "&lt;column&gt;" +#~ msgstr "&lt;column&gt;" + +#~ msgid "java -cp" +#~ msgstr "java -cp" + +#~ msgid "hibernate_classpaths" +#~ msgstr "hibernate_classpaths" + +#~ msgid "org.hibernate.tool.hbm2ddl.SchemaExport" +#~ msgstr "org.hibernate.tool.hbm2ddl.SchemaExport" + +#~ msgid "options mapping_files" +#~ msgstr "options mapping_files" + +#~ msgid "NamingStrategy" +#~ msgstr "NamingStrategy" + +#, fuzzy +#~ msgid "select a <placeholder-1/>" +#~ msgstr "" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "<placeholder-1/> を選択します\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "<placeholder-1/> を選択します。\n" +#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n" +#~ "<placeholder-1/> を選択します" + +#~ msgid "org.hibernate.tool.hbm2ddl.SchemaUpdate" +#~ msgstr "org.hibernate.tool.hbm2ddl.SchemaUpdate" + +#~ msgid ".cfg.xml" +#~ msgstr ".cfg.xml" + +#~ msgid "org.hibernate.tool.hbm2ddl.SchemaValidator" +#~ msgstr "org.hibernate.tool.hbm2ddl.SchemaValidator" Modified: core/trunk/documentation/manual/translations/ja-JP/content/transactions.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/transactions.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/transactions.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,794 +1,2070 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:47+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: transactions.xml:5 +#, no-c-format msgid "Transactions And Concurrency" msgstr "トランザクションと並行性" -#: index.docbook:7 -msgid "The most important point about Hibernate and concurrency control is that it is very easy to understand. Hibernate directly uses JDBC connections and JTA resources without adding any additional locking behavior. We highly recommend you spend some time with the JDBC, ANSI, and transaction isolation specification of your database management system." -msgstr "Hibernateと同時実行制御について最も重要な点は、容易に理解できることです。 Hibernateは新たなロックの振る舞いを追加しておらず、直接JDBCコネクションとJTAリソースを使用します。 JDBC、ANSI、およびデータベース管理システム（DBMS）のトランザクション分離の仕様を 少し時間をかけて勉強することを強く推奨します。" +#. Tag: para +#: transactions.xml:7 +#, no-c-format +msgid "" +"The most important point about Hibernate and concurrency control is that it " +"is very easy to understand. Hibernate directly uses JDBC connections and JTA " +"resources without adding any additional locking behavior. We highly " +"recommend you spend some time with the JDBC, ANSI, and transaction isolation " +"specification of your database management system." +msgstr "" +"Hibernateと同時実行制御について最も重要な点は、容易に理解できることです。 " +"Hibernateは新たなロックの振る舞いを追加しておらず、直接JDBCコネクションとJTA" +"リソースを使用します。 JDBC、ANSI、およびデータベース管理システム（DBMS）のト" +"ランザクション分離の仕様を 少し時間をかけて勉強することを強く推奨します。" -#: index.docbook:14 -msgid "Hibernate does not lock objects in memory. Your application can expect the behavior as defined by the isolation level of your database transactions. Note that thanks to the <literal>Session</literal>, which is also a transaction-scoped cache, Hibernate provides repeatable reads for lookup by identifier and entity queries (not reporting queries that return scalar values)." -msgstr "Hibernateはメモリ内のオブジェクトをロックしません。 アプリケーションは、データベーストランザクションの分離レベルで 定義した振る舞いを期待できます。 トランザクションスコープのキャッシュでもある <literal>Session</literal> のお陰で、 識別子やクエリにより検索したエンティティはリピータブルリードになります （スカラー値を返すようなレポートクエリは違います）。" +#. Tag: para +#: transactions.xml:14 +#, no-c-format +msgid "" +"Hibernate does not lock objects in memory. Your application can expect the " +"behavior as defined by the isolation level of your database transactions. " +"Note that thanks to the <literal>Session</literal>, which is also a " +"transaction-scoped cache, Hibernate provides repeatable reads for lookup by " +"identifier and entity queries (not reporting queries that return scalar " +"values)." +msgstr "" +"Hibernateはメモリ内のオブジェクトをロックしません。 アプリケーションは、デー" +"タベーストランザクションの分離レベルで 定義した振る舞いを期待できます。 トラ" +"ンザクションスコープのキャッシュでもある <literal>Session</literal> のお陰" +"で、 識別子やクエリにより検索したエンティティはリピータブルリードになります " +"（スカラー値を返すようなレポートクエリは違います）。" -#: index.docbook:22 -msgid "In addition to versioning for automatic optimistic concurrency control, Hibernate also offers a (minor) API for pessimistic locking of rows, using the <literal>SELECT FOR UPDATE</literal> syntax. Optimistic concurrency control and this API are discussed later in this chapter." -msgstr "バージョニングによる自動的な楽観的同時実行制御に加えて、 <literal>SELECT FOR UPDATE</literal> 文を使用して、 行を悲観的ロックするための（マイナーな）APIも提供します。 楽観的同時実行制御とこのAPIについては、この章の後のほうで議論します。" +#. Tag: para +#: transactions.xml:22 +#, no-c-format +msgid "" +"In addition to versioning for automatic optimistic concurrency control, " +"Hibernate also offers a (minor) API for pessimistic locking of rows, using " +"the <literal>SELECT FOR UPDATE</literal> syntax. Optimistic concurrency " +"control and this API are discussed later in this chapter." +msgstr "" +"バージョニングによる自動的な楽観的同時実行制御に加えて、 <literal>SELECT FOR " +"UPDATE</literal> 文を使用して、 行を悲観的ロックするための（マイナーな）APIも" +"提供します。 楽観的同時実行制御とこのAPIについては、この章の後のほうで議論し" +"ます。" -#: index.docbook:29 -msgid "We start the discussion of concurrency control in Hibernate with the granularity of <literal>Configuration</literal>, <literal>SessionFactory</literal>, and <literal>Session</literal>, as well as database transactions and long conversations." -msgstr "データベーストランザクションや長い対話（conversation、ロングトランザクション）だけでなく、 <literal>Configuration</literal>、<literal>SessionFactory</literal>、および <literal>Session</literal> という粒度でHibernateが行う同時実行制御の議論を始めます。" +#. Tag: para +#: transactions.xml:29 +#, no-c-format +msgid "" +"We start the discussion of concurrency control in Hibernate with the " +"granularity of <literal>Configuration</literal>, <literal>SessionFactory</" +"literal>, and <literal>Session</literal>, as well as database transactions " +"and long conversations." +msgstr "" +"データベーストランザクションや長い対話（conversation、ロングトランザクショ" +"ン）だけでなく、 <literal>Configuration</literal>、<literal>SessionFactory</" +"literal>、および <literal>Session</literal> という粒度でHibernateが行う同時実" +"行制御の議論を始めます。" -#: index.docbook:36 +#. Tag: title +#: transactions.xml:36 +#, no-c-format msgid "Session and transaction scopes" msgstr "sessionスコープとtransactionスコープ" -#: index.docbook:38 -msgid "A <literal>SessionFactory</literal> is an expensive-to-create, threadsafe object intended to be shared by all application threads. It is created once, usually on application startup, from a <literal>Configuration</literal> instance." -msgstr "<literal>SessionFactory</literal> は生成することが高価で、 スレッドセーフなオブジェクトです。 よって、アプリケーションのすべてのスレッドで共有すべきです。 通常、アプリケーションの起動時に、 <literal>Configuration</literal> インスタンスから１度だけ生成します。" +#. Tag: para +#: transactions.xml:38 +#, no-c-format +msgid "" +"A <literal>SessionFactory</literal> is an expensive-to-create, threadsafe " +"object intended to be shared by all application threads. It is created once, " +"usually on application startup, from a <literal>Configuration</literal> " +"instance." +msgstr "" +"<literal>SessionFactory</literal> は生成することが高価で、 スレッドセーフなオ" +"ブジェクトです。 よって、アプリケーションのすべてのスレッドで共有すべきで" +"す。 通常、アプリケーションの起動時に、 <literal>Configuration</literal> イン" +"スタンスから１度だけ生成します。" -#: index.docbook:44 -msgid "A <literal>Session</literal> is an inexpensive, non-threadsafe object that should be used once, for a single request, a conversation, single unit of work, and then discarded. A <literal>Session</literal> will not obtain a JDBC <literal>Connection</literal> (or a <literal>Datasource</literal>) unless it is needed, hence consume no resources until used." -msgstr "<literal>Session</literal> は高価ではなく、スレッドセーフなオブジェクトでもありません。 よって、１つの要求や１つの対話、１つの作業単位（unit of work）に対して１度だけ使い、 その後で捨てるべきです。 <literal>Session</literal> は必要になるまで、 JDBC <literal>Connection</literal>（もしくは <literal>DataSource</literal>）を獲得しません。 ゆえに、実際に使用するときまでリソースを消費しません。" +#. Tag: para +#: transactions.xml:44 +#, no-c-format +msgid "" +"A <literal>Session</literal> is an inexpensive, non-threadsafe object that " +"should be used once, for a single request, a conversation, single unit of " +"work, and then discarded. A <literal>Session</literal> will not obtain a " +"JDBC <literal>Connection</literal> (or a <literal>Datasource</literal>) " +"unless it is needed, hence consume no resources until used." +msgstr "" +"<literal>Session</literal> は高価ではなく、スレッドセーフなオブジェクトでもあ" +"りません。 よって、１つの要求や１つの対話、１つの作業単位（unit of work）に対" +"して１度だけ使い、 その後で捨てるべきです。 <literal>Session</literal> は必要" +"になるまで、 JDBC <literal>Connection</literal>（もしくは " +"<literal>DataSource</literal>）を獲得しません。 ゆえに、実際に使用するときま" +"でリソースを消費しません。" -#: index.docbook:52 -msgid "To complete this picture you also have to think about database transactions. A database transaction has to be as short as possible, to reduce lock contention in the database. Long database transactions will prevent your application from scaling to highly concurrent load. Hence, it is almost never good design to hold a database transaction open during user think time, until the unit of work is complete." -msgstr "この状況を完了させるために、 データベーストランザクションについても考えなければなりません。 データベース内のロックの競合を少なくするために、 データベーストランザクションは可能な限り短くするべきです。 長いデータベーストランザクションは、アプリケーションの高い並列実行性を阻害します。 ゆえに、ユーザーが考えている間（作業単位が完了するまで）データベーストランザクションを 開いたままにするのは、たいていの場合よい設計とはいえません。" +#. Tag: para +#: transactions.xml:52 +#, no-c-format +msgid "" +"To complete this picture you also have to think about database transactions. " +"A database transaction has to be as short as possible, to reduce lock " +"contention in the database. Long database transactions will prevent your " +"application from scaling to highly concurrent load. Hence, it is almost " +"never good design to hold a database transaction open during user think " +"time, until the unit of work is complete." +msgstr "" +"この状況を完了させるために、 データベーストランザクションについても考えなけれ" +"ばなりません。 データベース内のロックの競合を少なくするために、 データベース" +"トランザクションは可能な限り短くするべきです。 長いデータベーストランザクショ" +"ンは、アプリケーションの高い並列実行性を阻害します。 ゆえに、ユーザーが考えて" +"いる間（作業単位が完了するまで）データベーストランザクションを 開いたままにす" +"るのは、たいていの場合よい設計とはいえません。" -#: index.docbook:61 -msgid "What is the scope of a unit of work? Can a single Hibernate <literal>Session</literal> span several database transactions or is this a one-to-one relationship of scopes? When should you open and close a <literal>Session</literal> and how do you demarcate the database transaction boundaries?" -msgstr "作業単位というスコープとは何でしょうか？ １つのHibernate <literal>Session</literal> は、 いくつかのデータベーストランザクションをまたがることができるでしょうか？ または、スコープと一対一の関係でしょうか？ いつ <literal>Session</literal> を開き、閉じるべきでしょうか？ そして、データベーストランザクション境界をどのように分けるのでしょうか？" +#. Tag: para +#: transactions.xml:61 +#, no-c-format +msgid "" +"What is the scope of a unit of work? Can a single Hibernate " +"<literal>Session</literal> span several database transactions or is this a " +"one-to-one relationship of scopes? When should you open and close a " +"<literal>Session</literal> and how do you demarcate the database transaction " +"boundaries?" +msgstr "" +"作業単位というスコープとは何でしょうか？ １つのHibernate <literal>Session</" +"literal> は、 いくつかのデータベーストランザクションをまたがることができるで" +"しょうか？ または、スコープと一対一の関係でしょうか？ いつ <literal>Session</" +"literal> を開き、閉じるべきでしょうか？ そして、データベーストランザクション" +"境界をどのように分けるのでしょうか？" -#: index.docbook:69 +#. Tag: title +#: transactions.xml:69 +#, no-c-format msgid "Unit of work" msgstr "作業単位（Unit of work）" -#: index.docbook:71 -msgid "First, don't use the <emphasis>session-per-operation</emphasis> antipattern, that is, don't open and close a <literal>Session</literal> for every simple database call in a single thread! Of course, the same is true for database transactions. Database calls in an application are made using a planned sequence, they are grouped into atomic units of work. (Note that this also means that auto-commit after every single SQL statement is useless in an application, this mode is intended for ad-hoc SQL console work. Hibernate disables, or expects the application server to do so, auto-commit mode immediately.) Database transactions are never optional, all communication with a database has to occur inside a transaction, no matter if you read or write data. As explained, auto-commit behavior for reading data should be avoided, as many small transactions are unlikely to perform better than one clearly defined unit of work. The latter is also much more maintainable and extensible." -msgstr "１つ目は、<emphasis>session-per-operation</emphasis> アンチパターンを使ってはいけません。 すなわち、１つのスレッドの中で、単純なデータベース呼び出しのたびに <literal>Session</literal> を開いて、閉じてはいけません！ もちろん、データベーストランザクションについても同様です。 アプリケーション中のデータベース呼び出しは、 計画されたシーケンス（planned sequence）を使い、 アトミックな作業単位に分類されます。 （１つのSQL文ごとにコミットする自動コミットが、 使われないという意味でもあることに注意してください。 自動コミットは、SQLコンソールでアドホックな作業をする際に使うものです。 Hibernateは直ちに自動コミットモードを無効にします。 もしくは、アプリケーションサーバーが無効化することを期待しま�! ��。） データベーストランザクションはオプションではありません。 データベースとのすべての通信は、データの読み込みであっても、書き込みであっても、 トランザクションの中で行わなければなりません。 説明すると、データ読み込みに対して、自動コミットは避けるべきです。 なぜなら、多数の小さなトランザクションは、明確に定義された１つの作業単位と比べて、 パフォーマンスがよくなることはありません。 後者は保守性や拡張性もよりすぐれています。" +#. Tag: para +#: transactions.xml:71 +#, no-c-format +msgid "" +"First, don't use the <emphasis>session-per-operation</emphasis> antipattern, " +"that is, don't open and close a <literal>Session</literal> for every simple " +"database call in a single thread! Of course, the same is true for database " +"transactions. Database calls in an application are made using a planned " +"sequence, they are grouped into atomic units of work. (Note that this also " +"means that auto-commit after every single SQL statement is useless in an " +"application, this mode is intended for ad-hoc SQL console work. Hibernate " +"disables, or expects the application server to do so, auto-commit mode " +"immediately.) Database transactions are never optional, all communication " +"with a database has to occur inside a transaction, no matter if you read or " +"write data. As explained, auto-commit behavior for reading data should be " +"avoided, as many small transactions are unlikely to perform better than one " +"clearly defined unit of work. The latter is also much more maintainable and " +"extensible." +msgstr "" +"１つ目は、<emphasis>session-per-operation</emphasis> アンチパターンを使っては" +"いけません。 すなわち、１つのスレッドの中で、単純なデータベース呼び出しのたび" +"に <literal>Session</literal> を開いて、閉じてはいけません！ もちろん、データ" +"ベーストランザクションについても同様です。 アプリケーション中のデータベース呼" +"び出しは、 計画されたシーケンス（planned sequence）を使い、 アトミックな作業" +"単位に分類されます。 （１つのSQL文ごとにコミットする自動コミットが、 使われな" +"いという意味でもあることに注意してください。 自動コミットは、SQLコンソールで" +"アドホックな作業をする際に使うものです。 Hibernateは直ちに自動コミットモード" +"を無効にします。 もしくは、アプリケーションサーバーが無効化することを期待しま" +"す。） データベーストランザクションはオプションではありません。 データベース" +"とのすべての通信は、データの読み込みであっても、書き込みであっても、 トランザ" +"クションの中で行わなければなりません。 説明すると、データ読み込みに対して、自" +"動コミットは避けるべきです。 なぜなら、多数の小さなトランザクションは、明確に" +"定義された１つの作業単位と比べて、 パフォーマンスがよくなることはありませ" +"ん。 後者は保守性や拡張性もよりすぐれています。" -#: index.docbook:87 -msgid "The most common pattern in a multi-user client/server application is <emphasis>session-per-request</emphasis>. In this model, a request from the client is send to the server (where the Hibernate persistence layer runs), a new Hibernate <literal>Session</literal> is opened, and all database operations are executed in this unit of work. Once the work has been completed (and the response for the client has been prepared), the session is flushed and closed. You would also use a single database transaction to serve the clients request, starting and committing it when you open and close the <literal>Session</literal>. The relationship between the two is one-to-one and this model is a perfect fit for many applications." -msgstr "マルチユーザーのクライアント／サーバーアプリケーションの中で、 最もよく使われるパターンは、<emphasis>session-per-request</emphasis> です。 このモデルの中では、 クライアントから（Hibernate永続化層が動作する）サーバーへリクエストが送られ、 新しいHibernate <literal>Session</literal> が開かれます。 そして、この作業単位の中ですべてのデータベース処理が実行されます。 作業が完了した（そして、クライアントへのレスポンスが準備できた）時点で、 session をフラッシュし、閉じます。 クライアントの要求を処理するために、１つのデータベーストランザクションを使用するでしょう。 <literal>Session</literal> を開き、閉じる際に、 データベーストランザクションを開始し、コミットします。 二つの関係は一対一です。 このモデ! ルは多くのアプリケーションに完全に適合します。" +#. Tag: para +#: transactions.xml:87 +#, no-c-format +msgid "" +"The most common pattern in a multi-user client/server application is " +"<emphasis>session-per-request</emphasis>. In this model, a request from the " +"client is send to the server (where the Hibernate persistence layer runs), a " +"new Hibernate <literal>Session</literal> is opened, and all database " +"operations are executed in this unit of work. Once the work has been " +"completed (and the response for the client has been prepared), the session " +"is flushed and closed. You would also use a single database transaction to " +"serve the clients request, starting and committing it when you open and " +"close the <literal>Session</literal>. The relationship between the two is " +"one-to-one and this model is a perfect fit for many applications." +msgstr "" +"マルチユーザーのクライアント／サーバーアプリケーションの中で、 最もよく使われ" +"るパターンは、<emphasis>session-per-request</emphasis> です。 このモデルの中" +"では、 クライアントから（Hibernate永続化層が動作する）サーバーへリクエストが" +"送られ、 新しいHibernate <literal>Session</literal> が開かれます。 そして、こ" +"の作業単位の中ですべてのデータベース処理が実行されます。 作業が完了した（そし" +"て、クライアントへのレスポンスが準備できた）時点で、 session をフラッシュし、" +"閉じます。 クライアントの要求を処理するために、１つのデータベーストランザク" +"ションを使用するでしょう。 <literal>Session</literal> を開き、閉じる際に、 " +"データベーストランザクションを開始し、コミットします。 二つの関係は一対一で" +"す。 このモデルは多くのアプリケーションに完全に適合します。" -#: index.docbook:99 -msgid "The challenge lies in the implementation. Hibernate provides built-in management of the \"current session\" to simplify this pattern. All you have to do is start a transaction when a server request has to be processed, and end the transaction before the response is send to the client. You can do this in any way you like, common solutions are <literal>ServletFilter</literal>, AOP interceptor with a pointcut on the service methods, or a proxy/interception container. An EJB container is a standardized way to implement cross-cutting aspects such as transaction demarcation on EJB session beans, declaratively with CMT. If you decide to use programmatic transaction demarcation, prefer the Hibernate <literal>Transaction</literal> API shown later in this chapter, for ease of use and code portability." -msgstr "以降の実装にチャレンジしてください。 <literal>Session</literal> を持ち、トランザクションを正確に開始し、終わらせるだけでなく、 データアクセス操作も得やすくする必要があります。 リクエストがサーバーにヒットした際と、レスポンスを送信する前に、実行されるinterceptor （例えば、<literal>ServletFilter</literal>）を使って、作業単位の境界を実装するのが理想的です。 <literal>ThreadLocal</literal> 変数を使って、 リクエストを処理するスレッドに <literal>Session</literal> を結びつけることを推奨します。 これにより、スレッド内で実行されるすべてのコードで、 （static変数にアクセスするように）簡単に <literal>Session</literal> にアクセスできるようになります。 選択したデータベーストランザクション境界の機構次第で、<literal>ThreadL! ocal</literal> 変数の中にトランザクションコンテキストを保持するかもしれません。 この実装パターンは、<emphasis>ThreadLocal Session</emphasis> および <emphasis>Open Session in View</emphasis> という名前で知られています。 本ドキュメントで先に見せた <literal>HibernateUtil</literal> ヘルパークラスを拡張することで、 このパターンを容易に実装できます。 もちろん、interceptor を実装する方法を見つけ、環境をセットアップする必要があります。 HibernateのWebサイトにあるtipsと例を参照してください。" +#. Tag: para +#: transactions.xml:99 +#, no-c-format +msgid "" +"The challenge lies in the implementation. Hibernate provides built-in " +"management of the \"current session\" to simplify this pattern. All you have " +"to do is start a transaction when a server request has to be processed, and " +"end the transaction before the response is send to the client. You can do " +"this in any way you like, common solutions are <literal>ServletFilter</" +"literal>, AOP interceptor with a pointcut on the service methods, or a proxy/" +"interception container. An EJB container is a standardized way to implement " +"cross-cutting aspects such as transaction demarcation on EJB session beans, " +"declaratively with CMT. If you decide to use programmatic transaction " +"demarcation, prefer the Hibernate <literal>Transaction</literal> API shown " +"later in this chapter, for ease of use and code portability." +msgstr "" +"以降の実装にチャレンジしてください。 Hibernateは単純なこのパターンのために、" +"予め組み込まれた 「current session」の管理を提供します。 サーバーリクエストを" +"処理する際はトランザクションを開始しなければなりません。 そして、レスポンスを" +"クライアントに送信する前にトランザクションを終わらせます。 好きな方法で実現で" +"きます。一般的な解決策は <literal>ServletFilter</literal> や サービスメソッド" +"をポイントカットしてAOPインターセプター、 proxy/interception コンテナです。 " +"EJBコンテナはEJBセッションビーンをトランザクション境界として アスペクトをクロ" +"スカットする実装の標準的な方法です（CMTによる宣言的）。 プログラムによるトラ" +"ンザクション境界を使うと決めた場合、 簡単に使うため、互換性のあるコードにする" +"ために、 この章の後のほうにあるHibernate <literal>Transaction</literal> APIの" +"ほうがよいです。" -#: index.docbook:112 -msgid "Your application code can access a \"current session\" to process the request by simply calling <literal>sessionFactory.getCurrentSession()</literal> anywhere and as often as needed. You will always get a <literal>Session</literal> scoped to the current database transaction. This has to be configured for either resource-local or JTA environments, see <xref linkend=\"architecture-current-session\"/>." -msgstr "以降の実装にチャレンジしてください。 Hibernateは単純なこのパターンのために、予め組み込まれた 「current session」の管理を提供します。 サーバーリクエストを処理する際はトランザクションを開始しなければなりません。 そして、レスポンスをクライアントに送信する前にトランザクションを終わらせます。 好きな方法で実現できます。一般的な解決策は <literal>ServletFilter</literal> や サービスメソッドをポイントカットしてAOPインターセプター、 proxy/interception コンテナです。 EJBコンテナはEJBセッションビーンをトランザクション境界として アスペクトをクロスカットする実装の標準的な方法です（CMTによる宣言的）。 プログラムによるトランザクション境界を使うと決めた場合、 簡単に使うため、互換性のあるコードに�! ��るために、 この章の後のほうにあるHibernate <literal>Transaction</literal> APIのほうがよいです。" +#. Tag: para +#: transactions.xml:112 +#, no-c-format +msgid "" +"Your application code can access a \"current session\" to process the " +"request by simply calling <literal>sessionFactory.getCurrentSession()</" +"literal> anywhere and as often as needed. You will always get a " +"<literal>Session</literal> scoped to the current database transaction. This " +"has to be configured for either resource-local or JTA environments, see " +"<xref linkend=\"architecture-current-session\"/>." +msgstr "" +"アプリケーションのコードは、必要なときにどこでも、何回でも、 単に " +"<literal>sessionFactory.getCurrentSession()</literal> を呼び出すだけで 「現在" +"のセッション」にアクセスできます。 現在のデータベーストランザクションへの " +"<literal>セッション</literal> を常に取得します。 リソース・ローカルな環境、も" +"しくはJTA環境を構成しなければなりません （<xref linkend=\"architecture-" +"current-session\"/> を参照してください）。" -#: index.docbook:120 -msgid "Sometimes it is convenient to extend the scope of a <literal>Session</literal> and database transaction until the \"view has been rendered\". This is especially useful in servlet applications that utilize a separate rendering phase after the request has been processed. Extending the database transaction until view rendering is complete is easy to do if you implement your own interceptor. However, it is not easily doable if you rely on EJBs with container-managed transactions, as a transaction will be completed when an EJB method returns, before rendering of any view can start. See the Hibernate website and forum for tips and examples around this <emphasis>Open Session in View</emphasis> pattern." -msgstr "アプリケーションのコードは、必要なときにどこでも、何回でも、 単に <literal>sessionFactory.getCurrentSession()</literal> を呼び出すだけで 「現在のセッション」にアクセスできます。 現在のデータベーストランザクションへの <literal>セッション</literal> を常に取得します。 リソース・ローカルな環境、もしくはJTA環境を構成しなければなりません （<xref linkend=\"architecture-current-session\"/> を参照してください）。" +#. Tag: para +#: transactions.xml:120 +#, no-c-format +msgid "" +"Sometimes it is convenient to extend the scope of a <literal>Session</" +"literal> and database transaction until the \"view has been rendered\". This " +"is especially useful in servlet applications that utilize a separate " +"rendering phase after the request has been processed. Extending the database " +"transaction until view rendering is complete is easy to do if you implement " +"your own interceptor. However, it is not easily doable if you rely on EJBs " +"with container-managed transactions, as a transaction will be completed when " +"an EJB method returns, before rendering of any view can start. See the " +"Hibernate website and forum for tips and examples around this <emphasis>Open " +"Session in View</emphasis> pattern." +msgstr "" +"ときどき、「ビューを描画する」まで <literal>セッション</literal> とデータベー" +"ストランザクションのスコープを拡張すると便利なことがあります。 これは、要求の" +"処理と描画のフェーズを分けている サーブレットアプリケーションにおいて特に役立" +"ちます。 独自のインターセプタを実装すれば、 ビューを描画するまでデータベース" +"トランザクションを拡張するのは簡単です。 しかし、コンテナ管理トランザクション" +"のEJBに頼る場合は、簡単にはできません。 なぜなら、ビューの描画を開始する前" +"に、EJBのメソッドがリターンした際に、 トランザクションが完了するためです。 こ" +"の <emphasis>Open Session in View</emphasis> パターンに関連するヒントと例につ" +"いては、 HibernateのWebサイトやフォーラムを参照してください。" -#: index.docbook:135 +#. Tag: title +#: transactions.xml:135 +#, no-c-format msgid "Long conversations" -msgstr "ときどき、「ビューを描画する」まで <literal>セッション</literal> とデータベーストランザクションのスコープを拡張すると便利なことがあります。 これは、要求の処理と描画のフェーズを分けている サーブレットアプリケーションにおいて特に役立ちます。 独自のインターセプタを実装すれば、 ビューを描画するまでデータベーストランザクションを拡張するのは簡単です。 しかし、コンテナ管理トランザクションのEJBに頼る場合は、簡単にはできません。 なぜなら、ビューの描画を開始する前に、EJBのメソッドがリターンした際に、 トランザクションが完了するためです。 この <emphasis>Open Session in View</emphasis> パターンに関連するヒントと例については、 HibernateのWebサイトやフォーラムを参照してください。" - -#: index.docbook:137 -msgid "The session-per-request pattern is not the only useful concept you can use to design units of work. Many business processes require a whole series of interactions with the user interleaved with database accesses. In web and enterprise applications it is not acceptable for a database transaction to span a user interaction. Consider the following example:" msgstr "長い対話" -#: index.docbook:147 -msgid "The first screen of a dialog opens, the data seen by the user has been loaded in a particular <literal>Session</literal> and database transaction. The user is free to modify the objects." -msgstr "session-per-requestパターンは、作業単位を設計する際に役立つ考えというだけではありません。 多くのビジネスプロセスは、ユーザーとの一連の相互作用全体を要求します。 その相互作用には、データベースアクセスが含まれます。 Webとエンタープライズアプリケーションでは、データベーストランザクションが ユーザとの相互作用にまで渡ることは許されません。 次の例をよく考えてみてください。" +#. Tag: para +#: transactions.xml:137 +#, no-c-format +msgid "" +"The session-per-request pattern is not the only useful concept you can use " +"to design units of work. Many business processes require a whole series of " +"interactions with the user interleaved with database accesses. In web and " +"enterprise applications it is not acceptable for a database transaction to " +"span a user interaction. Consider the following example:" +msgstr "" +"session-per-requestパターンは、作業単位を設計する際に役立つ考えというだけでは" +"ありません。 多くのビジネスプロセスは、ユーザーとの一連の相互作用全体を要求し" +"ます。 その相互作用には、データベースアクセスが含まれます。 Webとエンタープラ" +"イズアプリケーションでは、データベーストランザクションが ユーザとの相互作用に" +"まで渡ることは許されません。 次の例をよく考えてみてください。" -#: index.docbook:154 -msgid "The user clicks \"Save\" after 5 minutes and expects his modifications to be made persistent; he also expects that he was the only person editing this information and that no conflicting modification can occur." -msgstr "ダイアログの最初の画面が開き、個々の <literal>Session</literal> とデータベーストランザクションの中でロードされたデータをユーザーに見せます。 ユーザーはオブジェクトを自由に修正できます。" +#. Tag: para +#: transactions.xml:147 +#, no-c-format +msgid "" +"The first screen of a dialog opens, the data seen by the user has been " +"loaded in a particular <literal>Session</literal> and database transaction. " +"The user is free to modify the objects." +msgstr "" +"ダイアログの最初の画面が開き、個々の <literal>Session</literal> とデータベー" +"ストランザクションの中でロードされたデータをユーザーに見せます。 ユーザーはオ" +"ブジェクトを自由に修正できます。" -#: index.docbook:162 -msgid "We call this unit of work, from the point of view of the user, a long running <emphasis>conversation</emphasis> (or <emphasis>application transaction</emphasis>). There are many ways how you can implement this in your application." -msgstr "5分後にユーザーは「Save」をクリックし、修正が永続化されるのを期待します。 また、この情報を編集したのは自分１人だけで、 修正のコンフリクトは発生しないと期待します。" +#. Tag: para +#: transactions.xml:154 +#, no-c-format +msgid "" +"The user clicks \"Save\" after 5 minutes and expects his modifications to be " +"made persistent; he also expects that he was the only person editing this " +"information and that no conflicting modification can occur." +msgstr "" +"5分後にユーザーは「Save」をクリックし、修正が永続化されるのを期待します。 ま" +"た、この情報を編集したのは自分１人だけで、 修正のコンフリクトは発生しないと期" +"待します。" -#: index.docbook:168 -msgid "A first naive implementation might keep the <literal>Session</literal> and database transaction open during user think time, with locks held in the database to prevent concurrent modification, and to guarantee isolation and atomicity. This is of course an anti-pattern, since lock contention would not allow the application to scale with the number of concurrent users." -msgstr "この作業単位を（ユーザーの視点で）長期の <emphasis>対話</emphasis> （もしくは、<emphasis>アプリケーショントランザクション</emphasis> ）と呼びます。 アプリケーションにこれを実装する方法はたくさんあります。" +#. Tag: para +#: transactions.xml:162 +#, no-c-format +msgid "" +"We call this unit of work, from the point of view of the user, a long " +"running <emphasis>conversation</emphasis> (or <emphasis>application " +"transaction</emphasis>). There are many ways how you can implement this in " +"your application." +msgstr "" +"この作業単位を（ユーザーの視点で）長期の <emphasis>対話</emphasis> （もしく" +"は、<emphasis>アプリケーショントランザクション</emphasis> ）と呼びます。 アプ" +"リケーションにこれを実装する方法はたくさんあります。" -#: index.docbook:176 -msgid "Clearly, we have to use several database transactions to implement the converastion. In this case, maintaining isolation of business processes becomes the partial responsibility of the application tier. A single conversation usually spans several database transactions. It will be atomic if only one of these database transactions (the last one) stores the updated data, all others simply read data (e.g. in a wizard-style dialog spanning several request/response cycles). This is easier to implement than it might sound, especially if you use Hibernate's features:" -msgstr "最初に思いつく実装は、ユーザーが考えている間、<literal>Session</literal> とデータベーストランザクションを開いたままにしておくことです。 同時に修正されず、分離と原子性が保証されるように、 データベース内のロックは保持したままにします。 もちろん、これはアンチパターンです。 なぜなら、ロックの競合が発生すると、 アプリケーションが同時ユーザー数に応じてスケールアップできなくなるからです。" +#. Tag: para +#: transactions.xml:168 +#, no-c-format +msgid "" +"A first naive implementation might keep the <literal>Session</literal> and " +"database transaction open during user think time, with locks held in the " +"database to prevent concurrent modification, and to guarantee isolation and " +"atomicity. This is of course an anti-pattern, since lock contention would " +"not allow the application to scale with the number of concurrent users." +msgstr "" +"最初に思いつく実装は、ユーザーが考えている間、<literal>Session</literal> と" +"データベーストランザクションを開いたままにしておくことです。 同時に修正され" +"ず、分離と原子性が保証されるように、 データベース内のロックは保持したままにし" +"ます。 もちろん、これはアンチパターンです。 なぜなら、ロックの競合が発生する" +"と、 アプリケーションが同時ユーザー数に応じてスケールアップできなくなるからで" +"す。" -#: index.docbook:189 -msgid "<emphasis>Automatic Versioning</emphasis> - Hibernate can do automatic optimistic concurrency control for you, it can automatically detect if a concurrent modification occured during user think time. Usually we only check at the end of the conversation." -msgstr "明らかに、対話を実装するためには、 いくつかのデータベーストランザクションを使用するべきです。 この場合、ビジネスプロセスの分離を維持することは、 アプリケーション層の責務の１つになります。 １つの対話は、 通常いくつかのデータベーストランザクションに及びます。 データベーストランザクションの１つのみ（最後の１つ）が更新したデータを保存し、 他はデータを読むだけであれば、それはアトミックです （例えば、いくつかの要求／応答を繰り返すウィザード形式のダイアログ）。 これは聞くより、実装したほうが簡単です。 Hibernateの機能を使うのであれば、特に簡単です。" +#. Tag: para +#: transactions.xml:176 +#, no-c-format +msgid "" +"Clearly, we have to use several database transactions to implement the " +"converastion. In this case, maintaining isolation of business processes " +"becomes the partial responsibility of the application tier. A single " +"conversation usually spans several database transactions. It will be atomic " +"if only one of these database transactions (the last one) stores the updated " +"data, all others simply read data (e.g. in a wizard-style dialog spanning " +"several request/response cycles). This is easier to implement than it might " +"sound, especially if you use Hibernate's features:" +msgstr "" +"明らかに、対話を実装するためには、 いくつかのデータベーストランザクションを使" +"用するべきです。 この場合、ビジネスプロセスの分離を維持することは、 アプリ" +"ケーション層の責務の１つになります。 １つの対話は、 通常いくつかのデータベー" +"ストランザクションに及びます。 データベーストランザクションの１つのみ（最後の" +"１つ）が更新したデータを保存し、 他はデータを読むだけであれば、それはアトミッ" +"クです （例えば、いくつかの要求／応答を繰り返すウィザード形式のダイアロ" +"グ）。 これは聞くより、実装したほうが簡単です。 Hibernateの機能を使うのであれ" +"ば、特に簡単です。" -#: index.docbook:197 -msgid "<emphasis>Detached Objects</emphasis> - If you decide to use the already discussed <emphasis>session-per-request</emphasis> pattern, all loaded instances will be in detached state during user think time. Hibernate allows you to reattach the objects and persist the modifications, the pattern is called <emphasis>session-per-request-with-detached-objects</emphasis>. Automatic versioning is used to isolate concurrent modifications." -msgstr "<emphasis>自動バージョニング</emphasis> - Hibernateは自動的に楽観的同時実行制御ができます。 ユーザーが考えている間に同時に修正がおきた場合、自動的に検出できます。 通常、対話の終了時にチェックするだけです。" +#. Tag: para +#: transactions.xml:189 +#, no-c-format +msgid "" +"<emphasis>Automatic Versioning</emphasis> - Hibernate can do automatic " +"optimistic concurrency control for you, it can automatically detect if a " +"concurrent modification occured during user think time. Usually we only " +"check at the end of the conversation." +msgstr "" +"<emphasis>自動バージョニング</emphasis> - Hibernateは自動的に楽観的同時実行制" +"御ができます。 ユーザーが考えている間に同時に修正がおきた場合、自動的に検出で" +"きます。 通常、対話の終了時にチェックするだけです。" -#: index.docbook:207 -msgid "<emphasis>Extended (or Long) Session</emphasis> - The Hibernate <literal>Session</literal> may be disconnected from the underlying JDBC connection after the database transaction has been committed, and reconnected when a new client request occurs. This pattern is known as <emphasis>session-per-conversation</emphasis> and makes even reattachment unnecessary. Automatic versioning is used to isolate concurrent modifications and the <literal>Session</literal> is usually not allowed to be flushed automatically, but explicitely." -msgstr "<emphasis>分離（Detached）オブジェクト</emphasis> - すでに議論した <emphasis>session-per-request</emphasis> パターンを使うと決定した場合、 ロードされたすべてのインスタンスは、ユーザが考えている間は、 セッションから分離された状態になります。 オブジェクトをセッションに再追加し、修正を永続化できます。 これを <emphasis>session-per-request-with-detached-objects</emphasis> パターンと呼びます。 自動バージョニングを使うことで、同時に行われる修正を分離できます。" +#. Tag: para +#: transactions.xml:197 +#, no-c-format +msgid "" +"<emphasis>Detached Objects</emphasis> - If you decide to use the already " +"discussed <emphasis>session-per-request</emphasis> pattern, all loaded " +"instances will be in detached state during user think time. Hibernate allows " +"you to reattach the objects and persist the modifications, the pattern is " +"called <emphasis>session-per-request-with-detached-objects</emphasis>. " +"Automatic versioning is used to isolate concurrent modifications." +msgstr "" +"<emphasis>分離（Detached）オブジェクト</emphasis> - すでに議論した " +"<emphasis>session-per-request</emphasis> パターンを使うと決定した場合、 ロー" +"ドされたすべてのインスタンスは、ユーザが考えている間は、 セッションから分離さ" +"れた状態になります。 オブジェクトをセッションに再追加し、修正を永続化できま" +"す。 これを <emphasis>session-per-request-with-detached-objects</emphasis> パ" +"ターンと呼びます。 自動バージョニングを使うことで、同時に行われる修正を分離で" +"きます。" -#: index.docbook:220 -msgid "Both <emphasis>session-per-request-with-detached-objects</emphasis> and <emphasis>session-per-conversation</emphasis> have advantages and disadvantages, we discuss them later in this chapter in the context of optimistic concurrency control." -msgstr "<emphasis>拡張（もしくは、長い）セッション</emphasis> - Hibernateの <literal>Session</literal> は、 データベーストランザクションをコミットした後、 裏で結びついているJDBCコネクションを切断できます。 そして、クライアントからの新しい要求が発生した際に、再接続できます。 このパターンは、<emphasis>session-per-conversation</emphasis> という名で知られており、オブジェクトをセッションへ再追加することさえ不要にします。 自動バージョニングを使うことで、同時に行われる修正を分離できます。 通常 <literal>Session</literal> を自動的にフラッシュさせず、 明示的にフラッシュします。" +#. Tag: para +#: transactions.xml:207 +#, no-c-format +msgid "" +"<emphasis>Extended (or Long) Session</emphasis> - The Hibernate " +"<literal>Session</literal> may be disconnected from the underlying JDBC " +"connection after the database transaction has been committed, and " +"reconnected when a new client request occurs. This pattern is known as " +"<emphasis>session-per-conversation</emphasis> and makes even reattachment " +"unnecessary. Automatic versioning is used to isolate concurrent " +"modifications and the <literal>Session</literal> is usually not allowed to " +"be flushed automatically, but explicitely." +msgstr "" +"<emphasis>拡張（もしくは、長い）セッション</emphasis> - Hibernateの " +"<literal>Session</literal> は、 データベーストランザクションをコミットした" +"後、 裏で結びついているJDBCコネクションを切断できます。 そして、クライアント" +"からの新しい要求が発生した際に、再接続できます。 このパターンは、" +"<emphasis>session-per-conversation</emphasis> という名で知られており、オブ" +"ジェクトをセッションへ再追加することさえ不要にします。 自動バージョニングを使" +"うことで、同時に行われる修正を分離できます。 通常 <literal>Session</literal> " +"を自動的にフラッシュさせず、 明示的にフラッシュします。" -#: index.docbook:229 +#. Tag: para +#: transactions.xml:220 +#, no-c-format +msgid "" +"Both <emphasis>session-per-request-with-detached-objects</emphasis> and " +"<emphasis>session-per-conversation</emphasis> have advantages and " +"disadvantages, we discuss them later in this chapter in the context of " +"optimistic concurrency control." +msgstr "" +"<emphasis>session-per-request-with-detached-objects</emphasis> と " +"<emphasis>session-per-conversation</emphasis> の２つは、 利点と欠点を持ってい" +"ます。 これについては、この章の後のほうで、楽観的同時実行制御の文脈の中で議論" +"します。" + +#. Tag: title +#: transactions.xml:229 +#, no-c-format msgid "Considering object identity" -msgstr "<emphasis>session-per-request-with-detached-objects</emphasis> と <emphasis>session-per-conversation</emphasis> の２つは、 利点と欠点を持っています。 これについては、この章の後のほうで、楽観的同時実行制御の文脈の中で議論します。" - -#: index.docbook:231 -msgid "An application may concurrently access the same persistent state in two different <literal>Session</literal>s. However, an instance of a persistent class is never shared between two <literal>Session</literal> instances. Hence there are two different notions of identity:" msgstr "オブジェクト識別子を考える" -#: index.docbook:240 +#. Tag: para +#: transactions.xml:231 +#, no-c-format +msgid "" +"An application may concurrently access the same persistent state in two " +"different <literal>Session</literal>s. However, an instance of a persistent " +"class is never shared between two <literal>Session</literal> instances. " +"Hence there are two different notions of identity:" +msgstr "" +"アプリケーションは、２つの異なる <literal>Session</literal> から 同じ永続状態" +"に同時にアクセスできます。 しかし、２つの <literal>Session</literal> インスタ" +"ンスが 永続性クラスの１つのインスタンスを共有することはできません。 ゆえに、" +"識別子には２つの異なる概念があるということになります。" + +#. Tag: term +#: transactions.xml:240 +#, no-c-format msgid "Database Identity" -msgstr "アプリケーションは、２つの異なる <literal>Session</literal> から 同じ永続状態に同時にアクセスできます。 しかし、２つの <literal>Session</literal> インスタンスが 永続性クラスの１つのインスタンスを共有することはできません。 ゆえに、識別子には２つの異なる概念があるということになります。" +msgstr "データベース識別子" -#: index.docbook:243 +#. Tag: literal +#: transactions.xml:243 +#, no-c-format msgid "foo.getId().equals( bar.getId() )" -msgstr "データベース識別子" +msgstr "foo.getId().equals( bar.getId() )" -#: index.docbook:248 +#. Tag: term +#: transactions.xml:248 +#, no-c-format msgid "JVM Identity" -msgstr "foo.getId().equals( bar.getId() )" +msgstr "JVM識別子" -#: index.docbook:251 +#. Tag: literal +#: transactions.xml:251 +#, no-c-format msgid "foo==bar" -msgstr "JVM識別子" - -#: index.docbook:257 -msgid "Then for objects attached to a <emphasis>particular</emphasis> <literal>Session</literal> (i.e. in the scope of a <literal>Session</literal>) the two notions are equivalent, and JVM identity for database identity is guaranteed by Hibernate. However, while the application might concurrently access the \"same\" (persistent identity) business object in two different sessions, the two instances will actually be \"different\" (JVM identity). Conflicts are resolved using (automatic versioning) at flush/commit time, using an optimistic approach." msgstr "foo==bar" -#: index.docbook:266 -msgid "This approach leaves Hibernate and the database to worry about concurrency; it also provides the best scalability, since guaranteeing identity in single-threaded units of work only doesn't need expensive locking or other means of synchronization. The application never needs to synchronize on any business object, as long as it sticks to a single thread per <literal>Session</literal>. Within a <literal>Session</literal> the application may safely use <literal>==</literal> to compare objects." -msgstr "<emphasis>個々の</emphasis> <literal>Session</literal> に追加されたオブジェクトにとって （すなわち、１つの <literal>Session</literal> のスコープの中では）、２つの概念は同じです。 データベース同一性とJVM同一性が一致することを、Hibernateが保証します。 しかし、アプリケーションが２つの異なるセッションから 「同じ」（永続性識別子の）ビジネスオブジェクトに同時にアクセスする限り、 ２つのインスタンスは実際に（JVM識別子が）「異なり」ます。 楽観的アプローチによって、（自動バージョニングの）フラッシュ／コミット時に コンフリクトが解決されます。" +#. Tag: para +#: transactions.xml:257 +#, fuzzy, no-c-format +msgid "" +"Then for objects attached to a <emphasis>particular</emphasis> " +"<literal>Session</literal> (i.e. in the scope of a <literal>Session</" +"literal>) the two notions are equivalent, and JVM identity for database " +"identity is guaranteed by Hibernate. However, while the application might " +"concurrently access the \"same\" (persistent identity) business object in " +"two different sessions, the two instances will actually be \"different" +"\" (JVM identity). Conflicts are resolved using (automatic versioning) at " +"flush/commit time, using an optimistic approach." +msgstr "" +"<emphasis>個々の</emphasis><literal>Session</literal> に追加されたオブジェク" +"トにとって （すなわち、１つの <literal>Session</literal> のスコープの中で" +"は）、２つの概念は同じです。 データベース同一性とJVM同一性が一致することを、" +"Hibernateが保証します。 しかし、アプリケーションが２つの異なるセッションから " +"「同じ」（永続性識別子の）ビジネスオブジェクトに同時にアクセスする限り、 ２つ" +"のインスタンスは実際に（JVM識別子が）「異なり」ます。 楽観的アプローチによっ" +"て、（自動バージョニングの）フラッシュ／コミット時に コンフリクトが解決されま" +"す。" -#: index.docbook:275 -msgid "However, an application that uses <literal>==</literal> outside of a <literal>Session</literal>, might see unexpected results. This might occur even in some unexpected places, for example, if you put two detached instances into the same <literal>Set</literal>. Both might have the same database identity (i.e. they represent the same row), but JVM identity is by definition not guaranteed for instances in detached state. The developer has to override the <literal>equals()</literal> and <literal>hashCode()</literal> methods in persistent classes and implement his own notion of object equality. There is one caveat: Never use the database identifier to implement equality, use a business key, a combination of unique, usually immutable, attributes. The database identifier will change if a transient object is made persistent. If the transient instance (usually together with detached instances) is held in a <literal>Set</literal>, changing the hashcode breaks the contract of t! he <literal>Set</literal>. Attributes for business keys don't have to be as stable as database primary keys, you only have to guarantee stability as long as the objects are in the same <literal>Set</literal>. See the Hibernate website for a more thorough discussion of this issue. Also note that this is not a Hibernate issue, but simply how Java object identity and equality has to be implemented." -msgstr "このアプローチでは、Hibernateとデータベースに同時実行についての心配が残ります。 一方で、最高のスケーラビリティが提供されます。 なぜなら、１スレッドの作業単位の中で一意性が保証されれば、 高価なロックや同期化が不要になるためです。 <literal>Session</literal> ごとに１つのスレッドを貼り付ける限り、 アプリケーションはビジネスオブジェクトをsynchronizeする必要はありません。 <literal>Session</literal> 内では、アプリケーションはオブジェクトを比較するために、 <literal>==</literal> を安全に使用できます。" +#. Tag: para +#: transactions.xml:266 +#, no-c-format +msgid "" +"This approach leaves Hibernate and the database to worry about concurrency; " +"it also provides the best scalability, since guaranteeing identity in single-" +"threaded units of work only doesn't need expensive locking or other means of " +"synchronization. The application never needs to synchronize on any business " +"object, as long as it sticks to a single thread per <literal>Session</" +"literal>. Within a <literal>Session</literal> the application may safely use " +"<literal>==</literal> to compare objects." +msgstr "" +"このアプローチでは、Hibernateとデータベースに同時実行についての心配が残りま" +"す。 一方で、最高のスケーラビリティが提供されます。 なぜなら、１スレッドの作" +"業単位の中で一意性が保証されれば、 高価なロックや同期化が不要になるためで" +"す。 <literal>Session</literal> ごとに１つのスレッドを貼り付ける限り、 アプリ" +"ケーションはビジネスオブジェクトをsynchronizeする必要はありません。 " +"<literal>Session</literal> 内では、アプリケーションはオブジェクトを比較するた" +"めに、 <literal>==</literal> を安全に使用できます。" -#: index.docbook:296 +#. Tag: para +#: transactions.xml:275 +#, no-c-format +msgid "" +"However, an application that uses <literal>==</literal> outside of a " +"<literal>Session</literal>, might see unexpected results. This might occur " +"even in some unexpected places, for example, if you put two detached " +"instances into the same <literal>Set</literal>. Both might have the same " +"database identity (i.e. they represent the same row), but JVM identity is by " +"definition not guaranteed for instances in detached state. The developer has " +"to override the <literal>equals()</literal> and <literal>hashCode()</" +"literal> methods in persistent classes and implement his own notion of " +"object equality. There is one caveat: Never use the database identifier to " +"implement equality, use a business key, a combination of unique, usually " +"immutable, attributes. The database identifier will change if a transient " +"object is made persistent. If the transient instance (usually together with " +"detached instances) is held in a <literal>Set</literal>, changing the " +"hashcode breaks the contract of the <literal>Set</literal>. Attributes for " +"business keys don't have to be as stable as database primary keys, you only " +"have to guarantee stability as long as the objects are in the same " +"<literal>Set</literal>. See the Hibernate website for a more thorough " +"discussion of this issue. Also note that this is not a Hibernate issue, but " +"simply how Java object identity and equality has to be implemented." +msgstr "" +"けれども、<literal>Session</literal> の外で <literal>==</literal> を使うアプ" +"リケーションは、予期しない結果に遭遇します。 これは予期しない場所で起こりえま" +"す。 例えば、２つの分離インスタンスを同じ <literal>Set</literal> に putしたと" +"きなどです。 両方とも同じデータベース識別子を持ちます（すなわち、同じ行を表し" +"ます）。 しかし、分離状態のインスタンスのJVM識別子は当然保証されません。 開発" +"者は、永続性クラスの <literal>equals()</literal> と <literal>hashCode()</" +"literal> メソッドをオーバーライドし、オブジェクト等価性の概念を実装すべきで" +"す。 警告が１つあります。等価性の実装にデータベース識別子を使わないでくださ" +"い。 ユニークな（普通は不変の）属性の組み合わせであるビジネスキーを使ってくだ" +"さい。 もし、一時オブジェクトが永続化された場合、データベース識別子が変わりま" +"す。 一時オブジェクトを（通常分離インスタンスと共に） <literal>Set</literal> " +"に保持する場合、ハッシュコードが変わるということは、<literal>Set</literal> の" +"契約を破るということです。 ビジネスキーのための属性は、データベースの主キーほ" +"ど安定すべきではないです。 オブジェクトが同じ <literal>Set</literal> の中にい" +"る間だけ、安定を保証すべきです。 この問題のより徹底的な議論は、HibernateのWeb" +"サイトを参照してください。 また、これはHibernateの問題ではなく、単にJavaオブ" +"ジェクトの識別子や等価性を どのように実装すべきかということです。" + +#. Tag: title +#: transactions.xml:296 +#, no-c-format msgid "Common issues" -msgstr "けれども、<literal>Session</literal> の外で <literal>==</literal> を使うアプリケーションは、予期しない結果に遭遇します。 これは予期しない場所で起こりえます。 例えば、２つの分離インスタンスを同じ <literal>Set</literal> に putしたときなどです。 両方とも同じデータベース識別子を持ちます（すなわち、同じ行を表します）。 しかし、分離状態のインスタンスのJVM識別子は当然保証されません。 開発者は、永続性クラスの <literal>equals()</literal> と <literal>hashCode()</literal> メソッドをオーバーライドし、オブジェクト等価性の概念を実装すべきです。 警告が１つあります。等価性の実装にデータベース識別子を使わないでください。 ユニークな（普通は不変の）属性の組み合わせであるビジネスキーを使ってください。 もし、一時オ! ブジェクトが永続化された場合、データベース識別子が変わります。 一時オブジェクトを（通常分離インスタンスと共に） <literal>Set</literal> に保持する場合、ハッシュコードが変わるということは、<literal>Set</literal> の契約を破るということです。 ビジネスキーのための属性は、データベースの主キーほど安定すべきではないです。 オブジェクトが同じ <literal>Set</literal> の中にいる間だけ、安定を保証すべきです。 この問題のより徹底的な議論は、HibernateのWebサイトを参照してください。 また、これはHibernateの問題ではなく、単にJavaオブジェクトの識別子や等価性を どのように実装すべきかということです。" - -#: index.docbook:298 -msgid "Never use the anti-patterns <emphasis>session-per-user-session</emphasis> or <emphasis>session-per-application</emphasis> (of course, there are rare exceptions to this rule). Note that some of the following issues might also appear with the recommended patterns, make sure you understand the implications before making a design decision:" msgstr "一般的な問題" -#: index.docbook:307 -msgid "A <literal>Session</literal> is not thread-safe. Things which are supposed to work concurrently, like HTTP requests, session beans, or Swing workers, will cause race conditions if a <literal>Session</literal> instance would be shared. If you keep your Hibernate <literal>Session</literal> in your <literal>HttpSession</literal> (discussed later), you should consider synchronizing access to your Http session. Otherwise, a user that clicks reload fast enough may use the same <literal>Session</literal> in two concurrently running threads." -msgstr "<emphasis>session-per-user-session</emphasis> と <emphasis>session-per-application</emphasis> アンチパターン は使ってはいけません（もちろん、まれに例外があります）。 注意：下記の問題のいくつかは、推奨されるパターンとしても出現します。 設計を決定する前に、裏の意味を理解するようにしてください。" +#. Tag: para +#: transactions.xml:298 +#, no-c-format +msgid "" +"Never use the anti-patterns <emphasis>session-per-user-session</emphasis> or " +"<emphasis>session-per-application</emphasis> (of course, there are rare " +"exceptions to this rule). Note that some of the following issues might also " +"appear with the recommended patterns, make sure you understand the " +"implications before making a design decision:" +msgstr "" +"<emphasis>session-per-user-session</emphasis> と <emphasis>session-per-" +"application</emphasis> アンチパターン は使ってはいけません（もちろん、まれに" +"例外があります）。 注意：下記の問題のいくつかは、推奨されるパターンとしても出" +"現します。 設計を決定する前に、裏の意味を理解するようにしてください。" -#: index.docbook:318 -msgid "An exception thrown by Hibernate means you have to rollback your database transaction and close the <literal>Session</literal> immediately (discussed later in more detail). If your <literal>Session</literal> is bound to the application, you have to stop the application. Rolling back the database transaction doesn't put your business objects back into the state they were at the start of the transaction. This means the database state and the business objects do get out of sync. Usually this is not a problem, because exceptions are not recoverable and you have to start over after rollback anyway." -msgstr "<literal>Session</literal> はスレッドセーフではありません。 HTTPリクエスト、セッションBean、Swingワーカーのように、 同時実行が可能なものが <literal>Session</literal> インスタンスを共有すると、 競合状態を引き起こします。 （後で議論する）<literal>HttpSession</literal> の中で Hibernate <literal>Session</literal> を保持する場合、 HttpSessionへのアクセスを同期化することを考慮すべきです。 さもなければ、ユーザーが十分早くリロードをクリックすると、 同時に走る２つのスレッドの中で、同じ <literal>Session</literal> が使われます。" +#. Tag: para +#: transactions.xml:307 +#, no-c-format +msgid "" +"A <literal>Session</literal> is not thread-safe. Things which are supposed " +"to work concurrently, like HTTP requests, session beans, or Swing workers, " +"will cause race conditions if a <literal>Session</literal> instance would be " +"shared. If you keep your Hibernate <literal>Session</literal> in your " +"<literal>HttpSession</literal> (discussed later), you should consider " +"synchronizing access to your Http session. Otherwise, a user that clicks " +"reload fast enough may use the same <literal>Session</literal> in two " +"concurrently running threads." +msgstr "" +"<literal>Session</literal> はスレッドセーフではありません。 HTTPリクエスト、" +"セッションBean、Swingワーカーのように、 同時実行が可能なものが " +"<literal>Session</literal> インスタンスを共有すると、 競合状態を引き起こしま" +"す。 （後で議論する）<literal>HttpSession</literal> の中で Hibernate " +"<literal>Session</literal> を保持する場合、 HttpSessionへのアクセスを同期化す" +"ることを考慮すべきです。 さもなければ、ユーザーが十分早くリロードをクリックす" +"ると、 同時に走る２つのスレッドの中で、同じ <literal>Session</literal> が使わ" +"れます。" -#: index.docbook:330 -msgid "The <literal>Session</literal> caches every object that is in persistent state (watched and checked for dirty state by Hibernate). This means it grows endlessly until you get an OutOfMemoryException, if you keep it open for a long time or simply load too much data. One solution for this is to call <literal>clear()</literal> and <literal>evict()</literal> to manage the <literal>Session</literal> cache, but you most likely should consider a Stored Procedure if you need mass data operations. Some solutions are shown in <xref linkend=\"batch\"/>. Keeping a <literal>Session</literal> open for the duration of a user session also means a high probability of stale data." -msgstr "Hibernateが例外を投げた場合は、データベーストランザクションをロールバックし、 直ちに <literal>Session</literal> を閉じるべきです（詳細を後で議論します）。 <literal>Session</literal> がアプリケーションに結び付けられているのであれば、 アプリケーションを停止すべきです。 データベーストランザクションをロールバックしても、ビジネスオブジェクトは トランザクションを開始したときの状態に戻りません。 これは、データベースの状態とビジネスオブジェクトは同期していないことを意味します。 通常これは問題になりません。 なぜなら、例外は回復できないからです。 とにかくロールバックした後にやり直すべきです。" +#. Tag: para +#: transactions.xml:318 +#, no-c-format +msgid "" +"An exception thrown by Hibernate means you have to rollback your database " +"transaction and close the <literal>Session</literal> immediately (discussed " +"later in more detail). If your <literal>Session</literal> is bound to the " +"application, you have to stop the application. Rolling back the database " +"transaction doesn't put your business objects back into the state they were " +"at the start of the transaction. This means the database state and the " +"business objects do get out of sync. Usually this is not a problem, because " +"exceptions are not recoverable and you have to start over after rollback " +"anyway." +msgstr "" +"Hibernateが例外を投げた場合は、データベーストランザクションをロールバック" +"し、 直ちに <literal>Session</literal> を閉じるべきです（詳細を後で議論しま" +"す）。 <literal>Session</literal> がアプリケーションに結び付けられているので" +"あれば、 アプリケーションを停止すべきです。 データベーストランザクションを" +"ロールバックしても、ビジネスオブジェクトは トランザクションを開始したときの状" +"態に戻りません。 これは、データベースの状態とビジネスオブジェクトは同期してい" +"ないことを意味します。 通常これは問題になりません。 なぜなら、例外は回復でき" +"ないからです。 とにかくロールバックした後にやり直すべきです。" -#: index.docbook:348 +#. Tag: para +#: transactions.xml:330 +#, no-c-format +msgid "" +"The <literal>Session</literal> caches every object that is in persistent " +"state (watched and checked for dirty state by Hibernate). This means it " +"grows endlessly until you get an OutOfMemoryException, if you keep it open " +"for a long time or simply load too much data. One solution for this is to " +"call <literal>clear()</literal> and <literal>evict()</literal> to manage the " +"<literal>Session</literal> cache, but you most likely should consider a " +"Stored Procedure if you need mass data operations. Some solutions are shown " +"in <xref linkend=\"batch\"/>. Keeping a <literal>Session</literal> open for " +"the duration of a user session also means a high probability of stale data." +msgstr "" +"<literal>Session</literal> は永続（persistent）状態のすべてのオブジェクトを " +"キャッシュします（Hibernateは監視し、ダーティ状態かチェックします）。 これ" +"は、長い間セッションを開いたままにするか、 非常に多くのデータをロードし続ける" +"かした場合は、 OutOfMemoryExceptionが発生するまで無限に大きくなることを意味し" +"ます。 解決策の１つは、<literal>Session</literal> キャッシュを管理するため" +"に、 <literal>clear()</literal> か <literal>evict()</literal> を呼ぶことで" +"す。 しかし、大きなデータを処理する必要があるなら、 たぶんストアドプロシー" +"ジャを考慮するべきでしょう。 いくつかの解決策は、<xref linkend=\"batch\"/> で" +"紹介されています。 ユーザーセッションの間、<literal>Session</literal> を開い" +"たままにするということは、 データが新鮮でなくなる確率が高くなることを意味しま" +"す。" + +#. Tag: title +#: transactions.xml:348 +#, no-c-format msgid "Database transaction demarcation" -msgstr "<literal>Session</literal> は永続（persistent）状態のすべてのオブジェクトを キャッシュします（Hibernateは監視し、ダーティ状態かチェックします）。 これは、長い間セッションを開いたままにするか、 非常に多くのデータをロードし続けるかした場合は、 OutOfMemoryExceptionが発生するまで無限に大きくなることを意味します。 解決策の１つは、<literal>Session</literal> キャッシュを管理するために、 <literal>clear()</literal> か <literal>evict()</literal> を呼ぶことです。 しかし、大きなデータを処理する必要があるなら、 たぶんストアドプロシージャを考慮するべきでしょう。 いくつかの解決策は、<xref linkend=\"batch\"/> で紹介されています。 ユーザーセッションの間、<literal>Session</literal> を開いたままにするということは、 データが新鮮でなく! なる確率が高くなることを意味します。" - -#: index.docbook:350 -msgid "Datatabase (or system) transaction boundaries are always necessary. No communication with the database can occur outside of a database transaction (this seems to confuse many developers who are used to the auto-commit mode). Always use clear transaction boundaries, even for read-only operations. Depending on your isolation level and database capabilities this might not be required but there is no downside if you always demarcate transactions explicitly. Certainly, a single database transaction is going to perform better than many small transactions, even for reading data." msgstr "データベーストランザクション境界" -#: index.docbook:360 -msgid "A Hibernate application can run in non-managed (i.e. standalone, simple Web- or Swing applications) and managed J2EE environments. In a non-managed environment, Hibernate is usually responsible for its own database connection pool. The application developer has to manually set transaction boundaries, in other words, begin, commit, or rollback database transactions himself. A managed environment usually provides container-managed transactions (CMT), with the transaction assembly defined declaratively in deployment descriptors of EJB session beans, for example. Programmatic transaction demarcation is then no longer necessary." -msgstr "データベース（もしくはシステム）トランザクションの境界は、常に必要です。 データベーストランザクションの外で、データベースとの通信は起きません （これは自動コミットモードに慣れている多くの開発者を混乱させるかもしれません）。 読み込むだけの操作にでも、いつも明確なトランザクション境界を使用してください。 分離レベルとデータベースの能力次第で、これは必要ないかもしれませんが、 常にトランザクション境界を明示的に指定しても、マイナス面は全くありません。 確かに、１つのデータベーストランザクションは多数の小さなトランザクションより （データの読み込みであっても）パフォーマンスがすぐれています。" +#. Tag: para +#: transactions.xml:350 +#, no-c-format +msgid "" +"Datatabase (or system) transaction boundaries are always necessary. No " +"communication with the database can occur outside of a database transaction " +"(this seems to confuse many developers who are used to the auto-commit " +"mode). Always use clear transaction boundaries, even for read-only " +"operations. Depending on your isolation level and database capabilities this " +"might not be required but there is no downside if you always demarcate " +"transactions explicitly. Certainly, a single database transaction is going " +"to perform better than many small transactions, even for reading data." +msgstr "" +"データベース（もしくはシステム）トランザクションの境界は、常に必要です。 デー" +"タベーストランザクションの外で、データベースとの通信は起きません （これは自動" +"コミットモードに慣れている多くの開発者を混乱させるかもしれません）。 読み込む" +"だけの操作にでも、いつも明確なトランザクション境界を使用してください。 分離レ" +"ベルとデータベースの能力次第で、これは必要ないかもしれませんが、 常にトランザ" +"クション境界を明示的に指定しても、マイナス面は全くありません。 確かに、１つの" +"データベーストランザクションは多数の小さなトランザクションより （データの読み" +"込みであっても）パフォーマンスがすぐれています。" -#: index.docbook:370 -msgid "However, it is often desirable to keep your persistence layer portable between non-managed resource-local environments, and systems that can rely on JTA but use BMT instead of CMT. In both cases you'd use programmatic transaction demaracation. Hibernate offers a wrapper API called <literal>Transaction</literal> that translates into the native transaction system of your deployment environment. This API is actually optional, but we strongly encourage its use unless you are in a CMT session bean." -msgstr "J2EE環境に管理されていない状態 （すなわち、スタンドアロン、単純なWebやSwingアプリケーション）でも、 管理された状態でも、Hibernateアプリケーションを実行できます。 管理されていない環境では、Hiberanteがデータベースのコネクションプールを提供します。 アプリケーション開発者は、トランザクション境界を手動で設定しなければなりません。 言い換えると、データベーストランザクションの開始、コミット、ロールバックを 開発者自身が設定する必要があるということです。 通常、管理された環境では、コンテナ管理によるトランザクション（CMT）が提供されます。 例えば、セッションBeanのデプロイメントディスクリプタで宣言的に定義し、 トランザクションを組み立てます。 プログラムによるトランザクション! 境界はもう必要ありません。" +#. Tag: para +#: transactions.xml:360 +#, no-c-format +msgid "" +"A Hibernate application can run in non-managed (i.e. standalone, simple Web- " +"or Swing applications) and managed J2EE environments. In a non-managed " +"environment, Hibernate is usually responsible for its own database " +"connection pool. The application developer has to manually set transaction " +"boundaries, in other words, begin, commit, or rollback database transactions " +"himself. A managed environment usually provides container-managed " +"transactions (CMT), with the transaction assembly defined declaratively in " +"deployment descriptors of EJB session beans, for example. Programmatic " +"transaction demarcation is then no longer necessary." +msgstr "" +"J2EE環境に管理されていない状態 （すなわち、スタンドアロン、単純なWebやSwingア" +"プリケーション）でも、 管理された状態でも、Hibernateアプリケーションを実行で" +"きます。 管理されていない環境では、Hiberanteがデータベースのコネクションプー" +"ルを提供します。 アプリケーション開発者は、トランザクション境界を手動で設定し" +"なければなりません。 言い換えると、データベーストランザクションの開始、コミッ" +"ト、ロールバックを 開発者自身が設定する必要があるということです。 通常、管理" +"された環境では、コンテナ管理によるトランザクション（CMT）が提供されます。 例" +"えば、セッションBeanのデプロイメントディスクリプタで宣言的に定義し、 トランザ" +"クションを組み立てます。 プログラムによるトランザクション境界はもう必要ありま" +"せん。" -#: index.docbook:379 -msgid "Usually, ending a <literal>Session</literal> involves four distinct phases:" -msgstr "しかしながら、管理されていないリソース・ローカルな環境と JTAに依存したシステム（CMTではなくBMT）の両方に、 永続化層をポータブルに保つのは、しばしば望ましいことです。 デプロイ環境のネイティブのトランザクションシステムを呼び出す <literal>Transaction</literal> というラッパーAPIをHibernateが提供します。 このAPIを使うかは任意ですが、CMTのセッションBeanを使わないのであれば、使うことを強く推奨します。" +#. Tag: para +#: transactions.xml:370 +#, no-c-format +msgid "" +"However, it is often desirable to keep your persistence layer portable " +"between non-managed resource-local environments, and systems that can rely " +"on JTA but use BMT instead of CMT. In both cases you'd use programmatic " +"transaction demaracation. Hibernate offers a wrapper API called " +"<literal>Transaction</literal> that translates into the native transaction " +"system of your deployment environment. This API is actually optional, but we " +"strongly encourage its use unless you are in a CMT session bean." +msgstr "" +"しかしながら、管理されていないリソース・ローカルな環境と JTAに依存したシステ" +"ム（CMTではなくBMT）の両方に、 永続化層をポータブルに保つのは、しばしば望まし" +"いことです。 デプロイ環境のネイティブのトランザクションシステムを呼び出す " +"<literal>Transaction</literal> というラッパーAPIをHibernateが提供します。 こ" +"のAPIを使うかは任意ですが、CMTのセッションBeanを使わないのであれば、使うこと" +"を強く推奨します。" -#: index.docbook:385 +#. Tag: para +#: transactions.xml:379 +#, no-c-format +msgid "" +"Usually, ending a <literal>Session</literal> involves four distinct phases:" +msgstr "" +"通常、<literal>Session</literal> 終了は、４つの異なるフェーズを含みます。" + +#. Tag: para +#: transactions.xml:385 +#, no-c-format msgid "flush the session" -msgstr "通常、<literal>Session</literal> 終了は、４つの異なるフェーズを含みます。" +msgstr "セッションのフラッシュ" -#: index.docbook:390 +#. Tag: para +#: transactions.xml:390 +#, no-c-format msgid "commit the transaction" -msgstr "セッションのフラッシュ" +msgstr "トランザクションのコミット" -#: index.docbook:395 +#. Tag: para +#: transactions.xml:395 +#, no-c-format msgid "close the session" -msgstr "トランザクションのコミット" +msgstr "セッションのクローズ" -#: index.docbook:400 +#. Tag: para +#: transactions.xml:400 +#, no-c-format msgid "handle exceptions" -msgstr "セッションのクローズ" - -#: index.docbook:406 -msgid "Flushing the session has been discussed earlier, we'll now have a closer look at transaction demarcation and exception handling in both managed- and non-managed environments." msgstr "例外のハンドリング" -#: index.docbook:413 +#. Tag: para +#: transactions.xml:406 +#, no-c-format +msgid "" +"Flushing the session has been discussed earlier, we'll now have a closer " +"look at transaction demarcation and exception handling in both managed- and " +"non-managed environments." +msgstr "" +"セッションのフラッシュについては、前のほうですでに議論しました。 管理された環" +"境と管理されていない環境の両方について、 トランザクション境界と例外ハンドリン" +"グをもっと詳しく見ていきましょう。" + +#. Tag: title +#: transactions.xml:413 +#, no-c-format msgid "Non-managed environment" -msgstr "セッションのフラッシュについては、前のほうですでに議論しました。 管理された環境と管理されていない環境の両方について、 トランザクション境界と例外ハンドリングをもっと詳しく見ていきましょう。" - -#: index.docbook:415 -msgid "If a Hibernate persistence layer runs in a non-managed environment, database connections are usually handled by simple (i.e. non-DataSource) connection pools from which Hibernate obtains connections as needed. The session/transaction handling idiom looks like this:" msgstr "管理されていない環境" -#: index.docbook:422 +#. Tag: para +#: transactions.xml:415 +#, no-c-format msgid "" - "<![CDATA[// Non-managed environment idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -msgstr "Hibernate永続化層を管理されていない環境で実装する場合は、 通常単純なコネクションプール（すなわちDataSourceではない）によって、 データベースコネクションを制御します。 Hibernateはそのコネクションプールから必要なコネクションを取得します。 セッション／トランザクション制御のイディオムは次のようになります。" +"If a Hibernate persistence layer runs in a non-managed environment, database " +"connections are usually handled by simple (i.e. non-DataSource) connection " +"pools from which Hibernate obtains connections as needed. The session/" +"transaction handling idiom looks like this:" +msgstr "" +"Hibernate永続化層を管理されていない環境で実装する場合は、 通常単純なコネク" +"ションプール（すなわちDataSourceではない）によって、 データベースコネクション" +"を制御します。 Hibernateはそのコネクションプールから必要なコネクションを取得" +"します。 セッション／トランザクション制御のイディオムは次のようになります。" -#: index.docbook:424 -msgid "You don't have to <literal>flush()</literal> the <literal>Session</literal> explicitly - the call to <literal>commit()</literal> automatically triggers the synchronization (depending upon the <xref linkend=\"objectstate-flushing\"/>FlushMode for the session. A call to <literal>close()</literal> marks the end of a session. The main implication of <literal>close()</literal> is that the JDBC connection will be relinquished by the session. This Java code is portable and runs in both non-managed and JTA environments." +#. Tag: programlisting +#: transactions.xml:422 +#, no-c-format +msgid "" +"<![CDATA[// Non-managed environment idiom\n" +"Session sess = factory.openSession();\n" +"Transaction tx = null;\n" +"try {\n" +" tx = sess.beginTransaction();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" tx.commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" if (tx != null) tx.rollback();\n" +" throw e; // or display error message\n" +"}\n" +"finally {\n" +" sess.close();\n" +"}]]>" msgstr "" - "<![CDATA[// Non-managed environment idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -#: index.docbook:433 -msgid "A much more flexible solution is Hibernate's built-in \"current session\" context management, as described earlier:" -msgstr "明示的に <literal>Session</literal> の <literal>flush()</literal> を呼び出すべきではなく、 <literal>commit()</literal> を呼び出すことにより、自動的に同期化処理が実行されます （セッションの <xref linkend=\"objectstate-flushing\"/>FlushMode に依存している）。 <literal>close()</literal> を呼び出すことにより、セッションの終わりを明確にします。 <literal>close()</literal> が暗黙的に行う主なことは、 セッションがJDBCコネクションを開放することです。 上記のJavaコードはポータブルであり、管理されていない環境とJTA環境の両方で実行できます。" +#. Tag: para +#: transactions.xml:424 +#, no-c-format +msgid "" +"You don't have to <literal>flush()</literal> the <literal>Session</literal> " +"explicitly - the call to <literal>commit()</literal> automatically triggers " +"the synchronization (depending upon the <link linkend=\"objectstate-flushing" +"\">FlushMode</link> for the session. A call to <literal>close()</literal> " +"marks the end of a session. The main implication of <literal>close()</" +"literal> is that the JDBC connection will be relinquished by the session. " +"This Java code is portable and runs in both non-managed and JTA environments." +msgstr "" +"明示的に <literal>Session</literal> の <literal>flush()</literal> を呼び出す" +"べきではなく、 <literal>commit()</literal> を呼び出すことにより、自動的に同期" +"化処理が実行されます （セッションの <xref linkend=\"objectstate-flushing" +"\">FlushMode</xref> に依存している）。 <literal>close()</literal> を呼び出す" +"ことにより、セッションの終わりを明確にします。 <literal>close()</literal> が" +"暗黙的に行う主なことは、 セッションがJDBCコネクションを開放することです。 上" +"記のJavaコードはポータブルであり、管理されていない環境とJTA環境の両方で実行で" +"きます。" -#: index.docbook:438 +#. Tag: para +#: transactions.xml:433 +#, no-c-format msgid "" - "<![CDATA[// Non-managed environment idiom with getCurrentSession()\n" - "try {\n" - " factory.getCurrentSession().beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " factory.getCurrentSession().getTransaction().commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " factory.getCurrentSession().getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}]]>" -msgstr "より適応性のある解決策は、Hibernateに予め組み込まれている 「current session」コンテキスト管理です。 言葉で説明するより下記を見たほうが速いでしょう。" +"A much more flexible solution is Hibernate's built-in \"current session\" " +"context management, as described earlier:" +msgstr "" +"より適応性のある解決策は、Hibernateに予め組み込まれている 「current session」" +"コンテキスト管理です。 言葉で説明するより下記を見たほうが速いでしょう。" -#: index.docbook:440 -msgid "You will very likely never see these code snippets in a regular application; fatal (system) exceptions should always be caught at the \"top\". In other words, the code that executes Hibernate calls (in the persistence layer) and the code that handles <literal>RuntimeException</literal> (and usually can only clean up and exit) are in different layers. The current context management by Hibernate can significantly simplify this design, as all you need is access to a <literal>SessionFactory</literal>. Exception handling is discussed later in this chapter." +#. Tag: programlisting +#: transactions.xml:438 +#, no-c-format +msgid "" +"<![CDATA[// Non-managed environment idiom with getCurrentSession()\n" +"try {\n" +" factory.getCurrentSession().beginTransaction();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" factory.getCurrentSession().getTransaction().commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" factory.getCurrentSession().getTransaction().rollback();\n" +" throw e; // or display error message\n" +"}]]>" msgstr "" - "<![CDATA[// Non-managed environment idiom with getCurrentSession()\n" - "try {\n" - " factory.getCurrentSession().beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " factory.getCurrentSession().getTransaction().commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " factory.getCurrentSession().getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}]]>" -#: index.docbook:450 -msgid "Note that you should select <literal>org.hibernate.transaction.JDBCTransactionFactory</literal> (which is the default), and for the second example <literal>\"thread\"</literal> as your <literal>hibernate.current_session_context_class</literal>." -msgstr "正規のアプリケーションの中では、このようなコードの切れ端を決して見ないでしょう。 致命的な（システム）例外は、常に「最上位」でキャッチすべきです。 言い換えれば、（永続化層で）Hibernate呼び出しを実行するコードと、 <literal>RuntimeException</literal> を制御する （通常はクリーンアップと終了のみ行うことができる）コードは、別々の層の中にあります。 Hibernateによるカレントコンテキスト管理は、この設計をかなり単純にします。 必要なのは、<literal>SessionFactory</literal> にアクセスすることだけです。 例外処理は、この章の後のほうで議論します。" +#. Tag: para +#: transactions.xml:440 +#, no-c-format +msgid "" +"You will very likely never see these code snippets in a regular application; " +"fatal (system) exceptions should always be caught at the \"top\". In other " +"words, the code that executes Hibernate calls (in the persistence layer) and " +"the code that handles <literal>RuntimeException</literal> (and usually can " +"only clean up and exit) are in different layers. The current context " +"management by Hibernate can significantly simplify this design, as all you " +"need is access to a <literal>SessionFactory</literal>. Exception handling is " +"discussed later in this chapter." +msgstr "" +"正規のアプリケーションの中では、このようなコードの切れ端を決して見ないでしょ" +"う。 致命的な（システム）例外は、常に「最上位」でキャッチすべきです。 言い換" +"えれば、（永続化層で）Hibernate呼び出しを実行するコードと、 " +"<literal>RuntimeException</literal> を制御する （通常はクリーンアップと終了の" +"み行うことができる）コードは、別々の層の中にあります。 Hibernateによるカレン" +"トコンテキスト管理は、この設計をかなり単純にします。 必要なのは、" +"<literal>SessionFactory</literal> にアクセスすることだけです。 例外処理は、こ" +"の章の後のほうで議論します。" -#: index.docbook:459 +#. Tag: para +#: transactions.xml:450 +#, no-c-format +msgid "" +"Note that you should select <literal>org.hibernate.transaction." +"JDBCTransactionFactory</literal> (which is the default), and for the second " +"example <literal>\"thread\"</literal> as your <literal>hibernate." +"current_session_context_class</literal>." +msgstr "" +"注意：（デフォルトですが） <literal>org.hibernate.transaction." +"JDBCTransactionFactory</literal> を選択するべきです。 第2の用例としては、 " +"<literal>hibernate.current_session_context_class</literal> を <literal>" +"\"thread\"</literal> とするとよいでしょう。" + +#. Tag: title +#: transactions.xml:459 +#, no-c-format msgid "Using JTA" -msgstr "注意：（デフォルトですが） <literal>org.hibernate.transaction.JDBCTransactionFactory</literal> を選択するべきです。 第2の用例としては、 <literal>hibernate.current_session_context_class</literal> を <literal>\"thread\"</literal> とするとよいでしょう。" - -#: index.docbook:461 -msgid "If your persistence layer runs in an application server (e.g. behind EJB session beans), every datasource connection obtained by Hibernate will automatically be part of the global JTA transaction. You can also install a standalone JTA implementation and use it without EJB. Hibernate offers two strategies for JTA integration." msgstr "JTAを使用する" -#: index.docbook:468 -msgid "If you use bean-managed transactions (BMT) Hibernate will tell the application server to start and end a BMT transaction if you use the <literal>Transaction</literal> API. So, the transaction management code is identical to the non-managed environment." -msgstr "永続化層をアプリケーションサーバー（例えば、EJBセッションBeanの背後）で実行する場合、 Hibernateから取得するすべてのデータソースコネクションは、 自動的にグローバルJTAトランザクションの一部になります。 EJBを使わずに、スタンドアロンのJTA実装を導入することもできます。 JTA統合のために、Hibernateは２つの戦略を提供します。" +#. Tag: para +#: transactions.xml:461 +#, no-c-format +msgid "" +"If your persistence layer runs in an application server (e.g. behind EJB " +"session beans), every datasource connection obtained by Hibernate will " +"automatically be part of the global JTA transaction. You can also install a " +"standalone JTA implementation and use it without EJB. Hibernate offers two " +"strategies for JTA integration." +msgstr "" +"永続化層をアプリケーションサーバー（例えば、EJBセッションBeanの背後）で実行す" +"る場合、 Hibernateから取得するすべてのデータソースコネクションは、 自動的にグ" +"ローバルJTAトランザクションの一部になります。 EJBを使わずに、スタンドアロンの" +"JTA実装を導入することもできます。 JTA統合のために、Hibernateは２つの戦略を提" +"供します。" -#: index.docbook:474 +#. Tag: para +#: transactions.xml:468 +#, no-c-format msgid "" - "<![CDATA[// BMT idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -msgstr "Bean管理トランザクション（BMT）を使い、<literal>Transaction</literal> APIを使う場合、 HibernateはアプリケーションサーバーにBMTトランザクションの開始と終わりを告げます。 すなわち、トランザクション管理のコードは、管理されない環境と同じになります。" +"If you use bean-managed transactions (BMT) Hibernate will tell the " +"application server to start and end a BMT transaction if you use the " +"<literal>Transaction</literal> API. So, the transaction management code is " +"identical to the non-managed environment." +msgstr "" +"Bean管理トランザクション（BMT）を使い、<literal>Transaction</literal> APIを使" +"う場合、 HibernateはアプリケーションサーバーにBMTトランザクションの開始と終わ" +"りを告げます。 すなわち、トランザクション管理のコードは、管理されない環境と同" +"じになります。" -#: index.docbook:476 -msgid "If you want to use a transaction-bound <literal>Session</literal>, that is, the <literal>getCurrentSession()</literal> functionality for easy context propagation, you will have to use the JTA <literal>UserTransaction</literal> API directly:" +#. Tag: programlisting +#: transactions.xml:474 +#, no-c-format +msgid "" +"<![CDATA[// BMT idiom\n" +"Session sess = factory.openSession();\n" +"Transaction tx = null;\n" +"try {\n" +" tx = sess.beginTransaction();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" tx.commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" if (tx != null) tx.rollback();\n" +" throw e; // or display error message\n" +"}\n" +"finally {\n" +" sess.close();\n" +"}]]>" msgstr "" - "<![CDATA[// BMT idiom\n" - "Session sess = factory.openSession();\n" - "Transaction tx = null;\n" - "try {\n" - " tx = sess.beginTransaction();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " if (tx != null) tx.rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -#: index.docbook:482 +#. Tag: para +#: transactions.xml:476 +#, no-c-format msgid "" - "<![CDATA[// BMT idiom with getCurrentSession()\n" - "try {\n" - " UserTransaction tx = (UserTransaction)new InitialContext()\n" - " .lookup(\"java:comp/UserTransaction\");\n" - "\n" - " tx.begin();\n" - "\n" - " // Do some work on Session bound to transaction\n" - " factory.getCurrentSession().load(...);\n" - " factory.getCurrentSession().persist(...);\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " tx.rollback();\n" - " throw e; // or display error message\n" - "}]]>" -msgstr "トランザクション境界として <literal>Session</literal> を使いたい場合、 簡単にコンテキストを伝播する機能である <literal>getCurrentSession()</literal> があるので、 JTAの <literal>UserTransaction</literal> APIを直接使用すべきでしょう。" +"If you want to use a transaction-bound <literal>Session</literal>, that is, " +"the <literal>getCurrentSession()</literal> functionality for easy context " +"propagation, you will have to use the JTA <literal>UserTransaction</literal> " +"API directly:" +msgstr "" +"トランザクション境界として <literal>Session</literal> を使いたい場合、 簡単に" +"コンテキストを伝播する機能である <literal>getCurrentSession()</literal> があ" +"るので、 JTAの <literal>UserTransaction</literal> APIを直接使用すべきでしょ" +"う。" -#: index.docbook:484 -msgid "With CMT, transaction demarcation is done in session bean deployment descriptors, not programatically, hence, the code is reduced to:" +#. Tag: programlisting +#: transactions.xml:482 +#, no-c-format +msgid "" +"<![CDATA[// BMT idiom with getCurrentSession()\n" +"try {\n" +" UserTransaction tx = (UserTransaction)new InitialContext()\n" +" .lookup(\"java:comp/UserTransaction\");\n" +"\n" +" tx.begin();\n" +"\n" +" // Do some work on Session bound to transaction\n" +" factory.getCurrentSession().load(...);\n" +" factory.getCurrentSession().persist(...);\n" +"\n" +" tx.commit();\n" +"}\n" +"catch (RuntimeException e) {\n" +" tx.rollback();\n" +" throw e; // or display error message\n" +"}]]>" msgstr "" - "<![CDATA[// BMT idiom with getCurrentSession()\n" - "try {\n" - " UserTransaction tx = (UserTransaction)new InitialContext()\n" - " .lookup(\"java:comp/UserTransaction\");\n" - "\n" - " tx.begin();\n" - "\n" - " // Do some work on Session bound to transaction\n" - " factory.getCurrentSession().load(...);\n" - " factory.getCurrentSession().persist(...);\n" - "\n" - " tx.commit();\n" - "}\n" - "catch (RuntimeException e) {\n" - " tx.rollback();\n" - " throw e; // or display error message\n" - "}]]>" -#: index.docbook:489 +#. Tag: para +#: transactions.xml:484 +#, no-c-format msgid "" - "<![CDATA[// CMT idiom\n" - " Session sess = factory.getCurrentSession();\n" - "\n" - " // do some work\n" - " ...\n" - "]]>" -msgstr "CMTでは、トランザクション境界をセッションBeanのデプロイメントディスクリプタで定義し、 プログラムでは行いません。 ゆえに、コードは次のように少なくなります。" +"With CMT, transaction demarcation is done in session bean deployment " +"descriptors, not programatically, hence, the code is reduced to:" +msgstr "" +"CMTでは、トランザクション境界をセッションBeanのデプロイメントディスクリプタで" +"定義し、 プログラムでは行いません。 ゆえに、コードは次のように少なくなりま" +"す。" -#: index.docbook:491 -msgid "In a CMT/EJB even rollback happens automatically, since an unhandled <literal>RuntimeException</literal> thrown by a session bean method tells the container to set the global transaction to rollback. <emphasis>This means you do not need to use the Hibernate <literal>Transaction</literal> API at all with BMT or CMT, and you get automatic propagation of the \"current\" Session bound to the transaction.</emphasis>" +#. Tag: programlisting +#: transactions.xml:489 +#, no-c-format +msgid "" +"<![CDATA[// CMT idiom\n" +" Session sess = factory.getCurrentSession();\n" +"\n" +" // do some work\n" +" ...\n" +"]]>" msgstr "" - "<![CDATA[// CMT idiom\n" - " Session sess = factory.getCurrentSession();\n" - "\n" - " // do some work\n" - " ...\n" - "]]>" -#: index.docbook:499 -msgid "Note that you should choose <literal>org.hibernate.transaction.JTATransactionFactory</literal> if you use JTA directly (BMT), and <literal>org.hibernate.transaction.CMTTransactionFactory</literal> in a CMT session bean, when you configure Hibernate's transaction factory. Remember to also set <literal>hibernate.transaction.manager_lookup_class</literal>. Furthermore, make sure that your <literal>hibernate.current_session_context_class</literal> is either unset (backwards compatiblity), or set to <literal>\"jta\"</literal>." -msgstr "CMT/EJBの中では、常にロールバックが自動的に実施されます。 なぜなら、セッションビーンのメソッドにより投げられた制御されていない <literal>RuntimeException</literal> は、グローバルトランザクションを ロールバックするようにコンテナに伝えるためです。 <emphasis>これは、BMTもしくはCMTといっしょにHibernate <literal>Transaction</literal> APIを使う必要は少しもないという意味です。</emphasis>" +#. Tag: para +#: transactions.xml:491 +#, no-c-format +msgid "" +"In a CMT/EJB even rollback happens automatically, since an unhandled " +"<literal>RuntimeException</literal> thrown by a session bean method tells " +"the container to set the global transaction to rollback. <emphasis>This " +"means you do not need to use the Hibernate <literal>Transaction</literal> " +"API at all with BMT or CMT, and you get automatic propagation of the " +"\"current\" Session bound to the transaction.</emphasis>" +msgstr "" +"CMT/EJBの中では、常にロールバックが自動的に実施されます。 なぜなら、セッショ" +"ンビーンのメソッドにより投げられた制御されていない " +"<literal>RuntimeException</literal> は、グローバルトランザクションを ロール" +"バックするようにコンテナに伝えるためです。 <emphasis>これは、BMTもしくはCMTと" +"いっしょにHibernate <literal>Transaction</literal> APIを使う必要は少しもない" +"という意味です。</emphasis>" -#: index.docbook:508 -msgid "The <literal>getCurrentSession()</literal> operation has one downside in a JTA environment. There is one caveat to the use of <literal>after_statement</literal> connection release mode, which is then used by default. Due to a silly limitation of the JTA spec, it is not possible for Hibernate to automatically clean up any unclosed <literal>ScrollableResults</literal> or <literal>Iterator</literal> instances returned by <literal>scroll()</literal> or <literal>iterate()</literal>. You <emphasis>must</emphasis> release the underlying database cursor by calling <literal>ScrollableResults.close()</literal> or <literal>Hibernate.close(Iterator)</literal> explicity from a <literal>finally</literal> block. (Of course, most applications can easily avoid using <literal>scroll()</literal> or <literal>iterate()</literal> at all from the JTA or CMT code.)" -msgstr "Hibernateのトランザクションファクトリを設定する際に、 JTAを直接使う（BMTの）場合は <literal>org.hibernate.transaction.JTATransactionFactory</literal> を、 CMTセッションビーンの中では <literal>org.hibernate.transaction.CMTTransactionFactory</literal> を 選択すべきだということに注意してください。 <literal>hibernate.transaction.manager_lookup_class</literal> をセットすることも思い出してください。 なお、<literal>hibernate.current_session_context_class</literal> は、 セットしないか（後方互換）、<literal>\"jta\"</literal> をセットしてください。" +#. Tag: para +#: transactions.xml:499 +#, no-c-format +msgid "" +"Note that you should choose <literal>org.hibernate.transaction." +"JTATransactionFactory</literal> if you use JTA directly (BMT), and " +"<literal>org.hibernate.transaction.CMTTransactionFactory</literal> in a CMT " +"session bean, when you configure Hibernate's transaction factory. Remember " +"to also set <literal>hibernate.transaction.manager_lookup_class</literal>. " +"Furthermore, make sure that your <literal>hibernate." +"current_session_context_class</literal> is either unset (backwards " +"compatiblity), or set to <literal>\"jta\"</literal>." +msgstr "" +"Hibernateのトランザクションファクトリを設定する際に、 JTAを直接使う（BMTの）" +"場合は <literal>org.hibernate.transaction.JTATransactionFactory</literal> " +"を、 CMTセッションビーンの中では <literal>org.hibernate.transaction." +"CMTTransactionFactory</literal> を 選択すべきだということに注意してくださ" +"い。 <literal>hibernate.transaction.manager_lookup_class</literal> をセットす" +"ることも思い出してください。 なお、<literal>hibernate." +"current_session_context_class</literal> は、 セットしないか（後方互換）、" +"<literal>\"jta\"</literal> をセットしてください。" -#: index.docbook:524 +#. Tag: para +#: transactions.xml:508 +#, no-c-format +msgid "" +"The <literal>getCurrentSession()</literal> operation has one downside in a " +"JTA environment. There is one caveat to the use of <literal>after_statement</" +"literal> connection release mode, which is then used by default. Due to a " +"silly limitation of the JTA spec, it is not possible for Hibernate to " +"automatically clean up any unclosed <literal>ScrollableResults</literal> or " +"<literal>Iterator</literal> instances returned by <literal>scroll()</" +"literal> or <literal>iterate()</literal>. You <emphasis>must</emphasis> " +"release the underlying database cursor by calling <literal>ScrollableResults." +"close()</literal> or <literal>Hibernate.close(Iterator)</literal> explicity " +"from a <literal>finally</literal> block. (Of course, most applications can " +"easily avoid using <literal>scroll()</literal> or <literal>iterate()</" +"literal> at all from the JTA or CMT code.)" +msgstr "" +"<literal>getCurrentSession()</literal> オペレーションは、JTA環境では１つの欠" +"点を持ちます。 デフォルトで使われる <literal>after_statement</literal> コネク" +"ションリリースモードを使用する上で、 警告が１つあります。 JTA仕様の愚かな制約" +"のために、 <literal>scroll()</literal> または <literal>iterate()</literal> が" +"返した、 閉じられていない <literal>ScrollableResults</literal> または " +"<literal>Iterator</literal> インスタンスをHibernateが自動的にクリーンアップす" +"ることはできません。 <literal>finally</literal> ブロックの中で、 " +"<literal>ScrollableResults.close()</literal> または <literal>Hibernate.close" +"(Iterator)</literal> を明示的に呼び出して、 裏に潜んだデータベースカーソルを" +"解放 <emphasis>しなければなりません</emphasis>。 （もちろん、多くのアプリケー" +"ションでは、JTAかCMTコードで <literal>scroll()</literal> や <literal>iterate" +"()</literal> の使用を避けるのは容易です。）" + +#. Tag: title +#: transactions.xml:524 +#, no-c-format msgid "Exception handling" -msgstr "<literal>getCurrentSession()</literal> オペレーションは、JTA環境では１つの欠点を持ちます。 デフォルトで使われる <literal>after_statement</literal> コネクションリリースモードを使用する上で、 警告が１つあります。 JTA仕様の愚かな制約のために、 <literal>scroll()</literal> または <literal>iterate()</literal> が返した、 閉じられていない <literal>ScrollableResults</literal> または <literal>Iterator</literal> インスタンスをHibernateが自動的にクリーンアップすることはできません。 <literal>finally</literal> ブロックの中で、 <literal>ScrollableResults.close()</literal> または <literal>Hibernate.close(Iterator)</literal> を明示的に呼び出して、 裏に潜んだデータベースカーソルを解放 <emphasis>しなければなりません</emphasis>。 （もちろん、多くのアプリケーションでは、JTAかCMTコードで ! <literal>scroll()</literal> や <literal>iterate()</literal> の使用を避けるのは容易です。）" - -#: index.docbook:526 -msgid "If the <literal>Session</literal> throws an exception (including any <literal>SQLException</literal>), you should immediately rollback the database transaction, call <literal>Session.close()</literal> and discard the <literal>Session</literal> instance. Certain methods of <literal>Session</literal> will <emphasis>not</emphasis> leave the session in a consistent state. No exception thrown by Hibernate can be treated as recoverable. Ensure that the <literal>Session</literal> will be closed by calling <literal>close()</literal> in a <literal>finally</literal> block." msgstr "例外ハンドリング" -#: index.docbook:537 -msgid "The <literal>HibernateException</literal>, which wraps most of the errors that can occur in a Hibernate persistence layer, is an unchecked exception (it wasn't in older versions of Hibernate). In our opinion, we shouldn't force the application developer to catch an unrecoverable exception at a low layer. In most systems, unchecked and fatal exceptions are handled in one of the first frames of the method call stack (i.e. in higher layers) and an error message is presented to the application user (or some other appropriate action is taken). Note that Hibernate might also throw other unchecked exceptions which are not a <literal>HibernateException</literal>. These are, again, not recoverable and appropriate action should be taken." -msgstr "<literal>Session</literal> が例外（<literal>SQLException</literal>を含む）を投げた場合、 直ちに、データベーストランザクションをロールバックし、<literal>Session.close()</literal> を呼び、<literal>Session</literal> インスタンスを破棄すべきです。 <literal>Session</literal> のいくつかのメソッドは、 セッションの状態を <emphasis>矛盾したまま</emphasis> にします。 Hibernateが投げた例外を、回復できるものとして扱うことはできません。 <literal>finally</literal> ブロックの中で <literal>close()</literal> を呼んで、 <literal>Session</literal> を確実に閉じてください。" +#. Tag: para +#: transactions.xml:526 +#, no-c-format +msgid "" +"If the <literal>Session</literal> throws an exception (including any " +"<literal>SQLException</literal>), you should immediately rollback the " +"database transaction, call <literal>Session.close()</literal> and discard " +"the <literal>Session</literal> instance. Certain methods of " +"<literal>Session</literal> will <emphasis>not</emphasis> leave the session " +"in a consistent state. No exception thrown by Hibernate can be treated as " +"recoverable. Ensure that the <literal>Session</literal> will be closed by " +"calling <literal>close()</literal> in a <literal>finally</literal> block." +msgstr "" +"<literal>Session</literal> が例外（<literal>SQLException</literal>を含む）を" +"投げた場合、 直ちに、データベーストランザクションをロールバックし、" +"<literal>Session.close()</literal> を呼び、<literal>Session</literal> インス" +"タンスを破棄すべきです。 <literal>Session</literal> のいくつかのメソッドは、 " +"セッションの状態を <emphasis>矛盾したまま</emphasis> にします。 Hibernateが投" +"げた例外を、回復できるものとして扱うことはできません。 <literal>finally</" +"literal> ブロックの中で <literal>close()</literal> を呼んで、 " +"<literal>Session</literal> を確実に閉じてください。" -#: index.docbook:549 -msgid "Hibernate wraps <literal>SQLException</literal>s thrown while interacting with the database in a <literal>JDBCException</literal>. In fact, Hibernate will attempt to convert the eexception into a more meningful subclass of <literal>JDBCException</literal>. The underlying <literal>SQLException</literal> is always available via <literal>JDBCException.getCause()</literal>. Hibernate converts the <literal>SQLException</literal> into an appropriate <literal>JDBCException</literal> subclass using the <literal>SQLExceptionConverter</literal> attached to the <literal>SessionFactory</literal>. By default, the <literal>SQLExceptionConverter</literal> is defined by the configured dialect; however, it is also possible to plug in a custom implementation (see the javadocs for the <literal>SQLExceptionConverterFactory</literal> class for details). The standard <literal>JDBCException</literal> subtypes are:" -msgstr "<literal>HibernateException</literal> は、Hibernate永続化層の中で発生する多くのエラーを ラップする、検査されない例外です（Hibernateの古いバージョンは違いました）。 私たちの意見は、アプリケーション開発者に回復不可能な例外を 下層でキャッチすることを強要すべきではないということです。 多くのシステムでは、検査されない例外と致命的な例外は、 コールスタックの最初のフレームの１つ（例えば、最上位の層で）でハンドリングし、 エラーメッセージをアプリケーションユーザーに表示します （もしくは、他の適切な処理を実施します）。 Hibernateは、<literal>HibernateException</literal> 以外の検査されない例外も 投げることに注意してください。 これらもまた、回復不可能であり、適切な処理を実施すべきです。" +#. Tag: para +#: transactions.xml:537 +#, no-c-format +msgid "" +"The <literal>HibernateException</literal>, which wraps most of the errors " +"that can occur in a Hibernate persistence layer, is an unchecked exception " +"(it wasn't in older versions of Hibernate). In our opinion, we shouldn't " +"force the application developer to catch an unrecoverable exception at a low " +"layer. In most systems, unchecked and fatal exceptions are handled in one of " +"the first frames of the method call stack (i.e. in higher layers) and an " +"error message is presented to the application user (or some other " +"appropriate action is taken). Note that Hibernate might also throw other " +"unchecked exceptions which are not a <literal>HibernateException</literal>. " +"These are, again, not recoverable and appropriate action should be taken." +msgstr "" +"<literal>HibernateException</literal> は、Hibernate永続化層の中で発生する多く" +"のエラーを ラップする、検査されない例外です（Hibernateの古いバージョンは違い" +"ました）。 私たちの意見は、アプリケーション開発者に回復不可能な例外を 下層で" +"キャッチすることを強要すべきではないということです。 多くのシステムでは、検査" +"されない例外と致命的な例外は、 コールスタックの最初のフレームの１つ（例えば、" +"最上位の層で）でハンドリングし、 エラーメッセージをアプリケーションユーザーに" +"表示します （もしくは、他の適切な処理を実施します）。 Hibernateは、" +"<literal>HibernateException</literal> 以外の検査されない例外も 投げることに注" +"意してください。 これらもまた、回復不可能であり、適切な処理を実施すべきです。" -#: index.docbook:565 -msgid "<literal>JDBCConnectionException</literal> - indicates an error with the underlying JDBC communication." -msgstr "Hibernateは、データベースとの対話中に投げられた <literal>SQLException</literal> を <literal>JDBCException</literal> でラップします。 実は、例外をより意味のある <literal>JDBCException</literal> のサブクラスに 変換しようと試みます。 元の <literal>SQLException</literal> は、<literal>JDBCException.getCause()</literal> によりいつでも得られます。 Hibernateは、<literal>SessionFactory</literal> に追加されている <literal>SQLExceptionConverter</literal> を使い、<literal>SQLException</literal> を 適当な <literal>JDBCException</literal> サブクラスに変換します。 デフォルトでは、<literal>SQLExceptionConverter</literal> は設定されているSQL方言により 定義されます。 一方で、独自の実装に差し替えることもできます （詳細は、<literal>SQLExceptionConverterFactory</literal> クラスのJavadocを参照してください）。 標�! �的な <literal>JDBCException</literal> のサブタイプを下記に示します。" +#. Tag: para +#: transactions.xml:549 +#, no-c-format +msgid "" +"Hibernate wraps <literal>SQLException</literal>s thrown while interacting " +"with the database in a <literal>JDBCException</literal>. In fact, Hibernate " +"will attempt to convert the eexception into a more meningful subclass of " +"<literal>JDBCException</literal>. The underlying <literal>SQLException</" +"literal> is always available via <literal>JDBCException.getCause()</" +"literal>. Hibernate converts the <literal>SQLException</literal> into an " +"appropriate <literal>JDBCException</literal> subclass using the " +"<literal>SQLExceptionConverter</literal> attached to the " +"<literal>SessionFactory</literal>. By default, the " +"<literal>SQLExceptionConverter</literal> is defined by the configured " +"dialect; however, it is also possible to plug in a custom implementation " +"(see the javadocs for the <literal>SQLExceptionConverterFactory</literal> " +"class for details). The standard <literal>JDBCException</literal> subtypes " +"are:" +msgstr "" +"Hibernateは、データベースとの対話中に投げられた <literal>SQLException</" +"literal> を <literal>JDBCException</literal> でラップします。 実は、例外をよ" +"り意味のある <literal>JDBCException</literal> のサブクラスに 変換しようと試み" +"ます。 元の <literal>SQLException</literal> は、<literal>JDBCException." +"getCause()</literal> によりいつでも得られます。 Hibernateは、" +"<literal>SessionFactory</literal> に追加されている " +"<literal>SQLExceptionConverter</literal> を使い、<literal>SQLException</" +"literal> を 適当な <literal>JDBCException</literal> サブクラスに変換します。 " +"デフォルトでは、<literal>SQLExceptionConverter</literal> は設定されているSQL" +"方言により 定義されます。 一方で、独自の実装に差し替えることもできます （詳細" +"は、<literal>SQLExceptionConverterFactory</literal> クラスのJavadocを参照して" +"ください）。 標準的な <literal>JDBCException</literal> のサブタイプを下記に示" +"します。" -#: index.docbook:571 -msgid "<literal>SQLGrammarException</literal> - indicates a grammar or syntax problem with the issued SQL." -msgstr "<literal>JDBCConnectionException</literal> - 基礎となるJDBC通信のエラーを表します。" +#. Tag: para +#: transactions.xml:565 +#, no-c-format +msgid "" +"<literal>JDBCConnectionException</literal> - indicates an error with the " +"underlying JDBC communication." +msgstr "" +"<literal>JDBCConnectionException</literal> - 基礎となるJDBC通信のエラーを表し" +"ます。" -#: index.docbook:577 -msgid "<literal>ConstraintViolationException</literal> - indicates some form of integrity constraint violation." -msgstr "<literal>SQLGrammarException</literal> - 発行するSQLの文法もしくは構文の問題を表します。" +#. Tag: para +#: transactions.xml:571 +#, no-c-format +msgid "" +"<literal>SQLGrammarException</literal> - indicates a grammar or syntax " +"problem with the issued SQL." +msgstr "" +"<literal>SQLGrammarException</literal> - 発行するSQLの文法もしくは構文の問題" +"を表します。" -#: index.docbook:583 -msgid "<literal>LockAcquisitionException</literal> - indicates an error acquiring a lock level necessary to perform the requested operation." -msgstr "<literal>ConstraintViolationException</literal> - 何らかの形式の完全性制約違反を表します。" +#. Tag: para +#: transactions.xml:577 +#, no-c-format +msgid "" +"<literal>ConstraintViolationException</literal> - indicates some form of " +"integrity constraint violation." +msgstr "" +"<literal>ConstraintViolationException</literal> - 何らかの形式の完全性制約違" +"反を表します。" -#: index.docbook:589 -msgid "<literal>GenericJDBCException</literal> - a generic exception which did not fall into any of the other categories." -msgstr "<literal>LockAcquisitionException</literal> - 要求された操作を実施するのに必要なロックレベルを得る際のエラーを表します。" +#. Tag: para +#: transactions.xml:583 +#, no-c-format +msgid "" +"<literal>LockAcquisitionException</literal> - indicates an error acquiring a " +"lock level necessary to perform the requested operation." +msgstr "" +"<literal>LockAcquisitionException</literal> - 要求された操作を実施するのに必" +"要なロックレベルを得る際のエラーを表します。" -#: index.docbook:599 +#. Tag: para +#: transactions.xml:589 +#, no-c-format +msgid "" +"<literal>GenericJDBCException</literal> - a generic exception which did not " +"fall into any of the other categories." +msgstr "" +"<literal>GenericJDBCException</literal> - 他のカテゴリに一致しなかった一般的" +"な例外です。" + +#. Tag: title +#: transactions.xml:599 +#, no-c-format msgid "Transaction timeout" -msgstr "<literal>GenericJDBCException</literal> - 他のカテゴリに一致しなかった一般的な例外です。" - -#: index.docbook:601 -msgid "One extremely important feature provided by a managed environment like EJB that is never provided for non-managed code is transaction timeout. Transaction timeouts ensure that no misbehaving transaction can indefinitely tie up resources while returning no response to the user. Outside a managed (JTA) environment, Hibernate cannot fully provide this functionality. However, Hibernate can at least control data access operations, ensuring that database level deadlocks and queries with huge result sets are limited by a defined timeout. In a managed environment, Hibernate can delegate transaction timeout to JTA. This functioanlity is abstracted by the Hibernate <literal>Transaction</literal> object." msgstr "トランザクションのタイムアウト" -#: index.docbook:614 +#. Tag: para +#: transactions.xml:601 +#, no-c-format msgid "" - "<![CDATA[\n" - "Session sess = factory.openSession();\n" - "try {\n" - " //set transaction timeout to 3 seconds\n" - " sess.getTransaction().setTimeout(3);\n" - " sess.getTransaction().begin();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " sess.getTransaction().commit()\n" - "}\n" - "catch (RuntimeException e) {\n" - " sess.getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -msgstr "EJBのような管理された環境が提供するきわめて重要な特徴の１つは、 トランザクションのタイムアウトです。 これは管理されていないコードには提供できません。 トランザクションタイムアウトは、不品行なトランザクションが ユーザーにレスポンスを返さないまま、無期限にリソースを使い続けない ことを保障します。 管理された環境（JTA）の外では、Hibernateはこの機能をフルに提供できません。 しかしながら、Hibernateは次のようなデータアクセス操作の制御くらいはできます。 データベースレベルのデッドロックや大きなリザルトセットを返すクエリを 定義されたタイムアウトによって確実に制限します。 管理された環境では、HibernateはトランザクションタイムアウトをJTAに委譲します。 この機能は、Hibernateの <lite! ral>Transaction</literal> オブジェクトに よって抽象化されています。" +"One extremely important feature provided by a managed environment like EJB " +"that is never provided for non-managed code is transaction timeout. " +"Transaction timeouts ensure that no misbehaving transaction can indefinitely " +"tie up resources while returning no response to the user. Outside a managed " +"(JTA) environment, Hibernate cannot fully provide this functionality. " +"However, Hibernate can at least control data access operations, ensuring " +"that database level deadlocks and queries with huge result sets are limited " +"by a defined timeout. In a managed environment, Hibernate can delegate " +"transaction timeout to JTA. This functioanlity is abstracted by the " +"Hibernate <literal>Transaction</literal> object." +msgstr "" +"EJBのような管理された環境が提供するきわめて重要な特徴の１つは、 トランザク" +"ションのタイムアウトです。 これは管理されていないコードには提供できません。 " +"トランザクションタイムアウトは、不品行なトランザクションが ユーザーにレスポン" +"スを返さないまま、無期限にリソースを使い続けない ことを保障します。 管理され" +"た環境（JTA）の外では、Hibernateはこの機能をフルに提供できません。 しかしなが" +"ら、Hibernateは次のようなデータアクセス操作の制御くらいはできます。 データ" +"ベースレベルのデッドロックや大きなリザルトセットを返すクエリを 定義されたタイ" +"ムアウトによって確実に制限します。 管理された環境では、Hibernateはトランザク" +"ションタイムアウトをJTAに委譲します。 この機能は、Hibernateの " +"<literal>Transaction</literal> オブジェクトに よって抽象化されています。" -#: index.docbook:616 -msgid "Note that <literal>setTimeout()</literal> may not be called in a CMT bean, where transaction timeouts must be defined declaratively." +#. Tag: programlisting +#: transactions.xml:614 +#, no-c-format +msgid "" +"<![CDATA[\n" +"Session sess = factory.openSession();\n" +"try {\n" +" //set transaction timeout to 3 seconds\n" +" sess.getTransaction().setTimeout(3);\n" +" sess.getTransaction().begin();\n" +"\n" +" // do some work\n" +" ...\n" +"\n" +" sess.getTransaction().commit()\n" +"}\n" +"catch (RuntimeException e) {\n" +" sess.getTransaction().rollback();\n" +" throw e; // or display error message\n" +"}\n" +"finally {\n" +" sess.close();\n" +"}]]>" msgstr "" - "<![CDATA[\n" - "Session sess = factory.openSession();\n" - "try {\n" - " //set transaction timeout to 3 seconds\n" - " sess.getTransaction().setTimeout(3);\n" - " sess.getTransaction().begin();\n" - "\n" - " // do some work\n" - " ...\n" - "\n" - " sess.getTransaction().commit()\n" - "}\n" - "catch (RuntimeException e) {\n" - " sess.getTransaction().rollback();\n" - " throw e; // or display error message\n" - "}\n" - "finally {\n" - " sess.close();\n" - "}]]>" -#: index.docbook:626 +#. Tag: para +#: transactions.xml:616 +#, no-c-format +msgid "" +"Note that <literal>setTimeout()</literal> may not be called in a CMT bean, " +"where transaction timeouts must be defined declaratively." +msgstr "" +"CMTビーンの中では <literal>setTimeout()</literal> を 呼び出せないことに注意し" +"てください。 トランザクションタイムアウトは宣言的に定義されるべきです。" + +#. Tag: title +#: transactions.xml:626 +#, no-c-format msgid "Optimistic concurrency control" -msgstr "CMTビーンの中では <literal>setTimeout()</literal> を 呼び出せないことに注意してください。 トランザクションタイムアウトは宣言的に定義されるべきです。" - -#: index.docbook:628 -msgid "The only approach that is consistent with high concurrency and high scalability is optimistic concurrency control with versioning. Version checking uses version numbers, or timestamps, to detect conflicting updates (and to prevent lost updates). Hibernate provides for three possible approaches to writing application code that uses optimistic concurrency. The use cases we show are in the context of long conversations, but version checking also has the benefit of preventing lost updates in single database transactions." msgstr "楽観的同時実行制御" -#: index.docbook:639 +#. Tag: para +#: transactions.xml:628 +#, no-c-format +msgid "" +"The only approach that is consistent with high concurrency and high " +"scalability is optimistic concurrency control with versioning. Version " +"checking uses version numbers, or timestamps, to detect conflicting updates " +"(and to prevent lost updates). Hibernate provides for three possible " +"approaches to writing application code that uses optimistic concurrency. The " +"use cases we show are in the context of long conversations, but version " +"checking also has the benefit of preventing lost updates in single database " +"transactions." +msgstr "" +"高い並列性と高いスケーラビリティの両方を実現するアプローチは、 バージョニング" +"を使った楽観的同時実行制御のみです。 更新の衝突を見つけるために（および、更新" +"が失われるのを防ぐために）、 バージョン番号もしくはタイムスタンプを使って、" +"バージョンをチェックします。 Hibernateは、楽観的同時実行を行うアプリケーショ" +"ンコードを書くための アプローチを３つ提供します。 私たちが見せるユースケース" +"は、長い対話を持ちますが、 バージョンチェックはまだ１つのデータベーストランザ" +"クションの中で更新を失うことを防ぐ 利点も持っています。" + +#. Tag: title +#: transactions.xml:639 +#, no-c-format msgid "Application version checking" -msgstr "高い並列性と高いスケーラビリティの両方を実現するアプローチは、 バージョニングを使った楽観的同時実行制御のみです。 更新の衝突を見つけるために（および、更新が失われるのを防ぐために）、 バージョン番号もしくはタイムスタンプを使って、バージョンをチェックします。 Hibernateは、楽観的同時実行を行うアプリケーションコードを書くための アプローチを３つ提供します。 私たちが見せるユースケースは、長い対話を持ちますが、 バージョンチェックはまだ１つのデータベーストランザクションの中で更新を失うことを防ぐ 利点も持っています。" - -#: index.docbook:641 -msgid "In an implementation without much help from Hibernate, each interaction with the database occurs in a new <literal>Session</literal> and the developer is responsible for reloading all persistent instances from the database before manipulating them. This approach forces the application to carry out its own version checking to ensure conversation transaction isolation. This approach is the least efficient in terms of database access. It is the approach most similar to entity EJBs." msgstr "アプリケーションによるバージョンチェック" -#: index.docbook:650 +#. Tag: para +#: transactions.xml:641 +#, no-c-format msgid "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "\n" - "int oldVersion = foo.getVersion();\n" - "session.load( foo, foo.getKey() ); // load the current state\n" - "if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException();\n" - "foo.setProperty(\"bar\");\n" - "\n" - "t.commit();\n" - "session.close();]]>" -msgstr "Hibernateにほとんど助けてもらわずに実装するケースです。 データベースとのやり取りは、それぞれ新しい <literal>Session</literal> の中で起こります。 開発者は、すべての永続性インスタンスを操作する前に、 データベースから再読み込みする責務があります。 このアプローチでは、対話トランザクションの分離を守るために、 アプリケーション自身がバージョンチェックを行う必要があります。 このアプローチは、データベースアクセスの中では、最も非効率です。 エンティティEJBと最も似ているアプローチです。" +"In an implementation without much help from Hibernate, each interaction with " +"the database occurs in a new <literal>Session</literal> and the developer is " +"responsible for reloading all persistent instances from the database before " +"manipulating them. This approach forces the application to carry out its own " +"version checking to ensure conversation transaction isolation. This approach " +"is the least efficient in terms of database access. It is the approach most " +"similar to entity EJBs." +msgstr "" +"Hibernateにほとんど助けてもらわずに実装するケースです。 データベースとのやり" +"取りは、それぞれ新しい <literal>Session</literal> の中で起こります。 開発者" +"は、すべての永続性インスタンスを操作する前に、 データベースから再読み込みする" +"責務があります。 このアプローチでは、対話トランザクションの分離を守るため" +"に、 アプリケーション自身がバージョンチェックを行う必要があります。 このアプ" +"ローチは、データベースアクセスの中では、最も非効率です。 エンティティEJBと最" +"も似ているアプローチです。" -#: index.docbook:652 -msgid "The <literal>version</literal> property is mapped using <literal>&lt;version&gt;</literal>, and Hibernate will automatically increment it during flush if the entity is dirty." +#. Tag: programlisting +#: transactions.xml:650 +#, no-c-format +msgid "" +"<![CDATA[// foo is an instance loaded by a previous Session\n" +"session = factory.openSession();\n" +"Transaction t = session.beginTransaction();\n" +"\n" +"int oldVersion = foo.getVersion();\n" +"session.load( foo, foo.getKey() ); // load the current state\n" +"if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException" +"();\n" +"foo.setProperty(\"bar\");\n" +"\n" +"t.commit();\n" +"session.close();]]>" msgstr "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "\n" - "int oldVersion = foo.getVersion();\n" - "session.load( foo, foo.getKey() ); // load the current state\n" - "if ( oldVersion != foo.getVersion() ) throw new StaleObjectStateException();\n" - "foo.setProperty(\"bar\");\n" - "\n" - "t.commit();\n" - "session.close();]]>" -#: index.docbook:658 -msgid "Of course, if you are operating in a low-data-concurrency environment and don't require version checking, you may use this approach and just skip the version check. In that case, <emphasis>last commit wins</emphasis> will be the default strategy for your long conversations. Keep in mind that this might confuse the users of the application, as they might experience lost updates without error messages or a chance to merge conflicting changes." -msgstr "<literal>&lt;version&gt;</literal> を使って、<literal>version</literal> プロパティをマッピングします。 Hibernateは、エンティティがダーティである場合、フラッシュし、 その間に <literal>version</literal> プロパティを自動的にインクリメントします。" +#. Tag: para +#: transactions.xml:652 +#, no-c-format +msgid "" +"The <literal>version</literal> property is mapped using <literal>&lt;" +"version&gt;</literal>, and Hibernate will automatically increment it during " +"flush if the entity is dirty." +msgstr "" +"<literal>&lt;version&gt;</literal> を使って、<literal>version</literal> プロ" +"パティをマッピングします。 Hibernateは、エンティティがダーティである場合、フ" +"ラッシュし、 その間に <literal>version</literal> プロパティを自動的にインクリ" +"メントします。" -#: index.docbook:667 -msgid "Clearly, manual version checking is only feasible in very trivial circumstances and not practical for most applications. Often not only single instances, but complete graphs of modified ojects have to be checked. Hibernate offers automatic version checking with either an extended <literal>Session</literal> or detached instances as the design paradigm." -msgstr "もちろん、データの並列性が低い環境で運用しており、バージョンチェックが不要なら、 このアプローチを使い、バージョンチェックをスキップするだけです。 その場合は、長い対話には、 <emphasis>「最後にコミットしたものが勝つ」</emphasis> がデフォルトの戦略でしょう。 このアプローチは、アプリケーションのユーザーを混乱させるかもしれないことを 心に留めて置いてください。それは、エラーメッセージや競合した変更をマージする機会が ないまま、更新を失う経験をするためです。" +#. Tag: para +#: transactions.xml:658 +#, no-c-format +msgid "" +"Of course, if you are operating in a low-data-concurrency environment and " +"don't require version checking, you may use this approach and just skip the " +"version check. In that case, <emphasis>last commit wins</emphasis> will be " +"the default strategy for your long conversations. Keep in mind that this " +"might confuse the users of the application, as they might experience lost " +"updates without error messages or a chance to merge conflicting changes." +msgstr "" +"もちろん、データの並列性が低い環境で運用しており、バージョンチェックが不要な" +"ら、 このアプローチを使い、バージョンチェックをスキップするだけです。 その場" +"合は、長い対話には、 <emphasis>「最後にコミットしたものが勝つ」</emphasis> が" +"デフォルトの戦略でしょう。 このアプローチは、アプリケーションのユーザーを混乱" +"させるかもしれないことを 心に留めて置いてください。それは、エラーメッセージや" +"競合した変更をマージする機会が ないまま、更新を失う経験をするためです。" -#: index.docbook:678 +#. Tag: para +#: transactions.xml:667 +#, no-c-format +msgid "" +"Clearly, manual version checking is only feasible in very trivial " +"circumstances and not practical for most applications. Often not only single " +"instances, but complete graphs of modified ojects have to be checked. " +"Hibernate offers automatic version checking with either an extended " +"<literal>Session</literal> or detached instances as the design paradigm." +msgstr "" +"確かに、マニュアルによるバージョンチェックは、些細な儀式だけで実行できます" +"が、 多くのアプリケーションにとって実用的ではありません。 しばしば、１つのイ" +"ンスタンスだけでなく、 修正されたオブジェクトの完全なグラフをチェックしなけれ" +"ばなりません。 Hibernateは、設計パラダイムとして、拡張 <literal>Session</" +"literal> か 分離されたインスタンスを自動的にバージョンチェックします。" + +#. Tag: title +#: transactions.xml:678 +#, no-c-format msgid "Extended session and automatic versioning" -msgstr "確かに、マニュアルによるバージョンチェックは、些細な儀式だけで実行できますが、 多くのアプリケーションにとって実用的ではありません。 しばしば、１つのインスタンスだけでなく、 修正されたオブジェクトの完全なグラフをチェックしなければなりません。 Hibernateは、設計パラダイムとして、拡張 <literal>Session</literal> か 分離されたインスタンスを自動的にバージョンチェックします。" - -#: index.docbook:680 -msgid "A single <literal>Session</literal> instance and its persistent instances are used for the whole conversation, known as <emphasis>session-per-conversation</emphasis>. Hibernate checks instance versions at flush time, throwing an exception if concurrent modification is detected. It's up to the developer to catch and handle this exception (common options are the opportunity for the user to merge changes or to restart the business conversation with non-stale data)." msgstr "拡張セッションと自動バージョニング" -#: index.docbook:689 -msgid "The <literal>Session</literal> is disconnected from any underlying JDBC connection when waiting for user interaction. This approach is the most efficient in terms of database access. The application need not concern itself with version checking or with reattaching detached instances, nor does it have to reload instances in every database transaction." -msgstr "１つの <literal>Session</literal> インスタンスとその永続性インスタンスは、 <emphasis>session-per-conversation</emphasis> として知られる、 対話全体で使われます。 Hibernateはフラッシュする際に、インスタンスのバージョンをチェックします。 同時に修正されたことを検出すると、例外を投げます。 この例外をキャッチして扱うのは、開発者の責任です （一般的な選択肢は、変更をマージするか古くないデータでビジネス対話を 再スタートする機会をユーザーに提供することです）。" +#. Tag: para +#: transactions.xml:680 +#, no-c-format +msgid "" +"A single <literal>Session</literal> instance and its persistent instances " +"are used for the whole conversation, known as <emphasis>session-per-" +"conversation</emphasis>. Hibernate checks instance versions at flush time, " +"throwing an exception if concurrent modification is detected. It's up to the " +"developer to catch and handle this exception (common options are the " +"opportunity for the user to merge changes or to restart the business " +"conversation with non-stale data)." +msgstr "" +"１つの <literal>Session</literal> インスタンスとその永続性インスタンスは、 " +"<emphasis>session-per-conversation</emphasis> として知られる、 対話全体で使わ" +"れます。 Hibernateはフラッシュする際に、インスタンスのバージョンをチェックし" +"ます。 同時に修正されたことを検出すると、例外を投げます。 この例外をキャッチ" +"して扱うのは、開発者の責任です （一般的な選択肢は、変更をマージするか古くない" +"データでビジネス対話を 再スタートする機会をユーザーに提供することです）。" -#: index.docbook:697 +#. Tag: para +#: transactions.xml:689 +#, no-c-format msgid "" - "<![CDATA[// foo is an instance loaded earlier by the old session\n" - "Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, start transaction\n" - "\n" - "foo.setProperty(\"bar\");\n" - "\n" - "session.flush(); // Only for last transaction in conversation\n" - "t.commit(); // Also return JDBC connection\n" - "session.close(); // Only for last transaction in conversation]]>" -msgstr "ユーザーの対話を待っているときは、 <literal>Session</literal> を基礎となるJDBCコネクションから切り離します。 このアプローチは、データベースアクセスの中では、最も効率的です。 アプリケーションは、バージョンチェックや分離されたインスタンスを再追加すること に関心を持つ必要はありません。また、あらゆるデータベーストランザクションの中で インスタンスを再読み込みする必要はありません。" +"The <literal>Session</literal> is disconnected from any underlying JDBC " +"connection when waiting for user interaction. This approach is the most " +"efficient in terms of database access. The application need not concern " +"itself with version checking or with reattaching detached instances, nor " +"does it have to reload instances in every database transaction." +msgstr "" +"ユーザーの対話を待っているときは、 <literal>Session</literal> を基礎となる" +"JDBCコネクションから切り離します。 このアプローチは、データベースアクセスの中" +"では、最も効率的です。 アプリケーションは、バージョンチェックや分離されたイン" +"スタンスを再追加すること に関心を持つ必要はありません。また、あらゆるデータ" +"ベーストランザクションの中で インスタンスを再読み込みする必要はありません。" -#: index.docbook:698 -msgid "The <literal>foo</literal> object still knows which <literal>Session</literal> it was loaded in. Beginning a new database transaction on an old session obtains a new connection and resumes the session. Committing a database transaction disconnects a session from the JDBC connection and returns the connection to the pool. After reconnection, to force a version check on data you aren't updating, you may call <literal>Session.lock()</literal> with <literal>LockMode.READ</literal> on any objects that might have been updated by another transaction. You don't need to lock any data that you <emphasis>are</emphasis> updating. Usually you would set <literal>FlushMode.MANUAL</literal> on an extended <literal>Session</literal>, so that only the last database transaction cycle is allowed to actually persist all modifications made in this conversation. Hence, only this last database transaction would include the <literal>flush()</literal> operation, and then also <literal>close()! </literal> the session to end the conversation." +#. Tag: programlisting +#: transactions.xml:697 +#, no-c-format +msgid "" +"<![CDATA[// foo is an instance loaded earlier by the old session\n" +"Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, " +"start transaction\n" +"\n" +"foo.setProperty(\"bar\");\n" +"\n" +"session.flush(); // Only for last transaction in conversation\n" +"t.commit(); // Also return JDBC connection\n" +"session.close(); // Only for last transaction in conversation]]>" msgstr "" - "<![CDATA[// foo is an instance loaded earlier by the old session\n" - "Transaction t = session.beginTransaction(); // Obtain a new JDBC connection, start transaction\n" - "\n" - "foo.setProperty(\"bar\");\n" - "\n" - "session.flush(); // Only for last transaction in conversation\n" - "t.commit(); // Also return JDBC connection\n" - "session.close(); // Only for last transaction in conversation]]>" -#: index.docbook:713 -msgid "This pattern is problematic if the <literal>Session</literal> is too big to be stored during user think time, e.g. an <literal>HttpSession</literal> should be kept as small as possible. As the <literal>Session</literal> is also the (mandatory) first-level cache and contains all loaded objects, we can probably use this strategy only for a few request/response cycles. You should use a <literal>Session</literal> only for a single conversation, as it will soon also have stale data." -msgstr "<literal>foo</literal> オブジェクトは、自分をロードした <literal>Session</literal> をまだ知っています。 古いセッションの上で新しいデータベーストランザクションを開始することで、 新しいコネクションを取得し、そのセッションが再開されます。 データベーストランザクションをコミットすることで、 セッションからJDBCコネクションを切断し、コネクションをプールに返します。 再接続した後、更新していないデータのバージョンチェックを強制するために、 他のトランザクションにより更新されているかもしれないオブジェクトに関して、 <literal>LockMode.READ</literal> をつけて <literal>Session.lock()</literal> を呼び出すことができます。 更新して <emphasis>いる</emphasis> データをロックする必要はありません。 通常、拡張 <literal>Session<! /literal> に <literal>FlushMode.MANUAL</literal> をセットします。 最後のデータベーストランザクションの周期でのみ、 対話の中で変更されたすべてを実際に永続化させるためです。 ゆえに、最後のデータベーストランザクションのみ <literal>flush()</literal> オペレーションを含みます。そして、対話を終わらせるために、 セッションも <literal>close()</literal> します。" +#. Tag: para +#: transactions.xml:698 +#, no-c-format +msgid "" +"The <literal>foo</literal> object still knows which <literal>Session</" +"literal> it was loaded in. Beginning a new database transaction on an old " +"session obtains a new connection and resumes the session. Committing a " +"database transaction disconnects a session from the JDBC connection and " +"returns the connection to the pool. After reconnection, to force a version " +"check on data you aren't updating, you may call <literal>Session.lock()</" +"literal> with <literal>LockMode.READ</literal> on any objects that might " +"have been updated by another transaction. You don't need to lock any data " +"that you <emphasis>are</emphasis> updating. Usually you would set " +"<literal>FlushMode.MANUAL</literal> on an extended <literal>Session</" +"literal>, so that only the last database transaction cycle is allowed to " +"actually persist all modifications made in this conversation. Hence, only " +"this last database transaction would include the <literal>flush()</literal> " +"operation, and then also <literal>close()</literal> the session to end the " +"conversation." +msgstr "" +"<literal>foo</literal> オブジェクトは、自分をロードした <literal>Session</" +"literal> をまだ知っています。 古いセッションの上で新しいデータベーストランザ" +"クションを開始することで、 新しいコネクションを取得し、そのセッションが再開さ" +"れます。 データベーストランザクションをコミットすることで、 セッションから" +"JDBCコネクションを切断し、コネクションをプールに返します。 再接続した後、更新" +"していないデータのバージョンチェックを強制するために、 他のトランザクションに" +"より更新されているかもしれないオブジェクトに関して、 <literal>LockMode.READ</" +"literal> をつけて <literal>Session.lock()</literal> を呼び出すことができま" +"す。 更新して <emphasis>いる</emphasis> データをロックする必要はありません。 " +"通常、拡張 <literal>Session</literal> に <literal>FlushMode.MANUAL</literal> " +"をセットします。 最後のデータベーストランザクションの周期でのみ、 対話の中で" +"変更されたすべてを実際に永続化させるためです。 ゆえに、最後のデータベーストラ" +"ンザクションのみ <literal>flush()</literal> オペレーションを含みます。そし" +"て、対話を終わらせるために、 セッションも <literal>close()</literal> します。" -#: index.docbook:723 -msgid "(Note that earlier Hibernate versions required explicit disconnection and reconnection of a <literal>Session</literal>. These methods are deprecated, as beginning and ending a transaction has the same effect.)" -msgstr "ユーザーが考慮中に、格納することができないくらい <literal>Session</literal> が大きいのであれば、このパターンは問題があります。 例えば、<literal>HttpSession</literal> は可能な限り小さく保つべきです。 <literal>Session</literal> は（強制的に）１次キャッシュでもあり、 ロードしたオブジェクトをすべて保持します。 おそらく、リクエスト／レスポンスのサイクルが数回であれば、この戦略が使えます。 １つの対話のためだけに <literal>Session</literal> を使うべきです。 なぜなら、すぐに新鮮でないデータを持つためです。" +#. Tag: para +#: transactions.xml:713 +#, no-c-format +msgid "" +"This pattern is problematic if the <literal>Session</literal> is too big to " +"be stored during user think time, e.g. an <literal>HttpSession</literal> " +"should be kept as small as possible. As the <literal>Session</literal> is " +"also the (mandatory) first-level cache and contains all loaded objects, we " +"can probably use this strategy only for a few request/response cycles. You " +"should use a <literal>Session</literal> only for a single conversation, as " +"it will soon also have stale data." +msgstr "" +"ユーザーが考慮中に、格納することができないくらい <literal>Session</literal> " +"が大きいのであれば、このパターンは問題があります。 例えば、" +"<literal>HttpSession</literal> は可能な限り小さく保つべきです。 " +"<literal>Session</literal> は（強制的に）１次キャッシュでもあり、 ロードした" +"オブジェクトをすべて保持します。 おそらく、リクエスト／レスポンスのサイクルが" +"数回であれば、この戦略が使えます。 １つの対話のためだけに <literal>Session</" +"literal> を使うべきです。 なぜなら、すぐに新鮮でないデータを持つためです。" -#: index.docbook:729 -msgid "Also note that you should keep the disconnected <literal>Session</literal> close to the persistence layer. In other words, use an EJB stateful session bean to hold the <literal>Session</literal> in a three-tier environment, and don't transfer it to the web layer (or even serialize it to a separate tier) to store it in the <literal>HttpSession</literal>." -msgstr "（Hibernateの以前のバージョンは、明示的な <literal>Session</literal> の 切断と再接続が必要だったことに注意してください。 これらのメソッドは非推奨になりました。 なぜなら、トランザクションの開始と終了は同じ効果があるためです。）" +#. Tag: para +#: transactions.xml:723 +#, no-c-format +msgid "" +"(Note that earlier Hibernate versions required explicit disconnection and " +"reconnection of a <literal>Session</literal>. These methods are deprecated, " +"as beginning and ending a transaction has the same effect.)" +msgstr "" +"（Hibernateの以前のバージョンは、明示的な <literal>Session</literal> の 切断" +"と再接続が必要だったことに注意してください。 これらのメソッドは非推奨になりま" +"した。 なぜなら、トランザクションの開始と終了は同じ効果があるためです。）" -#: index.docbook:737 -msgid "The extended session pattern, or <emphasis>session-per-conversation</emphasis>, is more difficult to implement with automatic current session context management. You need to supply your own implementation of the <literal>CurrentSessionContext</literal> for this, see the Hibernate Wiki for examples." -msgstr "切断した <literal>Session</literal> を永続化層の近くで保持すべきであることに 注意してください。 言い換えると、３層環境の中で <literal>Session</literal> を保持するために、 EJBステートフルセッションBeanを使ってください。 <literal>HttpSession</literal> に格納するために、Web層に転送しないでください （別の層へのシリアライズもしないでください）。" +#. Tag: para +#: transactions.xml:729 +#, no-c-format +msgid "" +"Also note that you should keep the disconnected <literal>Session</literal> " +"close to the persistence layer. In other words, use an EJB stateful session " +"bean to hold the <literal>Session</literal> in a three-tier environment, and " +"don't transfer it to the web layer (or even serialize it to a separate tier) " +"to store it in the <literal>HttpSession</literal>." +msgstr "" +"切断した <literal>Session</literal> を永続化層の近くで保持すべきであることに " +"注意してください。 言い換えると、３層環境の中で <literal>Session</literal> を" +"保持するために、 EJBステートフルセッションBeanを使ってください。 " +"<literal>HttpSession</literal> に格納するために、Web層に転送しないでください " +"（別の層へのシリアライズもしないでください）。" -#: index.docbook:747 +#. Tag: para +#: transactions.xml:737 +#, no-c-format +msgid "" +"The extended session pattern, or <emphasis>session-per-conversation</" +"emphasis>, is more difficult to implement with automatic current session " +"context management. You need to supply your own implementation of the " +"<literal>CurrentSessionContext</literal> for this, see the Hibernate Wiki " +"for examples." +msgstr "" +"拡張セッションパターン（もしくは、<emphasis>session-per-conversation</" +"emphasis>）は、 自動的なカレントセッションコンテキスト管理を実施するより難し" +"い。 このために、あなたは <literal>CurrentSessionContext</literal> の実装を供" +"給する必要があります。 Hibernate Wikiにある例を参照してください。" + +#. Tag: title +#: transactions.xml:747 +#, no-c-format msgid "Detached objects and automatic versioning" -msgstr "拡張セッションパターン（もしくは、<emphasis>session-per-conversation</emphasis>）は、 自動的なカレントセッションコンテキスト管理を実施するより難しい。 このために、あなたは <literal>CurrentSessionContext</literal> の実装を供給する必要があります。 Hibernate Wikiにある例を参照してください。" - -#: index.docbook:749 -msgid "Each interaction with the persistent store occurs in a new <literal>Session</literal>. However, the same persistent instances are reused for each interaction with the database. The application manipulates the state of detached instances originally loaded in another <literal>Session</literal> and then reattaches them using <literal>Session.update()</literal>, <literal>Session.saveOrUpdate()</literal>, or <literal>Session.merge()</literal>." msgstr "デタッチされたオブジェクトと自動バージョニング" -#: index.docbook:757 +#. Tag: para +#: transactions.xml:749 +#, no-c-format msgid "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "foo.setProperty(\"bar\");\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been loaded already\n" - "t.commit();\n" - "session.close();]]>" -msgstr "新しい <literal>Session</literal>により、永続化ストア（訳注：ＤＢ）との対話が発生します。 また一方、同じ永続性インスタンスが、データベースとの対話ごとに再利用されます。 アプリケーションは、元々は他の <literal>Session</literal> でロードされ、 デタッチされたインスタンスの状態を操作します。 そして、<literal>Session.update()</literal> もしくは、<literal>Session.saveOrUpdate()</literal>、 <literal>Session.merge()</literal> を使って、それらのインスタンスを再追加します。" +"Each interaction with the persistent store occurs in a new <literal>Session</" +"literal>. However, the same persistent instances are reused for each " +"interaction with the database. The application manipulates the state of " +"detached instances originally loaded in another <literal>Session</literal> " +"and then reattaches them using <literal>Session.update()</literal>, " +"<literal>Session.saveOrUpdate()</literal>, or <literal>Session.merge()</" +"literal>." +msgstr "" +"新しい <literal>Session</literal>により、永続化ストア（訳注：ＤＢ）との対話が" +"発生します。 また一方、同じ永続性インスタンスが、データベースとの対話ごとに再" +"利用されます。 アプリケーションは、元々は他の <literal>Session</literal> で" +"ロードされ、 デタッチされたインスタンスの状態を操作します。 そして、" +"<literal>Session.update()</literal> もしくは、<literal>Session.saveOrUpdate()" +"</literal>、 <literal>Session.merge()</literal> を使って、それらのインスタン" +"スを再追加します。" -#: index.docbook:759 -msgid "Again, Hibernate will check instance versions during flush, throwing an exception if conflicting updates occured." +#. Tag: programlisting +#: transactions.xml:757 +#, no-c-format +msgid "" +"<![CDATA[// foo is an instance loaded by a previous Session\n" +"foo.setProperty(\"bar\");\n" +"session = factory.openSession();\n" +"Transaction t = session.beginTransaction();\n" +"session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been loaded " +"already\n" +"t.commit();\n" +"session.close();]]>" msgstr "" - "<![CDATA[// foo is an instance loaded by a previous Session\n" - "foo.setProperty(\"bar\");\n" - "session = factory.openSession();\n" - "Transaction t = session.beginTransaction();\n" - "session.saveOrUpdate(foo); // Use merge() if \"foo\" might have been loaded already\n" - "t.commit();\n" - "session.close();]]>" -#: index.docbook:764 -msgid "You may also call <literal>lock()</literal> instead of <literal>update()</literal> and use <literal>LockMode.READ</literal> (performing a version check, bypassing all caches) if you are sure that the object has not been modified." -msgstr "この場合もやはり、Hibernateはフラッシュする際に、インスタンスのバージョンをチェックします。 更新の競合が発生した場合には、例外を投げます。" +#. Tag: para +#: transactions.xml:759 +#, no-c-format +msgid "" +"Again, Hibernate will check instance versions during flush, throwing an " +"exception if conflicting updates occured." +msgstr "" +"この場合もやはり、Hibernateはフラッシュする際に、インスタンスのバージョンを" +"チェックします。 更新の競合が発生した場合には、例外を投げます。" -#: index.docbook:773 +#. Tag: para +#: transactions.xml:764 +#, no-c-format +msgid "" +"You may also call <literal>lock()</literal> instead of <literal>update()</" +"literal> and use <literal>LockMode.READ</literal> (performing a version " +"check, bypassing all caches) if you are sure that the object has not been " +"modified." +msgstr "" +"オブジェクトが修正されていないことを確信している場合は、 <literal>update()</" +"literal> の代わりに、<literal>LockMode.READ</literal> を使って、 " +"<literal>lock()</literal> を呼び出すこともできます （すべてのキャッシュを迂回" +"し、バージョンチェックを実施します）。" + +#. Tag: title +#: transactions.xml:773 +#, no-c-format msgid "Customizing automatic versioning" -msgstr "オブジェクトが修正されていないことを確信している場合は、 <literal>update()</literal> の代わりに、<literal>LockMode.READ</literal> を使って、 <literal>lock()</literal> を呼び出すこともできます （すべてのキャッシュを迂回し、バージョンチェックを実施します）。" - -#: index.docbook:775 -msgid "You may disable Hibernate's automatic version increment for particular properties and collections by setting the <literal>optimistic-lock</literal> mapping attribute to <literal>false</literal>. Hibernate will then no longer increment versions if the property is dirty." msgstr "自動バージョニングのカスタマイズ" -#: index.docbook:782 -msgid "Legacy database schemas are often static and can't be modified. Or, other applications might also access the same database and don't know how to handle version numbers or even timestamps. In both cases, versioning can't rely on a particular column in a table. To force a version check without a version or timestamp property mapping, with a comparison of the state of all fields in a row, turn on <literal>optimistic-lock=\"all\"</literal> in the <literal>&lt;class&gt;</literal> mapping. Note that this concepetually only works if Hibernate can compare the old and new state, i.e. if you use a single long <literal>Session</literal> and not session-per-request-with-detached-objects." -msgstr "マッピングの <literal>optimistic-lock</literal> 属性に <literal>false</literal> を設定することにより、特定のプロパティやコレクションのために 自動バージョンインクリメントを無効にできます。 プロパティがダーティであっても、バージョンをインクリメントしません。" +#. Tag: para +#: transactions.xml:775 +#, no-c-format +msgid "" +"You may disable Hibernate's automatic version increment for particular " +"properties and collections by setting the <literal>optimistic-lock</literal> " +"mapping attribute to <literal>false</literal>. Hibernate will then no longer " +"increment versions if the property is dirty." +msgstr "" +"マッピングの <literal>optimistic-lock</literal> 属性に <literal>false</" +"literal> を設定することにより、特定のプロパティやコレクションのために 自動" +"バージョンインクリメントを無効にできます。 プロパティがダーティであっても、" +"バージョンをインクリメントしません。" -#: index.docbook:793 -msgid "Sometimes concurrent modification can be permitted as long as the changes that have been made don't overlap. If you set <literal>optimistic-lock=\"dirty\"</literal> when mapping the <literal>&lt;class&gt;</literal>, Hibernate will only compare dirty fields during flush." -msgstr "レガシーのデータベーススキーマは、しばしば固定的であり、変更できません。 または、他のアプリケーションが同じデータベースにアクセスしなければならず、 そのアプリケーションはバージョン番号やタイムスタンプさえ操作する方法を知りません。 どちらの場合も、テーブルの特定のカラムを当てにして、バージョニングを行えません。 バージョンやタイムスタンプのプロパティをマッピングせずに、バージョンチェックさせるために、 <literal>&lt;class&gt;</literal> マッピングに <literal>optimistic-lock=\"all\"</literal> を 指定してください。 行のすべてのフィールドの状態を比較するようになります。 これは、Hibernateが古い状態と新しい状態を比較できる場合に、 理論的に動作するだけであることに注意してください。 例え�! �、session-per-request-with-detached-objects ではなく、 １つの長い <literal>Session</literal> を使う場合です。" +#. Tag: para +#: transactions.xml:782 +#, no-c-format +msgid "" +"Legacy database schemas are often static and can't be modified. Or, other " +"applications might also access the same database and don't know how to " +"handle version numbers or even timestamps. In both cases, versioning can't " +"rely on a particular column in a table. To force a version check without a " +"version or timestamp property mapping, with a comparison of the state of all " +"fields in a row, turn on <literal>optimistic-lock=\"all\"</literal> in the " +"<literal>&lt;class&gt;</literal> mapping. Note that this concepetually only " +"works if Hibernate can compare the old and new state, i.e. if you use a " +"single long <literal>Session</literal> and not session-per-request-with-" +"detached-objects." +msgstr "" +"レガシーのデータベーススキーマは、しばしば固定的であり、変更できません。 また" +"は、他のアプリケーションが同じデータベースにアクセスしなければならず、 そのア" +"プリケーションはバージョン番号やタイムスタンプさえ操作する方法を知りません。 " +"どちらの場合も、テーブルの特定のカラムを当てにして、バージョニングを行えませ" +"ん。 バージョンやタイムスタンプのプロパティをマッピングせずに、バージョン" +"チェックさせるために、 <literal>&lt;class&gt;</literal> マッピングに " +"<literal>optimistic-lock=\"all\"</literal> を 指定してください。 行のすべての" +"フィールドの状態を比較するようになります。 これは、Hibernateが古い状態と新し" +"い状態を比較できる場合に、 理論的に動作するだけであることに注意してくださ" +"い。 例えば、session-per-request-with-detached-objects ではなく、 １つの長い " +"<literal>Session</literal> を使う場合です。" -#: index.docbook:799 -msgid "In both cases, with dedicated version/timestamp columns or with full/dirty field comparison, Hibernate uses a single <literal>UPDATE</literal> statement (with an appropriate <literal>WHERE</literal> clause) per entity to execute the version check and update the information. If you use transitive persistence to cascade reattachment to associated entities, Hibernate might execute uneccessary updates. This is usually not a problem, but <emphasis>on update</emphasis> triggers in the database might be executed even when no changes have been made to detached instances. You can customize this behavior by setting <literal>select-before-update=\"true\"</literal> in the <literal>&lt;class&gt;</literal> mapping, forcing Hibernate to <literal>SELECT</literal> the instance to ensure that changes did actually occur, before updating the row." -msgstr "ときどき、行われた変更が重ならない限り、同時に行われた変更を受け入れることができます。 <literal>&lt;class&gt;</literal> マッピングに <literal>optimistic-lock=\"dirty\"</literal> を設定した場合、フラッシュする際に、Hibernateはダーティフィールドのみを比較します。" +#. Tag: para +#: transactions.xml:793 +#, no-c-format +msgid "" +"Sometimes concurrent modification can be permitted as long as the changes " +"that have been made don't overlap. If you set <literal>optimistic-lock=" +"\"dirty\"</literal> when mapping the <literal>&lt;class&gt;</literal>, " +"Hibernate will only compare dirty fields during flush." +msgstr "" +"ときどき、行われた変更が重ならない限り、同時に行われた変更を受け入れることが" +"できます。 <literal>&lt;class&gt;</literal> マッピングに <literal>optimistic-" +"lock=\"dirty\"</literal> を設定した場合、フラッシュする際に、Hibernateはダー" +"ティフィールドのみを比較します。" -#: index.docbook:817 +#. Tag: para +#: transactions.xml:799 +#, no-c-format +msgid "" +"In both cases, with dedicated version/timestamp columns or with full/dirty " +"field comparison, Hibernate uses a single <literal>UPDATE</literal> " +"statement (with an appropriate <literal>WHERE</literal> clause) per entity " +"to execute the version check and update the information. If you use " +"transitive persistence to cascade reattachment to associated entities, " +"Hibernate might execute uneccessary updates. This is usually not a problem, " +"but <emphasis>on update</emphasis> triggers in the database might be " +"executed even when no changes have been made to detached instances. You can " +"customize this behavior by setting <literal>select-before-update=\"true\"</" +"literal> in the <literal>&lt;class&gt;</literal> mapping, forcing Hibernate " +"to <literal>SELECT</literal> the instance to ensure that changes did " +"actually occur, before updating the row." +msgstr "" +"専用のバージョン／タイムスタンプのカラムを使う場合、 もしくはすべて／ダーティ" +"のフィールドを比較する場合どちらであっても、 Hibernateはエンティティごとに1つ" +"の <literal>UPDATE</literal> 文を （適切な <literal>WHERE</literal> 節と共" +"に）使い、 バージョンチェックと情報の更新を行います。 関連するエンティティの" +"再追加をカスケードするために、 連鎖的な永続化を使用した場合、不必要な更新を実" +"行するかもしれません。 これは通常問題になりません。 しかし、分離したインスタ" +"ンスを変更していなくとも、 データベースの <emphasis>on update</emphasis> トリ" +"ガーが実行されるかもしれません。 <literal>&lt;class&gt;</literal> マッピング" +"に <literal>select-before-update=\"true\"</literal> を設定することによって、 " +"この振る舞いをカスタマイズできます。 確実に変更されたかを確認するために、行を" +"更新する前に、 必ずインスタンスを <literal>SELECT</literal> します。" + +#. Tag: title +#: transactions.xml:817 +#, no-c-format msgid "Pessimistic Locking" -msgstr "専用のバージョン／タイムスタンプのカラムを使う場合、 もしくはすべて／ダーティのフィールドを比較する場合どちらであっても、 Hibernateはエンティティごとに1つの <literal>UPDATE</literal> 文を （適切な <literal>WHERE</literal> 節と共に）使い、 バージョンチェックと情報の更新を行います。 関連するエンティティの再追加をカスケードするために、 連鎖的な永続化を使用した場合、不必要な更新を実行するかもしれません。 これは通常問題になりません。 しかし、分離したインスタンスを変更していなくとも、 データベースの <emphasis>on update</emphasis> トリガーが実行されるかもしれません。 <literal>&lt;class&gt;</literal> マッピングに <literal>select-before-update=\"true\"</literal> を設定することによって、 この振る舞いをカスタマイズで�! �ます。 確実に変更されたかを確認するために、行を更新する前に、 必ずインスタンスを <literal>SELECT</literal> します。" - -#: index.docbook:819 -msgid "It is not intended that users spend much time worring about locking strategies. Its usually enough to specify an isolation level for the JDBC connections and then simply let the database do all the work. However, advanced users may sometimes wish to obtain exclusive pessimistic locks, or re-obtain locks at the start of a new transaction." msgstr "悲観的ロック" -#: index.docbook:826 -msgid "Hibernate will always use the locking mechanism of the database, never lock objects in memory!" -msgstr "ユーザがロック戦略に悩むのに多くの時間を費やすことを意図していません。 通常は、JDBCコネクションに分離レベルを指定し、 単にデータベースにすべての仕事をさせれば十分です。 しかしながら、高度なユーザは、排他的な悲観的ロックを獲得することか、 新しいトランザクションが開始される際にロックを再獲得することを ときどき望むかもしれません。" +#. Tag: para +#: transactions.xml:819 +#, no-c-format +msgid "" +"It is not intended that users spend much time worring about locking " +"strategies. Its usually enough to specify an isolation level for the JDBC " +"connections and then simply let the database do all the work. However, " +"advanced users may sometimes wish to obtain exclusive pessimistic locks, or " +"re-obtain locks at the start of a new transaction." +msgstr "" +"ユーザがロック戦略に悩むのに多くの時間を費やすことを意図していません。 通常" +"は、JDBCコネクションに分離レベルを指定し、 単にデータベースにすべての仕事をさ" +"せれば十分です。 しかしながら、高度なユーザは、排他的な悲観的ロックを獲得する" +"ことか、 新しいトランザクションが開始される際にロックを再獲得することを とき" +"どき望むかもしれません。" -#: index.docbook:831 -msgid "The <literal>LockMode</literal> class defines the different lock levels that may be acquired by Hibernate. A lock is obtained by the following mechanisms:" -msgstr "Hibernateはいつもデータベースのロックの仕組みを使います。 メモリ内のオブジェクトを決してロックしません！" +#. Tag: para +#: transactions.xml:826 +#, no-c-format +msgid "" +"Hibernate will always use the locking mechanism of the database, never lock " +"objects in memory!" +msgstr "" +"Hibernateはいつもデータベースのロックの仕組みを使います。 メモリ内のオブジェ" +"クトを決してロックしません！" -#: index.docbook:838 -msgid "<literal>LockMode.WRITE</literal> is acquired automatically when Hibernate updates or inserts a row." -msgstr "<literal>LockMode</literal> クラスは、Hibernateが獲得できる異なるロックレベルを定義します。 以下の仕組みにより、ロックを獲得できます。" +#. Tag: para +#: transactions.xml:831 +#, no-c-format +msgid "" +"The <literal>LockMode</literal> class defines the different lock levels that " +"may be acquired by Hibernate. A lock is obtained by the following mechanisms:" +msgstr "" +"<literal>LockMode</literal> クラスは、Hibernateが獲得できる異なるロックレベル" +"を定義します。 以下の仕組みにより、ロックを獲得できます。" -#: index.docbook:844 -msgid "<literal>LockMode.UPGRADE</literal> may be acquired upon explicit user request using <literal>SELECT ... FOR UPDATE</literal> on databases which support that syntax." -msgstr "<literal>LockMode.WRITE</literal> は、 Hibernateが行を更新もしくは挿入する際に自動的に得られます。" +#. Tag: para +#: transactions.xml:838 +#, no-c-format +msgid "" +"<literal>LockMode.WRITE</literal> is acquired automatically when Hibernate " +"updates or inserts a row." +msgstr "" +"<literal>LockMode.WRITE</literal> は、 Hibernateが行を更新もしくは挿入する際" +"に自動的に得られます。" -#: index.docbook:850 -msgid "<literal>LockMode.UPGRADE_NOWAIT</literal> may be acquired upon explicit user request using a <literal>SELECT ... FOR UPDATE NOWAIT</literal> under Oracle." -msgstr "<literal>LockMode.UPGRADE</literal> は、 データベースでサポートされている文法 <literal>SELECT ... FOR UPDATE</literal> を使った、明示的なユーザー要求により得られるかもしれません。" +#. Tag: para +#: transactions.xml:844 +#, no-c-format +msgid "" +"<literal>LockMode.UPGRADE</literal> may be acquired upon explicit user " +"request using <literal>SELECT ... FOR UPDATE</literal> on databases which " +"support that syntax." +msgstr "" +"<literal>LockMode.UPGRADE</literal> は、 データベースでサポートされている文" +"法 <literal>SELECT ... FOR UPDATE</literal> を使った、明示的なユーザー要求に" +"より得られるかもしれません。" -#: index.docbook:856 -msgid "<literal>LockMode.READ</literal> is acquired automatically when Hibernate reads data under Repeatable Read or Serializable isolation level. May be re-acquired by explicit user request." -msgstr "<literal>LockMode.UPGRADE_NOWAIT</literal> は、 Oracle で <literal>SELECT ... FOR UPDATE NOWAIT</literal> を使った、 明示的なユーザー要求により得られるかもしれません。" +#. Tag: para +#: transactions.xml:850 +#, no-c-format +msgid "" +"<literal>LockMode.UPGRADE_NOWAIT</literal> may be acquired upon explicit " +"user request using a <literal>SELECT ... FOR UPDATE NOWAIT</literal> under " +"Oracle." +msgstr "" +"<literal>LockMode.UPGRADE_NOWAIT</literal> は、 Oracle で " +"<literal>SELECT ... FOR UPDATE NOWAIT</literal> を使った、 明示的なユーザー要" +"求により得られるかもしれません。" -#: index.docbook:863 -msgid "<literal>LockMode.NONE</literal> represents the absence of a lock. All objects switch to this lock mode at the end of a <literal>Transaction</literal>. Objects associated with the session via a call to <literal>update()</literal> or <literal>saveOrUpdate()</literal> also start out in this lock mode." -msgstr "<literal>LockMode.READ</literal> は、 Repeatable ReadもしくはSerializableの分離レベルで、データを読んだ際に自動的に得られます。 おそらく、明示的なユーザー要求により、再取得されます。" +#. Tag: para +#: transactions.xml:856 +#, no-c-format +msgid "" +"<literal>LockMode.READ</literal> is acquired automatically when Hibernate " +"reads data under Repeatable Read or Serializable isolation level. May be re-" +"acquired by explicit user request." +msgstr "" +"<literal>LockMode.READ</literal> は、 Repeatable ReadもしくはSerializableの分" +"離レベルで、データを読んだ際に自動的に得られます。 おそらく、明示的なユーザー" +"要求により、再取得されます。" -#: index.docbook:872 -msgid "The \"explicit user request\" is expressed in one of the following ways:" -msgstr "<literal>LockMode.NONE</literal> は、ロックしないことを表します。 <literal>Transaction</literal> の終わりに、 すべてのオブジェクトはこのロックモードに切り替わります。 <literal>update()</literal> や <literal>saveOrUpdate()</literal> を呼び出すことによって、 セッションに関連付けられたオブジェクトも、このロックモードで出発します。" +#. Tag: para +#: transactions.xml:863 +#, no-c-format +msgid "" +"<literal>LockMode.NONE</literal> represents the absence of a lock. All " +"objects switch to this lock mode at the end of a <literal>Transaction</" +"literal>. Objects associated with the session via a call to <literal>update()" +"</literal> or <literal>saveOrUpdate()</literal> also start out in this lock " +"mode." +msgstr "" +"<literal>LockMode.NONE</literal> は、ロックしないことを表します。 " +"<literal>Transaction</literal> の終わりに、 すべてのオブジェクトはこのロック" +"モードに切り替わります。 <literal>update()</literal> や <literal>saveOrUpdate" +"()</literal> を呼び出すことによって、 セッションに関連付けられたオブジェクト" +"も、このロックモードで出発します。" -#: index.docbook:878 -msgid "A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</literal>." +#. Tag: para +#: transactions.xml:872 +#, no-c-format +msgid "" +"The \"explicit user request\" is expressed in one of the following ways:" msgstr "「明示的なユーザー要求」とは、下記の方法の１つで言い表せます。" -#: index.docbook:883 +#. Tag: para +#: transactions.xml:878 +#, no-c-format +msgid "" +"A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</" +"literal>." +msgstr "" +"<literal>LockMode</literal> を指定した <literal>Session.load()</literal> の呼" +"び出し。" + +#. Tag: para +#: transactions.xml:883 +#, no-c-format msgid "A call to <literal>Session.lock()</literal>." -msgstr "<literal>LockMode</literal> を指定した <literal>Session.load()</literal> の呼び出し。" +msgstr "<literal>Session.lock()</literal> の呼び出し。" -#: index.docbook:888 +#. Tag: para +#: transactions.xml:888 +#, no-c-format msgid "A call to <literal>Query.setLockMode()</literal>." -msgstr "<literal>Session.lock()</literal> の呼び出し。" - -#: index.docbook:894 -msgid "If <literal>Session.load()</literal> is called with <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>, and the requested object was not yet loaded by the session, the object is loaded using <literal>SELECT ... FOR UPDATE</literal>. If <literal>load()</literal> is called for an object that is already loaded with a less restrictive lock than the one requested, Hibernate calls <literal>lock()</literal> for that object." msgstr "<literal>Query.setLockMode()</literal> の呼び出し。" -#: index.docbook:903 -msgid "<literal>Session.lock()</literal> performs a version number check if the specified lock mode is <literal>READ</literal>, <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>. (In the case of <literal>UPGRADE</literal> or <literal>UPGRADE_NOWAIT</literal>, <literal>SELECT ... FOR UPDATE</literal> is used.)" -msgstr "<literal>UPGRADE</literal> もしくは <literal>UPGRADE_NOWAIT</literal> が指定された <literal>Session.load()</literal> が呼び出され、 かつ要求されたオブジェクトがセッションによってまだロードされていなかった場合は、 <literal>SELECT ... FOR UPDATE</literal> を使って、オブジェクトがロードされます。 <literal>load()</literal> で呼び出されたオブジェクトが、 要求されているより制限が少ないロックですでにロードされていた場合は、 Hibernateはそのオブジェクトのために、<literal>lock()</literal> を呼び出します。" +#. Tag: para +#: transactions.xml:894 +#, no-c-format +msgid "" +"If <literal>Session.load()</literal> is called with <literal>UPGRADE</" +"literal> or <literal>UPGRADE_NOWAIT</literal>, and the requested object was " +"not yet loaded by the session, the object is loaded using " +"<literal>SELECT ... FOR UPDATE</literal>. If <literal>load()</literal> is " +"called for an object that is already loaded with a less restrictive lock " +"than the one requested, Hibernate calls <literal>lock()</literal> for that " +"object." +msgstr "" +"<literal>UPGRADE</literal> もしくは <literal>UPGRADE_NOWAIT</literal> が指定" +"された <literal>Session.load()</literal> が呼び出され、 かつ要求されたオブ" +"ジェクトがセッションによってまだロードされていなかった場合は、 " +"<literal>SELECT ... FOR UPDATE</literal> を使って、オブジェクトがロードされま" +"す。 <literal>load()</literal> で呼び出されたオブジェクトが、 要求されている" +"より制限が少ないロックですでにロードされていた場合は、 Hibernateはそのオブ" +"ジェクトのために、<literal>lock()</literal> を呼び出します。" -#: index.docbook:910 -msgid "If the database does not support the requested lock mode, Hibernate will use an appropriate alternate mode (instead of throwing an exception). This ensures that applications will be portable." -msgstr "指定されたロックモードが <literal>READ</literal> もしくは、<literal>UPGRADE</literal>、 <literal>UPGRADE_NOWAIT</literal> だった場合、<literal>Session.lock()</literal> は、バージョン番号のチェックを実施します。 （<literal>UPGRADE</literal> もしくは <literal>UPGRADE_NOWAIT</literal> の場合、 <literal>SELECT ... FOR UPDATE</literal> が使われます。）" +#. Tag: para +#: transactions.xml:903 +#, no-c-format +msgid "" +"<literal>Session.lock()</literal> performs a version number check if the " +"specified lock mode is <literal>READ</literal>, <literal>UPGRADE</literal> " +"or <literal>UPGRADE_NOWAIT</literal>. (In the case of <literal>UPGRADE</" +"literal> or <literal>UPGRADE_NOWAIT</literal>, <literal>SELECT ... FOR " +"UPDATE</literal> is used.)" +msgstr "" +"指定されたロックモードが <literal>READ</literal> もしくは、<literal>UPGRADE</" +"literal>、 <literal>UPGRADE_NOWAIT</literal> だった場合、<literal>Session." +"lock()</literal> は、バージョン番号のチェックを実施します。 " +"（<literal>UPGRADE</literal> もしくは <literal>UPGRADE_NOWAIT</literal> の場" +"合、 <literal>SELECT ... FOR UPDATE</literal> が使われます。）" -#: index.docbook:919 +#. Tag: para +#: transactions.xml:910 +#, no-c-format +msgid "" +"If the database does not support the requested lock mode, Hibernate will use " +"an appropriate alternate mode (instead of throwing an exception). This " +"ensures that applications will be portable." +msgstr "" +"データベースが要求されたロックモードをサポートしていない場合、 Hibernateは" +"（例外を投げる代わりに、）適切な代わりのモードを使います。 これは、アプリケー" +"ションがポータブルであることを保証します。" + +#. Tag: title +#: transactions.xml:919 +#, no-c-format msgid "Connection Release Modes" -msgstr "データベースが要求されたロックモードをサポートしていない場合、 Hibernateは（例外を投げる代わりに、）適切な代わりのモードを使います。 これは、アプリケーションがポータブルであることを保証します。" - -#: index.docbook:921 -msgid "The legacy (2.x) behavior of Hibernate in regards to JDBC connection management was that a <literal>Session</literal> would obtain a connection when it was first needed and then hold unto that connection until the session was closed. Hibernate 3.x introduced the notion of connection release modes to tell a session how to handle its JDBC connections. Note that the following discussion is pertinent only to connections provided through a configured <literal>ConnectionProvider</literal>; user-supplied connections are outside the breadth of this discussion. The different release modes are identified by the enumerated values of <literal>org.hibernate.ConnectionReleaseMode</literal>:" msgstr "コネクション開放モード" -#: index.docbook:935 -msgid "<literal>ON_CLOSE</literal> - is essentially the legacy behavior described above. The Hibernate session obatins a connection when it first needs to perform some JDBC access and holds unto that connection until the session is closed." -msgstr "Hibernateのレガシー（2.x）のJDBCコネクション管理に関する振る舞いは、 最初に必要とした際に <literal>Session</literal> がコネクションを得るというものでした。 そして、セッションが閉じられるまで、そのコネクションを保持しました。 Hibernate 3.xは、セッションにJDBCコネクションをどのように制御するかを伝える コネクション開放モードという概念を導入しました。 以降の議論は、構成された <literal>ConnectionProvider</literal> を通して提供される コネクションに適切であることに注意してください。 異なる開放モードは、<literal>org.hibernate.ConnectionReleaseMode</literal> に 列挙された値により確認されます。" +#. Tag: para +#: transactions.xml:921 +#, no-c-format +msgid "" +"The legacy (2.x) behavior of Hibernate in regards to JDBC connection " +"management was that a <literal>Session</literal> would obtain a connection " +"when it was first needed and then hold unto that connection until the " +"session was closed. Hibernate 3.x introduced the notion of connection " +"release modes to tell a session how to handle its JDBC connections. Note " +"that the following discussion is pertinent only to connections provided " +"through a configured <literal>ConnectionProvider</literal>; user-supplied " +"connections are outside the breadth of this discussion. The different " +"release modes are identified by the enumerated values of <literal>org." +"hibernate.ConnectionReleaseMode</literal>:" +msgstr "" +"Hibernateのレガシー（2.x）のJDBCコネクション管理に関する振る舞いは、 最初に必" +"要とした際に <literal>Session</literal> がコネクションを得るというものでし" +"た。 そして、セッションが閉じられるまで、そのコネクションを保持しました。 " +"Hibernate 3.xは、セッションにJDBCコネクションをどのように制御するかを伝える " +"コネクション開放モードという概念を導入しました。 以降の議論は、構成された " +"<literal>ConnectionProvider</literal> を通して提供される コネクションに適切で" +"あることに注意してください。 異なる開放モードは、<literal>org.hibernate." +"ConnectionReleaseMode</literal> に 列挙された値により確認されます。" -#: index.docbook:942 -msgid "<literal>AFTER_TRANSACTION</literal> - says to release connections after a <literal>org.hibernate.Transaction</literal> has completed." -msgstr "<literal>ON_CLOSE</literal> - 本質的に上記で述べたレガシーの振る舞いです。 Hibernateセッションは最初にJDBCアクセスを実行する必要がある際にコネクションを得ます。 そして、セッションが閉じられるまで、コネクションを保持します。" +#. Tag: para +#: transactions.xml:935 +#, no-c-format +msgid "" +"<literal>ON_CLOSE</literal> - is essentially the legacy behavior described " +"above. The Hibernate session obatins a connection when it first needs to " +"perform some JDBC access and holds unto that connection until the session is " +"closed." +msgstr "" +"<literal>ON_CLOSE</literal> - 本質的に上記で述べたレガシーの振る舞いです。 " +"Hibernateセッションは最初にJDBCアクセスを実行する必要がある際にコネクションを" +"得ます。 そして、セッションが閉じられるまで、コネクションを保持します。" -#: index.docbook:948 -msgid "<literal>AFTER_STATEMENT</literal> (also referred to as aggressive release) - says to release connections after each and every statement execution. This aggressive releasing is skipped if that statement leaves open resources associated with the given session; currently the only situation where this occurs is through the use of <literal>org.hibernate.ScrollableResults</literal>." -msgstr "<literal>AFTER_TRANSACTION</literal> - <literal>org.hibernate.Transaction</literal> が完了した後、 コネクションを開放します。" +#. Tag: para +#: transactions.xml:942 +#, no-c-format +msgid "" +"<literal>AFTER_TRANSACTION</literal> - says to release connections after a " +"<literal>org.hibernate.Transaction</literal> has completed." +msgstr "" +"<literal>AFTER_TRANSACTION</literal> - <literal>org.hibernate.Transaction</" +"literal> が完了した後、 コネクションを開放します。" -#: index.docbook:958 -msgid "The configuration parameter <literal>hibernate.connection.release_mode</literal> is used to specify which release mode to use. The possible values:" -msgstr "<literal>AFTER_STATEMENT</literal> （積極的な開放とも呼ばれる） - すべてのステートメントがそれぞれ実行された後、コネクションが開放されます。 ステートメントがセッションに関連するリソースを開いたままにする場合は、 この積極的な開放はスキップされます。 今のところ、これが起こるのは <literal>org.hibernate.ScrollableResults</literal> が使われる場合のみです。" +#. Tag: para +#: transactions.xml:948 +#, no-c-format +msgid "" +"<literal>AFTER_STATEMENT</literal> (also referred to as aggressive release) " +"- says to release connections after each and every statement execution. This " +"aggressive releasing is skipped if that statement leaves open resources " +"associated with the given session; currently the only situation where this " +"occurs is through the use of <literal>org.hibernate.ScrollableResults</" +"literal>." +msgstr "" +"<literal>AFTER_STATEMENT</literal> （積極的な開放とも呼ばれる） - すべてのス" +"テートメントがそれぞれ実行された後、コネクションが開放されます。 ステートメン" +"トがセッションに関連するリソースを開いたままにする場合は、 この積極的な開放は" +"スキップされます。 今のところ、これが起こるのは <literal>org.hibernate." +"ScrollableResults</literal> が使われる場合のみです。" -#: index.docbook:965 -msgid "<literal>auto</literal> (the default) - this choice delegates to the release mode returned by the <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal> method. For JTATransactionFactory, this returns ConnectionReleaseMode.AFTER_STATEMENT; for JDBCTransactionFactory, this returns ConnectionReleaseMode.AFTER_TRANSACTION. It is rarely a good idea to change this default behavior as failures due to the value of this setting tend to indicate bugs and/or invalid assumptions in user code." -msgstr "コンフィグレーションパラメータの <literal>hibernate.connection.release_mode</literal> は、使用する開放モードを指定するために使います。 指定できる値は次の通りです。" +#. Tag: para +#: transactions.xml:958 +#, no-c-format +msgid "" +"The configuration parameter <literal>hibernate.connection.release_mode</" +"literal> is used to specify which release mode to use. The possible values:" +msgstr "" +"コンフィグレーションパラメータの <literal>hibernate.connection.release_mode</" +"literal> は、使用する開放モードを指定するために使います。 指定できる値は次の" +"通りです。" -#: index.docbook:975 -msgid "<literal>on_close</literal> - says to use ConnectionReleaseMode.ON_CLOSE. This setting is left for backwards compatibility, but its use is highly discouraged." -msgstr "<literal>auto</literal> （デフォルト） - これを選択すると <literal>org.hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal> メソッドによって返される開放モードに委譲されます。 このメソッドは、 JTATransactionFactoryにはConnectionReleaseMode.AFTER_STATEMENTを返し、 JDBCTransactionFactoryにはConnectionReleaseMode.AFTER_TRANSACTIONを返します。 このデフォルトの振る舞いを変えてうまくいった試しがありません。 それは、この設定値が原因で起こる障害は、 ユーザコードの中でバグや間違った条件になりやすいからです。" +#. Tag: para +#: transactions.xml:965 +#, no-c-format +msgid "" +"<literal>auto</literal> (the default) - this choice delegates to the release " +"mode returned by the <literal>org.hibernate.transaction.TransactionFactory." +"getDefaultReleaseMode()</literal> method. For JTATransactionFactory, this " +"returns ConnectionReleaseMode.AFTER_STATEMENT; for JDBCTransactionFactory, " +"this returns ConnectionReleaseMode.AFTER_TRANSACTION. It is rarely a good " +"idea to change this default behavior as failures due to the value of this " +"setting tend to indicate bugs and/or invalid assumptions in user code." +msgstr "" +"<literal>auto</literal> （デフォルト） - これを選択すると <literal>org." +"hibernate.transaction.TransactionFactory.getDefaultReleaseMode()</literal> メ" +"ソッドによって返される開放モードに委譲されます。 このメソッドは、 " +"JTATransactionFactoryにはConnectionReleaseMode.AFTER_STATEMENTを返し、 " +"JDBCTransactionFactoryにはConnectionReleaseMode.AFTER_TRANSACTIONを返しま" +"す。 このデフォルトの振る舞いを変えてうまくいった試しがありません。 それは、" +"この設定値が原因で起こる障害は、 ユーザコードの中でバグや間違った条件になりや" +"すいからです。" -#: index.docbook:981 -msgid "<literal>after_transaction</literal> - says to use ConnectionReleaseMode.AFTER_TRANSACTION. This setting should not be used in JTA environments. Also note that with ConnectionReleaseMode.AFTER_TRANSACTION, if a session is considered to be in auto-commit mode connections will be released as if the release mode were AFTER_STATEMENT." -msgstr "<literal>on_close</literal> - ConnectionReleaseMode.ON_CLOSEを使います。 この設定は後方互換のために残されていますが、使わないことを強く勧めます。" +#. Tag: para +#: transactions.xml:975 +#, no-c-format +msgid "" +"<literal>on_close</literal> - says to use ConnectionReleaseMode.ON_CLOSE. " +"This setting is left for backwards compatibility, but its use is highly " +"discouraged." +msgstr "" +"<literal>on_close</literal> - ConnectionReleaseMode.ON_CLOSEを使います。 この" +"設定は後方互換のために残されていますが、使わないことを強く勧めます。" -#: index.docbook:989 -msgid "<literal>after_statement</literal> - says to use ConnectionReleaseMode.AFTER_STATEMENT. Additionally, the configured <literal>ConnectionProvider</literal> is consulted to see if it supports this setting (<literal>supportsAggressiveRelease()</literal>). If not, the release mode is reset to ConnectionReleaseMode.AFTER_TRANSACTION. This setting is only safe in environments where we can either re-acquire the same underlying JDBC connection each time we make a call into <literal>ConnectionProvider.getConnection()</literal> or in auto-commit environments where it does not matter whether we get back the same connection." -msgstr "<literal>after_transaction</literal> - ConnectionReleaseMode.AFTER_TRANSACTIONを使います。 この設定はJTA環境の中では使うべきではありません。 ConnectionReleaseMode.AFTER_TRANSACTIONを指定し、自動コミットモードの中では、 開放モードがAFTER_STATEMENTであるかのように、コネクションは開放されることに注意してください。" +#. Tag: para +#: transactions.xml:981 +#, no-c-format +msgid "" +"<literal>after_transaction</literal> - says to use ConnectionReleaseMode." +"AFTER_TRANSACTION. This setting should not be used in JTA environments. Also " +"note that with ConnectionReleaseMode.AFTER_TRANSACTION, if a session is " +"considered to be in auto-commit mode connections will be released as if the " +"release mode were AFTER_STATEMENT." +msgstr "" +"<literal>after_transaction</literal> - ConnectionReleaseMode." +"AFTER_TRANSACTIONを使います。 この設定はJTA環境の中では使うべきではありませ" +"ん。 ConnectionReleaseMode.AFTER_TRANSACTIONを指定し、自動コミットモードの中" +"では、 開放モードがAFTER_STATEMENTであるかのように、コネクションは開放される" +"ことに注意してください。" -#: index.docbook:1153 -msgid "appended paragraph 1" -msgstr "<literal>after_statement</literal> - ConnectionReleaseMode.AFTER_STATEMENTを使います。 さらに、設定された <literal>ConnectionProvider</literal> は、 この設定 (<literal>supportsAggressiveRelease()</literal>) をサポートするかどうか を調べるために使用します。 もしそうでない場合、開放モードはConnectionReleaseMode.AFTER_TRANSACTION にリセットされます。 この設定は次の環境でのみ安全です。 それは、<literal>ConnectionProvider.getConnection()</literal> を呼び出すたびに 基盤となるJDBCコネクションが同じものを取得できるか、 同じコネクションが得られることが問題とならない自動コミット環境の中です。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: transactions.xml:989 +#, no-c-format +msgid "" +"<literal>after_statement</literal> - says to use ConnectionReleaseMode." +"AFTER_STATEMENT. Additionally, the configured <literal>ConnectionProvider</" +"literal> is consulted to see if it supports this setting " +"(<literal>supportsAggressiveRelease()</literal>). If not, the release mode " +"is reset to ConnectionReleaseMode.AFTER_TRANSACTION. This setting is only " +"safe in environments where we can either re-acquire the same underlying JDBC " +"connection each time we make a call into <literal>ConnectionProvider." +"getConnection()</literal> or in auto-commit environments where it does not " +"matter whether we get back the same connection." +msgstr "" +"<literal>after_statement</literal> - ConnectionReleaseMode.AFTER_STATEMENTを" +"使います。 さらに、設定された <literal>ConnectionProvider</literal> は、 この" +"設定 (<literal>supportsAggressiveRelease()</literal>) をサポートするかどうか " +"を調べるために使用します。 もしそうでない場合、開放モードは" +"ConnectionReleaseMode.AFTER_TRANSACTION にリセットされます。 この設定は次の環" +"境でのみ安全です。 それは、<literal>ConnectionProvider.getConnection()</" +"literal> を呼び出すたびに 基盤となるJDBCコネクションが同じものを取得できる" +"か、 同じコネクションが得られることが問題とならない自動コミット環境の中です。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/tutorial.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/tutorial.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/tutorial.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,2432 +1,2777 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:7 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: tutorial.xml:7 +#, no-c-format msgid "Introduction to Hibernate" msgstr "Hibernateの導入" -#: index.docbook:10 +#. Tag: title +#: tutorial.xml:10 +#, no-c-format msgid "Preface" -msgstr "<title>前書き</title>" +msgstr "前書き" -#: index.docbook:12 -msgid "This chapter is an introductory tutorial for new users of Hibernate. We start with a simple command line application using an in-memory database and develop it in easy to understand steps." -msgstr "この章はHibernateを初めて使うユーザ向けの入門的なチュートリアルです。 インメモリデータベースを使う簡単なコマンドラインアプリケーションから始め、 一歩一歩わかりやすいやり方で開発を進めます。" +#. Tag: para +#: tutorial.xml:12 +#, no-c-format +msgid "" +"This chapter is an introductory tutorial for new users of Hibernate. We " +"start with a simple command line application using an in-memory database and " +"develop it in easy to understand steps." +msgstr "" +"この章はHibernateを初めて使うユーザ向けの入門的なチュートリアルです。 インメ" +"モリデータベースを使う簡単なコマンドラインアプリケーションから始め、 一歩一歩" +"わかりやすいやり方で開発を進めます。" -#: index.docbook:18 -msgid "This tutorial is intended for new users of Hibernate but requires Java and SQL knowledge. It is based on a tutorial by Michael Gloegl, the third-party libraries we name are for JDK 1.4 and 5.0. You might need others for JDK 1.3." -msgstr "このチュートリアルはHibernateを初めて使うユーザを想定していますが、 理解するにはJavaとSQLについての知識が必要です。 これはMichael Gloeglの手によるチュートリアルを下敷きにしていますが、 ここでサードパーティライブラリと言っているのは、JDK 1.4と5.0用のものです。 JDK 1.3を利用するのであれば他のライブラリが必要かもしれません。" +#. Tag: para +#: tutorial.xml:18 +#, no-c-format +msgid "" +"This tutorial is intended for new users of Hibernate but requires Java and " +"SQL knowledge. It is based on a tutorial by Michael Gloegl, the third-party " +"libraries we name are for JDK 1.4 and 5.0. You might need others for JDK 1.3." +msgstr "" +"このチュートリアルはHibernateを初めて使うユーザを想定していますが、 理解する" +"にはJavaとSQLについての知識が必要です。 これはMichael Gloeglの手によるチュー" +"トリアルを下敷きにしていますが、 ここでサードパーティライブラリと言っているの" +"は、JDK 1.4と5.0用のものです。 JDK 1.3を利用するのであれば他のライブラリが必" +"要かもしれません。" -#: index.docbook:24 -msgid "The source code for the tutorial is included in the distribution in the <literal>doc/reference/tutorial/</literal> directory." -msgstr "チュートリアルのソースコードはHibernateディストリビューションの <literal>doc/reference/tutorial/</literal> にあります。" +#. Tag: para +#: tutorial.xml:24 +#, no-c-format +msgid "" +"The source code for the tutorial is included in the distribution in the " +"<literal>doc/reference/tutorial/</literal> directory." +msgstr "" +"チュートリアルのソースコードはHibernateディストリビューションの <literal>doc/" +"reference/tutorial/</literal> にあります。" -#: index.docbook:32 +#. Tag: title +#: tutorial.xml:32 +#, no-c-format msgid "Part 1 - The first Hibernate Application" msgstr "パート1 - 初めてのHibernateアプリケーション" -#: index.docbook:34 -msgid "First, we'll create a simple console-based Hibernate application. We use an Java database (HSQL DB), so we do not have to install any database server." -msgstr "最初にコンソールベースの簡単なHibernateアプリケーションを作成します。 Javaデータベース（HSQL DB）を利用するので、 データベースサーバをインストールする必要はありません。" +#. Tag: para +#: tutorial.xml:34 +#, no-c-format +msgid "" +"First, we'll create a simple console-based Hibernate application. We use an " +"Java database (HSQL DB), so we do not have to install any database server." +msgstr "" +"最初にコンソールベースの簡単なHibernateアプリケーションを作成します。 Java" +"データベース（HSQL DB）を利用するので、 データベースサーバをインストールする" +"必要はありません。" -#: index.docbook:39 -msgid "Let's assume we need a small database application that can store events we want to attend, and information about the hosts of these events." -msgstr "仮に小さなデータベースアプリケーションが必要だとしましょう。 そのアプリケーションには出席したいイベントと、 そのイベントのホストについての情報を格納するものとします。" +#. Tag: para +#: tutorial.xml:39 +#, no-c-format +msgid "" +"Let's assume we need a small database application that can store events we " +"want to attend, and information about the hosts of these events." +msgstr "" +"仮に小さなデータベースアプリケーションが必要だとしましょう。 そのアプリケー" +"ションには出席したいイベントと、 そのイベントのホストについての情報を格納する" +"ものとします。" -#: index.docbook:44 -msgid "The first thing we do, is set up our development directory and put all the Java libraries we need into it. Download the Hibernate distribution from the Hibernate website. Extract the package and place all required libraries found in <literal>/lib</literal> into into the <literal>/lib</literal> directory of your new development working directory. It should look like this:" -msgstr "まず最初にすることは開発用のディレクトリをセットアップして、 必要となるすべてのJavaライブラリを配置することです。 HibernateウェブサイトからHibernateディストリビューションをダウンロードしてください。 ファイルを解凍して <literal>/lib</literal> にある必要なライブラリのすべてを、 新しい開発用ディレクトリの <literal>/lib</literal> ディレクトリに配置してください。 このようになっているはずです：" +#. Tag: para +#: tutorial.xml:44 +#, no-c-format +msgid "" +"The first thing we do, is set up our development directory and put all the " +"Java libraries we need into it. Download the Hibernate distribution from the " +"Hibernate website. Extract the package and place all required libraries " +"found in <literal>/lib</literal> into into the <literal>/lib</literal> " +"directory of your new development working directory. It should look like " +"this:" +msgstr "" +"まず最初にすることは開発用のディレクトリをセットアップして、 必要となるすべて" +"のJavaライブラリを配置することです。 HibernateウェブサイトからHibernateディス" +"トリビューションをダウンロードしてください。 ファイルを解凍して <literal>/" +"lib</literal> にある必要なライブラリのすべてを、 新しい開発用ディレクトリの " +"<literal>/lib</literal> ディレクトリに配置してください。 このようになっている" +"はずです：" -#: index.docbook:52 +#. Tag: programlisting +#: tutorial.xml:52 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " antlr.jar\n" - " cglib.jar\n" - " asm.jar\n" - " asm-attrs.jars\n" - " commons-collections.jar\n" - " commons-logging.jar\n" - " hibernate3.jar\n" - " jta.jar\n" - " dom4j.jar\n" - " log4j.jar ]]>" +"<![CDATA[.\n" +"+lib\n" +" antlr.jar\n" +" cglib.jar\n" +" asm.jar\n" +" asm-attrs.jars\n" +" commons-collections.jar\n" +" commons-logging.jar\n" +" hibernate3.jar\n" +" jta.jar\n" +" dom4j.jar\n" +" log4j.jar ]]>" msgstr "" - "<![CDATA[. -\n" - "+lib -\n" - " antlr.jar -\n" - " cglib.jar -\n" - " asm.jar -\n" - " asm-attrs.jars -\n" - " commons-collections.jar -\n" - " commons-logging.jar -\n" - " hibernate3.jar -\n" - " jta.jar -\n" - " dom4j.jar -\n" - " log4j.jar ]]>" -#: index.docbook:54 -msgid "This is the minimum set of required libraries (note that we also copied hibernate3.jar, the main archive) for Hibernate <emphasis>at the time of writing</emphasis>. The Hibernate release you are using might require more or less libraries. See the <literal>README.txt</literal> file in the <literal>lib/</literal> directory of the Hibernate distribution for more information about required and optional third-party libraries. (Actually, Log4j is not required but preferred by many developers.)" -msgstr "これが <emphasis>本ドキュメント執筆時点での</emphasis> Hibernateの必要最低限のライブラリです （メインアーカイブのhibernate3.jarもコピーしていることに注意してください）。 Hibernateのバージョンによってはさらに必要なライブラリや、不要なライブラリがあるかもしれません。 Hibernateディストリビューションの <literal>lib/</literal> ディレクトリにある <literal>README.txt</literal> ファイルを見てください。 必須またはオプションのサードパーティライブラリについての情報を載せています （実際Log4jは必須ではありませんが、多くの開発者が好んでいます）。" +#. Tag: para +#: tutorial.xml:54 +#, no-c-format +msgid "" +"This is the minimum set of required libraries (note that we also copied " +"hibernate3.jar, the main archive) for Hibernate <emphasis>at the time of " +"writing</emphasis>. The Hibernate release you are using might require more " +"or less libraries. See the <literal>README.txt</literal> file in the " +"<literal>lib/</literal> directory of the Hibernate distribution for more " +"information about required and optional third-party libraries. (Actually, " +"Log4j is not required but preferred by many developers.)" +msgstr "" +"これが <emphasis>本ドキュメント執筆時点での</emphasis> Hibernateの必要最低限" +"のライブラリです （メインアーカイブのhibernate3.jarもコピーしていることに注意" +"してください）。 Hibernateのバージョンによってはさらに必要なライブラリや、不" +"要なライブラリがあるかもしれません。 Hibernateディストリビューションの " +"<literal>lib/</literal> ディレクトリにある <literal>README.txt</literal> ファ" +"イルを見てください。 必須またはオプションのサードパーティライブラリについての" +"情報を載せています （実際Log4jは必須ではありませんが、多くの開発者が好んでい" +"ます）。" -#: index.docbook:63 -msgid "Next we create a class that represents the event we want to store in database." +#. Tag: para +#: tutorial.xml:63 +#, no-c-format +msgid "" +"Next we create a class that represents the event we want to store in " +"database." msgstr "次にデータベースに格納するイベントを表すクラスを作成します。" -#: index.docbook:68 +#. Tag: title +#: tutorial.xml:68 +#, no-c-format msgid "The first class" msgstr "最初のクラス" -#: index.docbook:70 -msgid "Our first persistent class is a simple JavaBean class with some properties:" +#. Tag: para +#: tutorial.xml:70 +#, no-c-format +msgid "" +"Our first persistent class is a simple JavaBean class with some properties:" msgstr "最初の永続クラスは、プロパティをいくつか持つシンプルなJavaBeanです：" -#: index.docbook:74 +#. Tag: programlisting +#: tutorial.xml:74 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "\n" - "import java.util.Date;\n" - "\n" - "public class Event {\n" - " private Long id;\n" - "\n" - " private String title;\n" - " private Date date;\n" - "\n" - " public Event() {}\n" - "\n" - " public Long getId() {\n" - " return id;\n" - " }\n" - "\n" - " private void setId(Long id) {\n" - " this.id = id;\n" - " }\n" - "\n" - " public Date getDate() {\n" - " return date;\n" - " }\n" - "\n" - " public void setDate(Date date) {\n" - " this.date = date;\n" - " }\n" - "\n" - " public String getTitle() {\n" - " return title;\n" - " }\n" - "\n" - " public void setTitle(String title) {\n" - " this.title = title;\n" - " }\n" - "}]]>" +"<![CDATA[package events;\n" +"\n" +"import java.util.Date;\n" +"\n" +"public class Event {\n" +" private Long id;\n" +"\n" +" private String title;\n" +" private Date date;\n" +"\n" +" public Event() {}\n" +"\n" +" public Long getId() {\n" +" return id;\n" +" }\n" +"\n" +" private void setId(Long id) {\n" +" this.id = id;\n" +" }\n" +"\n" +" public Date getDate() {\n" +" return date;\n" +" }\n" +"\n" +" public void setDate(Date date) {\n" +" this.date = date;\n" +" }\n" +"\n" +" public String getTitle() {\n" +" return title;\n" +" }\n" +"\n" +" public void setTitle(String title) {\n" +" this.title = title;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[package events; -\n" - " -\n" - "import java.util.Date; -\n" - " -\n" - "public class Event { -\n" - " private Long id; -\n" - " -\n" - " private String title; -\n" - " private Date date; -\n" - " -\n" - " public Event() {} -\n" - " -\n" - " public Long getId() { -\n" - " return id; -\n" - " } -\n" - " -\n" - " private void setId(Long id) { -\n" - " this.id = id; -\n" - " } -\n" - " -\n" - " public Date getDate() { -\n" - " return date; -\n" - " } -\n" - " -\n" - " public void setDate(Date date) { -\n" - " this.date = date; -\n" - " } -\n" - " -\n" - " public String getTitle() { -\n" - " return title; -\n" - " } -\n" - " -\n" - " public void setTitle(String title) { -\n" - " this.title = title; -\n" - " } -\n" - "}]]>" -#: index.docbook:76 -msgid "You can see that this class uses standard JavaBean naming conventions for property getter and setter methods, as well as private visibility for the fields. This is a recommended design - but not required. Hibernate can also access fields directly, the benefit of accessor methods is robustness for refactoring. The no-argument constructor is required to instantiate an object of this class through reflection." -msgstr "ご覧のとおり、このクラスはフィールドがprivateの可視性を持っているのと同時に、 JavaBean標準のゲッター、セッターメソッドの命名規約に従っています。 このような設計は推奨されていますが必須ではありません。 アクセサメソッドを設けるのはリファクタリングを考えた頑健性のためで、 Hibernateはフィールドに直接アクセスすることも可能です。 引数のないコンストラクタは、リフレクションでこのクラスのインスタンスを作成するために 必要です。" +#. Tag: para +#: tutorial.xml:76 +#, no-c-format +msgid "" +"You can see that this class uses standard JavaBean naming conventions for " +"property getter and setter methods, as well as private visibility for the " +"fields. This is a recommended design - but not required. Hibernate can also " +"access fields directly, the benefit of accessor methods is robustness for " +"refactoring. The no-argument constructor is required to instantiate an " +"object of this class through reflection." +msgstr "" +"ご覧のとおり、このクラスはフィールドがprivateの可視性を持っているのと同時" +"に、 JavaBean標準のゲッター、セッターメソッドの命名規約に従っています。 この" +"ような設計は推奨されていますが必須ではありません。 アクセサメソッドを設けるの" +"はリファクタリングを考えた頑健性のためで、 Hibernateはフィールドに直接アクセ" +"スすることも可能です。 引数のないコンストラクタは、リフレクションでこのクラス" +"のインスタンスを作成するために 必要です。" -#: index.docbook:84 -msgid "The <literal>id</literal> property holds a unique identifier value for a particular event. All persistent entity classes (there are less important dependent classes as well) will need such an identifier property if we want to use the full feature set of Hibernate. In fact, most applications (esp. web applications) need to distinguish objects by identifier, so you should consider this a feature rather than a limitation. However, we usually don't manipulate the identity of an object, hence the setter method should be private. Only Hibernate will assign identifiers when an object is saved. You can see that Hibernate can access public, private, and protected accessor methods, as well as (public, private, protected) fields directly. The choice is up to you and you can match it to fit your application design." -msgstr "<literal>id</literal> プロパティは、ある特定のイベントに対するユニークな識別子の値を保持します。 Hibernateの完全な機能を使いたければ、すべての永続エンティティクラス （それほど重要ではない依存クラスというものもあります） にこのような識別子プロパティが必要になります。 事実上ほとんどのアプリケーション（特にwebアプリケーション）では、 識別子でオブジェクトを区別する必要があるため、これは制限というよりも特徴であると考えるべきです。 しかし通常オブジェクトのIDを操作するようなことはしません。 そのためセッターメソッドはprivateにするべきです。 Hibernateだけがオブジェクトがセーブされたときに識別子へ値を代入します。 Hibernateが（public, private, protected）フィールドに直接アクセスできるの�! �同様に、 public, private, protectedのアクセサメソッドにアクセスできるということがわかるでしょう。 選択はあなたに任されているので、あなたのアプリケーションの設計に合わせることができます。" +#. Tag: para +#: tutorial.xml:84 +#, no-c-format +msgid "" +"The <literal>id</literal> property holds a unique identifier value for a " +"particular event. All persistent entity classes (there are less important " +"dependent classes as well) will need such an identifier property if we want " +"to use the full feature set of Hibernate. In fact, most applications (esp. " +"web applications) need to distinguish objects by identifier, so you should " +"consider this a feature rather than a limitation. However, we usually don't " +"manipulate the identity of an object, hence the setter method should be " +"private. Only Hibernate will assign identifiers when an object is saved. You " +"can see that Hibernate can access public, private, and protected accessor " +"methods, as well as (public, private, protected) fields directly. The choice " +"is up to you and you can match it to fit your application design." +msgstr "" +"<literal>id</literal> プロパティは、ある特定のイベントに対するユニークな識別" +"子の値を保持します。 Hibernateの完全な機能を使いたければ、すべての永続エン" +"ティティクラス （それほど重要ではない依存クラスというものもあります） にこの" +"ような識別子プロパティが必要になります。 事実上ほとんどのアプリケーション（特" +"にwebアプリケーション）では、 識別子でオブジェクトを区別する必要があるため、" +"これは制限というよりも特徴であると考えるべきです。 しかし通常オブジェクトのID" +"を操作するようなことはしません。 そのためセッターメソッドはprivateにするべき" +"です。 Hibernateだけがオブジェクトがセーブされたときに識別子へ値を代入しま" +"す。 Hibernateが（public, private, protected）フィールドに直接アクセスできる" +"のと同様に、 public, private, protectedのアクセサメソッドにアクセスできるとい" +"うことがわかるでしょう。 選択はあなたに任されているので、あなたのアプリケー" +"ションの設計に合わせることができます。" -#: index.docbook:96 -msgid "The no-argument constructor is a requirement for all persistent classes; Hibernate has to create objects for you, using Java Reflection. The constructor can be private, however, package visibility is required for runtime proxy generation and efficient data retrieval without bytecode instrumentation." -msgstr "引数のないコンストラクタはすべての永続クラスに必須です。 これはHibernateがJavaのリフレクションを使って、オブジェクトを作成しなければならないためです。 コンストラクタをprivateにすることは可能ですが、 実行時のプロキシ生成と、バイトコード操作なしの効率的なデータの抽出には、 package可視性が必要です。" +#. Tag: para +#: tutorial.xml:96 +#, no-c-format +msgid "" +"The no-argument constructor is a requirement for all persistent classes; " +"Hibernate has to create objects for you, using Java Reflection. The " +"constructor can be private, however, package visibility is required for " +"runtime proxy generation and efficient data retrieval without bytecode " +"instrumentation." +msgstr "" +"引数のないコンストラクタはすべての永続クラスに必須です。 これはHibernateが" +"Javaのリフレクションを使って、オブジェクトを作成しなければならないためです。 " +"コンストラクタをprivateにすることは可能ですが、 実行時のプロキシ生成と、バイ" +"トコード操作なしの効率的なデータの抽出には、 package可視性が必要です。" -#: index.docbook:103 -msgid "Place this Java source file in a directory called <literal>src</literal> in the development folder, and in its correct package. The directory should now look like this:" -msgstr "開発フォルダの <literal>src</literal> というディレクトリの適切なパッケージに、 このJavaソースファイルを配置してください。 この時点でディレクトリは以下のようになっているはずです：" +#. Tag: para +#: tutorial.xml:103 +#, no-c-format +msgid "" +"Place this Java source file in a directory called <literal>src</literal> in " +"the development folder, and in its correct package. The directory should now " +"look like this:" +msgstr "" +"開発フォルダの <literal>src</literal> というディレクトリの適切なパッケージ" +"に、 このJavaソースファイルを配置してください。 この時点でディレクトリは以下" +"のようになっているはずです：" -#: index.docbook:108 +#. Tag: programlisting +#: tutorial.xml:108 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " <Hibernate and third-party libraries>\n" - "+src\n" - " +events\n" - " Event.java]]>" +"<![CDATA[.\n" +"+lib\n" +" <Hibernate and third-party libraries>\n" +"+src\n" +" +events\n" +" Event.java]]>" msgstr "" - "<![CDATA[. -\n" - "+lib -\n" - " <Hibernate and third-party libraries> -\n" - "+src -\n" - " +events -\n" - " Event.java]]>" -#: index.docbook:110 +#. Tag: para +#: tutorial.xml:110 +#, no-c-format msgid "In the next step, we tell Hibernate about this persistent class." msgstr "次のステップでは、Hibernateにこの永続クラスの情報を教えます。" -#: index.docbook:117 +#. Tag: title +#: tutorial.xml:117 +#, no-c-format msgid "The mapping file" msgstr "マッピングファイル" -#: index.docbook:119 -msgid "Hibernate needs to know how to load and store objects of the persistent class. This is where the Hibernate mapping file comes into play. The mapping file tells Hibernate what table in the database it has to access, and what columns in that table it should use." -msgstr "Hibernateは、どのように永続クラスのオブジェクトをロードし格納すればよいかを知る必要があります。 ここでHibernateマッピングファイルが登場します。 マッピングファイルは、データベース内のどのテーブルにアクセスしなければならないか、 そのテーブルのどのカラムを使うべきかを、Hibernateに教えます。" +#. Tag: para +#: tutorial.xml:119 +#, no-c-format +msgid "" +"Hibernate needs to know how to load and store objects of the persistent " +"class. This is where the Hibernate mapping file comes into play. The mapping " +"file tells Hibernate what table in the database it has to access, and what " +"columns in that table it should use." +msgstr "" +"Hibernateは、どのように永続クラスのオブジェクトをロードし格納すればよいかを知" +"る必要があります。 ここでHibernateマッピングファイルが登場します。 マッピング" +"ファイルは、データベース内のどのテーブルにアクセスしなければならないか、 その" +"テーブルのどのカラムを使うべきかを、Hibernateに教えます。" -#: index.docbook:126 +#. Tag: para +#: tutorial.xml:126 +#, no-c-format msgid "The basic structure of a mapping file looks like this:" msgstr "マッピングファイルの基本的な構造はこのようになります：" -#: index.docbook:130 +#. Tag: programlisting +#: tutorial.xml:130 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\"?>\n" - "<!DOCTYPE hibernate-mapping PUBLIC\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" - "\n" - "<hibernate-mapping>\n" - "[...]\n" - "</hibernate-mapping>]]>" +"<![CDATA[<?xml version=\"1.0\"?>\n" +"<!DOCTYPE hibernate-mapping PUBLIC\n" +" \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\">\n" +"\n" +"<hibernate-mapping>\n" +"[...]\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\"?> -\n" - "<!DOCTYPE hibernate-mapping PUBLIC -\n" - " \"-//Hibernate/Hibernate Mapping DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd\"> -\n" - " -\n" - "<hibernate-mapping> -\n" - "[...] -\n" - "</hibernate-mapping>]]>" -#: index.docbook:132 -msgid "Note that the Hibernate DTD is very sophisticated. You can use it for auto-completion of XML mapping elements and attributes in your editor or IDE. You also should open up the DTD file in your text editor - it's the easiest way to get an overview of all elements and attributes and to see the defaults, as well as some comments. Note that Hibernate will not load the DTD file from the web, but first look it up from the classpath of the application. The DTD file is included in <literal>hibernate3.jar</literal> as well as in the <literal>src/</literal> directory of the Hibernate distribution." -msgstr "Hibernate DTDが非常に洗練されていることに注目してください。 このDTDは、エディタやIDEでのXMLマッピング要素と属性のオートコンプリーション機能に利用できます。 またDTDファイルをテキストエディタで開けてみてください。 というのも、すべての要素と属性を概観し、 コメントやデフォルトの値を見るには一番簡単な方法だからです。 Hibernateは、webからDTDファイルをロードせずに、 まずアプリケーションのクラスパスからこれを探し出そうとすることに注意してください。 DTDファイルはHibernateディストリビューションの <literal>src/</literal> ディレクトリと同様、<literal>hibernate3.jar</literal> にも含まれています。" +#. Tag: para +#: tutorial.xml:132 +#, no-c-format +msgid "" +"Note that the Hibernate DTD is very sophisticated. You can use it for auto-" +"completion of XML mapping elements and attributes in your editor or IDE. You " +"also should open up the DTD file in your text editor - it's the easiest way " +"to get an overview of all elements and attributes and to see the defaults, " +"as well as some comments. Note that Hibernate will not load the DTD file " +"from the web, but first look it up from the classpath of the application. " +"The DTD file is included in <literal>hibernate3.jar</literal> as well as in " +"the <literal>src/</literal> directory of the Hibernate distribution." +msgstr "" +"Hibernate DTDが非常に洗練されていることに注目してください。 このDTDは、エディ" +"タやIDEでのXMLマッピング要素と属性のオートコンプリーション機能に利用できま" +"す。 またDTDファイルをテキストエディタで開けてみてください。 というのも、すべ" +"ての要素と属性を概観し、 コメントやデフォルトの値を見るには一番簡単な方法だか" +"らです。 Hibernateは、webからDTDファイルをロードせずに、 まずアプリケーション" +"のクラスパスからこれを探し出そうとすることに注意してください。 DTDファイルは" +"Hibernateディストリビューションの <literal>src/</literal> ディレクトリと同" +"様、<literal>hibernate3.jar</literal> にも含まれています。" -#: index.docbook:143 -msgid "We will omit the DTD declaration in future examples to shorten the code. It is of course not optional." -msgstr "以降の例ではコードを短くするためにDTD宣言を省略します。 当然ですがこれはオプションではありません。" +#. Tag: para +#: tutorial.xml:143 +#, no-c-format +msgid "" +"We will omit the DTD declaration in future examples to shorten the code. It " +"is of course not optional." +msgstr "" +"以降の例ではコードを短くするためにDTD宣言を省略します。 当然ですがこれはオプ" +"ションではありません。" -#: index.docbook:148 -msgid "Between the two <literal>hibernate-mapping</literal> tags, include a <literal>class</literal> element. All persistent entity classes (again, there might be dependent classes later on, which are not first-class entities) need such a mapping, to a table in the SQL database:" -msgstr "2つの <literal>hibernate-mapping</literal> タグの間に <literal>class</literal> 要素を含めてください。 すべての永続エンティティクラス（念を押しますが、 ファーストクラスのエンティティではない依存クラスというものが後ほど登場します） はSQLデータベース内のテーブルへのこのようなマッピングを必要とします。" +#. Tag: para +#: tutorial.xml:148 +#, no-c-format +msgid "" +"Between the two <literal>hibernate-mapping</literal> tags, include a " +"<literal>class</literal> element. All persistent entity classes (again, " +"there might be dependent classes later on, which are not first-class " +"entities) need such a mapping, to a table in the SQL database:" +msgstr "" +"2つの <literal>hibernate-mapping</literal> タグの間に <literal>class</" +"literal> 要素を含めてください。 すべての永続エンティティクラス（念を押します" +"が、 ファーストクラスのエンティティではない依存クラスというものが後ほど登場し" +"ます） はSQLデータベース内のテーブルへのこのようなマッピングを必要とします。" -#: index.docbook:155 +#. Tag: programlisting +#: tutorial.xml:155 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"events.Event\" table=\"EVENTS\">\n" - "\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"events.Event\" table=\"EVENTS\">\n" +"\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " -\n" - " <class name=\"events.Event\" table=\"EVENTS\"> -\n" - " -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:157 -msgid "So far we told Hibernate how to persist and load object of class <literal>Event</literal> to the table <literal>EVENTS</literal>, each instance represented by a row in that table. Now we continue with a mapping of the unique identifier property to the tables primary key. In addition, as we don't want to care about handling this identifier, we configure Hibernate's identifier generation strategy for a surrogate primary key column:" -msgstr "これまで私たちは、<literal>Event</literal> クラスのオブジェクトを <literal>EVENTS</literal> テーブルに対して、どのように永続化したりロードしたりするのかを Hibernateに教えてきました。そして個々のインスタンスはテーブルの行として表現されます。 それでは引き続きテーブルの主キーに対するユニークな識別子プロパティをマッピングしていきます。 さらに、この識別子の扱いに気を使いたくなかったのと同様に、 代理の主キーカラムに対するHibernateの識別子生成戦略を設定します。" +#. Tag: para +#: tutorial.xml:157 +#, no-c-format +msgid "" +"So far we told Hibernate how to persist and load object of class " +"<literal>Event</literal> to the table <literal>EVENTS</literal>, each " +"instance represented by a row in that table. Now we continue with a mapping " +"of the unique identifier property to the tables primary key. In addition, as " +"we don't want to care about handling this identifier, we configure " +"Hibernate's identifier generation strategy for a surrogate primary key " +"column:" +msgstr "" +"これまで私たちは、<literal>Event</literal> クラスのオブジェクトを " +"<literal>EVENTS</literal> テーブルに対して、どのように永続化したりロードした" +"りするのかを Hibernateに教えてきました。そして個々のインスタンスはテーブルの" +"行として表現されます。 それでは引き続きテーブルの主キーに対するユニークな識別" +"子プロパティをマッピングしていきます。 さらに、この識別子の扱いに気を使いたく" +"なかったのと同様に、 代理の主キーカラムに対するHibernateの識別子生成戦略を設" +"定します。" -#: index.docbook:165 +#. Tag: programlisting +#: tutorial.xml:165 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"events.Event\" table=\"EVENTS\">\n" - " <id name=\"id\" column=\"EVENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"events.Event\" table=\"EVENTS\">\n" +" <id name=\"id\" column=\"EVENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " -\n" - " <class name=\"events.Event\" table=\"EVENTS\"> -\n" - " <id name=\"id\" column=\"EVENT_ID\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:167 -msgid "The <literal>id</literal> element is the declaration of the identifer property, <literal>name=\"id\"</literal> declares the name of the Java property - Hibernate will use the getter and setter methods to access the property. The column attribute tells Hibernate which column of the <literal>EVENTS</literal> table we use for this primary key. The nested <literal>generator</literal> element specifies the identifier generation strategy, in this case we used <literal>native</literal>, which picks the best strategy depending on the configured database (dialect). Hibernate supports database generated, globally unique, as well as application assigned identifiers (or any strategy you have written an extension for)." -msgstr "<literal>id</literal> 要素は識別子プロパティの宣言であり、 <literal>name=\"id\"</literal> でJavaプロパティの名前を宣言します。 Hibernateはこのプロパティへアクセスするためにゲッター、セッターメソッドを使います。 カラム属性では <literal>EVENTS</literal> テーブルのどのカラムを主キーとして使うのかを Hibernateに教えます。 入れ子になっている <literal>generator</literal> 要素は、識別子を生成する時の戦略を指定します。 （この例では <literal>native</literal> を用いました）。 この要素は、設定したデータベース（dialect）に対する最良な識別子生成戦略を選定するものです。 Hibernateは、アプリケーションで値を割り当てる戦略（もしくは独自に拡張した戦略）と同様に、 グローバルにユニークな値をデータベースに生成させる戦略もサポー�! ��しています。" +#. Tag: para +#: tutorial.xml:167 +#, no-c-format +msgid "" +"The <literal>id</literal> element is the declaration of the identifer " +"property, <literal>name=\"id\"</literal> declares the name of the Java " +"property - Hibernate will use the getter and setter methods to access the " +"property. The column attribute tells Hibernate which column of the " +"<literal>EVENTS</literal> table we use for this primary key. The nested " +"<literal>generator</literal> element specifies the identifier generation " +"strategy, in this case we used <literal>native</literal>, which picks the " +"best strategy depending on the configured database (dialect). Hibernate " +"supports database generated, globally unique, as well as application " +"assigned identifiers (or any strategy you have written an extension for)." +msgstr "" +"<literal>id</literal> 要素は識別子プロパティの宣言であり、 <literal>name=\"id" +"\"</literal> でJavaプロパティの名前を宣言します。 Hibernateはこのプロパティへ" +"アクセスするためにゲッター、セッターメソッドを使います。 カラム属性では " +"<literal>EVENTS</literal> テーブルのどのカラムを主キーとして使うのかを " +"Hibernateに教えます。 入れ子になっている <literal>generator</literal> 要素" +"は、識別子を生成する時の戦略を指定します。 （この例では <literal>native</" +"literal> を用いました）。 この要素は、設定したデータベース（dialect）に対する" +"最良な識別子生成戦略を選定するものです。 Hibernateは、アプリケーションで値を" +"割り当てる戦略（もしくは独自に拡張した戦略）と同様に、 グローバルにユニークな" +"値をデータベースに生成させる戦略もサポートしています。" -#: index.docbook:180 -msgid "Finally we include declarations for the persistent properties of the class in the mapping file. By default, no properties of the class are considered persistent:" -msgstr "最後にクラスの永続プロパティの宣言をマッピングファイルに含めます。 デフォルトでは、クラスのプロパティは永続と見なされません：" +#. Tag: para +#: tutorial.xml:180 +#, no-c-format +msgid "" +"Finally we include declarations for the persistent properties of the class " +"in the mapping file. By default, no properties of the class are considered " +"persistent:" +msgstr "" +"最後にクラスの永続プロパティの宣言をマッピングファイルに含めます。 デフォルト" +"では、クラスのプロパティは永続と見なされません：" -#: index.docbook:186 +#. Tag: programlisting +#: tutorial.xml:186 +#, no-c-format msgid "" - "<![CDATA[\n" - "<hibernate-mapping>\n" - "\n" - " <class name=\"events.Event\" table=\"EVENTS\">\n" - " <id name=\"id\" column=\"EVENT_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE\"/>\n" - " <property name=\"title\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[\n" +"<hibernate-mapping>\n" +"\n" +" <class name=\"events.Event\" table=\"EVENTS\">\n" +" <id name=\"id\" column=\"EVENT_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE\"/>\n" +" <property name=\"title\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[ -\n" - "<hibernate-mapping> -\n" - " -\n" - " <class name=\"events.Event\" table=\"EVENTS\"> -\n" - " <id name=\"id\" column=\"EVENT_ID\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"date\" type=\"timestamp\" column=\"EVENT_DATE\"/> -\n" - " <property name=\"title\"/> -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:188 -msgid "Just as with the <literal>id</literal> element, the <literal>name</literal> attribute of the <literal>property</literal> element tells Hibernate which getter and setter methods to use. So, in this case, Hibernate will look for <literal>getDate()/setDate()</literal>, as well as <literal>getTitle()/setTitle()</literal>." -msgstr "<literal>id</literal> 要素の場合と同様に、 <literal>property</literal> 要素の <literal>name</literal> 属性で、どのゲッターとセッターメソッドを使うべきかをHibernateに教えます。 この例では、Hibernateは <literal>getDate()/setDate()</literal> と <literal>getTitle()/setTitle()</literal> を 探します。" +#. Tag: para +#: tutorial.xml:188 +#, no-c-format +msgid "" +"Just as with the <literal>id</literal> element, the <literal>name</literal> " +"attribute of the <literal>property</literal> element tells Hibernate which " +"getter and setter methods to use. So, in this case, Hibernate will look for " +"<literal>getDate()/setDate()</literal>, as well as <literal>getTitle()/" +"setTitle()</literal>." +msgstr "" +"<literal>id</literal> 要素の場合と同様に、 <literal>property</literal> 要素" +"の <literal>name</literal> 属性で、どのゲッターとセッターメソッドを使うべきか" +"をHibernateに教えます。 この例では、Hibernateは <literal>getDate()/setDate()" +"</literal> と <literal>getTitle()/setTitle()</literal> を 探します。" -#: index.docbook:195 -msgid "Why does the <literal>date</literal> property mapping include the <literal>column</literal> attribute, but the <literal>title</literal> doesn't? Without the <literal>column</literal> attribute Hibernate by default uses the property name as the column name. This works fine for <literal>title</literal>. However, <literal>date</literal> is a reserved keyword in most database, so we better map it to a different name." -msgstr "なぜ <literal>date</literal> プロパティのマッピングには <literal>column</literal> 属性があり、<literal>title</literal> プロパティにはないのでしょうか？ <literal>column</literal> 属性がなければ、Hibernateはプロパティ名をカラム名として使います。 これは <literal>title</literal> では上手く行きます。 しかし <literal>date</literal> はほとんどのデータベースで予約語なので、 違う名前でマッピングした方がよいのです。" +#. Tag: para +#: tutorial.xml:195 +#, no-c-format +msgid "" +"Why does the <literal>date</literal> property mapping include the " +"<literal>column</literal> attribute, but the <literal>title</literal> " +"doesn't? Without the <literal>column</literal> attribute Hibernate by " +"default uses the property name as the column name. This works fine for " +"<literal>title</literal>. However, <literal>date</literal> is a reserved " +"keyword in most database, so we better map it to a different name." +msgstr "" +"なぜ <literal>date</literal> プロパティのマッピングには <literal>column</" +"literal> 属性があり、<literal>title</literal> プロパティにはないのでしょう" +"か？ <literal>column</literal> 属性がなければ、Hibernateはプロパティ名をカラ" +"ム名として使います。 これは <literal>title</literal> では上手く行きます。 し" +"かし <literal>date</literal> はほとんどのデータベースで予約語なので、 違う名" +"前でマッピングした方がよいのです。" -#: index.docbook:204 -msgid "The next interesting thing is that the <literal>title</literal> mapping also lacks a <literal>type</literal> attribute. The types we declare and use in the mapping files are not, as you might expect, Java data types. They are also not SQL database types. These types are so called <emphasis>Hibernate mapping types</emphasis>, converters which can translate from Java to SQL data types and vice versa. Again, Hibernate will try to determine the correct conversion and mapping type itself if the <literal>type</literal> attribute is not present in the mapping. In some cases this automatic detection (using Reflection on the Java class) might not have the default you expect or need. This is the case with the <literal>date</literal> property. Hibernate can't know if the property (which is of <literal>java.util.Date</literal>) should map to a SQL <literal>date</literal>, <literal>timestamp</literal>, or <literal>time</literal> column. We preserve full date and time information ! by mapping the property with a <literal>timestamp</literal> converter." -msgstr "次に興味深いのは <literal>title</literal> マッピングが <literal>type</literal> 属性をも欠いている点です。 マッピングファイルで宣言して使うtypeは、おわかりかもしれませんがJavaのデータ型ではありません。 SQLデータベースの型でもありません。 これは <emphasis>Hibernateマッピング型</emphasis> と呼ばれる、 JavaからSQLデータの型へまたはSQLからJavaデータ型へ翻訳するコンバータです。 繰り返しになりますが、Hibernateは <literal>type</literal> 属性がマッピングファイル内になければ、 正しいコンバージョンとマッピング型を自分で解決しようとします。 （Javaクラスのリフレクションを使った）この自動検知は、 場合によってはあなたが期待または必要とするデフォルト値にならないかもしれません。 <literal>date</literal> プロパティの場合が! そうでした。 Hibernateはこの（ <literal>java.util.Date</literal> の）プロパティを SQLの <literal>date</literal> , <literal>timestamp</literal> , <literal>time</literal> のうち、どのカラムにマッピングするべきなのかわかりません。 <literal>timestamp</literal> コンバータでプロパティをマッピングすることにより、完全な日時を保存します。" +#. Tag: para +#: tutorial.xml:204 +#, no-c-format +msgid "" +"The next interesting thing is that the <literal>title</literal> mapping also " +"lacks a <literal>type</literal> attribute. The types we declare and use in " +"the mapping files are not, as you might expect, Java data types. They are " +"also not SQL database types. These types are so called <emphasis>Hibernate " +"mapping types</emphasis>, converters which can translate from Java to SQL " +"data types and vice versa. Again, Hibernate will try to determine the " +"correct conversion and mapping type itself if the <literal>type</literal> " +"attribute is not present in the mapping. In some cases this automatic " +"detection (using Reflection on the Java class) might not have the default " +"you expect or need. This is the case with the <literal>date</literal> " +"property. Hibernate can't know if the property (which is of <literal>java." +"util.Date</literal>) should map to a SQL <literal>date</literal>, " +"<literal>timestamp</literal>, or <literal>time</literal> column. We preserve " +"full date and time information by mapping the property with a " +"<literal>timestamp</literal> converter." +msgstr "" +"次に興味深いのは <literal>title</literal> マッピングが <literal>type</" +"literal> 属性をも欠いている点です。 マッピングファイルで宣言して使うtypeは、" +"おわかりかもしれませんがJavaのデータ型ではありません。 SQLデータベースの型で" +"もありません。 これは <emphasis>Hibernateマッピング型</emphasis> と呼ばれ" +"る、 JavaからSQLデータの型へまたはSQLからJavaデータ型へ翻訳するコンバータで" +"す。 繰り返しになりますが、Hibernateは <literal>type</literal> 属性がマッピン" +"グファイル内になければ、 正しいコンバージョンとマッピング型を自分で解決しよう" +"とします。 （Javaクラスのリフレクションを使った）この自動検知は、 場合によっ" +"てはあなたが期待または必要とするデフォルト値にならないかもしれません。 " +"<literal>date</literal> プロパティの場合がそうでした。 Hibernateはこの" +"（ <literal>java.util.Date</literal> の）プロパティを SQLの <literal>date</" +"literal> , <literal>timestamp</literal> , <literal>time</literal> のうち、ど" +"のカラムにマッピングするべきなのかわかりません。 <literal>timestamp</" +"literal> コンバータでプロパティをマッピングすることにより、完全な日時を保存し" +"ます。" -#: index.docbook:220 -msgid "This mapping file should be saved as <literal>Event.hbm.xml</literal>, right in the directory next to the <literal>Event</literal> Java class source file. The naming of mapping files can be arbitrary, however the <literal>hbm.xml</literal> suffix is a convention in the Hibernate developer community. The directory structure should now look like this:" -msgstr "このマッピングファイルは、<literal>Event.hbm.xml</literal> として <literal>Event</literal> Javaクラスソースファイルのすぐ隣にセーブするべきです。 マッピングファイルの命名方法は任意ですが、<literal>hbm.xml</literal> サフィックスがHibernateの開発者のコミュニティ内での習慣となっています。 現在ディレクトリ構造はこのようになっているはずです：" +#. Tag: para +#: tutorial.xml:220 +#, no-c-format +msgid "" +"This mapping file should be saved as <literal>Event.hbm.xml</literal>, right " +"in the directory next to the <literal>Event</literal> Java class source " +"file. The naming of mapping files can be arbitrary, however the <literal>hbm." +"xml</literal> suffix is a convention in the Hibernate developer community. " +"The directory structure should now look like this:" +msgstr "" +"このマッピングファイルは、<literal>Event.hbm.xml</literal> として " +"<literal>Event</literal> Javaクラスソースファイルのすぐ隣にセーブするべきで" +"す。 マッピングファイルの命名方法は任意ですが、<literal>hbm.xml</literal> サ" +"フィックスがHibernateの開発者のコミュニティ内での習慣となっています。 現在" +"ディレクトリ構造はこのようになっているはずです：" -#: index.docbook:228 +#. Tag: programlisting +#: tutorial.xml:228 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " <Hibernate and third-party libraries>\n" - "+src\n" - " +events\n" - " Event.java\n" - " Event.hbm.xml]]>" +"<![CDATA[.\n" +"+lib\n" +" <Hibernate and third-party libraries>\n" +"+src\n" +" +events\n" +" Event.java\n" +" Event.hbm.xml]]>" msgstr "" - "<![CDATA[. -\n" - "+lib -\n" - " <Hibernate and third-party libraries> -\n" - "+src -\n" - " +events -\n" - " Event.java -\n" - " Event.hbm.xml]]>" -#: index.docbook:230 +#. Tag: para +#: tutorial.xml:230 +#, no-c-format msgid "We continue with the main configuration of Hibernate." msgstr "Hibernateの主要な設定を続けます。" -#: index.docbook:237 +#. Tag: title +#: tutorial.xml:237 +#, no-c-format msgid "Hibernate configuration" msgstr "Hibernateの設定" -#: index.docbook:239 -msgid "We now have a persistent class and its mapping file in place. It is time to configure Hibernate. Before we do this, we will need a database. HSQL DB, a java-based SQL DBMS, can be downloaded from the HSQL DB website(http://hsqldb.org/). Actually, you only need the <literal>hsqldb.jar</literal> from this download. Place this file in the <literal>lib/</literal> directory of the development folder." -msgstr "ここまでで永続クラスとマッピングファイルが揃いました。これからHibernateの設定を行いますが、 その前にデータベースが必要です。 HSQL DBはJavaベースのインメモリSQL DBMSであり、HSQL DBウェブサイトからダウンロードできます。 実際にはダウンロードした中の <literal>hsqldb.jar</literal> だけが必要です。 このファイルを開発フォルダの <literal>lib/</literal> ディレクトリに配置してください。" +#. Tag: para +#: tutorial.xml:239 +#, no-c-format +msgid "" +"We now have a persistent class and its mapping file in place. It is time to " +"configure Hibernate. Before we do this, we will need a database. HSQL DB, a " +"java-based SQL DBMS, can be downloaded from the HSQL DB website(http://" +"hsqldb.org/). Actually, you only need the <literal>hsqldb.jar</literal> from " +"this download. Place this file in the <literal>lib/</literal> directory of " +"the development folder." +msgstr "" +"ここまでで永続クラスとマッピングファイルが揃いました。これからHibernateの設定" +"を行いますが、 その前にデータベースが必要です。 HSQL DBはJavaベースのインメモ" +"リSQL DBMSであり、HSQL DBウェブサイトからダウンロードできます。 実際にはダウ" +"ンロードした中の <literal>hsqldb.jar</literal> だけが必要です。 このファイル" +"を開発フォルダの <literal>lib/</literal> ディレクトリに配置してください。" -#: index.docbook:247 -msgid "Create a directory called <literal>data</literal> in the root of the development directory - this is where HSQL DB will store its data files. Now start the database by running <literal>java -classpath ../lib/hsqldb.jar org.hsqldb.Server</literal> in this data directory. You can see it start up and bind to a TCP/IP socket, this is where our application will connect later. If you want to start with a fresh database during this tutorial, shutdown HSQL DB (press <literal>CTRL + C</literal> in the window), delete all files in the <literal>data/</literal> directory, and start HSQL DB again." -msgstr "<literal>data</literal> というディレクトリを開発ディレクトリのルートに作成してください。 HSQL DBはここにデータファイルを格納します。 このデータディレクトリにおいて <literal>java -classpath lib/hsqldb.jar org.hsqldb.Server</literal> を実行し、 データベースを起動させてください。 動作の開始と、TCP/IPソケットのバインドが確認できます。 後ほど作成するアプリケーションはここに接続します。 もしこのチュートリアル中にデータベースを初期化したければ、 HSQL DBをシャットダウンして（作業ウィンドウで <literal>CTRL + C</literal> を押します） <literal>data/</literal> ディレクトリ内のファイルを全て消去した後、 HSQL DBを再起動します。" +#. Tag: para +#: tutorial.xml:247 +#, no-c-format +msgid "" +"Create a directory called <literal>data</literal> in the root of the " +"development directory - this is where HSQL DB will store its data files. Now " +"start the database by running <literal>java -classpath ../lib/hsqldb.jar org." +"hsqldb.Server</literal> in this data directory. You can see it start up and " +"bind to a TCP/IP socket, this is where our application will connect later. " +"If you want to start with a fresh database during this tutorial, shutdown " +"HSQL DB (press <literal>CTRL + C</literal> in the window), delete all files " +"in the <literal>data/</literal> directory, and start HSQL DB again." +msgstr "" +"<literal>data</literal> というディレクトリを開発ディレクトリのルートに作成し" +"てください。 HSQL DBはここにデータファイルを格納します。 このデータディレクト" +"リにおいて <literal>java -classpath lib/hsqldb.jar org.hsqldb.Server</" +"literal> を実行し、 データベースを起動させてください。 動作の開始と、TCP/IPソ" +"ケットのバインドが確認できます。 後ほど作成するアプリケーションはここに接続し" +"ます。 もしこのチュートリアル中にデータベースを初期化したければ、 HSQL DBを" +"シャットダウンして（作業ウィンドウで <literal>CTRL + C</literal> を押しま" +"す） <literal>data/</literal> ディレクトリ内のファイルを全て消去した後、 " +"HSQL DBを再起動します。" -#: index.docbook:257 -msgid "Hibernate is the layer in your application which connects to this database, so it needs connection information. The connections are made through a JDBC connection pool, which we also have to configure. The Hibernate distribution contains several open source JDBC connection pooling tools, but will use the Hibernate built-in connection pool for this tutorial. Note that you have to copy the required library into your classpath and use different connection pooling settings if you want to use a production-quality third party JDBC pooling software." -msgstr "Hibernateはアプリケーションのデータベースに接続する層なので、 コネクションの情報が必要になります。 コネクションはJDBCコネクションプールを通じて行われますが、これも設定する必要があります。 HibernateディストリビューションにはいくつかのオープンソースのJDBCコネクションプールツールが含まれていますが、 このチュートリアルではHibernateに組み込まれたコネクションプールを使います。 もし製品レベルの品質のサードパーティJDBCコネクションプールソフトウェアを使いたければ、 クラスパスに必要なライブラリをコピーして、異なるコネクションプールを設定しなければ ならないことに注意してください。" +#. Tag: para +#: tutorial.xml:257 +#, no-c-format +msgid "" +"Hibernate is the layer in your application which connects to this database, " +"so it needs connection information. The connections are made through a JDBC " +"connection pool, which we also have to configure. The Hibernate distribution " +"contains several open source JDBC connection pooling tools, but will use the " +"Hibernate built-in connection pool for this tutorial. Note that you have to " +"copy the required library into your classpath and use different connection " +"pooling settings if you want to use a production-quality third party JDBC " +"pooling software." +msgstr "" +"Hibernateはアプリケーションのデータベースに接続する層なので、 コネクションの" +"情報が必要になります。 コネクションはJDBCコネクションプールを通じて行われます" +"が、これも設定する必要があります。 Hibernateディストリビューションにはいくつ" +"かのオープンソースのJDBCコネクションプールツールが含まれていますが、 この" +"チュートリアルではHibernateに組み込まれたコネクションプールを使います。 もし" +"製品レベルの品質のサードパーティJDBCコネクションプールソフトウェアを使いたけ" +"れば、 クラスパスに必要なライブラリをコピーして、異なるコネクションプールを設" +"定しなければ ならないことに注意してください。" -#: index.docbook:267 -msgid "For Hibernate's configuration, we can use a simple <literal>hibernate.properties</literal> file, a slightly more sophisticated <literal>hibernate.cfg.xml</literal> file, or even complete programmatic setup. Most users prefer the XML configuration file:" -msgstr "Hibernateの設定では、単純な <literal>hibernate.properties</literal> ファイル、 それより少し洗練されている <literal>hibernate.cfg.xml</literal> ファイル、 または完全にプログラム上でセットアップする方法が利用できます。 ほとんどのユーザが好むのはXML設定ファイルです：" +#. Tag: para +#: tutorial.xml:267 +#, no-c-format +msgid "" +"For Hibernate's configuration, we can use a simple <literal>hibernate." +"properties</literal> file, a slightly more sophisticated <literal>hibernate." +"cfg.xml</literal> file, or even complete programmatic setup. Most users " +"prefer the XML configuration file:" +msgstr "" +"Hibernateの設定では、単純な <literal>hibernate.properties</literal> ファイ" +"ル、 それより少し洗練されている <literal>hibernate.cfg.xml</literal> ファイ" +"ル、 または完全にプログラム上でセットアップする方法が利用できます。 ほとんど" +"のユーザが好むのはXML設定ファイルです：" -#: index.docbook:273 +#. Tag: programlisting +#: tutorial.xml:273 +#, no-c-format msgid "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" - "<!DOCTYPE hibernate-configuration PUBLIC\n" - " \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\"\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\">\n" - "\n" - "<hibernate-configuration>\n" - "\n" - " <session-factory>\n" - "\n" - " <!-- Database connection settings -->\n" - " <property name=\"connection.driver_class\">org.hsqldb.jdbcDriver</property>\n" - " <property name=\"connection.url\">jdbc:hsqldb:hsql://localhost</property>\n" - " <property name=\"connection.username\">sa</property>\n" - " <property name=\"connection.password\"></property>\n" - "\n" - " <!-- JDBC connection pool (use the built-in) -->\n" - " <property name=\"connection.pool_size\">1</property>\n" - "\n" - " <!-- SQL dialect -->\n" - " <property name=\"dialect\">org.hibernate.dialect.HSQLDialect</property>\n" - "\n" - " <!-- Enable Hibernate's automatic session context management -->\n" - " <property name=\"current_session_context_class\">thread</property>\n" - "\n" - " <!-- Disable the second-level cache -->\n" - " <property name=\"cache.provider_class\">org.hibernate.cache.NoCacheProvider</property>\n" - "\n" - " <!-- Echo all executed SQL to stdout -->\n" - " <property name=\"show_sql\">true</property>\n" - "\n" - " <!-- Drop and re-create the database schema on startup -->\n" - " <property name=\"hbm2ddl.auto\">create</property>\n" - "\n" - " <mapping resource=\"events/Event.hbm.xml\"/>\n" - "\n" - " </session-factory>\n" - "\n" - "</hibernate-configuration>]]>" +"<![CDATA[<?xml version='1.0' encoding='utf-8'?>\n" +"<!DOCTYPE hibernate-configuration PUBLIC\n" +" \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\"\n" +" \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd" +"\">\n" +"\n" +"<hibernate-configuration>\n" +"\n" +" <session-factory>\n" +"\n" +" <!-- Database connection settings -->\n" +" <property name=\"connection.driver_class\">org.hsqldb.jdbcDriver</" +"property>\n" +" <property name=\"connection.url\">jdbc:hsqldb:hsql://localhost</" +"property>\n" +" <property name=\"connection.username\">sa</property>\n" +" <property name=\"connection.password\"></property>\n" +"\n" +" <!-- JDBC connection pool (use the built-in) -->\n" +" <property name=\"connection.pool_size\">1</property>\n" +"\n" +" <!-- SQL dialect -->\n" +" <property name=\"dialect\">org.hibernate.dialect.HSQLDialect</" +"property>\n" +"\n" +" <!-- Enable Hibernate's automatic session context management -->\n" +" <property name=\"current_session_context_class\">thread</property>\n" +"\n" +" <!-- Disable the second-level cache -->\n" +" <property name=\"cache.provider_class\">org.hibernate.cache." +"NoCacheProvider</property>\n" +"\n" +" <!-- Echo all executed SQL to stdout -->\n" +" <property name=\"show_sql\">true</property>\n" +"\n" +" <!-- Drop and re-create the database schema on startup -->\n" +" <property name=\"hbm2ddl.auto\">create</property>\n" +"\n" +" <mapping resource=\"events/Event.hbm.xml\"/>\n" +"\n" +" </session-factory>\n" +"\n" +"</hibernate-configuration>]]>" msgstr "" - "<![CDATA[<?xml version='1.0' encoding='utf-8'?> -\n" - "<!DOCTYPE hibernate-configuration PUBLIC -\n" - " \"-//Hibernate/Hibernate Configuration DTD 3.0//EN\" -\n" - " \"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd\"> -\n" - " -\n" - "<hibernate-configuration> -\n" - " -\n" - " <session-factory> -\n" - " -\n" - " <!-- Database connection settings --> -\n" - " <property name=\"connection.driver_class\">org.hsqldb.jdbcDriver</property> -\n" - " <property name=\"connection.url\">jdbc:hsqldb:hsql://localhost</property> -\n" - " <property name=\"connection.username\">sa</property> -\n" - " <property name=\"connection.password\"></property> -\n" - " -\n" - " <!-- JDBC connection pool (use the built-in) --> -\n" - " <property name=\"connection.pool_size\">1</property> -\n" - " -\n" - " <!-- SQL dialect --> -\n" - " <property name=\"dialect\">org.hibernate.dialect.HSQLDialect</property> -\n" - " -\n" - " <!-- Enable Hibernate's automatic session context management --> -\n" - " <property name=\"current_session_context_class\">thread</property> -\n" - " -\n" - " <!-- Disable the second-level cache --> -\n" - " <property name=\"cache.provider_class\">org.hibernate.cache.NoCacheProvider</property> -\n" - " -\n" - " <!-- Echo all executed SQL to stdout --> -\n" - " <property name=\"show_sql\">true</property> -\n" - " -\n" - " <!-- Drop and re-create the database schema on startup --> -\n" - " <property name=\"hbm2ddl.auto\">create</property> -\n" - " -\n" - " <mapping resource=\"events/Event.hbm.xml\"/> -\n" - " -\n" - " </session-factory> -\n" - " -\n" - "</hibernate-configuration>]]>" -#: index.docbook:275 -msgid "Note that this XML configuration uses a different DTD. We configure Hibernate's <literal>SessionFactory</literal> - a global factory responsible for a particular database. If you have several databases, use several <literal>&lt;session-factory&gt;</literal> configurations, usually in several configuration files (for easier startup)." -msgstr "このXMLの設定が異なるDTDを使うことに注意してください。 特定のデータベースを受け持つグローバルファクトリであるHibernateの <literal>SessionFactory</literal> を設定します。 もし複数のデータベースがある場合には、 （スタートアップを簡単にするため）通常いくつかの設定ファイル内で、 いくつかの <literal>&lt;session-factory&gt;</literal> を使う設定にしてください。" +#. Tag: para +#: tutorial.xml:275 +#, no-c-format +msgid "" +"Note that this XML configuration uses a different DTD. We configure " +"Hibernate's <literal>SessionFactory</literal> - a global factory responsible " +"for a particular database. If you have several databases, use several " +"<literal>&lt;session-factory&gt;</literal> configurations, usually in " +"several configuration files (for easier startup)." +msgstr "" +"このXMLの設定が異なるDTDを使うことに注意してください。 特定のデータベースを受" +"け持つグローバルファクトリであるHibernateの <literal>SessionFactory</" +"literal> を設定します。 もし複数のデータベースがある場合には、 （スタートアッ" +"プを簡単にするため）通常いくつかの設定ファイル内で、 いくつかの <literal>&lt;" +"session-factory&gt;</literal> を使う設定にしてください。" -#: index.docbook:283 -msgid "The first four <literal>property</literal> elements contain the necessary configuration for the JDBC connection. The dialect <literal>property</literal> element specifies the particular SQL variant Hibernate generates. Hibernate's automatic session management for persistence contexts will come in handy as you will soon see. The <literal>hbm2ddl.auto</literal> option turns on automatic generation of database schemas - directly into the database. This can of course also be turned off (by removing the config option) or redirected to a file with the help of the <literal>SchemaExport</literal> Ant task. Finally, we add the mapping file(s) for persistent classes to the configuration." -msgstr "最初の4つの <literal>property</literal> 要素はJDBCコネクションに必要な設定を含んでいます。 dialectという名前の <literal>property</literal> 要素は、Hibernateが生成する特定のSQL方言を指定します。 永続的なコンテキストに対するHibernateのセッションの自動管理は、後の例ですぐにわかるように、役に立つことでしょう。 <literal>hbm2ddl.auto</literal> オプションはデータベーススキーマの自動生成をonにします。 これは直接データベースに対して生成されます。 当然（configオプションを削除して）offにしたり、 <literal>SchemaExport</literal> というAntタスクの助けを借りてファイルにリダイレクトしたりできます。 最後に永続クラスのためのマッピングファイルを設定に追加します。" +#. Tag: para +#: tutorial.xml:283 +#, no-c-format +msgid "" +"The first four <literal>property</literal> elements contain the necessary " +"configuration for the JDBC connection. The dialect <literal>property</" +"literal> element specifies the particular SQL variant Hibernate generates. " +"Hibernate's automatic session management for persistence contexts will come " +"in handy as you will soon see. The <literal>hbm2ddl.auto</literal> option " +"turns on automatic generation of database schemas - directly into the " +"database. This can of course also be turned off (by removing the config " +"option) or redirected to a file with the help of the <literal>SchemaExport</" +"literal> Ant task. Finally, we add the mapping file(s) for persistent " +"classes to the configuration." +msgstr "" +"最初の4つの <literal>property</literal> 要素はJDBCコネクションに必要な設定を" +"含んでいます。 dialectという名前の <literal>property</literal> 要素は、" +"Hibernateが生成する特定のSQL方言を指定します。 永続的なコンテキストに対する" +"Hibernateのセッションの自動管理は、後の例ですぐにわかるように、役に立つことで" +"しょう。 <literal>hbm2ddl.auto</literal> オプションはデータベーススキーマの自" +"動生成をonにします。 これは直接データベースに対して生成されます。 当然" +"（configオプションを削除して）offにしたり、 <literal>SchemaExport</literal> " +"というAntタスクの助けを借りてファイルにリダイレクトしたりできます。 最後に永" +"続クラスのためのマッピングファイルを設定に追加します。" -#: index.docbook:296 -msgid "Copy this file into the source directory, so it will end up in the root of the classpath. Hibernate automatically looks for a file called <literal>hibernate.cfg.xml</literal> in the root of the classpath, on startup." -msgstr "このファイルをソースディレクトリにコピーしてください。 するとこれはクラスパスのルートにあることになります。 Hibernateは、スタートアップ時にクラスパスのルートで <literal>hibernate.cfg.xml</literal> というファイルを自動的に探します。" +#. Tag: para +#: tutorial.xml:296 +#, no-c-format +msgid "" +"Copy this file into the source directory, so it will end up in the root of " +"the classpath. Hibernate automatically looks for a file called " +"<literal>hibernate.cfg.xml</literal> in the root of the classpath, on " +"startup." +msgstr "" +"このファイルをソースディレクトリにコピーしてください。 するとこれはクラスパス" +"のルートにあることになります。 Hibernateは、スタートアップ時にクラスパスの" +"ルートで <literal>hibernate.cfg.xml</literal> というファイルを自動的に探しま" +"す。" -#: index.docbook:305 +#. Tag: title +#: tutorial.xml:305 +#, no-c-format msgid "Building with Ant" msgstr "Antによるビルド" -#: index.docbook:307 -msgid "We'll now build the tutorial with Ant. You will need to have Ant installed - get it from the <ulink url=\"http://ant.apache.org/bindownload.cgi\">Ant download page</ulink>. How to install Ant will not be covered here. Please refer to the <ulink url=\"http://ant.apache.org/manual/index.html\">Ant manual</ulink>. After you have installed Ant, we can start to create the buildfile. It will be called <literal>build.xml</literal> and placed directly in the development directory." -msgstr "それではAntを使ってチュートリアルをビルドしましょう。 それにはAntがインストールされていなければなりません。 <ulink url=\"http://ant.apache.org/bindownload.cgi\">Antダウンロードページ&l... からダウンロードしてください。 Antのインストール方法はここでは説明しませんので、 <ulink url=\"http://ant.apache.org/manual/index.html\">Antマニュアル<... を参照してください。 Antをインストールすれば、ビルドファイルの作成を開始できます。 このファイルは <literal>build.xml</literal> と呼ばれ、開発ディレクトリに直接配置します。" +#. Tag: para +#: tutorial.xml:307 +#, no-c-format +msgid "" +"We'll now build the tutorial with Ant. You will need to have Ant installed - " +"get it from the <ulink url=\"http://ant.apache.org/bindownload.cgi\">Ant " +"download page</ulink>. How to install Ant will not be covered here. Please " +"refer to the <ulink url=\"http://ant.apache.org/manual/index.html\">Ant " +"manual</ulink>. After you have installed Ant, we can start to create the " +"buildfile. It will be called <literal>build.xml</literal> and placed " +"directly in the development directory." +msgstr "" +"それではAntを使ってチュートリアルをビルドしましょう。 それにはAntがインストー" +"ルされていなければなりません。 <ulink url=\"http://ant.apache.org/" +"bindownload.cgi\">Antダウンロードページ</ulink> からダウンロードしてくださ" +"い。 Antのインストール方法はここでは説明しませんので、 <ulink url=\"http://" +"ant.apache.org/manual/index.html\">Antマニュアル</ulink> を参照してくださ" +"い。 Antをインストールすれば、ビルドファイルの作成を開始できます。 このファイ" +"ルは <literal>build.xml</literal> と呼ばれ、開発ディレクトリに直接配置しま" +"す。" -#: index.docbook:316 +#. Tag: para +#: tutorial.xml:316 +#, no-c-format msgid "A basic build file looks like this:" msgstr "基本的なビルドファイルはこのようになります：" -#: index.docbook:320 +#. Tag: programlisting +#: tutorial.xml:320 +#, no-c-format msgid "" - "<![CDATA[<project name=\"hibernate-tutorial\" default=\"compile\">\n" - "\n" - " <property name=\"sourcedir\" value=\"${basedir}/src\"/>\n" - " <property name=\"targetdir\" value=\"${basedir}/bin\"/>\n" - " <property name=\"librarydir\" value=\"${basedir}/lib\"/>\n" - "\n" - " <path id=\"libraries\">\n" - " <fileset dir=\"${librarydir}\">\n" - " <include name=\"*.jar\"/>\n" - " </fileset>\n" - " </path>\n" - "\n" - " <target name=\"clean\">\n" - " <delete dir=\"${targetdir}\"/>\n" - " <mkdir dir=\"${targetdir}\"/>\n" - " </target>\n" - "\n" - " <target name=\"compile\" depends=\"clean, copy-resources\">\n" - " <javac srcdir=\"${sourcedir}\"\n" - " destdir=\"${targetdir}\"\n" - " classpathref=\"libraries\"/>\n" - " </target>\n" - "\n" - " <target name=\"copy-resources\">\n" - " <copy todir=\"${targetdir}\">\n" - " <fileset dir=\"${sourcedir}\">\n" - " <exclude name=\"**/*.java\"/>\n" - " </fileset>\n" - " </copy>\n" - " </target>\n" - "\n" - "</project>]]>" +"<![CDATA[<project name=\"hibernate-tutorial\" default=\"compile\">\n" +"\n" +" <property name=\"sourcedir\" value=\"${basedir}/src\"/>\n" +" <property name=\"targetdir\" value=\"${basedir}/bin\"/>\n" +" <property name=\"librarydir\" value=\"${basedir}/lib\"/>\n" +"\n" +" <path id=\"libraries\">\n" +" <fileset dir=\"${librarydir}\">\n" +" <include name=\"*.jar\"/>\n" +" </fileset>\n" +" </path>\n" +"\n" +" <target name=\"clean\">\n" +" <delete dir=\"${targetdir}\"/>\n" +" <mkdir dir=\"${targetdir}\"/>\n" +" </target>\n" +"\n" +" <target name=\"compile\" depends=\"clean, copy-resources\">\n" +" <javac srcdir=\"${sourcedir}\"\n" +" destdir=\"${targetdir}\"\n" +" classpathref=\"libraries\"/>\n" +" </target>\n" +"\n" +" <target name=\"copy-resources\">\n" +" <copy todir=\"${targetdir}\">\n" +" <fileset dir=\"${sourcedir}\">\n" +" <exclude name=\"**/*.java\"/>\n" +" </fileset>\n" +" </copy>\n" +" </target>\n" +"\n" +"</project>]]>" msgstr "" - "<![CDATA[<project name=\"hibernate-tutorial\" default=\"compile\"> -\n" - " -\n" - " <property name=\"sourcedir\" value=\"${basedir}/src\"/> -\n" - " <property name=\"targetdir\" value=\"${basedir}/bin\"/> -\n" - " <property name=\"librarydir\" value=\"${basedir}/lib\"/> -\n" - " -\n" - " <path id=\"libraries\"> -\n" - " <fileset dir=\"${librarydir}\"> -\n" - " <include name=\"*.jar\"/> -\n" - " </fileset> -\n" - " </path> -\n" - " -\n" - " <target name=\"clean\"> -\n" - " <delete dir=\"${targetdir}\"/> -\n" - " <mkdir dir=\"${targetdir}\"/> -\n" - " </target> -\n" - " -\n" - " <target name=\"compile\" depends=\"clean, copy-resources\"> -\n" - " <javac srcdir=\"${sourcedir}\" -\n" - " destdir=\"${targetdir}\" -\n" - " classpathref=\"libraries\"/> -\n" - " </target> -\n" - " -\n" - " <target name=\"copy-resources\"> -\n" - " <copy todir=\"${targetdir}\"> -\n" - " <fileset dir=\"${sourcedir}\"> -\n" - " <exclude name=\"**/*.java\"/> -\n" - " </fileset> -\n" - " </copy> -\n" - " </target> -\n" - " -\n" - "</project>]]>" -#: index.docbook:322 -msgid "This will tell Ant to add all files in the lib directory ending with <literal>.jar</literal> to the classpath used for compilation. It will also copy all non-Java source files to the target directory, e.g. configuration and Hibernate mapping files. If you now run Ant, you should get this output:" -msgstr "これは <literal>.jar</literal> で終わるlibディレクトリのすべてのファイルを、 コンパイルに使用するクラスパスに追加することをAntに教えます。 また、Javaソースファイルでないすべてのファイルをターゲットディレクトリにコピーするということでもあります。 例えば設定ファイルやHibernateマッピングファイルなどです。 今Antを実行すると、このような出力があるはずです：" +#. Tag: para +#: tutorial.xml:322 +#, no-c-format +msgid "" +"This will tell Ant to add all files in the lib directory ending with " +"<literal>.jar</literal> to the classpath used for compilation. It will also " +"copy all non-Java source files to the target directory, e.g. configuration " +"and Hibernate mapping files. If you now run Ant, you should get this output:" +msgstr "" +"これは <literal>.jar</literal> で終わるlibディレクトリのすべてのファイルを、 " +"コンパイルに使用するクラスパスに追加することをAntに教えます。 また、Javaソー" +"スファイルでないすべてのファイルをターゲットディレクトリにコピーするというこ" +"とでもあります。 例えば設定ファイルやHibernateマッピングファイルなどです。 今" +"Antを実行すると、このような出力があるはずです：" -#: index.docbook:329 +#. Tag: programlisting +#: tutorial.xml:329 +#, no-c-format msgid "" - "<![CDATA[C:\\hibernateTutorial\\>ant\n" - "Buildfile: build.xml\n" - "\n" - "copy-resources:\n" - " [copy] Copying 2 files to C:\\hibernateTutorial\\bin\n" - "\n" - "compile:\n" - " [javac] Compiling 1 source file to C:\\hibernateTutorial\\bin\n" - "\n" - "BUILD SUCCESSFUL\n" - "Total time: 1 second ]]>" +"<![CDATA[C:\\hibernateTutorial\\>ant\n" +"Buildfile: build.xml\n" +"\n" +"copy-resources:\n" +" [copy] Copying 2 files to C:\\hibernateTutorial\\bin\n" +"\n" +"compile:\n" +" [javac] Compiling 1 source file to C:\\hibernateTutorial\\bin\n" +"\n" +"BUILD SUCCESSFUL\n" +"Total time: 1 second ]]>" msgstr "" - "<![CDATA[C:¥hibernateTutorial¥>ant -\n" - "Buildfile: build.xml -\n" - " -\n" - "copy-resources: -\n" - " [copy] Copying 2 files to C:¥hibernateTutorial¥bin -\n" - " -\n" - "compile: -\n" - " [javac] Compiling 1 source file to C:¥hibernateTutorial¥bin -\n" - " -\n" - "BUILD SUCCESSFUL -\n" - "Total time: 1 second ]]>" -#: index.docbook:334 +#. Tag: title +#: tutorial.xml:334 +#, no-c-format msgid "Startup and helpers" msgstr "スタートアップとヘルパ" -#: index.docbook:336 -msgid "It's time to load and store some <literal>Event</literal> objects, but first we have to complete the setup with some infrastructure code. We have to startup Hibernate. This startup includes building a global <literal>SessionFactory</literal> object and to store it somewhere for easy access in application code. A <literal>SessionFactory</literal> can open up new <literal>Session</literal>'s. A <literal>Session</literal> represents a single-threaded unit of work, the <literal>SessionFactory</literal> is a thread-safe global object, instantiated once." -msgstr "さて <literal>Event</literal> オブジェクトをロードしたり格納したりする準備ができました。 しかしまずはインフラストラクチャのコードを書いて、セットアップを完了する必要があります。 まずはHibernateをスタートアップしなければなりません。 このスタートアップには、グローバルの <literal>SessionFactory</literal> オブジェクトを生成して、 それをアプリケーションのコードでアクセスしやすい場所に格納することが含まれます。 <literal>SessionFactory</literal> は新しく <literal>Session</literal> をオープンすることができます。 <literal>Session</literal> はシングルスレッドの作業単位(Unit of Work)を表現します。 それに対し<literal>SessionFactory</literal> はスレッドセーフのグローバルオブジェクトであり、 一度だけインスタンス化されます。" +#. Tag: para +#: tutorial.xml:336 +#, no-c-format +msgid "" +"It's time to load and store some <literal>Event</literal> objects, but first " +"we have to complete the setup with some infrastructure code. We have to " +"startup Hibernate. This startup includes building a global " +"<literal>SessionFactory</literal> object and to store it somewhere for easy " +"access in application code. A <literal>SessionFactory</literal> can open up " +"new <literal>Session</literal>'s. A <literal>Session</literal> represents a " +"single-threaded unit of work, the <literal>SessionFactory</literal> is a " +"thread-safe global object, instantiated once." +msgstr "" +"さて <literal>Event</literal> オブジェクトをロードしたり格納したりする準備が" +"できました。 しかしまずはインフラストラクチャのコードを書いて、セットアップを" +"完了する必要があります。 まずはHibernateをスタートアップしなければなりませ" +"ん。 このスタートアップには、グローバルの <literal>SessionFactory</literal> " +"オブジェクトを生成して、 それをアプリケーションのコードでアクセスしやすい場所" +"に格納することが含まれます。 <literal>SessionFactory</literal> は新しく " +"<literal>Session</literal> をオープンすることができます。 <literal>Session</" +"literal> はシングルスレッドの作業単位(Unit of Work)を表現します。 それに対し" +"<literal>SessionFactory</literal> はスレッドセーフのグローバルオブジェクトで" +"あり、 一度だけインスタンス化されます。" -#: index.docbook:346 -msgid "We'll create a <literal>HibernateUtil</literal> helper class which takes care of startup and makes accessing a <literal>SessionFactory</literal> convenient. Let's have a look at the implementation:" -msgstr "ここでスタートアップを行い、 便利に <literal>SessionFactory</literal> へアクセスする <literal>HibernateUtil</literal> ヘルパクラスを作成します。 実装を見てみましょう：" +#. Tag: para +#: tutorial.xml:346 +#, no-c-format +msgid "" +"We'll create a <literal>HibernateUtil</literal> helper class which takes " +"care of startup and makes accessing a <literal>SessionFactory</literal> " +"convenient. Let's have a look at the implementation:" +msgstr "" +"ここでスタートアップを行い、 便利に <literal>SessionFactory</literal> へアク" +"セスする <literal>HibernateUtil</literal> ヘルパクラスを作成します。 実装を見" +"てみましょう：" -#: index.docbook:352 +#. Tag: programlisting +#: tutorial.xml:352 +#, no-c-format msgid "" - "<![CDATA[package util;\n" - "\n" - "import org.hibernate.*;\n" - "import org.hibernate.cfg.*;\n" - "\n" - "public class HibernateUtil {\n" - "\n" - " private static final SessionFactory sessionFactory;\n" - "\n" - " static {\n" - " try {\n" - " // Create the SessionFactory from hibernate.cfg.xml\n" - " sessionFactory = new Configuration().configure().buildSessionFactory();\n" - " } catch (Throwable ex) {\n" - " // Make sure you log the exception, as it might be swallowed\n" - " System.err.println(\"Initial SessionFactory creation failed.\" + ex);\n" - " throw new ExceptionInInitializerError(ex);\n" - " }\n" - " }\n" - "\n" - " public static SessionFactory getSessionFactory() {\n" - " return sessionFactory;\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[package util;\n" +"\n" +"import org.hibernate.*;\n" +"import org.hibernate.cfg.*;\n" +"\n" +"public class HibernateUtil {\n" +"\n" +" private static final SessionFactory sessionFactory;\n" +"\n" +" static {\n" +" try {\n" +" // Create the SessionFactory from hibernate.cfg.xml\n" +" sessionFactory = new Configuration().configure()." +"buildSessionFactory();\n" +" } catch (Throwable ex) {\n" +" // Make sure you log the exception, as it might be swallowed\n" +" System.err.println(\"Initial SessionFactory creation failed.\" + " +"ex);\n" +" throw new ExceptionInInitializerError(ex);\n" +" }\n" +" }\n" +"\n" +" public static SessionFactory getSessionFactory() {\n" +" return sessionFactory;\n" +" }\n" +"\n" +"}]]>" msgstr "" - "<![CDATA[package util; -\n" - " -\n" - "import org.hibernate.*; -\n" - "import org.hibernate.cfg.*; -\n" - " -\n" - "public class HibernateUtil { -\n" - " -\n" - " private static final SessionFactory sessionFactory; -\n" - " -\n" - " static { -\n" - " try { -\n" - " // Create the SessionFactory from hibernate.cfg.xml -\n" - " sessionFactory = new Configuration().configure().buildSessionFactory(); -\n" - " } catch (Throwable ex) { -\n" - " // Make sure you log the exception, as it might be swallowed -\n" - " System.err.println(\"Initial SessionFactory creation failed.\" + ex); -\n" - " throw new ExceptionInInitializerError(ex); -\n" - " } -\n" - " } -\n" - " -\n" - " public static SessionFactory getSessionFactory() { -\n" - " return sessionFactory; -\n" - " } -\n" - " -\n" - "}]]>" -#: index.docbook:354 -msgid "This class does not only produce the global <literal>SessionFactory</literal> in its static initializer (called once by the JVM when the class is loaded), but also hides the fact that it uses a static singleton. It might as well lookup the <literal>SessionFactory</literal> from JNDI in an application server." -msgstr "このクラスは静的初期化ブロック（クラスがロードされるときにJVMによって一度だけ呼ばれる） でグローバルの <literal>SessionFactory</literal> を生成するだけではなく、 静的シングルトンの使用を隠蔽します。 アプリケーションサーバーのJNDIから <literal>SessionFactory</literal> を ルックアップするのと同様です。" +#. Tag: para +#: tutorial.xml:354 +#, no-c-format +msgid "" +"This class does not only produce the global <literal>SessionFactory</" +"literal> in its static initializer (called once by the JVM when the class is " +"loaded), but also hides the fact that it uses a static singleton. It might " +"as well lookup the <literal>SessionFactory</literal> from JNDI in an " +"application server." +msgstr "" +"このクラスは静的初期化ブロック（クラスがロードされるときにJVMによって一度だけ" +"呼ばれる） でグローバルの <literal>SessionFactory</literal> を生成するだけで" +"はなく、 静的シングルトンの使用を隠蔽します。 アプリケーションサーバーのJNDI" +"から <literal>SessionFactory</literal> を ルックアップするのと同様です。" -#: index.docbook:361 -msgid "If you give the <literal>SessionFactory</literal> a name in your configuration file, Hibernate will in fact try to bind it to JNDI after it has been built. To avoid this code completely you could also use JMX deployment and let the JMX-capable container instantiate and bind a <literal>HibernateService</literal> to JNDI. These advanced options are discussed in the Hibernate reference documentation." -msgstr "設定ファイル内で <literal>SessionFactory</literal> に名前を与えると、 Hibernateは <literal>SessionFactory</literal> 構築後にJNDIに対しバインドを行おうとします。 このコードを完全に排除するためには、 JMXデプロイメントを利用して JMXを利用できるコンテナをインスタンス化し、 <literal>HibernateService</literal> をJNDIへバインドすることもできます。 これらの高度なオプションは、Hibernateのリファレンスドキュメントで説明されています。" +#. Tag: para +#: tutorial.xml:361 +#, no-c-format +msgid "" +"If you give the <literal>SessionFactory</literal> a name in your " +"configuration file, Hibernate will in fact try to bind it to JNDI after it " +"has been built. To avoid this code completely you could also use JMX " +"deployment and let the JMX-capable container instantiate and bind a " +"<literal>HibernateService</literal> to JNDI. These advanced options are " +"discussed in the Hibernate reference documentation." +msgstr "" +"設定ファイル内で <literal>SessionFactory</literal> に名前を与えると、 " +"Hibernateは <literal>SessionFactory</literal> 構築後にJNDIに対しバインドを行" +"おうとします。 このコードを完全に排除するためには、 JMXデプロイメントを利用し" +"て JMXを利用できるコンテナをインスタンス化し、 <literal>HibernateService</" +"literal> をJNDIへバインドすることもできます。 これらの高度なオプションは、" +"Hibernateのリファレンスドキュメントで説明されています。" -#: index.docbook:370 -msgid "Place <literal>HibernateUtil.java</literal> in the development source directory, in a package next to <literal>events</literal>:" -msgstr "<literal>HibernateUtil.java</literal> を開発ソースディレクトリにある <literal>events</literal> パッケージの 隣に配置してください。" +#. Tag: para +#: tutorial.xml:370 +#, no-c-format +msgid "" +"Place <literal>HibernateUtil.java</literal> in the development source " +"directory, in a package next to <literal>events</literal>:" +msgstr "" +"<literal>HibernateUtil.java</literal> を開発ソースディレクトリにある " +"<literal>events</literal> パッケージの 隣に配置してください。" -#: index.docbook:375 +#. Tag: programlisting +#: tutorial.xml:375 +#, no-c-format msgid "" - "<![CDATA[.\n" - "+lib\n" - " <Hibernate and third-party libraries>\n" - "+src\n" - " +events\n" - " Event.java\n" - " Event.hbm.xml\n" - " +util\n" - " HibernateUtil.java\n" - " hibernate.cfg.xml\n" - "+data\n" - "build.xml]]>" +"<![CDATA[.\n" +"+lib\n" +" <Hibernate and third-party libraries>\n" +"+src\n" +" +events\n" +" Event.java\n" +" Event.hbm.xml\n" +" +util\n" +" HibernateUtil.java\n" +" hibernate.cfg.xml\n" +"+data\n" +"build.xml]]>" msgstr "" - "<![CDATA[. -\n" - "+lib -\n" - " <Hibernate and third-party libraries> -\n" - "+src -\n" - " +events -\n" - " Event.java -\n" - " Event.hbm.xml -\n" - " +util -\n" - " HibernateUtil.java -\n" - " hibernate.cfg.xml -\n" - "+data -\n" - "build.xml]]>" -#: index.docbook:377 -msgid "This should again compile without problems. We finally need to configure a logging system - Hibernate uses commons logging and leaves you the choice between Log4j and JDK 1.4 logging. Most developers prefer Log4j: copy <literal>log4j.properties</literal> from the Hibernate distribution (it's in the <literal>etc/</literal> directory) to your <literal>src</literal> directory, next to <literal>hibernate.cfg.xml</literal>. Have a look at the example configuration and change the settings if you like to have more verbose output. By default, only Hibernate startup message are shown on stdout." -msgstr "これは問題なく再コンパイルできるはずです。 最後にロギングシステムを設定する必要があります。 Hibernateはcommons loggingを使うため、Log4jとJDK 1.4 loggingの選択をする必要がありません。 ほとんどの開発者が好むのはLog4jです。 Hibernateディストリビューション（の<literal>etc/</literal> ディレクトリ）から <literal>log4j.properties</literal> をあなたの <literal>src</literal> ディレクトリ内の <literal>hibernate.cfg.xml</literal> の隣にコピーしてください。 設定例を見て、冗長な出力がよければ設定を変更してください。 デフォルトではHibernateのスタートアップメッセージだけが標準出力に表示されます。" +#. Tag: para +#: tutorial.xml:377 +#, no-c-format +msgid "" +"This should again compile without problems. We finally need to configure a " +"logging system - Hibernate uses commons logging and leaves you the choice " +"between Log4j and JDK 1.4 logging. Most developers prefer Log4j: copy " +"<literal>log4j.properties</literal> from the Hibernate distribution (it's in " +"the <literal>etc/</literal> directory) to your <literal>src</literal> " +"directory, next to <literal>hibernate.cfg.xml</literal>. Have a look at the " +"example configuration and change the settings if you like to have more " +"verbose output. By default, only Hibernate startup message are shown on " +"stdout." +msgstr "" +"これは問題なく再コンパイルできるはずです。 最後にロギングシステムを設定する必" +"要があります。 Hibernateはcommons loggingを使うため、Log4jとJDK 1.4 loggingの" +"選択をする必要がありません。 ほとんどの開発者が好むのはLog4jです。 Hibernate" +"ディストリビューション（の<literal>etc/</literal> ディレクトリ）から " +"<literal>log4j.properties</literal> をあなたの <literal>src</literal> ディレ" +"クトリ内の <literal>hibernate.cfg.xml</literal> の隣にコピーしてください。 設" +"定例を見て、冗長な出力がよければ設定を変更してください。 デフォルトでは" +"Hibernateのスタートアップメッセージだけが標準出力に表示されます。" -#: index.docbook:387 -msgid "The tutorial infrastructure is complete - and we are ready to do some real work with Hibernate." -msgstr "チュートリアルのインフラは完全です。 Hibernateを使って実際の作業をする準備が整いました。" +#. Tag: para +#: tutorial.xml:387 +#, no-c-format +msgid "" +"The tutorial infrastructure is complete - and we are ready to do some real " +"work with Hibernate." +msgstr "" +"チュートリアルのインフラは完全です。 Hibernateを使って実際の作業をする準備が" +"整いました。" -#: index.docbook:395 +#. Tag: title +#: tutorial.xml:395 +#, no-c-format msgid "Loading and storing objects" msgstr "オブジェクトのロードと格納" -#: index.docbook:397 -msgid "Finally, we can use Hibernate to load and store objects. We write an <literal>EventManager</literal> class with a <literal>main()</literal> method:" -msgstr "ついにオブジェクトのロードと格納にHibernateを使うことができます。 <literal>main()</literal> メソッドを持つ <literal>EventManager</literal> クラスを書きます：" +#. Tag: para +#: tutorial.xml:397 +#, no-c-format +msgid "" +"Finally, we can use Hibernate to load and store objects. We write an " +"<literal>EventManager</literal> class with a <literal>main()</literal> " +"method:" +msgstr "" +"ついにオブジェクトのロードと格納にHibernateを使うことができます。 " +"<literal>main()</literal> メソッドを持つ <literal>EventManager</literal> クラ" +"スを書きます：" -#: index.docbook:402 +#. Tag: programlisting +#: tutorial.xml:402 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "import org.hibernate.Session;\n" - "\n" - "import java.util.Date;\n" - "\n" - "import util.HibernateUtil;\n" - "\n" - "public class EventManager {\n" - "\n" - " public static void main(String[] args) {\n" - " EventManager mgr = new EventManager();\n" - "\n" - " if (args[0].equals(\"store\")) {\n" - " mgr.createAndStoreEvent(\"My Event\", new Date());\n" - " }\n" - "\n" - " HibernateUtil.getSessionFactory().close();\n" - " }\n" - "\n" - " private void createAndStoreEvent(String title, Date theDate) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - "\n" - " session.beginTransaction();\n" - "\n" - " Event theEvent = new Event();\n" - " theEvent.setTitle(title);\n" - " theEvent.setDate(theDate);\n" - "\n" - " session.save(theEvent);\n" - "\n" - " session.getTransaction().commit();\n" - " }\n" - "\n" - "}]]>" +"<![CDATA[package events;\n" +"import org.hibernate.Session;\n" +"\n" +"import java.util.Date;\n" +"\n" +"import util.HibernateUtil;\n" +"\n" +"public class EventManager {\n" +"\n" +" public static void main(String[] args) {\n" +" EventManager mgr = new EventManager();\n" +"\n" +" if (args[0].equals(\"store\")) {\n" +" mgr.createAndStoreEvent(\"My Event\", new Date());\n" +" }\n" +"\n" +" HibernateUtil.getSessionFactory().close();\n" +" }\n" +"\n" +" private void createAndStoreEvent(String title, Date theDate) {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +"\n" +" session.beginTransaction();\n" +"\n" +" Event theEvent = new Event();\n" +" theEvent.setTitle(title);\n" +" theEvent.setDate(theDate);\n" +"\n" +" session.save(theEvent);\n" +"\n" +" session.getTransaction().commit();\n" +" }\n" +"\n" +"}]]>" msgstr "" - "<![CDATA[package events; -\n" - "import org.hibernate.Session; -\n" - " -\n" - "import java.util.Date; -\n" - " -\n" - "import util.HibernateUtil; -\n" - " -\n" - "public class EventManager { -\n" - " -\n" - " public static void main(String[] args) { -\n" - " EventManager mgr = new EventManager(); -\n" - " -\n" - " if (args[0].equals(\"store\")) { -\n" - " mgr.createAndStoreEvent(\"My Event\", new Date()); -\n" - " } -\n" - " -\n" - " HibernateUtil.getSessionFactory().close(); -\n" - " } -\n" - " -\n" - " private void createAndStoreEvent(String title, Date theDate) { -\n" - " -\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession(); -\n" - " -\n" - " session.beginTransaction(); -\n" - " -\n" - " Event theEvent = new Event(); -\n" - " theEvent.setTitle(title); -\n" - " theEvent.setDate(theDate); -\n" - " -\n" - " session.save(theEvent); -\n" - " -\n" - " session.getTransaction().commit(); -\n" - " } -\n" - " -\n" - "}]]>" -#: index.docbook:404 -msgid "We create a new <literal>Event</literal> object, and hand it over to Hibernate. Hibernate now takes care of the SQL and executes <literal>INSERT</literal>s on the database. Let's have a look at the <literal>Session</literal> and <literal>Transaction</literal>-handling code before we run this." -msgstr "新しい <literal>Event</literal> オブジェクトを生成し、それをHibernateに渡します。 今ではHibernateがSQLを処理し、データベースで <literal>INSERT</literal> を実行します。 実行前に <literal>Session</literal> と <literal>Transaction</literal> を処理するコードを確認してください。" +#. Tag: para +#: tutorial.xml:404 +#, no-c-format +msgid "" +"We create a new <literal>Event</literal> object, and hand it over to " +"Hibernate. Hibernate now takes care of the SQL and executes <literal>INSERT</" +"literal>s on the database. Let's have a look at the <literal>Session</" +"literal> and <literal>Transaction</literal>-handling code before we run this." +msgstr "" +"新しい <literal>Event</literal> オブジェクトを生成し、それをHibernateに渡しま" +"す。 今ではHibernateがSQLを処理し、データベースで <literal>INSERT</literal> " +"を実行します。 実行前に <literal>Session</literal> と <literal>Transaction</" +"literal> を処理するコードを確認してください。" -#: index.docbook:411 -msgid "A <literal>Session</literal> is a single unit of work. For now we'll keep things simple and assume a one-to-one granularity between a Hibernate <literal>Session</literal> and a database transaction. To shield our code from the actual underlying transaction system (in this case plain JDBC, but it could also run with JTA) we use the <literal>Transaction</literal> API that is available on the Hibernate <literal>Session</literal>." -msgstr "<literal>Session</literal> は1つの作業単位(Unit of Work)です。 当分の間、話を簡単にするために、 <literal>Session</literal> と <literal>Transaction</literal> の対応を一対一と仮定します。 使用しているトランザクション・システム（このケースではJTAと共存できる単純なJDBC）からコードを保護するために、 Hibernate <literal>Session</literal> 上で利用可能な <literal>Transaction</literal> APIを使用します。" +#. Tag: para +#: tutorial.xml:411 +#, no-c-format +msgid "" +"A <literal>Session</literal> is a single unit of work. For now we'll keep " +"things simple and assume a one-to-one granularity between a Hibernate " +"<literal>Session</literal> and a database transaction. To shield our code " +"from the actual underlying transaction system (in this case plain JDBC, but " +"it could also run with JTA) we use the <literal>Transaction</literal> API " +"that is available on the Hibernate <literal>Session</literal>." +msgstr "" +"<literal>Session</literal> は1つの作業単位(Unit of Work)です。 当分の間、話を" +"簡単にするために、 <literal>Session</literal> と <literal>Transaction</" +"literal> の対応を一対一と仮定します。 使用しているトランザクション・システム" +"（このケースではJTAと共存できる単純なJDBC）からコードを保護するために、 " +"Hibernate <literal>Session</literal> 上で利用可能な <literal>Transaction</" +"literal> APIを使用します。" -#: index.docbook:419 -msgid "What does <literal>sessionFactory.getCurrentSession()</literal> do? First, you can call it as many times and anywhere you like, once you get hold of your <literal>SessionFactory</literal> (easy thanks to <literal>HibernateUtil</literal>). The <literal>getCurrentSession()</literal> method always returns the \"current\" unit of work. Remember that we switched the configuration option for this mechanism to \"thread\" in <literal>hibernate.cfg.xml</literal>? Hence, the current unit of work is bound to the current Java thread that executes our application. However, this is not the full picture, you also have to consider scope, when a unit of work begins and when it ends." -msgstr "<literal>sessionFactory.getCurrentSession()</literal> はなにをするのでしょうか？ まず、いったん <literal>SessionFactory</literal> を取得し保持すれば （ <literal>HibernateUtil</literal> のおかげで簡単です）、このメソッドを何度でも、 どこからでも呼び出すことが出来ます。 <literal>getCurrentSession()</literal> メソッドは常に「現在の」作業単位(Unit of Work)を返します。 <literal>hibernate.cfg.xml</literal> のこの機能の設定で、\"thread\"を指定したことを思い出してください。 このため現在の作業単位のスコープは、このアプリケーションを実行する現在のJavaスレッドです。 しかしこれで全てではありません。 <literal>Session</literal> は最初に必要となったとき、つまり最初に <literal>getCurrentSession()</literal> が 呼ばれたときに開始します。 そのときHibernateにより現在�! ��スレッドに結び付けられます。 トランザクションが終了（コミットもしくはロールバック）したとき、 Hibernateもスレッドから <literal>Session</literal> を切り離し、クローズします。 再び <literal>getCurrentSession()</literal> を呼ぶと、 新しい <literal>Session</literal> を取得して新しい作業単位をスタートできます。 この <emphasis>thread-bound</emphasis> プログラミング・モデルはHibernateを利用する上で最も人気があります。" +#. Tag: para +#: tutorial.xml:419 +#, no-c-format +msgid "" +"What does <literal>sessionFactory.getCurrentSession()</literal> do? First, " +"you can call it as many times and anywhere you like, once you get hold of " +"your <literal>SessionFactory</literal> (easy thanks to " +"<literal>HibernateUtil</literal>). The <literal>getCurrentSession()</" +"literal> method always returns the \"current\" unit of work. Remember that " +"we switched the configuration option for this mechanism to \"thread\" in " +"<literal>hibernate.cfg.xml</literal>? Hence, the current unit of work is " +"bound to the current Java thread that executes our application. However, " +"this is not the full picture, you also have to consider scope, when a unit " +"of work begins and when it ends." +msgstr "" +"<literal>sessionFactory.getCurrentSession()</literal> はなにをするのでしょう" +"か？ まず、いったん <literal>SessionFactory</literal> を取得し保持すれば " +"（ <literal>HibernateUtil</literal> のおかげで簡単です）、このメソッドを何度" +"でも、 どこからでも呼び出すことが出来ます。 <literal>getCurrentSession()</" +"literal> メソッドは常に「現在の」作業単位(Unit of Work)を返します。 " +"<literal>hibernate.cfg.xml</literal> のこの機能の設定で、\"thread\"を指定した" +"ことを思い出してください。 このため現在の作業単位のスコープは、このアプリケー" +"ションを実行する現在のJavaスレッドです。 しかしこれで全てではありません。" -#: index.docbook:430 -msgid "A <literal>Session</literal> begins when it is first needed, when the first call to <literal>getCurrentSession()</literal> is made. It is then bound by Hibernate to the current thread. When the transaction ends, either through commit or rollback, Hibernate automatically unbinds the <literal>Session</literal> from the thread and closes it for you. If you call <literal>getCurrentSession()</literal> again, you get a new <literal>Session</literal> and can start a new unit of work. This <emphasis>thread-bound</emphasis> programming model is the most popular way of using Hibernate, as it allows flexible layering of your code (transaction demarcation code can be separated from data access code, we'll do this later in this tutorial)." -msgstr "トランザクションの扱いと境界の詳しい情報については、 <xref linkend=\"transactions\"/> を見てください。 この例ではエラー処理やロールバックも割愛します。" +#. Tag: para +#: tutorial.xml:430 +#, no-c-format +msgid "" +"A <literal>Session</literal> begins when it is first needed, when the first " +"call to <literal>getCurrentSession()</literal> is made. It is then bound by " +"Hibernate to the current thread. When the transaction ends, either through " +"commit or rollback, Hibernate automatically unbinds the <literal>Session</" +"literal> from the thread and closes it for you. If you call " +"<literal>getCurrentSession()</literal> again, you get a new " +"<literal>Session</literal> and can start a new unit of work. This " +"<emphasis>thread-bound</emphasis> programming model is the most popular way " +"of using Hibernate, as it allows flexible layering of your code (transaction " +"demarcation code can be separated from data access code, we'll do this later " +"in this tutorial)." +msgstr "" +"<literal>Session</literal> は最初に必要となったとき、つまり最初に " +"<literal>getCurrentSession()</literal> が 呼ばれたときに開始します。 そのとき" +"Hibernateにより現在のスレッドに結び付けられます。 トランザクションが終了（コ" +"ミットもしくはロールバック）したとき、 Hibernateもスレッドから " +"<literal>Session</literal> を切り離し、クローズします。 再び " +"<literal>getCurrentSession()</literal> を呼ぶと、 新しい <literal>Session</" +"literal> を取得して新しい作業単位をスタートできます。 この <emphasis>thread-" +"bound</emphasis> プログラミング・モデルはHibernateを利用する上で最も人気があ" +"ります。" -#: index.docbook:441 -msgid "Related to the unit of work scope, should the Hibernate <literal>Session</literal> be used to execute one or several database operations? The above example uses one <literal>Session</literal> for one operation. This is pure coincidence, the example is just not complex enough to show any other approach. The scope of a Hibernate <literal>Session</literal> is flexible but you should never design your application to use a new Hibernate <literal>Session</literal> for <emphasis>every</emphasis> database operation. So even if you see it a few more times in the following (very trivial) examples, consider <emphasis>session-per-operation</emphasis> an anti-pattern. A real (web) application is shown later in this tutorial." -msgstr "この最初のルーチンを実行するには、Antのビルドファイルに呼び出し可能なターゲットを 追加しなければなりません：" +#. Tag: para +#: tutorial.xml:441 +#, no-c-format +msgid "" +"Related to the unit of work scope, should the Hibernate <literal>Session</" +"literal> be used to execute one or several database operations? The above " +"example uses one <literal>Session</literal> for one operation. This is pure " +"coincidence, the example is just not complex enough to show any other " +"approach. The scope of a Hibernate <literal>Session</literal> is flexible " +"but you should never design your application to use a new Hibernate " +"<literal>Session</literal> for <emphasis>every</emphasis> database " +"operation. So even if you see it a few more times in the following (very " +"trivial) examples, consider <emphasis>session-per-operation</emphasis> an " +"anti-pattern. A real (web) application is shown later in this tutorial." +msgstr "" +"Related to the unit of work scope, should the Hibernate <literal>Session</" +"literal> be used to execute one or several database operations? The above " +"example uses one <literal>Session</literal> for one operation. This is pure " +"coincidence, the example is just not complex enough to show any other " +"approach. The scope of a Hibernate <literal>Session</literal> is flexible " +"but you should never design your application to use a new Hibernate " +"<literal>Session</literal> for <emphasis>every</emphasis> database " +"operation. So even if you see it a few more times in the following (very " +"trivial) examples, consider <emphasis>session-per-operation</emphasis> an " +"anti-pattern. A real (web) application is shown later in this tutorial." -#: index.docbook:452 -msgid "Have a look at <xref linkend=\"transactions\"/> for more information about transaction handling and demarcation. We also skipped any error handling and rollback in the previous example." +#. Tag: para +#: tutorial.xml:452 +#, no-c-format +msgid "" +"Have a look at <xref linkend=\"transactions\"/> for more information about " +"transaction handling and demarcation. We also skipped any error handling and " +"rollback in the previous example." msgstr "" - "<![CDATA[<target name=\"run\" depends=\"compile\"> -\n" - " <java fork=\"true\" classname=\"events.EventManager\" classpathref=\"libraries\"> -\n" - " <classpath path=\"${targetdir}\"/> -\n" - " <arg value=\"${action}\"/> -\n" - " </java> -\n" - "</target>]]>" +"トランザクションの扱いと境界の詳しい情報については、 <xref linkend=" +"\"transactions\"/> を見てください。 この例ではエラー処理やロールバックも割愛" +"します。" -#: index.docbook:458 -msgid "To run this first routine we have to add a callable target to the Ant build file:" -msgstr "<literal>action</literal> 引数の値は、ターゲットを呼ぶときにコマンドラインで設定します：" +#. Tag: para +#: tutorial.xml:458 +#, no-c-format +msgid "" +"To run this first routine we have to add a callable target to the Ant build " +"file:" +msgstr "" +"この最初のルーチンを実行するには、Antのビルドファイルに呼び出し可能なターゲッ" +"トを 追加しなければなりません：" -#: index.docbook:462 +#. Tag: programlisting +#: tutorial.xml:462 +#, no-c-format msgid "" - "<![CDATA[<target name=\"run\" depends=\"compile\">\n" - " <java fork=\"true\" classname=\"events.EventManager\" classpathref=\"libraries\">\n" - " <classpath path=\"${targetdir}\"/>\n" - " <arg value=\"${action}\"/>\n" - " </java>\n" - "</target>]]>" -msgstr "<![CDATA[C:¥hibernateTutorial¥>ant run -Daction=store]]>" +"<![CDATA[<target name=\"run\" depends=\"compile\">\n" +" <java fork=\"true\" classname=\"events.EventManager\" classpathref=" +"\"libraries\">\n" +" <classpath path=\"${targetdir}\"/>\n" +" <arg value=\"${action}\"/>\n" +" </java>\n" +"</target>]]>" +msgstr "" -#: index.docbook:464 -msgid "The value of the <literal>action</literal> argument is set on the command line when calling the target:" -msgstr "コンパイルすると、Hibernateがスタートし、あなたの設定によりますが、 多くのログ出力があるはずです。 その最後には以下の行があるでしょう：" +#. Tag: para +#: tutorial.xml:464 +#, no-c-format +msgid "" +"The value of the <literal>action</literal> argument is set on the command " +"line when calling the target:" +msgstr "" +"<literal>action</literal> 引数の値は、ターゲットを呼ぶときにコマンドラインで" +"設定します：" -#: index.docbook:469 +#. Tag: programlisting +#: tutorial.xml:469 +#, no-c-format msgid "<![CDATA[C:\\hibernateTutorial\\>ant run -Daction=store]]>" -msgstr "<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]>" +msgstr "" -#: index.docbook:471 -msgid "You should see, after compilation, Hibernate starting up and, depending on your configuration, lots of log output. At the end you will find the following line:" -msgstr "これはHibernateが実行する <literal>INSERT</literal> で、 クエスチョンマークはJDBCバインドパラメータを表しています。 引数としてバインドされる値を見るため、あるいはログの冗長性を減らすためには、 <literal>log4j.properties</literal> をチェックしてください。" +#. Tag: para +#: tutorial.xml:471 +#, no-c-format +msgid "" +"You should see, after compilation, Hibernate starting up and, depending on " +"your configuration, lots of log output. At the end you will find the " +"following line:" +msgstr "" +"コンパイルすると、Hibernateがスタートし、あなたの設定によりますが、 多くのロ" +"グ出力があるはずです。 その最後には以下の行があるでしょう：" -#: index.docbook:476 -msgid "<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]>" -msgstr "それでは同じように格納されたイベントの一覧を見ようと思います。 そのためメインメソッドにオプションを追加します：" +#. Tag: programlisting +#: tutorial.xml:476 +#, no-c-format +msgid "" +"<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) " +"values (?, ?, ?)]]>" +msgstr "" -#: index.docbook:478 -msgid "This is the <literal>INSERT</literal> executed by Hibernate, the question marks represent JDBC bind parameters. To see the values bound as arguments, or to reduce the verbosity of the log, check your <literal>log4j.properties</literal>." +#. Tag: para +#: tutorial.xml:478 +#, no-c-format +msgid "" +"This is the <literal>INSERT</literal> executed by Hibernate, the question " +"marks represent JDBC bind parameters. To see the values bound as arguments, " +"or to reduce the verbosity of the log, check your <literal>log4j.properties</" +"literal>." msgstr "" - "<![CDATA[if (args[0].equals(\"store\")) { -\n" - " mgr.createAndStoreEvent(\"My Event\", new Date()); -\n" - "} -\n" - "else if (args[0].equals(\"list\")) { -\n" - " List events = mgr.listEvents(); -\n" - " for (int i = 0; i < events.size(); i++) { -\n" - " Event theEvent = (Event) events.get(i); -\n" - " System.out.println(\"Event: \" + theEvent.getTitle() + -\n" - " \" Time: \" + theEvent.getDate()); -\n" - " } -\n" - "}]]>" +"これはHibernateが実行する <literal>INSERT</literal> で、 クエスチョンマークは" +"JDBCバインドパラメータを表しています。 引数としてバインドされる値を見るため、" +"あるいはログの冗長性を減らすためには、 <literal>log4j.properties</literal> を" +"チェックしてください。" -#: index.docbook:484 -msgid "Now we'd like to list stored events as well, so we add an option to the main method:" -msgstr "新しい <literal>listEvents()メソッド</literal> も追加します。" +#. Tag: para +#: tutorial.xml:484 +#, no-c-format +msgid "" +"Now we'd like to list stored events as well, so we add an option to the main " +"method:" +msgstr "" +"それでは同じように格納されたイベントの一覧を見ようと思います。 そのためメイン" +"メソッドにオプションを追加します：" -#: index.docbook:488 +#. Tag: programlisting +#: tutorial.xml:488 +#, no-c-format msgid "" - "<![CDATA[if (args[0].equals(\"store\")) {\n" - " mgr.createAndStoreEvent(\"My Event\", new Date());\n" - "}\n" - "else if (args[0].equals(\"list\")) {\n" - " List events = mgr.listEvents();\n" - " for (int i = 0; i < events.size(); i++) {\n" - " Event theEvent = (Event) events.get(i);\n" - " System.out.println(\"Event: \" + theEvent.getTitle() +\n" - " \" Time: \" + theEvent.getDate());\n" - " }\n" - "}]]>" +"<![CDATA[if (args[0].equals(\"store\")) {\n" +" mgr.createAndStoreEvent(\"My Event\", new Date());\n" +"}\n" +"else if (args[0].equals(\"list\")) {\n" +" List events = mgr.listEvents();\n" +" for (int i = 0; i < events.size(); i++) {\n" +" Event theEvent = (Event) events.get(i);\n" +" System.out.println(\"Event: \" + theEvent.getTitle() +\n" +" \" Time: \" + theEvent.getDate());\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[private List listEvents() { -\n" - " -\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession(); -\n" - " -\n" - " session.beginTransaction(); -\n" - " -\n" - " List result = session.createQuery(\"from Event\").list(); -\n" - " -\n" - " session.getTransaction().commit(); -\n" - " -\n" - " return result; -\n" - "}]]>" -#: index.docbook:490 +#. Tag: para +#: tutorial.xml:490 +#, no-c-format msgid "We also add a new <literal>listEvents() method</literal>:" -msgstr "ここですることは、データベースから存在するすべての <literal>Event</literal> オブジェクトをロードするHQL (Hibernate Query Language) クエリを使うことです。 Hibernateは適切なSQLを生成し、それをデータベースに送り、 そのデータを使って <literal>Event</literal> オブジェクトを生成します。 当然HQLでさらに複雑なクエリを作成できます。" +msgstr "新しい <literal>listEvents()メソッド</literal> も追加します。" -#: index.docbook:494 +#. Tag: programlisting +#: tutorial.xml:494 +#, no-c-format msgid "" - "<![CDATA[private List listEvents() {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - "\n" - " session.beginTransaction();\n" - "\n" - " List result = session.createQuery(\"from Event\").list();\n" - "\n" - " session.getTransaction().commit();\n" - "\n" - " return result;\n" - "}]]>" -msgstr "以下のステップで、すべての実行とテストを行います。" +"<![CDATA[private List listEvents() {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +"\n" +" session.beginTransaction();\n" +"\n" +" List result = session.createQuery(\"from Event\").list();\n" +"\n" +" session.getTransaction().commit();\n" +"\n" +" return result;\n" +"}]]>" +msgstr "" -#: index.docbook:496 -msgid "What we do here is use an HQL (Hibernate Query Language) query to load all existing <literal>Event</literal> objects from the database. Hibernate will generate the appropriate SQL, send it to the database and populate <literal>Event</literal> objects with the data. You can create more complex queries with HQL, of course." -msgstr "hbm2ddlを通す前にデータベースのデータを作成し、データベーススキーマを生成するために、 <literal>ant run -Daction=store</literal> を実行してください。" +#. Tag: para +#: tutorial.xml:496 +#, no-c-format +msgid "" +"What we do here is use an HQL (Hibernate Query Language) query to load all " +"existing <literal>Event</literal> objects from the database. Hibernate will " +"generate the appropriate SQL, send it to the database and populate " +"<literal>Event</literal> objects with the data. You can create more complex " +"queries with HQL, of course." +msgstr "" +"ここですることは、データベースから存在するすべての <literal>Event</literal> " +"オブジェクトをロードするHQL (Hibernate Query Language) クエリを使うことで" +"す。 Hibernateは適切なSQLを生成し、それをデータベースに送り、 そのデータを" +"使って <literal>Event</literal> オブジェクトを生成します。 当然HQLでさらに複" +"雑なクエリを作成できます。" -#: index.docbook:503 +#. Tag: para +#: tutorial.xml:503 +#, no-c-format msgid "Now, to execute and test all of this, follow these steps:" -msgstr "今は <literal>hibernate.cfg.xml</literal> ファイルのプロパティをコメントアウトしてhbm2ddlを無効にしてください。 通常は継続的に単体テストをしている間はhbm2ddlを有効にしておくのですが、 それ以外の場合にhbm2ddlを起動すると格納しておいた全てのデータを <emphasis>ドロップ</emphasis> するでしょう。 設定を <literal>create</literal> にすると、結果として 「SessionFactory生成の際、スキーマから全てのテーブルをドロップして再作成する」という設定になります。" +msgstr "以下のステップで、すべての実行とテストを行います。" -#: index.docbook:509 -msgid "Run <literal>ant run -Daction=store</literal> to store something into the database and, of course, to generate the database schema before through hbm2ddl." -msgstr "今 <literal>-Daction=list</literal> と指定してAntを呼ぶと、 これまで格納したイベントが見えるはずです。 <literal>store</literal> アクションを数回以上呼ぶことも可能です。" +#. Tag: para +#: tutorial.xml:509 +#, no-c-format +msgid "" +"Run <literal>ant run -Daction=store</literal> to store something into the " +"database and, of course, to generate the database schema before through " +"hbm2ddl." +msgstr "" +"hbm2ddlを通す前にデータベースのデータを作成し、データベーススキーマを生成する" +"ために、 <literal>ant run -Daction=store</literal> を実行してください。" -#: index.docbook:515 -msgid "Now disable hbm2ddl by commenting out the property in your <literal>hibernate.cfg.xml</literal> file. Usually you only leave it turned on in continous unit testing, but another run of hbm2ddl would <emphasis>drop</emphasis> everything you have stored - the <literal>create</literal> configuration setting actually translates into \"drop all tables from the schema, then re-create all tables, when the SessionFactory is build\"." -msgstr "注意：初めてHibernateに触れる人々の多くがここで失敗するため、<emphasis>Table not found</emphasis> エラーメッセージに 関する質問を定期的に見かけます。 しかし上記のステップに従えば、hbm2ddlが最初に実行されたときにデータベーススキーマを作成し、 その後の実行においてもこのスキーマを使用するので、問題は起こらないでしょう。 マッピングやデータベーススキーマを変更したときは、もう一度hbm2ddlを有効にしてください。" +#. Tag: para +#: tutorial.xml:515 +#, no-c-format +msgid "" +"Now disable hbm2ddl by commenting out the property in your " +"<literal>hibernate.cfg.xml</literal> file. Usually you only leave it turned " +"on in continous unit testing, but another run of hbm2ddl would " +"<emphasis>drop</emphasis> everything you have stored - the <literal>create</" +"literal> configuration setting actually translates into \"drop all tables " +"from the schema, then re-create all tables, when the SessionFactory is build" +"\"." +msgstr "" +"今は <literal>hibernate.cfg.xml</literal> ファイルのプロパティをコメントアウ" +"トしてhbm2ddlを無効にしてください。 通常は継続的に単体テストをしている間は" +"hbm2ddlを有効にしておくのですが、 それ以外の場合にhbm2ddlを起動すると格納して" +"おいた全てのデータを <emphasis>ドロップ</emphasis> するでしょう。 設定を " +"<literal>create</literal> にすると、結果として 「SessionFactory生成の際、ス" +"キーマから全てのテーブルをドロップして再作成する」という設定になります。" -#: index.docbook:525 -msgid "If you now call Ant with <literal>-Daction=list</literal>, you should see the events you have stored so far. You can of course also call the <literal>store</literal> action a few times more." -msgstr "パート2 - 関連のマッピング" +#. Tag: para +#: tutorial.xml:525 +#, no-c-format +msgid "" +"If you now call Ant with <literal>-Daction=list</literal>, you should see " +"the events you have stored so far. You can of course also call the " +"<literal>store</literal> action a few times more." +msgstr "" +"今 <literal>-Daction=list</literal> と指定してAntを呼ぶと、 これまで格納した" +"イベントが見えるはずです。 <literal>store</literal> アクションを数回以上呼ぶ" +"ことも可能です。" -#: index.docbook:531 -msgid "Note: Most new Hibernate users fail at this point and we see questions about <emphasis>Table not found</emphasis> error messages regularly. However, if you follow the steps outlined above you will not have this problem, as hbm2ddl creates the database schema on the first run, and subsequent application restarts will use this schema. If you change the mapping and/or database schema, you have to re-enable hbm2ddl once again." -msgstr "永続エンティティクラスをテーブルにマッピングしました。 さらにこの上にいくつかのクラスの関連を追加しましょう。 まず初めにアプリケーションに人々を追加し、彼らが参加するイベントのリストを格納します。" +#. Tag: para +#: tutorial.xml:531 +#, no-c-format +msgid "" +"Note: Most new Hibernate users fail at this point and we see questions about " +"<emphasis>Table not found</emphasis> error messages regularly. However, if " +"you follow the steps outlined above you will not have this problem, as " +"hbm2ddl creates the database schema on the first run, and subsequent " +"application restarts will use this schema. If you change the mapping and/or " +"database schema, you have to re-enable hbm2ddl once again." +msgstr "" +"注意：初めてHibernateに触れる人々の多くがここで失敗するため、<emphasis>Table " +"not found</emphasis> エラーメッセージに 関する質問を定期的に見かけます。 しか" +"し上記のステップに従えば、hbm2ddlが最初に実行されたときにデータベーススキーマ" +"を作成し、 その後の実行においてもこのスキーマを使用するので、問題は起こらない" +"でしょう。 マッピングやデータベーススキーマを変更したときは、もう一度hbm2ddl" +"を有効にしてください。" -#: index.docbook:544 +#. Tag: title +#: tutorial.xml:544 +#, no-c-format msgid "Part 2 - Mapping associations" -msgstr "Personクラスのマッピング" +msgstr "パート2 - 関連のマッピング" -#: index.docbook:546 -msgid "We mapped a persistent entity class to a table. Let's build on this and add some class associations. First we'll add people to our application, and store a list of events they participate in." -msgstr "最初の <literal>Person</literal> クラスは単純です：" +#. Tag: para +#: tutorial.xml:546 +#, no-c-format +msgid "" +"We mapped a persistent entity class to a table. Let's build on this and add " +"some class associations. First we'll add people to our application, and " +"store a list of events they participate in." +msgstr "" +"永続エンティティクラスをテーブルにマッピングしました。 さらにこの上にいくつか" +"のクラスの関連を追加しましょう。 まず初めにアプリケーションに人々を追加し、彼" +"らが参加するイベントのリストを格納します。" -#: index.docbook:552 +#. Tag: title +#: tutorial.xml:552 +#, no-c-format msgid "Mapping the Person class" -msgstr "" - "<![CDATA[package events; -\n" - " -\n" - "public class Person { -\n" - " -\n" - " private Long id; -\n" - " private int age; -\n" - " private String firstname; -\n" - " private String lastname; -\n" - " -\n" - " public Person() {} -\n" - " -\n" - " // Accessor methods for all properties, private setter for 'id' -\n" - " -\n" - "}]]>" +msgstr "Personクラスのマッピング" -#: index.docbook:554 +#. Tag: para +#: tutorial.xml:554 +#, no-c-format msgid "The first cut of the <literal>Person</literal> class is simple:" -msgstr "<literal>Person.hbm.xml</literal> という新しいマッピングファイルを作成してください （ファイルの最初にDTDへの参照を忘れずに入れてください）：" +msgstr "最初の <literal>Person</literal> クラスは単純です：" -#: index.docbook:558 +#. Tag: programlisting +#: tutorial.xml:558 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "\n" - "public class Person {\n" - "\n" - " private Long id;\n" - " private int age;\n" - " private String firstname;\n" - " private String lastname;\n" - "\n" - " public Person() {}\n" - "\n" - " // Accessor methods for all properties, private setter for 'id'\n" - "\n" - "}]]>" +"<![CDATA[package events;\n" +"\n" +"public class Person {\n" +"\n" +" private Long id;\n" +" private int age;\n" +" private String firstname;\n" +" private String lastname;\n" +"\n" +" public Person() {}\n" +"\n" +" // Accessor methods for all properties, private setter for 'id'\n" +"\n" +"}]]>" msgstr "" - "<![CDATA[<hibernate-mapping> -\n" - " -\n" - " <class name=\"events.Person\" table=\"PERSON\"> -\n" - " <id name=\"id\" column=\"PERSON_ID\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"age\"/> -\n" - " <property name=\"firstname\"/> -\n" - " <property name=\"lastname\"/> -\n" - " </class> -\n" - " -\n" - "</hibernate-mapping>]]>" -#: index.docbook:560 -msgid "Create a new mapping file called <literal>Person.hbm.xml</literal> (don't forget the DTD reference at the top):" -msgstr "最後にHibernateの設定に新しいマッピングを追加してください：" +#. Tag: para +#: tutorial.xml:560 +#, no-c-format +msgid "" +"Create a new mapping file called <literal>Person.hbm.xml</literal> (don't " +"forget the DTD reference at the top):" +msgstr "" +"<literal>Person.hbm.xml</literal> という新しいマッピングファイルを作成してく" +"ださい （ファイルの最初にDTDへの参照を忘れずに入れてください）：" -#: index.docbook:565 +#. Tag: programlisting +#: tutorial.xml:565 +#, no-c-format msgid "" - "<![CDATA[<hibernate-mapping>\n" - "\n" - " <class name=\"events.Person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"age\"/>\n" - " <property name=\"firstname\"/>\n" - " <property name=\"lastname\"/>\n" - " </class>\n" - "\n" - "</hibernate-mapping>]]>" +"<![CDATA[<hibernate-mapping>\n" +"\n" +" <class name=\"events.Person\" table=\"PERSON\">\n" +" <id name=\"id\" column=\"PERSON_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"age\"/>\n" +" <property name=\"firstname\"/>\n" +" <property name=\"lastname\"/>\n" +" </class>\n" +"\n" +"</hibernate-mapping>]]>" msgstr "" - "<![CDATA[<mapping resource=\"events/Event.hbm.xml\"/> -\n" - "<mapping resource=\"events/Person.hbm.xml\"/>]]>" -#: index.docbook:567 +#. Tag: para +#: tutorial.xml:567 +#, no-c-format msgid "Finally, add the new mapping to Hibernate's configuration:" -msgstr "それではこれら2つのエンティティ間の関連を作成します。 人々がイベントに参加でき、イベントが参加者を持つのは明らかです。 扱わなければならない設計の問題は、方向、多重度、コレクションの振る舞いです。" +msgstr "最後にHibernateの設定に新しいマッピングを追加してください：" -#: index.docbook:571 +#. Tag: programlisting +#: tutorial.xml:571 +#, no-c-format msgid "" - "<![CDATA[<mapping resource=\"events/Event.hbm.xml\"/>\n" - "<mapping resource=\"events/Person.hbm.xml\"/>]]>" -msgstr "単方向Setベース関連" +"<![CDATA[<mapping resource=\"events/Event.hbm.xml\"/>\n" +"<mapping resource=\"events/Person.hbm.xml\"/>]]>" +msgstr "" -#: index.docbook:573 -msgid "We'll now create an association between these two entities. Obviously, persons can participate in events, and events have participants. The design questions we have to deal with are: directionality, multiplicity, and collection behavior." -msgstr "イベントのコレクションを <literal>Person</literal> クラスに追加します。 こうしておくと、明示的なクエリ、つまりわざわざ<literal>aPerson.getEvents()</literal>を呼び出さずに、 特定の人に紐付くイベントを簡単にナビゲートすることができます。 私たちはJavaのコレクション、<literal>Set</literal> を使います。 コレクションは重複要素を持たないし、順番は私たちには意味がないからです。" +#. Tag: para +#: tutorial.xml:573 +#, no-c-format +msgid "" +"We'll now create an association between these two entities. Obviously, " +"persons can participate in events, and events have participants. The design " +"questions we have to deal with are: directionality, multiplicity, and " +"collection behavior." +msgstr "" +"それではこれら2つのエンティティ間の関連を作成します。 人々がイベントに参加で" +"き、イベントが参加者を持つのは明らかです。 扱わなければならない設計の問題は、" +"方向、多重度、コレクションの振る舞いです。" -#: index.docbook:583 +#. Tag: title +#: tutorial.xml:583 +#, no-c-format msgid "A unidirectional Set-based association" -msgstr "<literal>Set</literal> で実装される単方向、多値関連が必要です。 Javaクラス内に対応するコードを書いてマッピングしましょう：" +msgstr "単方向Setベース関連" -#: index.docbook:585 -msgid "We'll add a collection of events to the <literal>Person</literal> class. That way we can easily navigate to the events for a particular person, without executing an explicit query - by calling <literal>aPerson.getEvents()</literal>. We use a Java collection, a <literal>Set</literal>, because the collection will not contain duplicate elements and the ordering is not relevant for us." +#. Tag: para +#: tutorial.xml:585 +#, no-c-format +msgid "" +"We'll add a collection of events to the <literal>Person</literal> class. " +"That way we can easily navigate to the events for a particular person, " +"without executing an explicit query - by calling <literal>aPerson.getEvents()" +"</literal>. We use a Java collection, a <literal>Set</literal>, because the " +"collection will not contain duplicate elements and the ordering is not " +"relevant for us." msgstr "" - "<![CDATA[public class Person { -\n" - " -\n" - " private Set events = new HashSet(); -\n" - " -\n" - " public Set getEvents() { -\n" - " return events; -\n" - " } -\n" - " -\n" - " public void setEvents(Set events) { -\n" - " this.events = events; -\n" - " } -\n" - "}]]>" +"イベントのコレクションを <literal>Person</literal> クラスに追加します。 こう" +"しておくと、明示的なクエリ、つまりわざわざ<literal>aPerson.getEvents()</" +"literal>を呼び出さずに、 特定の人に紐付くイベントを簡単にナビゲートすることが" +"できます。 私たちはJavaのコレクション、<literal>Set</literal> を使います。 コ" +"レクションは重複要素を持たないし、順番は私たちには意味がないからです。" -#: index.docbook:592 -msgid "We need a unidirectional, many-valued associations, implemented with a <literal>Set</literal>. Let's write the code for this in the Java classes and then map it:" -msgstr "この関連をマッピングする前に、反対側について考えてください。 明らかなことですが、今はこれを単方向にしただけです。 逆に、 <literal>Event</literal> 側にも別のコレクションを作ることもできます。 例えば <literal>anEvent.getParticipants()</literal> のように、 双方向にナビゲートしたければ、そうすることもできます。 これは機能的にみて必要ではありません。 特定のイベントに関係するデータを取得する明確なクエリを、いつでも実行することが出来ました。 この設計の選択は開発者に任されていて、この議論により明らかなのは関連の多重度です。 つまり両側を「多」値にする、 <emphasis>多対多</emphasis> と呼ばれる関連です。 そのためHibernateのmany-to-manyマッピングを使います：" +#. Tag: para +#: tutorial.xml:592 +#, no-c-format +msgid "" +"We need a unidirectional, many-valued associations, implemented with a " +"<literal>Set</literal>. Let's write the code for this in the Java classes " +"and then map it:" +msgstr "" +"<literal>Set</literal> で実装される単方向、多値関連が必要です。 Javaクラス内" +"に対応するコードを書いてマッピングしましょう：" -#: index.docbook:597 +#. Tag: programlisting +#: tutorial.xml:597 +#, no-c-format msgid "" - "<![CDATA[public class Person {\n" - "\n" - " private Set events = new HashSet();\n" - "\n" - " public Set getEvents() {\n" - " return events;\n" - " }\n" - "\n" - " public void setEvents(Set events) {\n" - " this.events = events;\n" - " }\n" - "}]]>" +"<![CDATA[public class Person {\n" +"\n" +" private Set events = new HashSet();\n" +"\n" +" public Set getEvents() {\n" +" return events;\n" +" }\n" +"\n" +" public void setEvents(Set events) {\n" +" this.events = events;\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[<class name=\"events.Person\" table=\"PERSON\"> -\n" - " <id name=\"id\" column=\"PERSON_ID\"> -\n" - " <generator class=\"native\"/> -\n" - " </id> -\n" - " <property name=\"age\"/> -\n" - " <property name=\"firstname\"/> -\n" - " <property name=\"lastname\"/> -\n" - " -\n" - " <set name=\"events\" table=\"PERSON_EVENT\"> -\n" - " <key column=\"PERSON_ID\"/> -\n" - " <many-to-many column=\"EVENT_ID\" class=\"events.Event\"/> -\n" - " </set> -\n" - " -\n" - "</class>]]>" -#: index.docbook:599 -msgid "Before we map this association, think about the other side. Clearly, we could just keep this unidirectional. Or, we could create another collection on the <literal>Event</literal>, if we want to be able to navigate it bi-directional, i.e. <literal>anEvent.getParticipants()</literal>. This is not necessary, from a functional perspective. You could always execute an explicit query to retrieve the participants for a particular event. This is a design choice left to you, but what is clear from this discussion is the multiplicity of the association: \"many\" valued on both sides, we call this a <emphasis>many-to-many</emphasis> association. Hence, we use Hibernate's many-to-many mapping:" -msgstr "Hibernateはありとあらゆる種類のコレクションマッピングをサポートしていますが、 最も一般的なものが <literal>&lt;set&gt;</literal> です。 多対多関連（または <emphasis>n:m</emphasis> エンティティリレーションシップ）には、 関連テーブルが必要です。 このテーブルのそれぞれの行は、人とイベント間のリンクを表現します。 テーブル名は <literal>set</literal> 要素の <literal>table</literal> 属性で設定します。 人側の関連の識別子カラム名は <literal>&lt;key&gt;</literal> 要素で、 イベント側のカラム名は <literal>&lt;many-to-many&gt;</literal> の <literal>column</literal> 属性で定義します。 Hibernateにコレクションのオブジェクトのクラス （正確には、参照のコレクションの反対側のクラス）を教えなければなりません。" +#. Tag: para +#: tutorial.xml:599 +#, no-c-format +msgid "" +"Before we map this association, think about the other side. Clearly, we " +"could just keep this unidirectional. Or, we could create another collection " +"on the <literal>Event</literal>, if we want to be able to navigate it bi-" +"directional, i.e. <literal>anEvent.getParticipants()</literal>. This is not " +"necessary, from a functional perspective. You could always execute an " +"explicit query to retrieve the participants for a particular event. This is " +"a design choice left to you, but what is clear from this discussion is the " +"multiplicity of the association: \"many\" valued on both sides, we call this " +"a <emphasis>many-to-many</emphasis> association. Hence, we use Hibernate's " +"many-to-many mapping:" +msgstr "" +"この関連をマッピングする前に、反対側について考えてください。 明らかなことです" +"が、今はこれを単方向にしただけです。 逆に、 <literal>Event</literal> 側にも別" +"のコレクションを作ることもできます。 例えば <literal>anEvent.getParticipants" +"()</literal> のように、 双方向にナビゲートしたければ、そうすることもできま" +"す。 これは機能的にみて必要ではありません。 特定のイベントに関係するデータを" +"取得する明確なクエリを、いつでも実行することが出来ました。 この設計の選択は開" +"発者に任されていて、この議論により明らかなのは関連の多重度です。 つまり両側を" +"「多」値にする、 <emphasis>多対多</emphasis> と呼ばれる関連です。 そのため" +"Hibernateのmany-to-manyマッピングを使います：" -#: index.docbook:610 +#. Tag: programlisting +#: tutorial.xml:610 +#, no-c-format msgid "" - "<![CDATA[<class name=\"events.Person\" table=\"PERSON\">\n" - " <id name=\"id\" column=\"PERSON_ID\">\n" - " <generator class=\"native\"/>\n" - " </id>\n" - " <property name=\"age\"/>\n" - " <property name=\"firstname\"/>\n" - " <property name=\"lastname\"/>\n" - "\n" - " <set name=\"events\" table=\"PERSON_EVENT\">\n" - " <key column=\"PERSON_ID\"/>\n" - " <many-to-many column=\"EVENT_ID\" class=\"events.Event\"/>\n" - " </set>\n" - "\n" - "</class>]]>" -msgstr "そのためこのマッピングのデータベーススキーマは以下のようになります。：" +"<![CDATA[<class name=\"events.Person\" table=\"PERSON\">\n" +" <id name=\"id\" column=\"PERSON_ID\">\n" +" <generator class=\"native\"/>\n" +" </id>\n" +" <property name=\"age\"/>\n" +" <property name=\"firstname\"/>\n" +" <property name=\"lastname\"/>\n" +"\n" +" <set name=\"events\" table=\"PERSON_EVENT\">\n" +" <key column=\"PERSON_ID\"/>\n" +" <many-to-many column=\"EVENT_ID\" class=\"events.Event\"/>\n" +" </set>\n" +"\n" +"</class>]]>" +msgstr "" -#: index.docbook:612 -msgid "Hibernate supports all kinds of collection mappings, a <literal>&lt;set&gt;</literal> being most common. For a many-to-many association (or <emphasis>n:m</emphasis> entity relationship), an association table is needed. Each row in this table represents a link between a person and an event. The table name is configured with the <literal>table</literal> attribute of the <literal>set</literal> element. The identifier column name in the association, for the person's side, is defined with the <literal>&lt;key&gt;</literal> element, the column name for the event's side with the <literal>column</literal> attribute of the <literal>&lt;many-to-many&gt;</literal>. You also have to tell Hibernate the class of the objects in your collection (correct: the class on the other side of the collection of references)." +#. Tag: para +#: tutorial.xml:612 +#, no-c-format +msgid "" +"Hibernate supports all kinds of collection mappings, a <literal>&lt;set&gt;</" +"literal> being most common. For a many-to-many association (or <emphasis>n:" +"m</emphasis> entity relationship), an association table is needed. Each row " +"in this table represents a link between a person and an event. The table " +"name is configured with the <literal>table</literal> attribute of the " +"<literal>set</literal> element. The identifier column name in the " +"association, for the person's side, is defined with the <literal>&lt;key&gt;" +"</literal> element, the column name for the event's side with the " +"<literal>column</literal> attribute of the <literal>&lt;many-to-many&gt;</" +"literal>. You also have to tell Hibernate the class of the objects in your " +"collection (correct: the class on the other side of the collection of " +"references)." msgstr "" - "<![CDATA[ -\n" - " _____________ __________________ -\n" - " | | | | _____________ -\n" - " | EVENTS | | PERSON_EVENT | | | -\n" - " |_____________| |__________________| | PERSON | -\n" - " | | | | |_____________| -\n" - " | *EVENT_ID | <--> | *EVENT_ID | | | -\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | -\n" - " | TITLE | |__________________| | AGE | -\n" - " |_____________| | FIRSTNAME | -\n" - " | LASTNAME | -\n" - " |_____________| -\n" - " ]]>" +"Hibernateはありとあらゆる種類のコレクションマッピングをサポートしています" +"が、 最も一般的なものが <literal>&lt;set&gt;</literal> です。 多対多関連（ま" +"たは <emphasis>n:m</emphasis> エンティティリレーションシップ）には、 関連テー" +"ブルが必要です。 このテーブルのそれぞれの行は、人とイベント間のリンクを表現し" +"ます。 テーブル名は <literal>set</literal> 要素の <literal>table</literal> 属" +"性で設定します。 人側の関連の識別子カラム名は <literal>&lt;key&gt;</literal> " +"要素で、 イベント側のカラム名は <literal>&lt;many-to-many&gt;</literal> の " +"<literal>column</literal> 属性で定義します。 Hibernateにコレクションのオブ" +"ジェクトのクラス （正確には、参照のコレクションの反対側のクラス）を教えなけれ" +"ばなりません。" -#: index.docbook:624 +#. Tag: para +#: tutorial.xml:624 +#, no-c-format msgid "The database schema for this mapping is therefore:" -msgstr "関連を働かせる" +msgstr "そのためこのマッピングのデータベーススキーマは以下のようになります。：" -#: index.docbook:628 +#. Tag: programlisting +#: tutorial.xml:628 +#, no-c-format msgid "" - "<![CDATA[\n" - " _____________ __________________\n" - " | | | | _____________\n" - " | EVENTS | | PERSON_EVENT | | |\n" - " |_____________| |__________________| | PERSON |\n" - " | | | | |_____________|\n" - " | *EVENT_ID | <--> | *EVENT_ID | | |\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |\n" - " | TITLE | |__________________| | AGE |\n" - " |_____________| | FIRSTNAME |\n" - " | LASTNAME |\n" - " |_____________|\n" - " ]]>" -msgstr "<literal>EventManager</literal> の新しいメソッドで人々とイベントを一緒にしましょう：" +"<![CDATA[\n" +" _____________ __________________\n" +" | | | | _____________\n" +" | EVENTS | | PERSON_EVENT | | |\n" +" |_____________| |__________________| | PERSON |\n" +" | | | | |_____________|\n" +" | *EVENT_ID | <--> | *EVENT_ID | | |\n" +" | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID |\n" +" | TITLE | |__________________| | AGE |\n" +" |_____________| | FIRSTNAME |\n" +" | LASTNAME |\n" +" |_____________|\n" +" ]]>" +msgstr "" -#: index.docbook:633 +#. Tag: title +#: tutorial.xml:633 +#, no-c-format msgid "Working the association" +msgstr "関連を働かせる" + +#. Tag: para +#: tutorial.xml:635 +#, no-c-format +msgid "" +"Let's bring some people and events together in a new method in " +"<literal>EventManager</literal>:" msgstr "" - "<![CDATA[private void addPersonToEvent(Long personId, Long eventId) { -\n" - " -\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession(); -\n" - " session.beginTransaction(); -\n" - " -\n" - " Person aPerson = (Person) session.load(Person.class, personId); -\n" - " Event anEvent = (Event) session.load(Event.class, eventId); -\n" - " -\n" - " aPerson.getEvents().add(anEvent); -\n" - " -\n" - " session.getTransaction().commit(); -\n" - "}]]>" +"<literal>EventManager</literal> の新しいメソッドで人々とイベントを一緒にしま" +"しょう：" -#: index.docbook:635 -msgid "Let's bring some people and events together in a new method in <literal>EventManager</literal>:" -msgstr "<literal>Person</literal> と <literal>Event</literal> をロードした後、 普通のコレクションメソッドを使って単純にそのコレクションを修正してください。 ご覧のとおり <literal>update()</literal> や <literal>save()</literal> の明示的な呼び出しはありません。 Hibernateは、修正されたことにより更新する必要のあるコレクションを自動的に検知します。 これは <emphasis>自動ダーティチェック</emphasis> と呼ばれ、 オブジェクトの名前やdateプロパティを修正することで試すことも可能です。 それらが <emphasis>永続</emphasis> 状態にある限り、 つまり特定のHibernate <literal>Session</literal> にバインドされている限り （例えば作業単位(Unit of Work)の中で単にロードまたはセーブされた）、 Hibernateはどんな変更もモニターし、遅延書き込み(write-behind)でSQLを実行し�! ��す。 通常、作業単位(Unit of Work)の最後にだけ行われるデータベースとメモリの状態を同期させる処理は、 <emphasis>フラッシュ</emphasis> と呼ばれます。 このコードでは、作業単位(Unit of Work)はデータベーストランザクションのコミット（もしくはロールバック）で終了します。 これは、 <literal>CurrentSessionContext</literal> クラスに対して <literal>thread</literal> を設定したためです。" +#. Tag: programlisting +#: tutorial.xml:639 +#, no-c-format +msgid "" +"<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session.beginTransaction();\n" +"\n" +" Person aPerson = (Person) session.load(Person.class, personId);\n" +" Event anEvent = (Event) session.load(Event.class, eventId);\n" +"\n" +" aPerson.getEvents().add(anEvent);\n" +"\n" +" session.getTransaction().commit();\n" +"}]]>" +msgstr "" -#: index.docbook:639 +#. Tag: para +#: tutorial.xml:641 +#, no-c-format msgid "" - "<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session.load(Person.class, personId);\n" - " Event anEvent = (Event) session.load(Event.class, eventId);\n" - "\n" - " aPerson.getEvents().add(anEvent);\n" - "\n" - " session.getTransaction().commit();\n" - "}]]>" -msgstr "異なる作業単位(Unit of Work)で人々とイベントをロードすることも当然できます。 そうでなければ、永続状態にないとき（以前に永続であったなら、この状態を <emphasis>分離（detached）</emphasis> と呼びます）、 <literal>Session</literal> の外部でオブジェクトを修正します。 分離されるときにはコレクションを変更することも可能です：" +"After loading a <literal>Person</literal> and an <literal>Event</literal>, " +"simply modify the collection using the normal collection methods. As you can " +"see, there is no explicit call to <literal>update()</literal> or " +"<literal>save()</literal>, Hibernate automatically detects that the " +"collection has been modified and needs to be updated. This is called " +"<emphasis>automatic dirty checking</emphasis>, and you can also try it by " +"modifying the name or the date property of any of your objects. As long as " +"they are in <emphasis>persistent</emphasis> state, that is, bound to a " +"particular Hibernate <literal>Session</literal> (i.e. they have been just " +"loaded or saved in a unit of work), Hibernate monitors any changes and " +"executes SQL in a write-behind fashion. The process of synchronizing the " +"memory state with the database, usually only at the end of a unit of work, " +"is called <emphasis>flushing</emphasis>. In our code, the unit of work ends " +"with a commit (or rollback) of the database transaction - as defined by the " +"<literal>thread</literal> configuration option for the " +"<literal>CurrentSessionContext</literal> class." +msgstr "" +"<literal>Person</literal> と <literal>Event</literal> をロードした後、 普通の" +"コレクションメソッドを使って単純にそのコレクションを修正してください。 ご覧の" +"とおり <literal>update()</literal> や <literal>save()</literal> の明示的な呼" +"び出しはありません。 Hibernateは、修正されたことにより更新する必要のあるコレ" +"クションを自動的に検知します。 これは <emphasis>自動ダーティチェック</" +"emphasis> と呼ばれ、 オブジェクトの名前やdateプロパティを修正することで試すこ" +"とも可能です。 それらが <emphasis>永続</emphasis> 状態にある限り、 つまり特定" +"のHibernate <literal>Session</literal> にバインドされている限り （例えば作業" +"単位(Unit of Work)の中で単にロードまたはセーブされた）、 Hibernateはどんな変" +"更もモニターし、遅延書き込み(write-behind)でSQLを実行します。 通常、作業単位" +"(Unit of Work)の最後にだけ行われるデータベースとメモリの状態を同期させる処理" +"は、 <emphasis>フラッシュ</emphasis> と呼ばれます。 このコードでは、作業単位" +"(Unit of Work)はデータベーストランザクションのコミット（もしくはロールバッ" +"ク）で終了します。 これは、 <literal>CurrentSessionContext</literal> クラスに" +"対して <literal>thread</literal> を設定したためです。" -#: index.docbook:641 -msgid "After loading a <literal>Person</literal> and an <literal>Event</literal>, simply modify the collection using the normal collection methods. As you can see, there is no explicit call to <literal>update()</literal> or <literal>save()</literal>, Hibernate automatically detects that the collection has been modified and needs to be updated. This is called <emphasis>automatic dirty checking</emphasis>, and you can also try it by modifying the name or the date property of any of your objects. As long as they are in <emphasis>persistent</emphasis> state, that is, bound to a particular Hibernate <literal>Session</literal> (i.e. they have been just loaded or saved in a unit of work), Hibernate monitors any changes and executes SQL in a write-behind fashion. The process of synchronizing the memory state with the database, usually only at the end of a unit of work, is called <emphasis>flushing</emphasis>. In our code, the unit of work ends with a commit (or rollback) of the dat! abase transaction - as defined by the <literal>thread</literal> configuration option for the <literal>CurrentSessionContext</literal> class." +#. Tag: para +#: tutorial.xml:656 +#, no-c-format +msgid "" +"You might of course load person and event in different units of work. Or you " +"modify an object outside of a <literal>Session</literal>, when it is not in " +"persistent state (if it was persistent before, we call this state " +"<emphasis>detached</emphasis>). You can even modify a collection when it is " +"detached:" msgstr "" - "<![CDATA[private void addPersonToEvent(Long personId, Long eventId) { -\n" - " -\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession(); -\n" - " session.beginTransaction(); -\n" - " -\n" - " Person aPerson = (Person) session -\n" - " .createQuery(\"select p from Person p left join fetch p.events where p.id = :pid\") -\n" - " .setParameter(\"pid\", personId) -\n" - " .uniqueResult(); // Eager fetch the collection so we can use it detached -\n" - " -\n" - " Event anEvent = (Event) session.load(Event.class, eventId); -\n" - " -\n" - " session.getTransaction().commit(); -\n" - " -\n" - " // End of first unit of work -\n" - " -\n" - " aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached -\n" - " -\n" - " // Begin second unit of work -\n" - " -\n" - " Session session2 = HibernateUtil.getSessionFactory().getCurrentSession(); -\n" - " session2.beginTransaction(); -\n" - " -\n" - " session2.update(aPerson); // Reattachment of aPerson -\n" - " -\n" - " session2.getTransaction().commit(); -\n" - "}]]>" +"異なる作業単位(Unit of Work)で人々とイベントをロードすることも当然できます。 " +"そうでなければ、永続状態にないとき（以前に永続であったなら、この状態を " +"<emphasis>分離（detached）</emphasis> と呼びます）、 <literal>Session</" +"literal> の外部でオブジェクトを修正します。 分離されるときにはコレクションを" +"変更することも可能です：" -#: index.docbook:656 -msgid "You might of course load person and event in different units of work. Or you modify an object outside of a <literal>Session</literal>, when it is not in persistent state (if it was persistent before, we call this state <emphasis>detached</emphasis>). You can even modify a collection when it is detached:" -msgstr "<literal>update</literal> の呼び出しは分離オブジェクトを再び永続化します。 これは、新しい作業単位(Unit of Work)にバインドすると言えるでしょう。 そのため分離の間に加えられたどのような修正もデータベースにセーブできます。 エンティティオブジェクトのコレクションへの修正（追加･削除）も同様にセーブできます。" +#. Tag: programlisting +#: tutorial.xml:663 +#, no-c-format +msgid "" +"<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session.beginTransaction();\n" +"\n" +" Person aPerson = (Person) session\n" +" .createQuery(\"select p from Person p left join fetch p.events " +"where p.id = :pid\")\n" +" .setParameter(\"pid\", personId)\n" +" .uniqueResult(); // Eager fetch the collection so we can use it " +"detached\n" +"\n" +" Event anEvent = (Event) session.load(Event.class, eventId);\n" +"\n" +" session.getTransaction().commit();\n" +"\n" +" // End of first unit of work\n" +"\n" +" aPerson.getEvents().add(anEvent); // aPerson (and its collection) is " +"detached\n" +"\n" +" // Begin second unit of work\n" +"\n" +" Session session2 = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session2.beginTransaction();\n" +"\n" +" session2.update(aPerson); // Reattachment of aPerson\n" +"\n" +" session2.getTransaction().commit();\n" +"}]]>" +msgstr "" -#: index.docbook:663 +#. Tag: para +#: tutorial.xml:665 +#, no-c-format msgid "" - "<![CDATA[private void addPersonToEvent(Long personId, Long eventId) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session\n" - " .createQuery(\"select p from Person p left join fetch p.events where p.id = :pid\")\n" - " .setParameter(\"pid\", personId)\n" - " .uniqueResult(); // Eager fetch the collection so we can use it detached\n" - "\n" - " Event anEvent = (Event) session.load(Event.class, eventId);\n" - "\n" - " session.getTransaction().commit();\n" - "\n" - " // End of first unit of work\n" - "\n" - " aPerson.getEvents().add(anEvent); // aPerson (and its collection) is detached\n" - "\n" - " // Begin second unit of work\n" - "\n" - " Session session2 = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session2.beginTransaction();\n" - "\n" - " session2.update(aPerson); // Reattachment of aPerson\n" - "\n" - " session2.getTransaction().commit();\n" - "}]]>" -msgstr "これは今はあまり使いみちがありませんが、 自分のアプリケーションの設計に組み込むことができる重要なコンセプトです。 それではこのエクササイズの最後に、 <literal>EventManager</literal> のメインメソッドに新しいアクションを追加して コマンドラインから呼び出してみましょう。 人やイベントの識別子が必要なら、 <literal>save()</literal> メソッドが返してくれます （場合によっては識別子を返すためにメソッドを修正する必要があるかもしれません）。" +"The call to <literal>update</literal> makes a detached object persistent " +"again, you could say it binds it to a new unit of work, so any modifications " +"you made to it while detached can be saved to the database. This includes " +"any modifications (additions/deletions) you made to a collection of that " +"entity object." +msgstr "" +"<literal>update</literal> の呼び出しは分離オブジェクトを再び永続化します。 こ" +"れは、新しい作業単位(Unit of Work)にバインドすると言えるでしょう。 そのため分" +"離の間に加えられたどのような修正もデータベースにセーブできます。 エンティティ" +"オブジェクトのコレクションへの修正（追加･削除）も同様にセーブできます。" -#: index.docbook:665 -msgid "The call to <literal>update</literal> makes a detached object persistent again, you could say it binds it to a new unit of work, so any modifications you made to it while detached can be saved to the database. This includes any modifications (additions/deletions) you made to a collection of that entity object." +#. Tag: para +#: tutorial.xml:672 +#, no-c-format +msgid "" +"Well, this is not much use in our current situation, but it's an important " +"concept you can design into your own application. For now, complete this " +"exercise by adding a new action to the <literal>EventManager</literal>'s " +"main method and call it from the command line. If you need the identifiers " +"of a person and an event - the <literal>save()</literal> method returns it " +"(you might have to modify some of the previous methods to return that " +"identifier):" msgstr "" - "<![CDATA[else if (args[0].equals(\"addpersontoevent\")) { -\n" - " Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date()); -\n" - " Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\"); -\n" - " mgr.addPersonToEvent(personId, eventId); -\n" - " System.out.println(\"Added person \" + personId + \" to event \" + eventId); -\n" - "}]]>" +"これは今はあまり使いみちがありませんが、 自分のアプリケーションの設計に組み込" +"むことができる重要なコンセプトです。 それではこのエクササイズの最後に、 " +"<literal>EventManager</literal> のメインメソッドに新しいアクションを追加して " +"コマンドラインから呼び出してみましょう。 人やイベントの識別子が必要なら、 " +"<literal>save()</literal> メソッドが返してくれます （場合によっては識別子を返" +"すためにメソッドを修正する必要があるかもしれません）。" -#: index.docbook:672 -msgid "Well, this is not much use in our current situation, but it's an important concept you can design into your own application. For now, complete this exercise by adding a new action to the <literal>EventManager</literal>'s main method and call it from the command line. If you need the identifiers of a person and an event - the <literal>save()</literal> method returns it (you might have to modify some of the previous methods to return that identifier):" -msgstr "これは同じように重要な2つのクラス、つまり2つのエンティティ間の関連の例でした。 前に述べたように、典型的なモデルには、普通「比較的重要ではない」他のクラスと型があります。 これまでに見たような <literal>int</literal> や <literal>String</literal> のようなものです。 このようなクラスを <emphasis>値型</emphasis> と言います。 このインスタンスは特定のエンティティに <emphasis>依存</emphasis> します。 この型のインスタンスは独自のIDを持ちませんし、 エンティティ間で共有されることもありません （ファーストネームが同じだったとしても、2人の人は同じ <literal>firstname</literal> オブジェクトを参照しません）。 値型はもちろんJDK内に見つかりますが、それだけではなく （実際、HibernateアプリケーションにおいてすべてのJDK�! �ラスは値型と見なせます）、 例えば <literal>Address</literal> や <literal>MonetaryAmount</literal> のような独自の依存クラスを書くこともできます。" +#. Tag: programlisting +#: tutorial.xml:680 +#, no-c-format +msgid "" +"<![CDATA[else if (args[0].equals(\"addpersontoevent\")) {\n" +" Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date());\n" +" Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\");\n" +" mgr.addPersonToEvent(personId, eventId);\n" +" System.out.println(\"Added person \" + personId + \" to event \" + " +"eventId);\n" +"}]]>" +msgstr "" -#: index.docbook:680 +#. Tag: para +#: tutorial.xml:682 +#, no-c-format msgid "" - "<![CDATA[else if (args[0].equals(\"addpersontoevent\")) {\n" - " Long eventId = mgr.createAndStoreEvent(\"My Event\", new Date());\n" - " Long personId = mgr.createAndStorePerson(\"Foo\", \"Bar\");\n" - " mgr.addPersonToEvent(personId, eventId);\n" - " System.out.println(\"Added person \" + personId + \" to event \" + eventId);\n" - "}]]>" -msgstr "値型のコレクションを設計することもできます。 これは他のエンティティへの参照のコレクションとは概念的に非常に異なりますが、 Javaではほとんど同じように見えます。" +"This was an example of an association between two equally important classes, " +"two entities. As mentioned earlier, there are other classes and types in a " +"typical model, usually \"less important\". Some you have already seen, like " +"an <literal>int</literal> or a <literal>String</literal>. We call these " +"classes <emphasis>value types</emphasis>, and their instances " +"<emphasis>depend</emphasis> on a particular entity. Instances of these types " +"don't have their own identity, nor are they shared between entities (two " +"persons don't reference the same <literal>firstname</literal> object, even " +"if they have the same first name). Of course, value types can not only be " +"found in the JDK (in fact, in a Hibernate application all JDK classes are " +"considered value types), but you can also write dependent classes yourself, " +"<literal>Address</literal> or <literal>MonetaryAmount</literal>, for example." +msgstr "" +"これは同じように重要な2つのクラス、つまり2つのエンティティ間の関連の例でし" +"た。 前に述べたように、典型的なモデルには、普通「比較的重要ではない」他のクラ" +"スと型があります。 これまでに見たような <literal>int</literal> や " +"<literal>String</literal> のようなものです。 このようなクラスを <emphasis>値" +"型</emphasis> と言います。 このインスタンスは特定のエンティティに <emphasis>" +"依存</emphasis> します。 この型のインスタンスは独自のIDを持ちませんし、 エン" +"ティティ間で共有されることもありません （ファーストネームが同じだったとして" +"も、2人の人は同じ <literal>firstname</literal> オブジェクトを参照しませ" +"ん）。 値型はもちろんJDK内に見つかりますが、それだけではなく （実際、" +"HibernateアプリケーションにおいてすべてのJDKクラスは値型と見なせます）、 例え" +"ば <literal>Address</literal> や <literal>MonetaryAmount</literal> のような独" +"自の依存クラスを書くこともできます。" -#: index.docbook:682 -msgid "This was an example of an association between two equally important classes, two entities. As mentioned earlier, there are other classes and types in a typical model, usually \"less important\". Some you have already seen, like an <literal>int</literal> or a <literal>String</literal>. We call these classes <emphasis>value types</emphasis>, and their instances <emphasis>depend</emphasis> on a particular entity. Instances of these types don't have their own identity, nor are they shared between entities (two persons don't reference the same <literal>firstname</literal> object, even if they have the same first name). Of course, value types can not only be found in the JDK (in fact, in a Hibernate application all JDK classes are considered value types), but you can also write dependent classes yourself, <literal>Address</literal> or <literal>MonetaryAmount</literal>, for example." +#. Tag: para +#: tutorial.xml:695 +#, no-c-format +msgid "" +"You can also design a collection of value types. This is conceptually very " +"different from a collection of references to other entities, but looks " +"almost the same in Java." +msgstr "" +"値型のコレクションを設計することもできます。 これは他のエンティティへの参照の" +"コレクションとは概念的に非常に異なりますが、 Javaではほとんど同じように見えま" +"す。" + +#. Tag: title +#: tutorial.xml:703 +#, no-c-format +msgid "Collection of values" msgstr "値のコレクション" -#: index.docbook:695 -msgid "You can also design a collection of value types. This is conceptually very different from a collection of references to other entities, but looks almost the same in Java." -msgstr "値型オブジェクトのコレクションを <literal>Person</literal> エンティティへ追加します。 Eメールアドレスを格納したいのですが、<literal>String</literal> 型を使っているので、 コレクションは再び <literal>Set</literal> です：" +#. Tag: para +#: tutorial.xml:705 +#, no-c-format +msgid "" +"We add a collection of value typed objects to the <literal>Person</literal> " +"entity. We want to store email addresses, so the type we use is " +"<literal>String</literal>, and the collection is again a <literal>Set</" +"literal>:" +msgstr "" +"値型オブジェクトのコレクションを <literal>Person</literal> エンティティへ追加" +"します。 Eメールアドレスを格納したいのですが、<literal>String</literal> 型を" +"使っているので、 コレクションは再び <literal>Set</literal> です：" -#: index.docbook:703 -msgid "Collection of values" +#. Tag: programlisting +#: tutorial.xml:710 +#, no-c-format +msgid "" +"<![CDATA[private Set emailAddresses = new HashSet();\n" +"\n" +"public Set getEmailAddresses() {\n" +" return emailAddresses;\n" +"}\n" +"\n" +"public void setEmailAddresses(Set emailAddresses) {\n" +" this.emailAddresses = emailAddresses;\n" +"}]]>" msgstr "" - "<![CDATA[private Set emailAddresses = new HashSet(); -\n" - " -\n" - "public Set getEmailAddresses() { -\n" - " return emailAddresses; -\n" - "} -\n" - " -\n" - "public void setEmailAddresses(Set emailAddresses) { -\n" - " this.emailAddresses = emailAddresses; -\n" - "}]]>" -#: index.docbook:705 -msgid "We add a collection of value typed objects to the <literal>Person</literal> entity. We want to store email addresses, so the type we use is <literal>String</literal>, and the collection is again a <literal>Set</literal>:" +#. Tag: para +#: tutorial.xml:712 +#, no-c-format +msgid "The mapping of this <literal>Set</literal>:" msgstr "この <literal>Set</literal> のマッピングです：" -#: index.docbook:710 +#. Tag: programlisting +#: tutorial.xml:716 +#, no-c-format msgid "" - "<![CDATA[private Set emailAddresses = new HashSet();\n" - "\n" - "public Set getEmailAddresses() {\n" - " return emailAddresses;\n" - "}\n" - "\n" - "public void setEmailAddresses(Set emailAddresses) {\n" - " this.emailAddresses = emailAddresses;\n" - "}]]>" +"<![CDATA[<set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR\">\n" +" <key column=\"PERSON_ID\"/>\n" +" <element type=\"string\" column=\"EMAIL_ADDR\"/>\n" +"</set>]]>" msgstr "" - "<![CDATA[<set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR\"> -\n" - " <key column=\"PERSON_ID\"/> -\n" - " <element type=\"string\" column=\"EMAIL_ADDR\"/> -\n" - "</set>]]>" -#: index.docbook:712 -msgid "The mapping of this <literal>Set</literal>:" -msgstr "前のマッピングと比べて違うのは <literal>element</literal> の部分ですが、 Hibernateにこのコレクションが他のエンティティへの参照を含まず、 <literal>String</literal> 型の要素のコレクションを含むことを教えます。 （小文字の名前(string)はHibernateのマッピング型またはコンバータであるということです）。 繰り返しますが、<literal>set</literal> 要素の <literal>table</literal> 属性は、 コレクションのためのテーブル名を指定します。 <literal>key</literal> 要素はコレクションテーブルの外部キーカラム名を定義します。 <literal>element</literal> 要素の <literal>column</literal> 属性は <literal>String</literal> の値が実際に格納されるカラムの名前を定義します。" - -#: index.docbook:716 +#. Tag: para +#: tutorial.xml:718 +#, no-c-format msgid "" - "<![CDATA[<set name=\"emailAddresses\" table=\"PERSON_EMAIL_ADDR\">\n" - " <key column=\"PERSON_ID\"/>\n" - " <element type=\"string\" column=\"EMAIL_ADDR\"/>\n" - "</set>]]>" -msgstr "更新したスキーマを見てください：" - -#: index.docbook:718 -msgid "The difference compared with the earlier mapping is the <literal>element</literal> part, which tells Hibernate that the collection does not contain references to another entity, but a collection of elements of type <literal>String</literal> (the lowercase name tells you it's a Hibernate mapping type/converter). Once again, the <literal>table</literal> attribute of the <literal>set</literal> element determines the table name for the collection. The <literal>key</literal> element defines the foreign-key column name in the collection table. The <literal>column</literal> attribute in the <literal>element</literal> element defines the column name where the <literal>String</literal> values will actually be stored." +"The difference compared with the earlier mapping is the <literal>element</" +"literal> part, which tells Hibernate that the collection does not contain " +"references to another entity, but a collection of elements of type " +"<literal>String</literal> (the lowercase name tells you it's a Hibernate " +"mapping type/converter). Once again, the <literal>table</literal> attribute " +"of the <literal>set</literal> element determines the table name for the " +"collection. The <literal>key</literal> element defines the foreign-key " +"column name in the collection table. The <literal>column</literal> attribute " +"in the <literal>element</literal> element defines the column name where the " +"<literal>String</literal> values will actually be stored." msgstr "" - "<![CDATA[ -\n" - " _____________ __________________ -\n" - " | | | | _____________ -\n" - " | EVENTS | | PERSON_EVENT | | | ___________________ -\n" - " |_____________| |__________________| | PERSON | | | -\n" - " | | | | |_____________| | PERSON_EMAIL_ADDR | -\n" - " | *EVENT_ID | <--> | *EVENT_ID | | | |___________________| -\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | *PERSON_ID | -\n" - " | TITLE | |__________________| | AGE | | *EMAIL_ADDR | -\n" - " |_____________| | FIRSTNAME | |___________________| -\n" - " | LASTNAME | -\n" - " |_____________| -\n" - " ]]>" +"前のマッピングと比べて違うのは <literal>element</literal> の部分ですが、 " +"Hibernateにこのコレクションが他のエンティティへの参照を含まず、 " +"<literal>String</literal> 型の要素のコレクションを含むことを教えます。 （小文" +"字の名前(string)はHibernateのマッピング型またはコンバータであるということで" +"す）。 繰り返しますが、<literal>set</literal> 要素の <literal>table</" +"literal> 属性は、 コレクションのためのテーブル名を指定します。 <literal>key</" +"literal> 要素はコレクションテーブルの外部キーカラム名を定義します。 " +"<literal>element</literal> 要素の <literal>column</literal> 属性は " +"<literal>String</literal> の値が実際に格納されるカラムの名前を定義します。" -#: index.docbook:728 +#. Tag: para +#: tutorial.xml:728 +#, no-c-format msgid "Have a look at the updated schema:" -msgstr "コレクションテーブルの主キーは、実際は両方のカラムを使った複合キーであることがわかります。 これは人ごとにEメールアドレスが重複できないということで、 Javaのsetに要求されるセマンティクスそのものです。" +msgstr "更新したスキーマを見てください：" -#: index.docbook:732 +#. Tag: programlisting +#: tutorial.xml:732 +#, no-c-format msgid "" - "<![CDATA[\n" - " _____________ __________________\n" - " | | | | _____________\n" - " | EVENTS | | PERSON_EVENT | | | ___________________\n" - " |_____________| |__________________| | PERSON | | |\n" - " | | | | |_____________| | PERSON_EMAIL_ADDR |\n" - " | *EVENT_ID | <--> | *EVENT_ID | | | |___________________|\n" - " | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | *PERSON_ID |\n" - " | TITLE | |__________________| | AGE | | *EMAIL_ADDR |\n" - " |_____________| | FIRSTNAME | |___________________|\n" - " | LASTNAME |\n" - " |_____________|\n" - " ]]>" -msgstr "以前人とイベントを関連づけたときと全く同じように、 今や試しにコレクションに要素を追加することができるようになりました。 両方ともJavaでは同じコードです。" +"<![CDATA[\n" +" _____________ __________________\n" +" | | | | _____________\n" +" | EVENTS | | PERSON_EVENT | | | " +"___________________\n" +" |_____________| |__________________| | PERSON | " +"| |\n" +" | | | | |_____________| | " +"PERSON_EMAIL_ADDR |\n" +" | *EVENT_ID | <--> | *EVENT_ID | | | |" +"___________________|\n" +" | EVENT_DATE | | *PERSON_ID | <--> | *PERSON_ID | <--> | " +"*PERSON_ID |\n" +" | TITLE | |__________________| | AGE | | " +"*EMAIL_ADDR |\n" +" |_____________| | FIRSTNAME | |" +"___________________|\n" +" | LASTNAME |\n" +" |_____________|\n" +" ]]>" +msgstr "" -#: index.docbook:734 -msgid "You can see that the primary key of the collection table is in fact a composite key, using both columns. This also implies that there can't be duplicate email addresses per person, which is exactly the semantics we need for a set in Java." +#. Tag: para +#: tutorial.xml:734 +#, no-c-format +msgid "" +"You can see that the primary key of the collection table is in fact a " +"composite key, using both columns. This also implies that there can't be " +"duplicate email addresses per person, which is exactly the semantics we need " +"for a set in Java." msgstr "" - "<![CDATA[private void addEmailToPerson(Long personId, String emailAddress) { -\n" - " -\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession(); -\n" - " session.beginTransaction(); -\n" - " -\n" - " Person aPerson = (Person) session.load(Person.class, personId); -\n" - " -\n" - " // The getEmailAddresses() might trigger a lazy load of the collection -\n" - " aPerson.getEmailAddresses().add(emailAddress); -\n" - " -\n" - " session.getTransaction().commit(); -\n" - "}]]>" +"コレクションテーブルの主キーは、実際は両方のカラムを使った複合キーであること" +"がわかります。 これは人ごとにEメールアドレスが重複できないということで、 Java" +"のsetに要求されるセマンティクスそのものです。" -#: index.docbook:740 -msgid "You can now try and add elements to this collection, just like we did before by linking persons and events. It's the same code in Java:" -msgstr "今回、コレクションの初期化に <emphasis>fetch</emphasis> クエリを使用しませんでした。 そのため、getterメソッドの呼び出しによってコレクションを初期化するためのSELECTが 実行されるので、コレクションに要素を追加できます。 SQLのログを監視して、即時フェッチを使って最適化してください。" +#. Tag: para +#: tutorial.xml:740 +#, no-c-format +msgid "" +"You can now try and add elements to this collection, just like we did before " +"by linking persons and events. It's the same code in Java:" +msgstr "" +"以前人とイベントを関連づけたときと全く同じように、 今や試しにコレクションに要" +"素を追加することができるようになりました。 両方ともJavaでは同じコードです。" -#: index.docbook:745 +#. Tag: programlisting +#: tutorial.xml:745 +#, no-c-format msgid "" - "<![CDATA[private void addEmailToPerson(Long personId, String emailAddress) {\n" - "\n" - " Session session = HibernateUtil.getSessionFactory().getCurrentSession();\n" - " session.beginTransaction();\n" - "\n" - " Person aPerson = (Person) session.load(Person.class, personId);\n" - "\n" - " // The getEmailAddresses() might trigger a lazy load of the collection\n" - " aPerson.getEmailAddresses().add(emailAddress);\n" - "\n" - " session.getTransaction().commit();\n" - "}]]>" -msgstr "双方向関連" +"<![CDATA[private void addEmailToPerson(Long personId, String emailAddress) " +"{\n" +"\n" +" Session session = HibernateUtil.getSessionFactory().getCurrentSession" +"();\n" +" session.beginTransaction();\n" +"\n" +" Person aPerson = (Person) session.load(Person.class, personId);\n" +"\n" +" // The getEmailAddresses() might trigger a lazy load of the collection\n" +" aPerson.getEmailAddresses().add(emailAddress);\n" +"\n" +" session.getTransaction().commit();\n" +"}]]>" +msgstr "" -#: index.docbook:747 -msgid "This time we didnt' use a <emphasis>fetch</emphasis> query to initialize the collection. Hence, the call to its getter method will trigger an additional select to initialize it, so we can add an element to it. Monitor the SQL log and try to optimize this with an eager fetch." -msgstr "次に双方向関連をマッピングします。 Javaで両側から人とイベントの関連を動作させます。 もちろん、データベーススキーマは変わりませんが、多重度は多対多のままです。 リレーショナルデータベースはネットワークプログラミング言語よりも柔軟なので、 ナビゲーションの方向のようなものを必要としません。 データはあらゆるの方法で見たり復元できるということです。" +#. Tag: para +#: tutorial.xml:747 +#, no-c-format +msgid "" +"This time we didnt' use a <emphasis>fetch</emphasis> query to initialize the " +"collection. Hence, the call to its getter method will trigger an additional " +"select to initialize it, so we can add an element to it. Monitor the SQL log " +"and try to optimize this with an eager fetch." +msgstr "" +"今回、コレクションの初期化に <emphasis>fetch</emphasis> クエリを使用しません" +"でした。 そのため、getterメソッドの呼び出しによってコレクションを初期化するた" +"めのSELECTが 実行されるので、コレクションに要素を追加できます。 SQLのログを監" +"視して、即時フェッチを使って最適化してください。" -#: index.docbook:757 +#. Tag: title +#: tutorial.xml:757 +#, no-c-format msgid "Bi-directional associations" -msgstr "まず <literal>Event</literal> イベントクラスに参加者のコレクションを追加します：" +msgstr "双方向関連" -#: index.docbook:759 -msgid "Next we are going to map a bi-directional association - making the association between person and event work from both sides in Java. Of course, the database schema doesn't change, we still have many-to-many multiplicity. A relational database is more flexible than a network programming language, so it doesn't need anything like a navigation direction - data can be viewed and retrieved in any possible way." +#. Tag: para +#: tutorial.xml:759 +#, no-c-format +msgid "" +"Next we are going to map a bi-directional association - making the " +"association between person and event work from both sides in Java. Of " +"course, the database schema doesn't change, we still have many-to-many " +"multiplicity. A relational database is more flexible than a network " +"programming language, so it doesn't need anything like a navigation " +"direction - data can be viewed and retrieved in any possible way." msgstr "" - "<![CDATA[private Set participants = new HashSet(); -\n" - " -\n" - "public Set getParticipants() { -\n" - " return participants; -\n" - "} -\n" - " -\n" - "public void setParticipants(Set participants) { -\n" - " this.participants = participants; -\n" - "}]]>" +"次に双方向関連をマッピングします。 Javaで両側から人とイベントの関連を動作させ" +"ます。 もちろん、データベーススキーマは変わりませんが、多重度は多対多のままで" +"す。 リレーショナルデータベースはネットワークプログラミング言語よりも柔軟なの" +"で、 ナビゲーションの方向のようなものを必要としません。 データはあらゆるの方" +"法で見たり復元できるということです。" -#: index.docbook:767 -msgid "First, add a collection of participants to the <literal>Event</literal> Event class:" -msgstr "それでは <literal>Event.hbm.xml</literal> で関連のこちら側をマッピングしてください。" +#. Tag: para +#: tutorial.xml:767 +#, no-c-format +msgid "" +"First, add a collection of participants to the <literal>Event</literal> " +"Event class:" +msgstr "" +"まず <literal>Event</literal> イベントクラスに参加者のコレクションを追加しま" +"す：" -#: index.docbook:771 +#. Tag: programlisting +#: tutorial.xml:771 +#, no-c-format msgid "" - "<![CDATA[private Set participants = new HashSet();\n" - "\n" - "public Set getParticipants() {\n" - " return participants;\n" - "}\n" - "\n" - "public void setParticipants(Set participants) {\n" - " this.participants = participants;\n" - "}]]>" +"<![CDATA[private Set participants = new HashSet();\n" +"\n" +"public Set getParticipants() {\n" +" return participants;\n" +"}\n" +"\n" +"public void setParticipants(Set participants) {\n" +" this.participants = participants;\n" +"}]]>" msgstr "" - "<![CDATA[<set name=\"participants\" table=\"PERSON_EVENT\" inverse=\"true\"> -\n" - " <key column=\"EVENT_ID\"/> -\n" - " <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/> -\n" - "</set>]]>" -#: index.docbook:773 -msgid "Now map this side of the association too, in <literal>Event.hbm.xml</literal>." -msgstr "ご覧のとおり、いずれのマッピングドキュメント(XMLファイル)でも、普通の <literal>set</literal> マッピングを使っています。 <literal>key</literal> と <literal>many-to-many</literal> のカラム名が、 両方のマッピングドキュメントで入れ替えになっていることに注目してください。 ここで最も重要な追加項目は、 <literal>Event</literal> のコレクションマッピングの <literal>set</literal> 要素にある <literal>inverse=\"true\"</literal> 属性です。" +#. Tag: para +#: tutorial.xml:773 +#, no-c-format +msgid "" +"Now map this side of the association too, in <literal>Event.hbm.xml</" +"literal>." +msgstr "" +"それでは <literal>Event.hbm.xml</literal> で関連のこちら側をマッピングしてく" +"ださい。" -#: index.docbook:777 +#. Tag: programlisting +#: tutorial.xml:777 +#, no-c-format msgid "" - "<![CDATA[<set name=\"participants\" table=\"PERSON_EVENT\" inverse=\"true\">\n" - " <key column=\"EVENT_ID\"/>\n" - " <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/>\n" - "</set>]]>" -msgstr "この指定の意味は、2つの間のエンティティ間のリンクについての情報を探す必要があるとき、 Hibernateは反対側のエンティティ、つまり <literal>Person</literal> クラスから探すということです。 一度2つのエンティティ間の双方向リンクがどのように作成されるかがわかれば、 これを理解することはとても簡単です。" +"<![CDATA[<set name=\"participants\" table=\"PERSON_EVENT\" inverse=\"true" +"\">\n" +" <key column=\"EVENT_ID\"/>\n" +" <many-to-many column=\"PERSON_ID\" class=\"events.Person\"/>\n" +"</set>]]>" +msgstr "" -#: index.docbook:779 -msgid "As you see, these are normal <literal>set</literal> mappings in both mapping documents. Notice that the column names in <literal>key</literal> and <literal>many-to-many</literal> are swapped in both mapping documents. The most important addition here is the <literal>inverse=\"true\"</literal> attribute in the <literal>set</literal> element of the <literal>Event</literal>'s collection mapping." -msgstr "双方向リンクの動作" +#. Tag: para +#: tutorial.xml:779 +#, no-c-format +msgid "" +"As you see, these are normal <literal>set</literal> mappings in both mapping " +"documents. Notice that the column names in <literal>key</literal> and " +"<literal>many-to-many</literal> are swapped in both mapping documents. The " +"most important addition here is the <literal>inverse=\"true\"</literal> " +"attribute in the <literal>set</literal> element of the <literal>Event</" +"literal>'s collection mapping." +msgstr "" +"ご覧のとおり、いずれのマッピングドキュメント(XMLファイル)でも、普通の " +"<literal>set</literal> マッピングを使っています。 <literal>key</literal> と " +"<literal>many-to-many</literal> のカラム名が、 両方のマッピングドキュメントで" +"入れ替えになっていることに注目してください。 ここで最も重要な追加項目は、 " +"<literal>Event</literal> のコレクションマッピングの <literal>set</literal> 要" +"素にある <literal>inverse=\"true\"</literal> 属性です。" -#: index.docbook:787 -msgid "What this means is that Hibernate should take the other side - the <literal>Person</literal> class - when it needs to find out information about the link between the two. This will be a lot easier to understand once you see how the bi-directional link between our two entities is created ." -msgstr "まず、Hibernateが通常のJavaのセマンティクスに影響を及ぼさないことを心に留めておいてください。 私たちは、単方向の例としてどのように <literal>Person</literal> と <literal>Event</literal> の間のリンクを作成したでしょうか？ <literal>Person</literal> のインスタンスのイベントへの参照のコレクションに <literal>Event</literal> のインスタンスを追加しました。 そのためこのリンクを双方向にしたければ、 当たり前ですが反対側にも同じことをしなければなりません。 <literal>Event</literal> のコレクションに <literal>Person</literal> への 参照を追加するということです。 この「両側でリンクを設定すること」は絶対に必要なので、決して忘れないでください。" +#. Tag: para +#: tutorial.xml:787 +#, no-c-format +msgid "" +"What this means is that Hibernate should take the other side - the " +"<literal>Person</literal> class - when it needs to find out information " +"about the link between the two. This will be a lot easier to understand once " +"you see how the bi-directional link between our two entities is created ." +msgstr "" +"この指定の意味は、2つの間のエンティティ間のリンクについての情報を探す必要があ" +"るとき、 Hibernateは反対側のエンティティ、つまり <literal>Person</literal> ク" +"ラスから探すということです。 一度2つのエンティティ間の双方向リンクがどのよう" +"に作成されるかがわかれば、 これを理解することはとても簡単です。" -#: index.docbook:796 +#. Tag: title +#: tutorial.xml:796 +#, no-c-format msgid "Working bi-directional links" -msgstr "多くの開発者は慎重にプログラムするので、 エンティティの両側に正しく関連を設定するリンク管理メソッドを作成します。 例えば <literal>Person</literal> では以下のようになります。：" +msgstr "双方向リンクの動作" -#: index.docbook:798 -msgid "First, keep in mind that Hibernate does not affect normal Java semantics. How did we create a link between a <literal>Person</literal> and an <literal>Event</literal> in the unidirectional example? We added an instance of <literal>Event</literal> to the collection of event references, of an instance of <literal>Person</literal>. So, obviously, if we want to make this link working bi-directional, we have to do the same on the other side - adding a <literal>Person</literal> reference to the collection in an <literal>Event</literal>. This \"setting the link on both sides\" is absolutely necessary and you should never forget doing it." +#. Tag: para +#: tutorial.xml:798 +#, no-c-format +msgid "" +"First, keep in mind that Hibernate does not affect normal Java semantics. " +"How did we create a link between a <literal>Person</literal> and an " +"<literal>Event</literal> in the unidirectional example? We added an instance " +"of <literal>Event</literal> to the collection of event references, of an " +"instance of <literal>Person</literal>. So, obviously, if we want to make " +"this link working bi-directional, we have to do the same on the other side - " +"adding a <literal>Person</literal> reference to the collection in an " +"<literal>Event</literal>. This \"setting the link on both sides\" is " +"absolutely necessary and you should never forget doing it." msgstr "" - "<![CDATA[protected Set getEvents() { -\n" - " return events; -\n" - "} -\n" - " -\n" - "protected void setEvents(Set events) { -\n" - " this.events = events; -\n" - "} -\n" - " -\n" - "public void addToEvent(Event event) { -\n" - " this.getEvents().add(event); -\n" - " event.getParticipants().add(this); -\n" - "} -\n" - " -\n" - "public void removeFromEvent(Event event) { -\n" - " this.getEvents().remove(event); -\n" - " event.getParticipants().remove(this); -\n" - "}]]>" +"まず、Hibernateが通常のJavaのセマンティクスに影響を及ぼさないことを心に留めて" +"おいてください。 私たちは、単方向の例としてどのように <literal>Person</" +"literal> と <literal>Event</literal> の間のリンクを作成したでしょうか？ " +"<literal>Person</literal> のインスタンスのイベントへの参照のコレクションに " +"<literal>Event</literal> のインスタンスを追加しました。 そのためこのリンクを" +"双方向にしたければ、 当たり前ですが反対側にも同じことをしなければなりませ" +"ん。 <literal>Event</literal> のコレクションに <literal>Person</literal> へ" +"の 参照を追加するということです。 この「両側でリンクを設定すること」は絶対に" +"必要なので、決して忘れないでください。" -#: index.docbook:808 -msgid "Many developers program defensive and create link management methods to correctly set both sides, e.g. in <literal>Person</literal>:" -msgstr "コレクションのゲットとセットメソッドが現在protectedになっていることに注意してください。 これは同じパッケージのクラスやサブクラスのメソッドは依然アクセスが可能ですが、 （ほとんど）そのパッケージ外のどのクラスでも直接そのコレクションを台無しにすることを防ぎます。 おそらく反対側のコレクションにも同じことをした方がいいでしょう。" +#. Tag: para +#: tutorial.xml:808 +#, no-c-format +msgid "" +"Many developers program defensive and create link management methods to " +"correctly set both sides, e.g. in <literal>Person</literal>:" +msgstr "" +"多くの開発者は慎重にプログラムするので、 エンティティの両側に正しく関連を設定" +"するリンク管理メソッドを作成します。 例えば <literal>Person</literal> では以" +"下のようになります。：" -#: index.docbook:813 +#. Tag: programlisting +#: tutorial.xml:813 +#, no-c-format msgid "" - "<![CDATA[protected Set getEvents() {\n" - " return events;\n" - "}\n" - "\n" - "protected void setEvents(Set events) {\n" - " this.events = events;\n" - "}\n" - "\n" - "public void addToEvent(Event event) {\n" - " this.getEvents().add(event);\n" - " event.getParticipants().add(this);\n" - "}\n" - "\n" - "public void removeFromEvent(Event event) {\n" - " this.getEvents().remove(event);\n" - " event.getParticipants().remove(this);\n" - "}]]>" -msgstr "<literal>inverse</literal> マッピング属性とはいったい何でしょうか？ 開発者とJavaにとっては、双方向リンクは単に両側の参照を正しく設定するということです。 しかしHibernateは（制約違反を避けるために）SQLの <literal>INSERT</literal> と <literal>UPDATE</literal> 文を正確に変更するための十分な情報を持っていないので、 双方向関連プロパティを扱うための何らかの助けを必要とします。 関連の片側を <literal>inverse</literal> に設定することで、Hibernateは基本的には設定した側を無視し、 反対側の <emphasis>鏡</emphasis> として考えます。 これだけで、Hibernateは方向を持つナビゲーションモデルをSQLデータベーススキーマへ変換するときの すべての問題にうまく対処できます。 覚えておかなければならないルールは簡単です。 双方向関連は必�! ��片側を <literal>inverse</literal> にする必要があるということです。 一対多関連ではそれは多側でなければなりません。 多対多関連ではどちら側でも構いません。どちらでも違いはありません。" +"<![CDATA[protected Set getEvents() {\n" +" return events;\n" +"}\n" +"\n" +"protected void setEvents(Set events) {\n" +" this.events = events;\n" +"}\n" +"\n" +"public void addToEvent(Event event) {\n" +" this.getEvents().add(event);\n" +" event.getParticipants().add(this);\n" +"}\n" +"\n" +"public void removeFromEvent(Event event) {\n" +" this.getEvents().remove(event);\n" +" event.getParticipants().remove(this);\n" +"}]]>" +msgstr "" -#: index.docbook:815 -msgid "Notice that the get and set methods for the collection are now protected - this allows classes in the same package and subclasses to still access the methods, but prevents everybody else from messing with the collections directly (well, almost). You should probably do the same with the collection on the other side." -msgstr "ではこれを小さなWebアプリケーションにしてみましょう。" +#. Tag: para +#: tutorial.xml:815 +#, no-c-format +msgid "" +"Notice that the get and set methods for the collection are now protected - " +"this allows classes in the same package and subclasses to still access the " +"methods, but prevents everybody else from messing with the collections " +"directly (well, almost). You should probably do the same with the collection " +"on the other side." +msgstr "" +"コレクションのゲットとセットメソッドが現在protectedになっていることに注意して" +"ください。 これは同じパッケージのクラスやサブクラスのメソッドは依然アクセスが" +"可能ですが、 （ほとんど）そのパッケージ外のどのクラスでも直接そのコレクション" +"を台無しにすることを防ぎます。 おそらく反対側のコレクションにも同じことをした" +"方がいいでしょう。" -#: index.docbook:822 -msgid "What about the <literal>inverse</literal> mapping attribute? For you, and for Java, a bi-directional link is simply a matter of setting the references on both sides correctly. Hibernate however doesn't have enough information to correctly arrange SQL <literal>INSERT</literal> and <literal>UPDATE</literal> statements (to avoid constraint violations), and needs some help to handle bi-directional associations properly. Making one side of the association <literal>inverse</literal> tells Hibernate to basically ignore it, to consider it a <emphasis>mirror</emphasis> of the other side. That's all that is necessary for Hibernate to work out all of the issues when transformation a directional navigation model to a SQL database schema. The rules you have to remember are straightforward: All bi-directional associations need one side as <literal>inverse</literal>. In a one-to-many association it has to be the many-side, in many-to-many association you can pick either side, there! is no difference." -msgstr "パート3 - EventManager Webアプリケーション" +#. Tag: para +#: tutorial.xml:822 +#, no-c-format +msgid "" +"What about the <literal>inverse</literal> mapping attribute? For you, and " +"for Java, a bi-directional link is simply a matter of setting the references " +"on both sides correctly. Hibernate however doesn't have enough information " +"to correctly arrange SQL <literal>INSERT</literal> and <literal>UPDATE</" +"literal> statements (to avoid constraint violations), and needs some help to " +"handle bi-directional associations properly. Making one side of the " +"association <literal>inverse</literal> tells Hibernate to basically ignore " +"it, to consider it a <emphasis>mirror</emphasis> of the other side. That's " +"all that is necessary for Hibernate to work out all of the issues when " +"transformation a directional navigation model to a SQL database schema. The " +"rules you have to remember are straightforward: All bi-directional " +"associations need one side as <literal>inverse</literal>. In a one-to-many " +"association it has to be the many-side, in many-to-many association you can " +"pick either side, there is no difference." +msgstr "" +"<literal>inverse</literal> マッピング属性とはいったい何でしょうか？ 開発者と" +"Javaにとっては、双方向リンクは単に両側の参照を正しく設定するということです。 " +"しかしHibernateは（制約違反を避けるために）SQLの <literal>INSERT</literal> " +"と <literal>UPDATE</literal> 文を正確に変更するための十分な情報を持っていない" +"ので、 双方向関連プロパティを扱うための何らかの助けを必要とします。 関連の片" +"側を <literal>inverse</literal> に設定することで、Hibernateは基本的には設定し" +"た側を無視し、 反対側の <emphasis>鏡</emphasis> として考えます。 これだけで、" +"Hibernateは方向を持つナビゲーションモデルをSQLデータベーススキーマへ変換する" +"ときの すべての問題にうまく対処できます。 覚えておかなければならないルールは" +"簡単です。 双方向関連は必ず片側を <literal>inverse</literal> にする必要がある" +"ということです。 一対多関連ではそれは多側でなければなりません。 多対多関連で" +"はどちら側でも構いません。どちらでも違いはありません。" -#: index.docbook:837 +#. Tag: para +#: tutorial.xml:837 +#, no-c-format msgid "Let's turn this into a small web application." -msgstr "HibernateのWebアプリケーションは、スタンドアローンのアプリケーションのように <literal>Session</literal> と <literal>Transaction</literal> を使用します。 しかしいくつかの一般的なパターンが役立ちます。 ここで <literal>EventManagerServlet</literal> を作成します。このサーブレットは、 データベースに格納した全てのイベントをリストにでき、さらにHTMLフォームから新しいイベントを入力できるものです。" +msgstr "ではこれを小さなWebアプリケーションにしてみましょう。" -#: index.docbook:844 +#. Tag: title +#: tutorial.xml:844 +#, no-c-format msgid "Part 3 - The EventManager web application" -msgstr "基本的なServletの記述" +msgstr "パート3 - EventManager Webアプリケーション" -#: index.docbook:846 -msgid "A Hibernate web application uses <literal>Session</literal> and <literal>Transaction</literal> almost like a standalone application. However, some common patterns are useful. We now write an <literal>EventManagerServlet</literal>. This servlet can list all events stored in the database, and it provides an HTML form to enter new events." -msgstr "新しいクラスを、ソースディレクトリの <literal>events</literal> パッケージに作成してください。" +#. Tag: para +#: tutorial.xml:846 +#, no-c-format +msgid "" +"A Hibernate web application uses <literal>Session</literal> and " +"<literal>Transaction</literal> almost like a standalone application. " +"However, some common patterns are useful. We now write an " +"<literal>EventManagerServlet</literal>. This servlet can list all events " +"stored in the database, and it provides an HTML form to enter new events." +msgstr "" +"HibernateのWebアプリケーションは、スタンドアローンのアプリケーションのように " +"<literal>Session</literal> と <literal>Transaction</literal> を使用します。 " +"しかしいくつかの一般的なパターンが役立ちます。 ここで " +"<literal>EventManagerServlet</literal> を作成します。このサーブレットは、 " +"データベースに格納した全てのイベントをリストにでき、さらにHTMLフォームから新" +"しいイベントを入力できるものです。" -#: index.docbook:854 +#. Tag: title +#: tutorial.xml:854 +#, no-c-format msgid "Writing the basic servlet" +msgstr "基本的なServletの記述" + +#. Tag: para +#: tutorial.xml:856 +#, no-c-format +msgid "" +"Create a new class in your source directory, in the <literal>events</" +"literal> package:" msgstr "" - "<![CDATA[package events; -\n" - " -\n" - "// Imports -\n" - " -\n" - "public class EventManagerServlet extends HttpServlet { -\n" - " -\n" - " // Servlet code -\n" - "}]]>" +"新しいクラスを、ソースディレクトリの <literal>events</literal> パッケージに作" +"成してください。" -#: index.docbook:856 -msgid "Create a new class in your source directory, in the <literal>events</literal> package:" -msgstr "ServletはHTTPの <literal>GET</literal> リクエストのみを処理するので、 <literal>doGet()</literal> を実装します。" +#. Tag: programlisting +#: tutorial.xml:861 +#, no-c-format +msgid "" +"<![CDATA[package events;\n" +"\n" +"// Imports\n" +"\n" +"public class EventManagerServlet extends HttpServlet {\n" +"\n" +" // Servlet code\n" +"}]]>" +msgstr "" -#: index.docbook:861 +#. Tag: para +#: tutorial.xml:863 +#, no-c-format msgid "" - "<![CDATA[package events;\n" - "\n" - "// Imports\n" - "\n" - "public class EventManagerServlet extends HttpServlet {\n" - "\n" - " // Servlet code\n" - "}]]>" +"The servlet handles HTTP <literal>GET</literal> requests only, hence, the " +"method we implement is <literal>doGet()</literal>:" msgstr "" - "<![CDATA[protected void doGet(HttpServletRequest request, -\n" - " HttpServletResponse response) -\n" - " throws ServletException, IOException { -\n" - " -\n" - " SimpleDateFormat dateFormatter = new SimpleDateFormat(\"dd.MM.yyyy\"); -\n" - " -\n" - " try { -\n" - " // Begin unit of work -\n" - " HibernateUtil.getSessionFactory() -\n" - " .getCurrentSession().beginTransaction(); -\n" - " -\n" - " // Process request and render page... -\n" - " -\n" - " // End unit of work -\n" - " HibernateUtil.getSessionFactory() -\n" - " .getCurrentSession().getTransaction().commit(); -\n" - " -\n" - " } catch (Exception ex) { -\n" - " HibernateUtil.getSessionFactory() -\n" - " .getCurrentSession().getTransaction().rollback(); -\n" - " throw new ServletException(ex); -\n" - " } -\n" - " -\n" - "}]]>" +"ServletはHTTPの <literal>GET</literal> リクエストのみを処理するので、 " +"<literal>doGet()</literal> を実装します。" -#: index.docbook:863 -msgid "The servlet handles HTTP <literal>GET</literal> requests only, hence, the method we implement is <literal>doGet()</literal>:" -msgstr "これは <emphasis>session-per-request</emphasis> というパターンです。 Servletがリクエストを受け取ると、 <literal>SessionFactory</literal> の <literal>getCurrentSession()</literal> の最初の呼び出しで、 Hibernateの新しい <literal>Session</literal> が開かれます。 そのときデータベーストランザクションが開始されます。 データの読み書きに関わらず、すべてのデータアクセスはトランザクション内で行います。 （アプリケーション内ではオートコミットモードを使用しません）。" +#. Tag: programlisting +#: tutorial.xml:868 +#, no-c-format +msgid "" +"<![CDATA[protected void doGet(HttpServletRequest request,\n" +" HttpServletResponse response)\n" +" throws ServletException, IOException {\n" +"\n" +" SimpleDateFormat dateFormatter = new SimpleDateFormat(\"dd.MM.yyyy\");\n" +"\n" +" try {\n" +" // Begin unit of work\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().beginTransaction();\n" +"\n" +" // Process request and render page...\n" +"\n" +" // End unit of work\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().getTransaction().commit();\n" +"\n" +" } catch (Exception ex) {\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().getTransaction().rollback();\n" +" throw new ServletException(ex);\n" +" }\n" +"\n" +"}]]>" +msgstr "" -#: index.docbook:868 +#. Tag: para +#: tutorial.xml:870 +#, fuzzy, no-c-format msgid "" - "<![CDATA[protected void doGet(HttpServletRequest request,\n" - " HttpServletResponse response)\n" - " throws ServletException, IOException {\n" - "\n" - " SimpleDateFormat dateFormatter = new SimpleDateFormat(\"dd.MM.yyyy\");\n" - "\n" - " try {\n" - " // Begin unit of work\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().beginTransaction();\n" - "\n" - " // Process request and render page...\n" - "\n" - " // End unit of work\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().getTransaction().commit();\n" - "\n" - " } catch (Exception ex) {\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().getTransaction().rollback();\n" - " throw new ServletException(ex);\n" - " }\n" - "\n" - "}]]>" -msgstr "次に、リクエストのアクションは処理され、レスポンスであるHTMLが描画されます。 これについてはすぐに説明します。" +"The pattern we are applying here is called <emphasis>session-per-request</" +"emphasis>. When a request hits the servlet, a new Hibernate " +"<literal>Session</literal> is opened through the first call to " +"<literal>getCurrentSession()</literal> on the <literal>SessionFactory</" +"literal>. Then a database transaction is started&mdash;all data access as to " +"occur inside a transaction, no matter if data is read or written (we don't " +"use the auto-commit mode in applications)." +msgstr "" +"これは <emphasis>session-per-request</emphasis> というパターンです。 Servlet" +"がリクエストを受け取ると、 <literal>SessionFactory</literal> の " +"<literal>getCurrentSession()</literal> の最初の呼び出しで、 Hibernateの新し" +"い <literal>Session</literal> が開かれます。 そのときデータベーストランザク" +"ションが開始されます。 データの読み書きに関わらず、すべてのデータアクセスはト" +"ランザクション内で行います。 （アプリケーション内ではオートコミットモードを使" +"用しません）。" -#: index.docbook:870 -msgid "The pattern we are applying here is called <emphasis>session-per-request</emphasis>. When a request hits the servlet, a new Hibernate <literal>Session</literal> is opened through the first call to <literal>getCurrentSession()</literal> on the <literal>SessionFactory</literal>. Then a database transaction is started&mdash;all data access as to occur inside a transaction, no matter if data is read or written (we don't use the auto-commit mode in applications)." -msgstr "最後にリクエストの処理とHTML描画が完了したときに、作業単位(Unit of Work)を終了します。 もし処理や描画中に問題が発生した場合、exceptionが投げられてデータベーストランザクションをロールバックします。 これで <literal>session-per-request</literal> パターンが完了します。 全てのサーブレットにトランザクション境界のコードを書く代わりに、サーブレットフィルタに記述することも可能です。 <emphasis>Open Session in View</emphasis> と呼ばれるこのパターンについては、 HibernateのWebサイトやWikiを参照してください。 サーブレットではなくJSPでHTML描画をしようとすると、すぐにこのパターンについての情報が必要になるでしょう。" +#. Tag: para +#: tutorial.xml:879 +#, no-c-format +msgid "" +"Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> " +"for every database operation. Use one Hibernate <literal>Session</literal> " +"that is scoped to the whole request. Use <literal>getCurrentSession()</" +"literal>, so that it is automatically bound to the current Java thread." +msgstr "" +"Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> " +"for every database operation. Use one Hibernate <literal>Session</literal> " +"that is scoped to the whole request. Use <literal>getCurrentSession()</" +"literal>, so that it is automatically bound to the current Java thread." -#: index.docbook:879 -msgid "Do <emphasis>not</emphasis> use a new Hibernate <literal>Session</literal> for every database operation. Use one Hibernate <literal>Session</literal> that is scoped to the whole request. Use <literal>getCurrentSession()</literal>, so that it is automatically bound to the current Java thread." +#. Tag: para +#: tutorial.xml:886 +#, no-c-format +msgid "" +"Next, the possible actions of the request are processed and the response " +"HTML is rendered. We'll get to that part soon." +msgstr "" +"次に、リクエストのアクションは処理され、レスポンスであるHTMLが描画されます。 " +"これについてはすぐに説明します。" + +#. Tag: para +#: tutorial.xml:891 +#, fuzzy, no-c-format +msgid "" +"Finally, the unit of work ends when processing and rendering is complete. If " +"any problem occured during processing or rendering, an exception will be " +"thrown and the database transaction rolled back. This completes the " +"<literal>session-per-request</literal> pattern. Instead of the transaction " +"demarcation code in every servlet you could also write a servlet filter. See " +"the Hibernate website and Wiki for more information about this pattern, " +"called <emphasis>Open Session in View</emphasis>&mdash;you'll need it as " +"soon as you consider rendering your view in JSP, not in a servlet." +msgstr "" +"最後にリクエストの処理とHTML描画が完了したときに、作業単位(Unit of Work)を終" +"了します。 もし処理や描画中に問題が発生した場合、exceptionが投げられてデータ" +"ベーストランザクションをロールバックします。 これで <literal>session-per-" +"request</literal> パターンが完了します。 全てのサーブレットにトランザクション" +"境界のコードを書く代わりに、サーブレットフィルタに記述することも可能です。 " +"<emphasis>Open Session in View</emphasis> と呼ばれるこのパターンについては、 " +"HibernateのWebサイトやWikiを参照してください。 サーブレットではなくJSPでHTML" +"描画をしようとすると、すぐにこのパターンについての情報が必要になるでしょう。" + +#. Tag: title +#: tutorial.xml:905 +#, no-c-format +msgid "Processing and rendering" msgstr "処理と描画" -#: index.docbook:886 -msgid "Next, the possible actions of the request are processed and the response HTML is rendered. We'll get to that part soon." +#. Tag: para +#: tutorial.xml:907 +#, no-c-format +msgid "" +"Let's implement the processing of the request and rendering of the page." msgstr "では、リクエストの処理とページの描画を実装します。" -#: index.docbook:891 -msgid "Finally, the unit of work ends when processing and rendering is complete. If any problem occured during processing or rendering, an exception will be thrown and the database transaction rolled back. This completes the <literal>session-per-request</literal> pattern. Instead of the transaction demarcation code in every servlet you could also write a servlet filter. See the Hibernate website and Wiki for more information about this pattern, called <emphasis>Open Session in View</emphasis>&mdash;you'll need it as soon as you consider rendering your view in JSP, not in a servlet." +#. Tag: programlisting +#: tutorial.xml:911 +#, no-c-format +msgid "" +"<![CDATA[// Write HTML header\n" +"PrintWriter out = response.getWriter();\n" +"out.println(\"<html><head><title>Event Manager</title></head><body>\");\n" +"\n" +"// Handle actions\n" +"if ( \"store\".equals(request.getParameter(\"action\")) ) {\n" +"\n" +" String eventTitle = request.getParameter(\"eventTitle\");\n" +" String eventDate = request.getParameter(\"eventDate\");\n" +"\n" +" if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) {\n" +" out.println(\"<b><i>Please enter event title and date.</i></b>\");\n" +" } else {\n" +" createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));\n" +" out.println(\"<b><i>Added event.</i></b>\");\n" +" }\n" +"}\n" +"\n" +"// Print page\n" +"printEventForm(out);\n" +"listEvents(out, dateFormatter);\n" +"\n" +"// Write HTML footer\n" +"out.println(\"</body></html>\");\n" +"out.flush();\n" +"out.close();]]>" msgstr "" - "<![CDATA[// Write HTML header -\n" - "PrintWriter out = response.getWriter(); -\n" - "out.println(\"<html><head><title>Event Manager</title></head><body>\"); -\n" - " -\n" - "// Handle actions -\n" - "if ( \"store\".equals(request.getParameter(\"action\")) ) { -\n" - " -\n" - " String eventTitle = request.getParameter(\"eventTitle\"); -\n" - " String eventDate = request.getParameter(\"eventDate\"); -\n" - " -\n" - " if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) { -\n" - " out.println(\"<b><i>Please enter event title and date.</i></b>\"); -\n" - " } else { -\n" - " createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate)); -\n" - " out.println(\"<b><i>Added event.</i></b>\"); -\n" - " } -\n" - "} -\n" - " -\n" - "// Print page -\n" - "printEventForm(out); -\n" - "listEvents(out, dateFormatter); -\n" - " -\n" - "// Write HTML footer -\n" - "out.println(\"</body></html>\"); -\n" - "out.flush(); -\n" - "out.close();]]>" -#: index.docbook:905 -msgid "Processing and rendering" -msgstr "JavaとHTMLが混在するコーディングスタイルは、より複雑なアプリケーションには適していないでしょう （このチュートリアルでは、基本的なHibernateのコンセプトを示しているだけであることを覚えておいてください）。 このコードはHTMLのヘッダーとフッターの記述です。 このページには、イベントを入力するHTMLフォームと、データベースにある全てのイベントのリストが表示されます。 最初のメソッドはごく単純なHTML出力です。" +#. Tag: para +#: tutorial.xml:913 +#, fuzzy, no-c-format +msgid "" +"Granted, this coding style with a mix of Java and HTML would not scale in a " +"more complex application&mdash;keep in mind that we are only illustrating " +"basic Hibernate concepts in this tutorial. The code prints an HTML header " +"and a footer. Inside this page, an HTML form for event entry and a list of " +"all events in the database are printed. The first method is trivial and only " +"outputs HTML:" +msgstr "" +"JavaとHTMLが混在するコーディングスタイルは、より複雑なアプリケーションには適" +"していないでしょう （このチュートリアルでは、基本的なHibernateのコンセプトを" +"示しているだけであることを覚えておいてください）。 このコードはHTMLのヘッダー" +"とフッターの記述です。 このページには、イベントを入力するHTMLフォームと、デー" +"タベースにある全てのイベントのリストが表示されます。 最初のメソッドはごく単純" +"なHTML出力です。" -#: index.docbook:907 -msgid "Let's implement the processing of the request and rendering of the page." +#. Tag: programlisting +#: tutorial.xml:922 +#, no-c-format +msgid "" +"<![CDATA[private void printEventForm(PrintWriter out) {\n" +" out.println(\"<h2>Add new event:</h2>\");\n" +" out.println(\"<form>\");\n" +" out.println(\"Title: <input name='eventTitle' length='50'/><br/>\");\n" +" out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' " +"length='10'/><br/>\");\n" +" out.println(\"<input type='submit' name='action' value='store'/>\");\n" +" out.println(\"</form>\");\n" +"}]]>" msgstr "" - "<![CDATA[private void printEventForm(PrintWriter out) { -\n" - " out.println(\"<h2>Add new event:</h2>\"); -\n" - " out.println(\"<form>\"); -\n" - " out.println(\"Title: <input name='eventTitle' length='50'/><br/>\"); -\n" - " out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>\"); -\n" - " out.println(\"<input type='submit' name='action' value='store'/>\"); -\n" - " out.println(\"</form>\"); -\n" - "}]]>" -#: index.docbook:911 +#. Tag: para +#: tutorial.xml:924 +#, no-c-format msgid "" - "<![CDATA[// Write HTML header\n" - "PrintWriter out = response.getWriter();\n" - "out.println(\"<html><head><title>Event Manager</title></head><body>\");\n" - "\n" - "// Handle actions\n" - "if ( \"store\".equals(request.getParameter(\"action\")) ) {\n" - "\n" - " String eventTitle = request.getParameter(\"eventTitle\");\n" - " String eventDate = request.getParameter(\"eventDate\");\n" - "\n" - " if ( \"\".equals(eventTitle) || \"\".equals(eventDate) ) {\n" - " out.println(\"<b><i>Please enter event title and date.</i></b>\");\n" - " } else {\n" - " createAndStoreEvent(eventTitle, dateFormatter.parse(eventDate));\n" - " out.println(\"<b><i>Added event.</i></b>\");\n" - " }\n" - "}\n" - "\n" - "// Print page\n" - "printEventForm(out);\n" - "listEvents(out, dateFormatter);\n" - "\n" - "// Write HTML footer\n" - "out.println(\"</body></html>\");\n" - "out.flush();\n" - "out.close();]]>" -msgstr "<literal>listEvents()</literal> メソッドは、現在のスレッドに結びつく Hibernateの <literal>Session</literal> を使用して、クエリを実行します。" +"The <literal>listEvents()</literal> method uses the Hibernate " +"<literal>Session</literal> bound to the current thread to execute a query:" +msgstr "" +"<literal>listEvents()</literal> メソッドは、現在のスレッドに結びつく " +"Hibernateの <literal>Session</literal> を使用して、クエリを実行します。" -#: index.docbook:913 -msgid "Granted, this coding style with a mix of Java and HTML would not scale in a more complex application&mdash;keep in mind that we are only illustrating basic Hibernate concepts in this tutorial. The code prints an HTML header and a footer. Inside this page, an HTML form for event entry and a list of all events in the database are printed. The first method is trivial and only outputs HTML:" +#. Tag: programlisting +#: tutorial.xml:930 +#, no-c-format +msgid "" +"<![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat " +"dateFormatter) {\n" +"\n" +" List result = HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().createCriteria(Event.class).list" +"();\n" +" if (result.size() > 0) {\n" +" out.println(\"<h2>Events in database:</h2>\");\n" +" out.println(\"<table border='1'>\");\n" +" out.println(\"<tr>\");\n" +" out.println(\"<th>Event title</th>\");\n" +" out.println(\"<th>Event date</th>\");\n" +" out.println(\"</tr>\");\n" +" for (Iterator it = result.iterator(); it.hasNext();) {\n" +" Event event = (Event) it.next();\n" +" out.println(\"<tr>\");\n" +" out.println(\"<td>\" + event.getTitle() + \"</td>\");\n" +" out.println(\"<td>\" + dateFormatter.format(event.getDate()) + " +"\"</td>\");\n" +" out.println(\"</tr>\");\n" +" }\n" +" out.println(\"</table>\");\n" +" }\n" +"}]]>" msgstr "" - "<![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) { -\n" - " -\n" - " List result = HibernateUtil.getSessionFactory() -\n" - " .getCurrentSession().createCriteria(Event.class).list(); -\n" - " if (result.size() > 0) { -\n" - " out.println(\"<h2>Events in database:</h2>\"); -\n" - " out.println(\"<table border='1'>\"); -\n" - " out.println(\"<tr>\"); -\n" - " out.println(\"<th>Event title</th>\"); -\n" - " out.println(\"<th>Event date</th>\"); -\n" - " out.println(\"</tr>\"); -\n" - " for (Iterator it = result.iterator(); it.hasNext();) { -\n" - " Event event = (Event) it.next(); -\n" - " out.println(\"<tr>\"); -\n" - " out.println(\"<td>\" + event.getTitle() + \"</td>\"); -\n" - " out.println(\"<td>\" + dateFormatter.format(event.getDate()) + \"</td>\"); -\n" - " out.println(\"</tr>\"); -\n" - " } -\n" - " out.println(\"</table>\"); -\n" - " } -\n" - "}]]>" -#: index.docbook:922 +#. Tag: para +#: tutorial.xml:932 +#, no-c-format msgid "" - "<![CDATA[private void printEventForm(PrintWriter out) {\n" - " out.println(\"<h2>Add new event:</h2>\");\n" - " out.println(\"<form>\");\n" - " out.println(\"Title: <input name='eventTitle' length='50'/><br/>\");\n" - " out.println(\"Date (e.g. 24.12.2009): <input name='eventDate' length='10'/><br/>\");\n" - " out.println(\"<input type='submit' name='action' value='store'/>\");\n" - " out.println(\"</form>\");\n" - "}]]>" -msgstr "最後に、 <literal>store</literal> アクションが <literal>createAndStoreEvent()</literal> メソッドを 呼び出します。このメソッドでも現在のスレッドの <literal>Session</literal> を利用します。" +"Finally, the <literal>store</literal> action is dispatched to the " +"<literal>createAndStoreEvent()</literal> method, which also uses the " +"<literal>Session</literal> of the current thread:" +msgstr "" +"最後に、 <literal>store</literal> アクションが <literal>createAndStoreEvent()" +"</literal> メソッドを 呼び出します。このメソッドでも現在のスレッドの " +"<literal>Session</literal> を利用します。" -#: index.docbook:924 -msgid "The <literal>listEvents()</literal> method uses the Hibernate <literal>Session</literal> bound to the current thread to execute a query:" +#. Tag: programlisting +#: tutorial.xml:938 +#, no-c-format +msgid "" +"<![CDATA[protected void createAndStoreEvent(String title, Date theDate) {\n" +" Event theEvent = new Event();\n" +" theEvent.setTitle(title);\n" +" theEvent.setDate(theDate);\n" +"\n" +" HibernateUtil.getSessionFactory()\n" +" .getCurrentSession().save(theEvent);\n" +"}]]>" msgstr "" - "<![CDATA[protected void createAndStoreEvent(String title, Date theDate) { -\n" - " Event theEvent = new Event(); -\n" - " theEvent.setTitle(title); -\n" - " theEvent.setDate(theDate); -\n" - " -\n" - " HibernateUtil.getSessionFactory() -\n" - " .getCurrentSession().save(theEvent); -\n" - "}]]>" -#: index.docbook:930 +#. Tag: para +#: tutorial.xml:940 +#, no-c-format msgid "" - "<![CDATA[private void listEvents(PrintWriter out, SimpleDateFormat dateFormatter) {\n" - "\n" - " List result = HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().createCriteria(Event.class).list();\n" - " if (result.size() > 0) {\n" - " out.println(\"<h2>Events in database:</h2>\");\n" - " out.println(\"<table border='1'>\");\n" - " out.println(\"<tr>\");\n" - " out.println(\"<th>Event title</th>\");\n" - " out.println(\"<th>Event date</th>\");\n" - " out.println(\"</tr>\");\n" - " for (Iterator it = result.iterator(); it.hasNext();) {\n" - " Event event = (Event) it.next();\n" - " out.println(\"<tr>\");\n" - " out.println(\"<td>\" + event.getTitle() + \"</td>\");\n" - " out.println(\"<td>\" + dateFormatter.format(event.getDate()) + \"</td>\");\n" - " out.println(\"</tr>\");\n" - " }\n" - " out.println(\"</table>\");\n" - " }\n" - "}]]>" -msgstr "これでサーブレットの完成です。 サーブレットへのリクエストは、一つの <literal>Session</literal> と <literal>Transaction</literal> で処理されるでしょう。 最初のスタンドアローンのアプリケーションのように、 Hibernateは自動的にこれらのオブジェクトを実行するスレッドに結び付けることができます。 これにより、開発者が自由にコードをレイヤー分けでき、 好きな方法で <literal>SessionFactory</literal> へのアクセスができるようになります。 通常、開発者はより洗練されたデザインを使用して、データアクセスのコードを データアクセスオブジェクトに移動するでしょう（DAOパターン）。 より多くの例は、HibernateのWikiを参照してください。" +"That's it, the servlet is complete. A request to the servlet will be " +"processed in a single <literal>Session</literal> and <literal>Transaction</" +"literal>. As earlier in the standalone application, Hibernate can " +"automatically bind these ojects to the current thread of execution. This " +"gives you the freedom to layer your code and access the " +"<literal>SessionFactory</literal> in any way you like. Usually you'd use a " +"more sophisticated design and move the data access code into data access " +"objects (the DAO pattern). See the Hibernate Wiki for more examples." +msgstr "" +"これでサーブレットの完成です。 サーブレットへのリクエストは、一つの " +"<literal>Session</literal> と <literal>Transaction</literal> で処理されるで" +"しょう。 最初のスタンドアローンのアプリケーションのように、 Hibernateは自動的" +"にこれらのオブジェクトを実行するスレッドに結び付けることができます。 これによ" +"り、開発者が自由にコードをレイヤー分けでき、 好きな方法で " +"<literal>SessionFactory</literal> へのアクセスができるようになります。 通常、" +"開発者はより洗練されたデザインを使用して、データアクセスのコードを データアク" +"セスオブジェクトに移動するでしょう（DAOパターン）。 より多くの例は、Hibernate" +"のWikiを参照してください。" -#: index.docbook:932 -msgid "Finally, the <literal>store</literal> action is dispatched to the <literal>createAndStoreEvent()</literal> method, which also uses the <literal>Session</literal> of the current thread:" +#. Tag: title +#: tutorial.xml:954 +#, no-c-format +msgid "Deploying and testing" msgstr "デプロイとテスト" -#: index.docbook:938 +#. Tag: para +#: tutorial.xml:956 +#, no-c-format msgid "" - "<![CDATA[protected void createAndStoreEvent(String title, Date theDate) {\n" - " Event theEvent = new Event();\n" - " theEvent.setTitle(title);\n" - " theEvent.setDate(theDate);\n" - "\n" - " HibernateUtil.getSessionFactory()\n" - " .getCurrentSession().save(theEvent);\n" - "}]]>" -msgstr "このアプリケーションのデプロイのために、Webアーカイブ（WAR）を作成してください。 以下のAntターゲットを <literal>build.xml</literal> に加えてください。" +"To deploy this application you have to create a web archive, a WAR. Add the " +"following Ant target to your <literal>build.xml</literal>:" +msgstr "" +"このアプリケーションのデプロイのために、Webアーカイブ（WAR）を作成してくださ" +"い。 以下のAntターゲットを <literal>build.xml</literal> に加えてください。" -#: index.docbook:940 -msgid "That's it, the servlet is complete. A request to the servlet will be processed in a single <literal>Session</literal> and <literal>Transaction</literal>. As earlier in the standalone application, Hibernate can automatically bind these ojects to the current thread of execution. This gives you the freedom to layer your code and access the <literal>SessionFactory</literal> in any way you like. Usually you'd use a more sophisticated design and move the data access code into data access objects (the DAO pattern). See the Hibernate Wiki for more examples." +#. Tag: programlisting +#: tutorial.xml:961 +#, no-c-format +msgid "" +"<![CDATA[<target name=\"war\" depends=\"compile\">\n" +" <war destfile=\"hibernate-tutorial.war\" webxml=\"web.xml\">\n" +" <lib dir=\"${librarydir}\">\n" +" <exclude name=\"jsdk*.jar\"/>\n" +" </lib>\n" +"\n" +" <classes dir=\"${targetdir}\"/>\n" +" </war>\n" +"</target>]]>" msgstr "" - "<![CDATA[<target name=\"war\" depends=\"compile\"> -\n" - " <war destfile=\"hibernate-tutorial.war\" webxml=\"web.xml\"> -\n" - " <lib dir=\"${librarydir}\"> -\n" - " <exclude name=\"jsdk*.jar\"/> -\n" - " </lib> -\n" - " -\n" - " <classes dir=\"${targetdir}\"/> -\n" - " </war> -\n" - "</target>]]>" -#: index.docbook:954 -msgid "Deploying and testing" -msgstr "このターゲットは <literal>hibernate-tutorial.war</literal> というファイルを プロジェクトディレクトリに作成します。 このファイルはすべてのライブラリと <literal>web.xml</literal> 記述子を含んでおり、 プロジェクトのベースディレクトリに置かれることを期待されます。" +#. Tag: para +#: tutorial.xml:963 +#, no-c-format +msgid "" +"This target creates a file called <literal>hibernate-tutorial.war</literal> " +"in your project directory. It packages all libraries and the <literal>web." +"xml</literal> descriptor, which is expected in the base directory of your " +"project:" +msgstr "" +"このターゲットは <literal>hibernate-tutorial.war</literal> というファイルを " +"プロジェクトディレクトリに作成します。 このファイルはすべてのライブラリと " +"<literal>web.xml</literal> 記述子を含んでおり、 プロジェクトのベースディレク" +"トリに置かれることを期待されます。" -#: index.docbook:956 -msgid "To deploy this application you have to create a web archive, a WAR. Add the following Ant target to your <literal>build.xml</literal>:" +#. Tag: programlisting +#: tutorial.xml:969 +#, no-c-format +msgid "" +"<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +"<web-app version=\"2.4\"\n" +" xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" +" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" +" xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee http://java.sun.com/" +"xml/ns/j2ee/web-app_2_4.xsd\">\n" +"\n" +" <servlet>\n" +" <servlet-name>Event Manager</servlet-name>\n" +" <servlet-class>events.EventManagerServlet</servlet-class>\n" +" </servlet>\n" +"\n" +" <servlet-mapping>\n" +" <servlet-name>Event Manager</servlet-name>\n" +" <url-pattern>/eventmanager</url-pattern>\n" +" </servlet-mapping>\n" +"</web-app>]]>" msgstr "" - "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?> -\n" - "<web-app version=\"2.4\" -\n" - " xmlns=\"http://java.sun.com/xml/ns/j2ee\" -\n" - " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" -\n" - " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd\"> -\n" - " -\n" - " <servlet> -\n" - " <servlet-name>Event Manager</servlet-name> -\n" - " <servlet-class>events.EventManagerServlet</servlet-class> -\n" - " </servlet> -\n" - " -\n" - " <servlet-mapping> -\n" - " <servlet-name>Event Manager</servlet-name> -\n" - " <url-pattern>/eventmanager</url-pattern> -\n" - " </servlet-mapping> -\n" - "</web-app>]]>" -#: index.docbook:961 +#. Tag: para +#: tutorial.xml:971 +#, no-c-format msgid "" - "<![CDATA[<target name=\"war\" depends=\"compile\">\n" - " <war destfile=\"hibernate-tutorial.war\" webxml=\"web.xml\">\n" - " <lib dir=\"${librarydir}\">\n" - " <exclude name=\"jsdk*.jar\"/>\n" - " </lib>\n" - "\n" - " <classes dir=\"${targetdir}\"/>\n" - " </war>\n" - "</target>]]>" -msgstr "Webアプリケーションのコンパイルとデプロイの前に、 <literal>jsdk.jar</literal> という 追加のライブラリが必要なことに注意してください。 これはJavaサーブレットの開発キットです。 もしまだこのライブラリを持っていないなら、Sunのウェブサイトで入手して、 ライブラリディレクトリにコピーしてください。 しかし、これはコンパイルにのみ使用され、WARパッケージからは除外されます。" +"Before you compile and deploy the web application, note that an additional " +"library is required: <literal>jsdk.jar</literal>. This is the Java servlet " +"development kit, if you don't have this library already, get it from the Sun " +"website and copy it to your library directory. However, it will be only used " +"for compliation and excluded from the WAR package." +msgstr "" +"Webアプリケーションのコンパイルとデプロイの前に、 <literal>jsdk.jar</" +"literal> という 追加のライブラリが必要なことに注意してください。 これはJava" +"サーブレットの開発キットです。 もしまだこのライブラリを持っていないなら、Sun" +"のウェブサイトで入手して、 ライブラリディレクトリにコピーしてください。 しか" +"し、これはコンパイルにのみ使用され、WARパッケージからは除外されます。" -#: index.docbook:963 -msgid "This target creates a file called <literal>hibernate-tutorial.war</literal> in your project directory. It packages all libraries and the <literal>web.xml</literal> descriptor, which is expected in the base directory of your project:" -msgstr "ビルドとデプロイのために、プロジェクトディレクトリで <literal>ant war</literal> を呼び出し、 <literal>hibernate-tutorial.war</literal> ファイルをTomcatの <literal>webapp</literal> ディレクトリにコピーしてください。 まだTomcatをインストールしていなければ、ダウンロードして、以下のインストールガイドに従ってください。 しかし、このアプリケーションのデプロイするために、Tomcatの設定を変更する必要はありません。" +#. Tag: para +#: tutorial.xml:979 +#, no-c-format +msgid "" +"To build and deploy call <literal>ant war</literal> in your project " +"directory and copy the <literal>hibernate-tutorial.war</literal> file into " +"your Tomcat <literal>webapp</literal> directory. If you don't have Tomcat " +"installed, download it and follow the installation instructions. You don't " +"have to change any Tomcat configuration to deploy this application though." +msgstr "" +"ビルドとデプロイのために、プロジェクトディレクトリで <literal>ant war</" +"literal> を呼び出し、 <literal>hibernate-tutorial.war</literal> ファイルを" +"Tomcatの <literal>webapp</literal> ディレクトリにコピーしてください。 まだ" +"Tomcatをインストールしていなければ、ダウンロードして、以下のインストールガイ" +"ドに従ってください。 しかし、このアプリケーションのデプロイするために、Tomcat" +"の設定を変更する必要はありません。" -#: index.docbook:969 +#. Tag: para +#: tutorial.xml:987 +#, no-c-format msgid "" - "<![CDATA[<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" - "<web-app version=\"2.4\"\n" - " xmlns=\"http://java.sun.com/xml/ns/j2ee\"\n" - " xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n" - " xsi:schemaLocation=\"http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd\">\n" - "\n" - " <servlet>\n" - " <servlet-name>Event Manager</servlet-name>\n" - " <servlet-class>events.EventManagerServlet</servlet-class>\n" - " </servlet>\n" - "\n" - " <servlet-mapping>\n" - " <servlet-name>Event Manager</servlet-name>\n" - " <url-pattern>/eventmanager</url-pattern>\n" - " </servlet-mapping>\n" - "</web-app>]]>" -msgstr "一度デプロイしてTomcatを起動すれば、 <literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal> で アプリケーションへのアクセスが可能です。 最初のリクエストが作成したサーブレットに渡ったときに、Tomcatのログで Hibernateの初期化処理を確認してください （ <literal>HibernateUtil</literal> 内の静的初期化ブロックが呼ばれています）。 また、exceptionが発生したなら詳細を確認してください。" +"Once deployed and Tomcat is running, access the application at " +"<literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. " +"Make sure you watch the Tomcat log to see Hibernate initialize when the " +"first request hits your servlet (the static initializer in " +"<literal>HibernateUtil</literal> is called) and to get the detailed output " +"if any exceptions occurs." +msgstr "" +"一度デプロイしてTomcatを起動すれば、 <literal>http://localhost:8080/" +"hibernate-tutorial/eventmanager</literal> で アプリケーションへのアクセスが可" +"能です。 最初のリクエストが作成したサーブレットに渡ったときに、Tomcatのログ" +"で Hibernateの初期化処理を確認してください （ <literal>HibernateUtil</" +"literal> 内の静的初期化ブロックが呼ばれています）。 また、exceptionが発生した" +"なら詳細を確認してください。" -#: index.docbook:971 -msgid "Before you compile and deploy the web application, note that an additional library is required: <literal>jsdk.jar</literal>. This is the Java servlet development kit, if you don't have this library already, get it from the Sun website and copy it to your library directory. However, it will be only used for compliation and excluded from the WAR package." -msgstr "<title>要約</title>" - -#: index.docbook:979 -msgid "To build and deploy call <literal>ant war</literal> in your project directory and copy the <literal>hibernate-tutorial.war</literal> file into your Tomcat <literal>webapp</literal> directory. If you don't have Tomcat installed, download it and follow the installation instructions. You don't have to change any Tomcat configuration to deploy this application though." -msgstr "このチュートリアルでは、簡単なスタンドアローンのHibernateアプリケーションと 小規模のWebアプリケーションを書くための基本を紹介しました。" - -#: index.docbook:987 -msgid "Once deployed and Tomcat is running, access the application at <literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. Make sure you watch the Tomcat log to see Hibernate initialize when the first request hits your servlet (the static initializer in <literal>HibernateUtil</literal> is called) and to get the detailed output if any exceptions occurs." -msgstr "もうHibernateに自信があれば、リファレンスドキュメントの目次に目を通して、 面白そうだと思うトピックを探してください。 最も頻繁に質問があるのは、トランザクション処理（<xref linkend=\"transactions\"/>）、 フェッチのパフォーマンス（<xref linkend=\"performance\"/>）、 APIの使い方（<xref linkend=\"objectstate\"/>）とクエリ （<xref linkend=\"objectstate-querying\"/>）です。" - -#: index.docbook:1000 +#. Tag: title +#: tutorial.xml:1000 +#, no-c-format msgid "Summary" -msgstr "さらに（特別な）チュートリアルが必要なら、Hibernateウェブサイトを忘れずにチェックしてください。" +msgstr "要約" -#: index.docbook:1002 -msgid "This tutorial covered the basics of writing a simple standalone Hibernate application and a small web application." +#. Tag: para +#: tutorial.xml:1002 +#, no-c-format +msgid "" +"This tutorial covered the basics of writing a simple standalone Hibernate " +"application and a small web application." msgstr "" +"このチュートリアルでは、簡単なスタンドアローンのHibernateアプリケーションと " +"小規模のWebアプリケーションを書くための基本を紹介しました。" -#: index.docbook:1007 -msgid "If you already feel confident with Hibernate, continue browsing through the reference documentation table of contents for topics you find interesting - most asked are transactional processing (<xref linkend=\"transactions\"/>), fetch performance (<xref linkend=\"performance\"/>), or the usage of the API (<xref linkend=\"objectstate\"/>) and the query features (<xref linkend=\"objectstate-querying\"/>)." +#. Tag: para +#: tutorial.xml:1007 +#, no-c-format +msgid "" +"If you already feel confident with Hibernate, continue browsing through the " +"reference documentation table of contents for topics you find interesting - " +"most asked are transactional processing (<xref linkend=\"transactions\"/>), " +"fetch performance (<xref linkend=\"performance\"/>), or the usage of the API " +"(<xref linkend=\"objectstate\"/>) and the query features (<xref linkend=" +"\"objectstate-querying\"/>)." msgstr "" +"もうHibernateに自信があれば、リファレンスドキュメントの目次に目を通して、 面" +"白そうだと思うトピックを探してください。 最も頻繁に質問があるのは、トランザク" +"ション処理（<xref linkend=\"transactions\"/>）、 フェッチのパフォーマンス" +"（<xref linkend=\"performance\"/>）、 APIの使い方（<xref linkend=" +"\"objectstate\"/>）とクエリ （<xref linkend=\"objectstate-querying\"/>）で" +"す。" -#: index.docbook:1015 -msgid "Don't forget to check the Hibernate website for more (specialized) tutorials." +#. Tag: para +#: tutorial.xml:1015 +#, no-c-format +msgid "" +"Don't forget to check the Hibernate website for more (specialized) tutorials." msgstr "" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +"さらに（特別な）チュートリアルが必要なら、Hibernateウェブサイトを忘れずに" +"チェックしてください。" Modified: core/trunk/documentation/manual/translations/ja-JP/content/xml.po =================================================================== --- core/trunk/documentation/manual/translations/ja-JP/content/xml.po 2007-10-25 07:54:59 UTC (rev 14131) +++ core/trunk/documentation/manual/translations/ja-JP/content/xml.po 2007-10-25 07:57:28 UTC (rev 14132) @@ -1,549 +1,442 @@ -#, fuzzy msgid "" msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2007-10-25 07:48+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" -"Content-Type: text/plain; charset=utf-8\n" -#: index.docbook:5 +"Language-Team: LANGUAGE <LL(a)li.org&gt;\n&quot; +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. Tag: title +#: xml.xml:5 +#, no-c-format msgid "XML Mapping" msgstr "XMLマッピング" -#: index.docbook:7 -msgid "Note that this is an experimental feature in Hibernate 3.0 and is under extremely active development." -msgstr "XMLマッピングはHibernate3.0では試験的な機能であり、非常に活動的に開発中です。" +#. Tag: emphasis +#: xml.xml:7 +#, no-c-format +msgid "" +"Note that this is an experimental feature in Hibernate 3.0 and is under " +"extremely active development." +msgstr "" +"XMLマッピングはHibernate3.0では試験的な機能であり、非常に活動的に開発中です。" -#: index.docbook:13 +#. Tag: title +#: xml.xml:13 +#, no-c-format msgid "Working with XML data" msgstr "XMLデータでの作業" -#: index.docbook:15 -msgid "Hibernate lets you work with persistent XML data in much the same way you work with persistent POJOs. A parsed XML tree can be thought of as just another way to represent the relational data at the object level, instead of POJOs." -msgstr "Hibernateでは永続性のPOJOを使って作業するのとほぼ同じようなやり方で、 永続性のXMLデータを使って作業できます。" +#. Tag: para +#: xml.xml:15 +#, no-c-format +msgid "" +"Hibernate lets you work with persistent XML data in much the same way you " +"work with persistent POJOs. A parsed XML tree can be thought of as just " +"another way to represent the relational data at the object level, instead of " +"POJOs." +msgstr "" +"Hibernateでは永続性のPOJOを使って作業するのとほぼ同じようなやり方で、 永続性" +"のXMLデータを使って作業できます。" -#: index.docbook:22 -msgid "Hibernate supports dom4j as API for manipulating XML trees. You can write queries that retrieve dom4j trees from the database and have any modification you make to the tree automatically synchronized to the database. You can even take an XML document, parse it using dom4j, and write it to the database with any of Hibernate's basic operations: <literal>persist(), saveOrUpdate(), merge(), delete(), replicate()</literal> (merging is not yet supported)." -msgstr "HibernateはXMLツリーを操作するためのAPIとしてdom4jをサポートしています。 データベースからdom4jのツリーを復元するクエリを書くことができ、 ツリーに対して行った修正は自動的にデータベースと同期されます。 またXMLドキュメントを取得することができ、dom4jを使ってドキュメントをパースし、 Hibernateの任意の基本操作を使ってデータベースへ書き込むことができます。： つまり、<literal>persist(), saveOrUpdate(), merge(), delete(), replicate()</literal> 操作です(マージはまだサポートしていません)。" +#. Tag: para +#: xml.xml:22 +#, no-c-format +msgid "" +"Hibernate supports dom4j as API for manipulating XML trees. You can write " +"queries that retrieve dom4j trees from the database and have any " +"modification you make to the tree automatically synchronized to the " +"database. You can even take an XML document, parse it using dom4j, and write " +"it to the database with any of Hibernate's basic operations: <literal>persist" +"(), saveOrUpdate(), merge(), delete(), replicate()</literal> (merging is not " +"yet supported)." +msgstr "" +"HibernateはXMLツリーを操作するためのAPIとしてdom4jをサポートしています。 デー" +"タベースからdom4jのツリーを復元するクエリを書くことができ、 ツリーに対して" +"行った修正は自動的にデータベースと同期されます。 またXMLドキュメントを取得す" +"ることができ、dom4jを使ってドキュメントをパースし、 Hibernateの任意の基本操作" +"を使ってデータベースへ書き込むことができます。： つまり、<literal>persist(), " +"saveOrUpdate(), merge(), delete(), replicate()</literal> 操作です(マージはま" +"だサポートしていません)。" -#: index.docbook:32 -msgid "This feature has many applications including data import/export, externalization of entity data via JMS or SOAP and XSLT-based reporting." -msgstr "データのインポート/エクスポート、 JMSによるエンティティデータの外部化やSOAP、XSLTベースのレポートなど、 この機能には多くの用途があります。" +#. Tag: para +#: xml.xml:32 +#, no-c-format +msgid "" +"This feature has many applications including data import/export, " +"externalization of entity data via JMS or SOAP and XSLT-based reporting." +msgstr "" +"データのインポート/エクスポート、 JMSによるエンティティデータの外部化やSOAP、" +"XSLTベースのレポートなど、 この機能には多くの用途があります。" -#: index.docbook:37 -msgid "A single mapping may be used to simultaneously map properties of a class and nodes of an XML document to the database, or, if there is no class to map, it may be used to map just the XML." -msgstr "単一のマッピングは、クラスのプロパティとXMLドキュメントのノードを 同時にデータベースへマッピングするために使うことができます。 またマッピングするクラスがなければ、 XMLだけをマッピングするために使うことができます。" +#. Tag: para +#: xml.xml:37 +#, no-c-format +msgid "" +"A single mapping may be used to simultaneously map properties of a class and " +"nodes of an XML document to the database, or, if there is no class to map, " +"it may be used to map just the XML." +msgstr "" +"単一のマッピングは、クラスのプロパティとXMLドキュメントのノードを 同時にデー" +"タベースへマッピングするために使うことができます。 またマッピングするクラスが" +"なければ、 XMLだけをマッピングするために使うことができます。" -#: index.docbook:44 +#. Tag: title +#: xml.xml:44 +#, no-c-format msgid "Specifying XML and class mapping together" msgstr "XMLとクラスのマッピングを同時に指定する" -#: index.docbook:46 +#. Tag: para +#: xml.xml:46 +#, no-c-format msgid "Here is an example of mapping a POJO and XML simultaneously:" msgstr "これはPOJOとXMLを同時にマッピングする例です。：" -#: index.docbook:50 +#. Tag: programlisting +#: xml.xml:50 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Account\" \n" - " table=\"ACCOUNTS\" \n" - " node=\"account\">\n" - " \n" - " <id name=\"accountId\" \n" - " column=\"ACCOUNT_ID\" \n" - " node=\"@id\"/>\n" - " \n" - " <many-to-one name=\"customer\" \n" - " column=\"CUSTOMER_ID\" \n" - " node=\"customer/@id\" \n" - " embed-xml=\"false\"/>\n" - " \n" - " <property name=\"balance\" \n" - " column=\"BALANCE\" \n" - " node=\"balance\"/>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Account\" \n" +" table=\"ACCOUNTS\" \n" +" node=\"account\">\n" +" \n" +" <id name=\"accountId\" \n" +" column=\"ACCOUNT_ID\" \n" +" node=\"@id\"/>\n" +" \n" +" <many-to-one name=\"customer\" \n" +" column=\"CUSTOMER_ID\" \n" +" node=\"customer/@id\" \n" +" embed-xml=\"false\"/>\n" +" \n" +" <property name=\"balance\" \n" +" column=\"BALANCE\" \n" +" node=\"balance\"/>\n" +" \n" +" ...\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Account\" -\n" - " table=\"ACCOUNTS\" -\n" - " node=\"account\"> -\n" - " -\n" - " <id name=\"accountId\" -\n" - " column=\"ACCOUNT_ID\" -\n" - " node=\"@id\"/> -\n" - " -\n" - " <many-to-one name=\"customer\" -\n" - " column=\"CUSTOMER_ID\" -\n" - " node=\"customer/@id\" -\n" - " embed-xml=\"false\"/> -\n" - " -\n" - " <property name=\"balance\" -\n" - " column=\"BALANCE\" -\n" - " node=\"balance\"/> -\n" - " -\n" - " ... -\n" - " -\n" - "</class>]]>" -#: index.docbook:54 +#. Tag: title +#: xml.xml:54 +#, no-c-format msgid "Specifying only an XML mapping" msgstr "XMLマッピングだけを指定する" -#: index.docbook:56 +#. Tag: para +#: xml.xml:56 +#, no-c-format msgid "Here is an example where there is no POJO class:" msgstr "これはPOJOクラスがないマッピングの例です。：" -#: index.docbook:60 +#. Tag: programlisting +#: xml.xml:60 +#, no-c-format msgid "" - "<![CDATA[<class entity-name=\"Account\" \n" - " table=\"ACCOUNTS\" \n" - " node=\"account\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"ACCOUNT_ID\" \n" - " node=\"@id\" \n" - " type=\"string\"/>\n" - " \n" - " <many-to-one name=\"customerId\" \n" - " column=\"CUSTOMER_ID\" \n" - " node=\"customer/@id\" \n" - " embed-xml=\"false\" \n" - " entity-name=\"Customer\"/>\n" - " \n" - " <property name=\"balance\" \n" - " column=\"BALANCE\" \n" - " node=\"balance\" \n" - " type=\"big_decimal\"/>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" +"<![CDATA[<class entity-name=\"Account\" \n" +" table=\"ACCOUNTS\" \n" +" node=\"account\">\n" +" \n" +" <id name=\"id\" \n" +" column=\"ACCOUNT_ID\" \n" +" node=\"@id\" \n" +" type=\"string\"/>\n" +" \n" +" <many-to-one name=\"customerId\" \n" +" column=\"CUSTOMER_ID\" \n" +" node=\"customer/@id\" \n" +" embed-xml=\"false\" \n" +" entity-name=\"Customer\"/>\n" +" \n" +" <property name=\"balance\" \n" +" column=\"BALANCE\" \n" +" node=\"balance\" \n" +" type=\"big_decimal\"/>\n" +" \n" +" ...\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class entity-name=\"Account\" -\n" - " table=\"ACCOUNTS\" -\n" - " node=\"account\"> -\n" - " -\n" - " <id name=\"id\" -\n" - " column=\"ACCOUNT_ID\" -\n" - " node=\"@id\" -\n" - " type=\"string\"/> -\n" - " -\n" - " <many-to-one name=\"customerId\" -\n" - " column=\"CUSTOMER_ID\" -\n" - " node=\"customer/@id\" -\n" - " embed-xml=\"false\" -\n" - " entity-name=\"Customer\"/> -\n" - " -\n" - " <property name=\"balance\" -\n" - " column=\"BALANCE\" -\n" - " node=\"balance\" -\n" - " type=\"big_decimal\"/> -\n" - " -\n" - " ... -\n" - " -\n" - "</class>]]>" -#: index.docbook:62 -msgid "This mapping allows you to access the data as a dom4j tree, or as a graph of property name/value pairs (java <literal>Map</literal>s). The property names are purely logical constructs that may be referred to in HQL queries." -msgstr "このマッピングにより、dom4jツリーか、 プロパティ名/値の組のグラフ（javaの <literal>Map</literal>）として データにアクセスできます。 プロパティの名前は、HQLクエリー内で参照できる純粋な論理構造です。" +#. Tag: para +#: xml.xml:62 +#, no-c-format +msgid "" +"This mapping allows you to access the data as a dom4j tree, or as a graph of " +"property name/value pairs (java <literal>Map</literal>s). The property names " +"are purely logical constructs that may be referred to in HQL queries." +msgstr "" +"このマッピングにより、dom4jツリーか、 プロパティ名/値の組のグラフ（javaの " +"<literal>Map</literal>）として データにアクセスできます。 プロパティの名前" +"は、HQLクエリー内で参照できる純粋な論理構造です。" -#: index.docbook:73 +#. Tag: title +#: xml.xml:73 +#, no-c-format msgid "XML mapping metadata" msgstr "XMLマッピングのメタデータ" -#: index.docbook:75 -msgid "Many Hibernate mapping elements accept the <literal>node</literal> attribute. This let's you specify the name of an XML attribute or element that holds the property or entity data. The format of the <literal>node</literal> attribute must be one of the following:" -msgstr "多くのHibernateのマッピング要素は　<literal>node</literal>　属性が使用できます。 これによりXML属性の名前やプロパティやエンティティデータを保持する要素を指定できます。 <literal>node</literal>　属性のフォーマットは以下の中の1つでなければなりません。：" +#. Tag: para +#: xml.xml:75 +#, no-c-format +msgid "" +"Many Hibernate mapping elements accept the <literal>node</literal> " +"attribute. This let's you specify the name of an XML attribute or element " +"that holds the property or entity data. The format of the <literal>node</" +"literal> attribute must be one of the following:" +msgstr "" +"多くのHibernateのマッピング要素は　<literal>node</literal>　属性が使用できま" +"す。 これによりXML属性の名前やプロパティやエンティティデータを保持する要素を" +"指定できます。 <literal>node</literal>　属性のフォーマットは以下の中の1つでな" +"ければなりません。：" -#: index.docbook:84 +#. Tag: para +#: xml.xml:84 +#, no-c-format msgid "<literal>\"element-name\"</literal> - map to the named XML element" -msgstr "<literal>\"element-name\"</literal> - 指定したXML要素へマッピングします" +msgstr "" +"<literal>\"element-name\"</literal> - 指定したXML要素へマッピングします" -#: index.docbook:87 +#. Tag: para +#: xml.xml:87 +#, no-c-format msgid "<literal>\"@attribute-name\"</literal> - map to the named XML attribute" -msgstr "<literal>\"@attribute-name\"</literal> - 指定したXML属性へマッピングします" +msgstr "" +"<literal>\"@attribute-name\"</literal> - 指定したXML属性へマッピングします" -#: index.docbook:90 +#. Tag: para +#: xml.xml:90 +#, no-c-format msgid "<literal>\".\"</literal> - map to the parent element" msgstr "<literal>\".\"</literal> -　親要素へマッピングします" -#: index.docbook:93 -msgid "<literal>\"element-name/@attribute-name\"</literal> - map to the named attribute of the named element" -msgstr "<literal>\"element-name/@attribute-name\"</literal> - 指定したエレメントの指定した属性へマッピングします" +#. Tag: para +#: xml.xml:93 +#, no-c-format +msgid "" +"<literal>\"element-name/@attribute-name\"</literal> - map to the named " +"attribute of the named element" +msgstr "" +"<literal>\"element-name/@attribute-name\"</literal> - 指定したエレメントの指" +"定した属性へマッピングします" -#: index.docbook:100 -msgid "For collections and single valued associations, there is an additional <literal>embed-xml</literal> attribute. If <literal>embed-xml=\"true\"</literal>, the default, the XML tree for the associated entity (or collection of value type) will be embedded directly in the XML tree for the entity that owns the association. Otherwise, if <literal>embed-xml=\"false\"</literal>, then only the referenced identifier value will appear in the XML for single point associations and collections will simply not appear at all." -msgstr "コレクションと単一の値の関連に対して、 おまけの <literal>embed-xml</literal> 属性があります。 デフォルトの <literal>embed-xml=\"true\"</literal> と設定した場合、 関連するエンティティ(値型のコレクション)のXMLツリーは、 直接関連を所有するエンティティのXMLツリー内に埋め込まれます。 反対に、<literal>embed-xml=\"false\"</literal> と設定した場合、 参照される識別子の値だけが多重度１側の関連に対するXMLに現れ、 単純にコレクションはまったく現れなくなります。" +#. Tag: para +#: xml.xml:100 +#, no-c-format +msgid "" +"For collections and single valued associations, there is an additional " +"<literal>embed-xml</literal> attribute. If <literal>embed-xml=\"true\"</" +"literal>, the default, the XML tree for the associated entity (or collection " +"of value type) will be embedded directly in the XML tree for the entity that " +"owns the association. Otherwise, if <literal>embed-xml=\"false\"</literal>, " +"then only the referenced identifier value will appear in the XML for single " +"point associations and collections will simply not appear at all." +msgstr "" +"コレクションと単一の値の関連に対して、 おまけの <literal>embed-xml</literal> " +"属性があります。 デフォルトの <literal>embed-xml=\"true\"</literal> と設定し" +"た場合、 関連するエンティティ(値型のコレクション)のXMLツリーは、 直接関連を所" +"有するエンティティのXMLツリー内に埋め込まれます。 反対に、<literal>embed-xml=" +"\"false\"</literal> と設定した場合、 参照される識別子の値だけが多重度１側の関" +"連に対するXMLに現れ、 単純にコレクションはまったく現れなくなります。" -#: index.docbook:110 -msgid "You should be careful not to leave <literal>embed-xml=\"true\"</literal> for too many associations, since XML does not deal well with circularity!" -msgstr "あまりに多くの関連に対して <literal>embed-xml=\"true\"</literal> としたままにするのは注意すべきです。 XMLは循環をうまく扱えません。" +#. Tag: para +#: xml.xml:110 +#, no-c-format +msgid "" +"You should be careful not to leave <literal>embed-xml=\"true\"</literal> for " +"too many associations, since XML does not deal well with circularity!" +msgstr "" +"あまりに多くの関連に対して <literal>embed-xml=\"true\"</literal> としたままに" +"するのは注意すべきです。 XMLは循環をうまく扱えません。" -#: index.docbook:115 +#. Tag: programlisting +#: xml.xml:115 +#, no-c-format msgid "" - "<![CDATA[<class name=\"Customer\" \n" - " table=\"CUSTOMER\" \n" - " node=\"customer\">\n" - " \n" - " <id name=\"id\" \n" - " column=\"CUST_ID\" \n" - " node=\"@id\"/>\n" - " \n" - " <map name=\"accounts\" \n" - " node=\".\" \n" - " embed-xml=\"true\">\n" - " <key column=\"CUSTOMER_ID\" \n" - " not-null=\"true\"/>\n" - " <map-key column=\"SHORT_DESC\" \n" - " node=\"@short-desc\" \n" - " type=\"string\"/>\n" - " <one-to-many entity-name=\"Account\"\n" - " embed-xml=\"false\" \n" - " node=\"account\"/>\n" - " </map>\n" - " \n" - " <component name=\"name\" \n" - " node=\"name\">\n" - " <property name=\"firstName\" \n" - " node=\"first-name\"/>\n" - " <property name=\"initial\" \n" - " node=\"initial\"/>\n" - " <property name=\"lastName\" \n" - " node=\"last-name\"/>\n" - " </component>\n" - " \n" - " ...\n" - " \n" - "</class>]]>" +"<![CDATA[<class name=\"Customer\" \n" +" table=\"CUSTOMER\" \n" +" node=\"customer\">\n" +" \n" +" <id name=\"id\" \n" +" column=\"CUST_ID\" \n" +" node=\"@id\"/>\n" +" \n" +" <map name=\"accounts\" \n" +" node=\".\" \n" +" embed-xml=\"true\">\n" +" <key column=\"CUSTOMER_ID\" \n" +" not-null=\"true\"/>\n" +" <map-key column=\"SHORT_DESC\" \n" +" node=\"@short-desc\" \n" +" type=\"string\"/>\n" +" <one-to-many entity-name=\"Account\"\n" +" embed-xml=\"false\" \n" +" node=\"account\"/>\n" +" </map>\n" +" \n" +" <component name=\"name\" \n" +" node=\"name\">\n" +" <property name=\"firstName\" \n" +" node=\"first-name\"/>\n" +" <property name=\"initial\" \n" +" node=\"initial\"/>\n" +" <property name=\"lastName\" \n" +" node=\"last-name\"/>\n" +" </component>\n" +" \n" +" ...\n" +" \n" +"</class>]]>" msgstr "" - "<![CDATA[<class name=\"Customer\" -\n" - " table=\"CUSTOMER\" -\n" - " node=\"customer\"> -\n" - " -\n" - " <id name=\"id\" -\n" - " column=\"CUST_ID\" -\n" - " node=\"@id\"/> -\n" - " -\n" - " <map name=\"accounts\" -\n" - " node=\".\" -\n" - " embed-xml=\"true\"> -\n" - " <key column=\"CUSTOMER_ID\" -\n" - " not-null=\"true\"/> -\n" - " <map-key column=\"SHORT_DESC\" -\n" - " node=\"@short-desc\" -\n" - " type=\"string\"/> -\n" - " <one-to-many entity-name=\"Account\" -\n" - " embed-xml=\"false\" -\n" - " node=\"account\"/> -\n" - " </map> -\n" - " -\n" - " <component name=\"name\" -\n" - " node=\"name\"> -\n" - " <property name=\"firstName\" -\n" - " node=\"first-name\"/> -\n" - " <property name=\"initial\" -\n" - " node=\"initial\"/> -\n" - " <property name=\"lastName\" -\n" - " node=\"last-name\"/> -\n" - " </component> -\n" - " -\n" - " ... -\n" - " -\n" - "</class>]]>" -#: index.docbook:117 -msgid "in this case, we have decided to embed the collection of account ids, but not the actual account data. The following HQL query:" -msgstr "この例では、実際のaccountのデータではなく、 accountのidのコレクションを埋め込むことにしました。 続きのHQLクエリです：" +#. Tag: para +#: xml.xml:117 +#, no-c-format +msgid "" +"in this case, we have decided to embed the collection of account ids, but " +"not the actual account data. The following HQL query:" +msgstr "" +"この例では、実際のaccountのデータではなく、 accountのidのコレクションを埋め込" +"むことにしました。 続きのHQLクエリです：" -#: index.docbook:122 -msgid "<![CDATA[from Customer c left join fetch c.accounts where c.lastName like :lastName]]>" -msgstr "<![CDATA[from Customer c left join fetch c.accounts where c.lastName like :lastName]]>" +#. Tag: programlisting +#: xml.xml:122 +#, no-c-format +msgid "" +"<![CDATA[from Customer c left join fetch c.accounts where c.lastName like :" +"lastName]]>" +msgstr "" -#: index.docbook:124 +#. Tag: para +#: xml.xml:124 +#, no-c-format msgid "Would return datasets such as this:" msgstr "このようなデータセットを返すでしょう" -#: index.docbook:128 +#. Tag: programlisting +#: xml.xml:128 +#, no-c-format msgid "" - "<![CDATA[<customer id=\"123456789\">\n" - " <account short-desc=\"Savings\">987632567</account>\n" - " <account short-desc=\"Credit Card\">985612323</account>\n" - " <name>\n" - " <first-name>Gavin</first-name>\n" - " <initial>A</initial>\n" - " <last-name>King</last-name>\n" - " </name>\n" - " ...\n" - "</customer>]]>" +"<![CDATA[<customer id=\"123456789\">\n" +" <account short-desc=\"Savings\">987632567</account>\n" +" <account short-desc=\"Credit Card\">985612323</account>\n" +" <name>\n" +" <first-name>Gavin</first-name>\n" +" <initial>A</initial>\n" +" <last-name>King</last-name>\n" +" </name>\n" +" ...\n" +"</customer>]]>" msgstr "" - "<![CDATA[<customer id=\"123456789\"> -\n" - " <account short-desc=\"Savings\">987632567</account> -\n" - " <account short-desc=\"Credit Card\">985612323</account> -\n" - " <name> -\n" - " <first-name>Gavin</first-name> -\n" - " <initial>A</initial> -\n" - " <last-name>King</last-name> -\n" - " </name> -\n" - " ... -\n" - "</customer>]]>" -#: index.docbook:130 -msgid "If you set <literal>embed-xml=\"true\"</literal> on the <literal>&lt;one-to-many&gt;</literal> mapping, the data might look more like this:" -msgstr "<literal>&lt;one-to-many&gt;</literal> マッピングで <literal>embed-xml=\"true\"</literal> と設定した場合、 データはこのようになるでしょう。" +#. Tag: para +#: xml.xml:130 +#, no-c-format +msgid "" +"If you set <literal>embed-xml=\"true\"</literal> on the <literal>&lt;one-to-" +"many&gt;</literal> mapping, the data might look more like this:" +msgstr "" +"<literal>&lt;one-to-many&gt;</literal> マッピングで <literal>embed-xml=\"true" +"\"</literal> と設定した場合、 データはこのようになるでしょう。" -#: index.docbook:135 +#. Tag: programlisting +#: xml.xml:135 +#, no-c-format msgid "" - "<![CDATA[<customer id=\"123456789\">\n" - " <account id=\"987632567\" short-desc=\"Savings\">\n" - " <customer id=\"123456789\"/>\n" - " <balance>100.29</balance>\n" - " </account>\n" - " <account id=\"985612323\" short-desc=\"Credit Card\">\n" - " <customer id=\"123456789\"/>\n" - " <balance>-2370.34</balance>\n" - " </account>\n" - " <name>\n" - " <first-name>Gavin</first-name>\n" - " <initial>A</initial>\n" - " <last-name>King</last-name>\n" - " </name>\n" - " ...\n" - "</customer>]]>" +"<![CDATA[<customer id=\"123456789\">\n" +" <account id=\"987632567\" short-desc=\"Savings\">\n" +" <customer id=\"123456789\"/>\n" +" <balance>100.29</balance>\n" +" </account>\n" +" <account id=\"985612323\" short-desc=\"Credit Card\">\n" +" <customer id=\"123456789\"/>\n" +" <balance>-2370.34</balance>\n" +" </account>\n" +" <name>\n" +" <first-name>Gavin</first-name>\n" +" <initial>A</initial>\n" +" <last-name>King</last-name>\n" +" </name>\n" +" ...\n" +"</customer>]]>" msgstr "" - "<![CDATA[<customer id=\"123456789\"> -\n" - " <account id=\"987632567\" short-desc=\"Savings\"> -\n" - " <customer id=\"123456789\"/> -\n" - " <balance>100.29</balance> -\n" - " </account> -\n" - " <account id=\"985612323\" short-desc=\"Credit Card\"> -\n" - " <customer id=\"123456789\"/> -\n" - " <balance>-2370.34</balance> -\n" - " </account> -\n" - " <name> -\n" - " <first-name>Gavin</first-name> -\n" - " <initial>A</initial> -\n" - " <last-name>King</last-name> -\n" - " </name> -\n" - " ... -\n" - "</customer>]]>" -#: index.docbook:141 +#. Tag: title +#: xml.xml:141 +#, no-c-format msgid "Manipulating XML data" msgstr "XMLデータを扱う" -#: index.docbook:143 -msgid "Let's rearead and update XML documents in the application. We do this by obtaining a dom4j session:" -msgstr "XMLドキュメントを、アプリケーション内で再読み込みや更新をしてみましょう。 以下ではdom4jのセッションを取得することで行います。：" +#. Tag: para +#: xml.xml:143 +#, no-c-format +msgid "" +"Let's rearead and update XML documents in the application. We do this by " +"obtaining a dom4j session:" +msgstr "" +"XMLドキュメントを、アプリケーション内で再読み込みや更新をしてみましょう。 以" +"下ではdom4jのセッションを取得することで行います。：" -#: index.docbook:148 +#. Tag: programlisting +#: xml.xml:148 +#, no-c-format msgid "" - "<![CDATA[Document doc = ....;\n" - " \n" - "Session session = factory.openSession();\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "List results = dom4jSession\n" - " .createQuery(\"from Customer c left join fetch c.accounts where c.lastName like :lastName\")\n" - " .list();\n" - "for ( int i=0; i<results.size(); i++ ) {\n" - " //add the customer data to the XML document\n" - " Element customer = (Element) results.get(i);\n" - " doc.add(customer);\n" - "}\n" - "\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Document doc = ....;\n" +" \n" +"Session session = factory.openSession();\n" +"Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"List results = dom4jSession\n" +" .createQuery(\"from Customer c left join fetch c.accounts where c." +"lastName like :lastName\")\n" +" .list();\n" +"for ( int i=0; i<results.size(); i++ ) {\n" +" //add the customer data to the XML document\n" +" Element customer = (Element) results.get(i);\n" +" doc.add(customer);\n" +"}\n" +"\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" - "<![CDATA[Document doc = ....; -\n" - " -\n" - "Session session = factory.openSession(); -\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "List results = dom4jSession -\n" - " .createQuery(\"from Customer c left join fetch c.accounts where c.lastName like :lastName\") -\n" - " .list(); -\n" - "for ( int i=0; i<results.size(); i++ ) { -\n" - " //add the customer data to the XML document -\n" - " Element customer = (Element) results.get(i); -\n" - " doc.getRootElement().add(customer); -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" -#: index.docbook:150 +#. Tag: programlisting +#: xml.xml:150 +#, no-c-format msgid "" - "<![CDATA[Session session = factory.openSession();\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" - "Transaction tx = session.beginTransaction();\n" - "\n" - "Element cust = (Element) dom4jSession.get(\"Customer\", customerId);\n" - "for ( int i=0; i<results.size(); i++ ) {\n" - " Element customer = (Element) results.get(i);\n" - " //change the customer name in the XML and database\n" - " Element name = customer.element(\"name\");\n" - " name.element(\"first-name\").setText(firstName);\n" - " name.element(\"initial\").setText(initial);\n" - " name.element(\"last-name\").setText(lastName);\n" - "}\n" - "\n" - "tx.commit();\n" - "session.close();]]>" +"<![CDATA[Session session = factory.openSession();\n" +"Session dom4jSession = session.getSession(EntityMode.DOM4J);\n" +"Transaction tx = session.beginTransaction();\n" +"\n" +"Element cust = (Element) dom4jSession.get(\"Customer\", customerId);\n" +"for ( int i=0; i<results.size(); i++ ) {\n" +" Element customer = (Element) results.get(i);\n" +" //change the customer name in the XML and database\n" +" Element name = customer.element(\"name\");\n" +" name.element(\"first-name\").setText(firstName);\n" +" name.element(\"initial\").setText(initial);\n" +" name.element(\"last-name\").setText(lastName);\n" +"}\n" +"\n" +"tx.commit();\n" +"session.close();]]>" msgstr "" - "<![CDATA[Session session = factory.openSession(); -\n" - "Session dom4jSession = session.getSession(EntityMode.DOM4J); -\n" - "Transaction tx = session.beginTransaction(); -\n" - " -\n" - "Element cust = (Element) dom4jSession.get(\"Customer\", customerId); -\n" - "for ( int i=0; i<results.size(); i++ ) { -\n" - " Element customer = (Element) results.get(i); -\n" - " //change the customer name in the XML and database -\n" - " Element name = customer.element(\"name\"); -\n" - " name.element(\"first-name\").setText(firstName); -\n" - " name.element(\"initial\").setText(initial); -\n" - " name.element(\"last-name\").setText(lastName); -\n" - "} -\n" - " -\n" - "tx.commit(); -\n" - "session.close();]]>" -#: index.docbook:152 -msgid "It is extremely useful to combine this feature with Hibernate's <literal>replicate()</literal> operation to implement XML-based data import/export." -msgstr "XMLベースのデータのインポート/エクスポートを実装するために、 Hibernateの <literal>replicate()</literal> 操作をこの機能を結びつけるのは 極めて有効です。" - -msgid "ROLES_OF_TRANSLATORS" -msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->" - -msgid "CREDIT_FOR_TRANSLATORS" -msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->" - +#. Tag: para +#: xml.xml:152 +#, no-c-format +msgid "" +"It is extremely useful to combine this feature with Hibernate's " +"<literal>replicate()</literal> operation to implement XML-based data import/" +"export." +msgstr "" +"XMLベースのデータのインポート/エクスポートを実装するために、 Hibernateの " +"<literal>replicate()</literal> 操作をこの機能を結びつけるのは 極めて有効で" +"す。"