[hibernate-commits] Hibernate SVN: r14135 - core/trunk/documentation/manual/translations/pt-BR/content.
hibernate-commits at lists.jboss.org
hibernate-commits at lists.jboss.org
Thu Oct 25 20:46:39 EDT 2007
Author: xhuang at jboss.com
Date: 2007-10-25 20:46:38 -0400 (Thu, 25 Oct 2007)
New Revision: 14135
Modified:
core/trunk/documentation/manual/translations/pt-BR/content/architecture.po
core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po
core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po
core/trunk/documentation/manual/translations/pt-BR/content/batch.po
core/trunk/documentation/manual/translations/pt-BR/content/best_practices.po
core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po
core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po
core/trunk/documentation/manual/translations/pt-BR/content/configuration.po
core/trunk/documentation/manual/translations/pt-BR/content/events.po
core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po
core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po
core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po
core/trunk/documentation/manual/translations/pt-BR/content/filters.po
core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po
core/trunk/documentation/manual/translations/pt-BR/content/performance.po
core/trunk/documentation/manual/translations/pt-BR/content/persistent_classes.po
core/trunk/documentation/manual/translations/pt-BR/content/preface.po
core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po
core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po
core/trunk/documentation/manual/translations/pt-BR/content/query_sql.po
core/trunk/documentation/manual/translations/pt-BR/content/session_api.po
core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po
core/trunk/documentation/manual/translations/pt-BR/content/transactions.po
core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po
core/trunk/documentation/manual/translations/pt-BR/content/xml.po
Log:
Convert from pt-BR XML and merge with latest English XML
Modified: core/trunk/documentation/manual/translations/pt-BR/content/architecture.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/architecture.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/architecture.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,216 +1,644 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:21
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 "Arquitetura"
-#: index.docbook:24
+#. Tag: title
+#: architecture.xml:24
+#, no-c-format
msgid "Overview"
-msgstr "Visão Geral"
+msgstr "Visão Geral"
-#: index.docbook:26
+#. Tag: para
+#: architecture.xml:26
+#, no-c-format
msgid "A (very) high-level view of the Hibernate architecture:"
-msgstr "Uma visão bem ampla da arquitetura do Hibernate:"
+msgstr "Uma visão bem ampla da arquitetura do 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."
-msgstr "Esse diagrama mostra o Hibernate usando o banco de dados e a configuração de dados para prover persistência de serviços (e persistência de objetos) para o aplicativo."
+#. 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 ""
+"Esse diagrama mostra o Hibernate usando o banco de dados e a configuração de "
+"dados para prover persistência de serviços (e persistência de objetos) para "
+"o aplicativo."
-#: 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:"
-msgstr "Nós gostaríamos de mostrar uma visão mais detalhada da arquitetura em execução. Infelizmente, o Hibernate é muito flexível e suporta várias aproximações. Nós iremos mostrar os dois extremos. Na arquitetura mais simples o aplicativo fornece suas próprias conexões JDBC e gerencia suas transações. Esta abordagem usa o mínimo de subconjuntos das APIs do Hibernate:"
+#. 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 ""
+"Nós gostaríamos de mostrar uma visão mais detalhada da arquitetura em "
+"execução. Infelizmente, o Hibernate é muito flexível e suporta várias "
+"aproximações. Nós iremos mostrar os dois extremos. Na arquitetura mais "
+"simples o aplicativo fornece suas próprias conexões JDBC e gerencia suas "
+"transações. Esta abordagem usa o mínimo de subconjuntos das APIs do "
+"Hibernate:"
-#: 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."
-msgstr "A arquitetura \"completa\" abstrai a aplicação de ter de lidar diretamente com JDBC/JTA e APIs e deixa o Hibernate tomar conta dos detalhes."
+#. 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 ""
+"A arquitetura \"completa\" abstrai a aplicação de ter de lidar diretamente "
+"com JDBC/JTA e APIs e deixa o Hibernate tomar conta dos detalhes."
-#: index.docbook:75
+#. Tag: para
+#: architecture.xml:75
+#, fuzzy, no-c-format
msgid "Heres some definitions of the objects in the diagrams:"
-msgstr "Algumas definições dos objetos do diagrama:"
+msgstr "Algumas definições dos objetos do diagrama: <placeholder-1/>"
-#: index.docbook:80
+#. Tag: term
+#: architecture.xml:80
+#, no-c-format
msgid "SessionFactory (<literal>org.hibernate.SessionFactory</literal>)"
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."
-msgstr "Um cache threadsafe (imutáveis) composto de identidades compiladas para um único banco de dados. Uma fabrica para <literal>Session</literal> e um cliente de <literal>ConnectionProvider</literal>. Pode conter um cachê opcional de dados (segundo nível) reutilizáveis entre transações, no nível de processo- ou cluster."
+#. 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 ""
+"Um cache threadsafe (imutáveis) composto de identidades compiladas para um "
+"único banco de dados. Uma fabrica para <literal>Session</literal> e um "
+"cliente de <literal>ConnectionProvider</literal>. Pode conter um cachê "
+"opcional de dados (segundo nível) reutilizáveis entre transações, no nível "
+"de processo- ou cluster."
-#: index.docbook:92
+#. Tag: term
+#: architecture.xml:92
+#, no-c-format
msgid "Session (<literal>org.hibernate.Session</literal>)"
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."
-msgstr "Objeto single-threaded, de vida curta, representando uma conversação entre o aplicativo e o armazenamento persistente. Cria uma camada sobre uma conexão JDBC. É uma fabrica de <literal>Transaction</literal>. Possui um cachê obrigatório (primeiro nível) de objetos persistentes, usado para navegação no gráficos de objetos e pesquisa de objetos pelo identificador."
+#. 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 ""
+"Objeto single-threaded, de vida curta, representando uma conversação entre o "
+"aplicativo e o armazenamento persistente. Cria uma camada sobre uma conexão "
+"JDBC. É uma fabrica de <literal>Transaction</literal>. Possui um cachê "
+"obrigatório (primeiro nível) de objetos persistentes, usado para navegação "
+"no gráficos de objetos e pesquisa de objetos pelo identificador."
-#: index.docbook:104
+#. Tag: term
+#: architecture.xml:104
+#, no-c-format
msgid "Persistent objects and collections"
msgstr "Objetos persistentes e coleções"
-#: 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)."
-msgstr "Objetos, de vida curta, single threaded contendo estado persistente e função de negócios. Esses podem ser JavaBeans/POJOs, onde única coisa especial sobre eles é que são associados a (exatamente uma) <literal>Session</literal>. Quando a <literal>Session</literal> é fechada, eles são separados e liberados para serem usados dentro de qualquer camada da aplicacao (Ex. diretamente como data transfer objects de e para a camada de apresentação)"
+#. 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 ""
+"Objetos, de vida curta, single threaded contendo estado persistente e função "
+"de negócios. Esses podem ser JavaBeans/POJOs, onde única coisa especial "
+"sobre eles é que são associados a (exatamente uma) <literal>Session</"
+"literal>. Quando a <literal>Session</literal> é fechada, eles são separados "
+"e liberados para serem usados dentro de qualquer camada da aplicacao (Ex. "
+"diretamente como data transfer objects de e para a camada de apresentação)"
-#: index.docbook:117
+#. Tag: term
+#: architecture.xml:117
+#, no-c-format
msgid "Transient and detached objects and collections"
msgstr "Objetos e coleções desatachados e transientes"
-#: 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>."
-msgstr "Instâncias de classes persistentes que ainda não estão associadas a uma <literal>Session</literal>. Eles podem ter sido instanciados pela aplicação e não persistido (ainda) ou eles foram instanciados por uma <literal>Session</literal> que foi encerrada."
+#. 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 ""
+"Instâncias de classes persistentes que ainda não estão associadas a uma "
+"<literal>Session</literal>. Eles podem ter sido instanciados pela aplicação "
+"e não persistido (ainda) ou eles foram instanciados por uma "
+"<literal>Session</literal> que foi encerrada."
-#: index.docbook:128
+#. Tag: term
+#: architecture.xml:128
+#, no-c-format
msgid "Transaction (<literal>org.hibernate.Transaction</literal>)"
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!"
-msgstr "(Opcional) Objeto de vida curta, single threaded, usado pela aplicação para especificar unidades atômicas de trabalho. Abstrai o aplicativo de lidar diretamente com transações JDBC, JTA ou CORBA. Uma <literal>Session</literal> pode, em alguns casos, iniciar várias <literal>Transaction</literal>s. Entretanto, a demarcação da transação, mesmo utilizando API ou Transaction subjacentes, nunca é opcional!"
+#. 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 ""
+"(Opcional) Objeto de vida curta, single threaded, usado pela aplicação para "
+"especificar unidades atômicas de trabalho. Abstrai o aplicativo de lidar "
+"diretamente com transações JDBC, JTA ou CORBA. Uma <literal>Session</"
+"literal> pode, em alguns casos, iniciar várias <literal>Transaction</"
+"literal>s. Entretanto, a demarcação da transação, mesmo utilizando API ou "
+"Transaction subjacentes, nunca é opcional!"
-#: index.docbook:141
-msgid "ConnectionProvider (<literal>org.hibernate.connection.ConnectionProvider</literal>)"
-msgstr "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."
-msgstr "(Opcional) Uma fábrica de (e combinações de) conexões JDBC. Abstrai a aplicação de lidar diretamente com <literal>Datasource</literal> ou <literal>DriverManager</literal>. Não exposto para a aplicação, mas pode ser implementado ou estendido pelo programador."
+#. 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 ""
+"(Opcional) Uma fábrica de (e combinações de) conexões JDBC. Abstrai a "
+"aplicação de lidar diretamente com <literal>Datasource</literal> ou "
+"<literal>DriverManager</literal>. Não exposto para a aplicação, mas pode ser "
+"implementado ou estendido pelo programador."
-#: index.docbook:151
-msgid "TransactionFactory (<literal>org.hibernate.TransactionFactory</literal>)"
-msgstr "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."
-msgstr "(Opcional) Uma fábrica para instâncias de <literal>Transaction</literal>. Não exposta a aplicação, mas pode ser extendida/implementada pelo programador."
+#. 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 ""
+"(Opcional) Uma fábrica para instâncias de <literal>Transaction</literal>. "
+"Não exposta a aplicação, mas pode ser extendida/implementada pelo "
+"programador."
-#: index.docbook:160
+#. Tag: emphasis
+#: architecture.xml:160
+#, no-c-format
msgid "Extension Interfaces"
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."
-msgstr "O Hibernate oferece várias opções de interfaces estendidas que você pode implementar para customizar sua camada persistente. Veja a documentação da API para maiores detalhes."
+#. 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 ""
+"O Hibernate oferece várias opções de interfaces estendidas que você pode "
+"implementar para customizar sua camada persistente. Veja a documentação da "
+"API para maiores detalhes."
-#: 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."
-msgstr "Dada uma arquitetura simples, o aplicativo passa pelas APIs <literal>Transaction</literal>/<literal>TransactionFactory</literal> e/ou <literal>ConnectionProvider</literal> para se comunicar diretamente com a transação JTA ou JDBC."
+#. 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 ""
+"Dada uma arquitetura simples, o aplicativo passa pelas APIs "
+"<literal>Transaction</literal>/<literal>TransactionFactory</literal> e/ou "
+"<literal>ConnectionProvider</literal> para se comunicar diretamente com a "
+"transação JTA ou JDBC."
-#: index.docbook:179
+#. Tag: title
+#: architecture.xml:179
+#, no-c-format
msgid "Instance states"
msgstr "Estados de instância"
-#: 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:"
-msgstr "Uma instância de classes persistentes pode estar em um dos três diferentes estados, que são definidos respeitando um <emphasis>contexto persistente</emphasis>. O objeto <literal>Session</literal> do Hibernate é o contexto persistente:"
+#. 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 ""
+"Uma instância de classes persistentes pode estar em um dos três diferentes "
+"estados, que são definidos respeitando um <emphasis>contexto persistente</"
+"emphasis>. O objeto <literal>Session</literal> do Hibernate é o contexto "
+"persistente:"
-#: index.docbook:188
+#. Tag: term
+#: architecture.xml:188
+#, no-c-format
msgid "transient"
msgstr "transiente"
-#: 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)."
-msgstr "A instância não é, e nunca foi associada com nenhum contexto persistente. Não possui uma identidade persistente (valor de chave primária)."
+#. 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 ""
+"A instância não é, e nunca foi associada com nenhum contexto persistente. "
+"Não possui uma identidade persistente (valor de chave primária)."
-#: index.docbook:198
+#. Tag: term
+#: architecture.xml:198
+#, no-c-format
msgid "persistent"
msgstr "persistente"
-#: 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)."
-msgstr "A instância está atualmente associada a um contexto persistente. Possui uma identidade persistente (valor de chave primária) e, talvez, correspondente a um registro no banco de dados. Para um contexto persistente em particular, o Hibernate <emphasis>guarantees</emphasis> que a identidade persistente é equivalente a identidade Java (na localização em memória do objeto)."
+#. 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 ""
+"A instância está atualmente associada a um contexto persistente. Possui uma "
+"identidade persistente (valor de chave primária) e, talvez, correspondente a "
+"um registro no banco de dados. Para um contexto persistente em particular, o "
+"Hibernate <emphasis>guarantees</emphasis> que a identidade persistente é "
+"equivalente a identidade Java (na localização em memória do objeto)."
-#: index.docbook:212
+#. Tag: term
+#: architecture.xml:212
+#, no-c-format
msgid "detached"
msgstr "desatachado"
-#: 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."
-msgstr "A instância foi associada com um contexto persistente, porém este contexto foi fechado, ou a instância foi serializada por outro processo. Possui uma identidade persistente, e, talvez, correspondenta a um registro no banco de dados. Para instâncias desatachadas, o Hibernate não garante o relacionamento entre identidade persistente e identidade Java."
+#. 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 ""
+"A instância foi associada com um contexto persistente, porém este contexto "
+"foi fechado, ou a instância foi serializada por outro processo. Possui uma "
+"identidade persistente, e, talvez, correspondenta a um registro no banco de "
+"dados. Para instâncias desatachadas, o Hibernate não garante o "
+"relacionamento entre identidade persistente e identidade Java."
-#: index.docbook:229
+#. Tag: title
+#: architecture.xml:229
+#, no-c-format
msgid "JMX Integration"
msgstr "Integração 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>."
-msgstr "JMX é padrão J2EE para manipulação de componentes Java. O Hibernate pode ser manipulado por um serviço JMX padrão. Nós fornecemos uma implementação do MBean na distribuição, <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 é padrão J2EE para manipulação de componentes Java. O Hibernate pode ser "
+"manipulado por um serviço JMX padrão. Nós fornecemos uma implementação do "
+"MBean na distribuição, <literal>org.hibernate.jmx.HibernateService</literal>."
-#: 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:"
-msgstr "Para um exemplo de como instalar o Hibernate como um serviço JMX em um servidor de aplicativo JBoss, por favor, consulte o manual do usuário do JBoss. No JBoss As, você poderá ver os benefícios de de se fazer o deploy usando 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 ""
+"Para um exemplo de como instalar o Hibernate como um serviço JMX em um "
+"servidor de aplicativo JBoss, por favor, consulte o manual do usuário do "
+"JBoss. No JBoss As, você poderá ver os benefícios de de se fazer o deploy "
+"usando 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>."
-msgstr "<emphasis>Session Management:</emphasis> O ciclo de vida de uma <literal>Session</literal> do Hibernate pode ser automaticamente conectada a um escopo de transação JTA. Isso significa que você não precisará mais abrir e fechar manualmente uma <literal>Session</literal>, isso se torna trabalho para um interceptor EJB do JBoss . Você também não precisa se preocupar, nunca mais, com demarcação de transação em seu código (a não ser que você prefira escrever uma camada persistente portável, para isso, use a API opcional do Hibernate <literal>Transaction</literal>). Você deve chamar <literal>HibernateContext</literal> para acessar uma <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>Session Management:</emphasis> O ciclo de vida de uma "
+"<literal>Session</literal> do Hibernate pode ser automaticamente conectada a "
+"um escopo de transação JTA. Isso significa que você não precisará mais abrir "
+"e fechar manualmente uma <literal>Session</literal>, isso se torna trabalho "
+"para um interceptor EJB do JBoss . Você também não precisa se preocupar, "
+"nunca mais, com demarcação de transação em seu código (a não ser que você "
+"prefira escrever uma camada persistente portável, para isso, use a API "
+"opcional do Hibernate <literal>Transaction</literal>). Você deve chamar "
+"<literal>HibernateContext</literal> para acessar uma <literal>Session</"
+"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."
-msgstr "<emphasis>HAR deployment:</emphasis>: Normalmente você faz o deploy de um serviço JMX do Hibernate usando um serviço descritor de deploy do JBoss (em um EAR e/ou arquivo SAR), que suporta todas as configurações usuais de uma <literal>SessionFactory</literal> do Hibernate. Entretanto, você ainda precisa nomear todos os seus arquivos de mapeamento no descritor de deploração. Se você decidir usar o deploy opcional HAR, o JBoss irá automaticamente detectar todos os seus arquivos de mapeamento no seu arquivo HAR."
+#. 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 deployment:</emphasis>: Normalmente você faz o deploy de um "
+"serviço JMX do Hibernate usando um serviço descritor de deploy do JBoss (em "
+"um EAR e/ou arquivo SAR), que suporta todas as configurações usuais de uma "
+"<literal>SessionFactory</literal> do Hibernate. Entretanto, você ainda "
+"precisa nomear todos os seus arquivos de mapeamento no descritor de "
+"deploração. Se você decidir usar o deploy opcional HAR, o JBoss irá "
+"automaticamente detectar todos os seus arquivos de mapeamento no seu arquivo "
+"HAR."
-#: index.docbook:268
-msgid "Consult the JBoss AS user guide for more information about these options."
-msgstr "Consulte o manual do usuário do JBoss AS, para obter maiores informações sobre essas opções."
+#. Tag: para
+#: architecture.xml:268
+#, no-c-format
+msgid ""
+"Consult the JBoss AS user guide for more information about these options."
+msgstr ""
+"Consulte o manual do usuário do JBoss AS, para obter maiores informações "
+"sobre essas opções."
-#: index.docbook:272
-msgid "Another feature available as a JMX service are runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\"/>."
-msgstr "Another feature available as a JMX service are runtime Hibernate statistics. See <xref linkend=\"configuration-optional-statistics\"/>. Outra opção disponível como um serviço JMX são as estatísticas de execução do Hibernate. Veja a <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 ""
+"Another feature available as a JMX service are runtime Hibernate statistics. "
+"See <xref linkend=\"configuration-optional-statistics\"/>. Outra opção "
+"disponível como um serviço JMX são as estatísticas de execução do Hibernate. "
+"Veja a <xref linkend=\"configuration-optional-statistics\"/>."
-#: index.docbook:279
+#. Tag: title
+#: architecture.xml:279
+#, no-c-format
msgid "JCA Support"
msgstr "Suporte 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."
-msgstr "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. O Hibernate pode também ser configurado como um conector JCA. Por favor, visite o website para maiores detalhes. Entretanto, note que o suporte JCA do Hibernate ainda é considerado 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 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. O Hibernate pode também ser configurado como um conector JCA. "
+"Por favor, visite o website para maiores detalhes. Entretanto, note que o "
+"suporte JCA do Hibernate ainda é considerado experimental."
-#: index.docbook:287
+#. Tag: title
+#: architecture.xml:287
+#, no-c-format
msgid "Contextual Sessions"
msgstr "Sessões contextuais"
-#: 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."
-msgstr "Muitas aplicações que usam o Hibernate necessita de algum tipo de sessão \"contextual\", onde uma sessão dada é na verdade um escopo de um contexto. Entretanto, através de aplicações a definição sobre um contexto é geralmente diferente; e contextos diferentes definem escopos diferentes. Aplicações usando versões anteriores ao Hibernate 3.0 tendem a utilizar tanto sessões contextuais baseadas em <literal>ThreadLocal</literal>, classes utilitárias como <literal>HibernateUtil</literal>, ou utilizar frameworks de terceiros(como Spring ou Pico) que provê sessões contextuais baseadas em proxy."
+#. 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 ""
+"Muitas aplicações que usam o Hibernate necessita de algum tipo de sessão "
+"\"contextual\", onde uma sessão dada é na verdade um escopo de um contexto. "
+"Entretanto, através de aplicações a definição sobre um contexto é geralmente "
+"diferente; e contextos diferentes definem escopos diferentes. Aplicações "
+"usando versões anteriores ao Hibernate 3.0 tendem a utilizar tanto sessões "
+"contextuais baseadas em <literal>ThreadLocal</literal>, classes utilitárias "
+"como <literal>HibernateUtil</literal>, ou utilizar frameworks de terceiros"
+"(como Spring ou Pico) que provê sessões contextuais baseadas em proxy."
-#: 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."
-msgstr "A partir da versão 3.0.1, o Hibernate adicionou o método <literal>SessionFactory.getCurrentSession()</literal>. Inicialmente, este assume o uso de transações <literal>JTA</literal>, onde a transação <literal>JTA</literal> define tanto o escopo quanto o contexto de uma sessão atual. O time do Hibernate mantém este recurso, desenvolvendo as diversas implementações do <literal>JTA TransactionManager</literal>, a maioria (se não todos) aplicativos deveria utilizar o gerenciador de transações <literal>JTA</literal> sendo ou não instalados dentro de um container <literal>J2EE</literal>. Baseado neste recurso, você deveria sempre utilizar sessões contextuais baseadas em <literal>JTA</literal>."
+#. 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 ""
+"A partir da versão 3.0.1, o Hibernate adicionou o método "
+"<literal>SessionFactory.getCurrentSession()</literal>. Inicialmente, este "
+"assume o uso de transações <literal>JTA</literal>, onde a transação "
+"<literal>JTA</literal> define tanto o escopo quanto o contexto de uma sessão "
+"atual. O time do Hibernate mantém este recurso, desenvolvendo as diversas "
+"implementações do <literal>JTA TransactionManager</literal>, a maioria (se "
+"não todos) aplicativos deveria utilizar o gerenciador de transações "
+"<literal>JTA</literal> sendo ou não instalados dentro de um container "
+"<literal>J2EE</literal>. Baseado neste recurso, você deveria sempre utilizar "
+"sessões contextuais baseadas em <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."
-msgstr "Entretanto, na versão 3.1, o processo por trás do método <literal>SessionFactory.getCurrentSession()</literal> é agora plugavel. Com isso, uma nova interface (<literal>org.hibernate.context.CurrentSessionContext</literal>) e um novo parâmetro de configuração (<literal>hibernate.current_session_context_class</literal>) foram adicionados para possibilitar a compatibilidade do contexto e do escopo na definição de sessões correntes."
+#. 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 ""
+"Entretanto, na versão 3.1, o processo por trás do método "
+"<literal>SessionFactory.getCurrentSession()</literal> é agora plugavel. Com "
+"isso, uma nova interface (<literal>org.hibernate.context."
+"CurrentSessionContext</literal>) e um novo parâmetro de configuração "
+"(<literal>hibernate.current_session_context_class</literal>) foram "
+"adicionados para possibilitar a compatibilidade do contexto e do escopo na "
+"definição de sessões correntes."
-#: 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."
-msgstr "De uma olhada em Javadocs sobre a interface <literal>org.hibernate.context.CurrentSessionContext</literal> para uma discussão detalhada. Ela define um método único, <literal>currentSession()</literal>, com o qual a implementação é responsável por rastrear a sessão contextual corrente. Por fora do \"encapsulamento\", o Hibernate possui duas implementações dessa 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 ""
+"De uma olhada em Javadocs sobre a interface <literal>org.hibernate.context."
+"CurrentSessionContext</literal> para uma discussão detalhada. Ela define um "
+"método único, <literal>currentSession()</literal>, com o qual a "
+"implementação é responsável por rastrear a sessão contextual corrente. Por "
+"fora do \"encapsulamento\", o Hibernate possui duas implementações dessa "
+"interface."
-#: 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."
-msgstr "<literal>org.hibernate.context.JTASessionContext</literal> - As sessões correntes são rastreadas e recebem um escopo por uma transação <literal>JTA</literal>. O processamento aqui é exatamente igual ao antigo processo JTA. Consulte em Javadocs para maiores detalhes."
+#. 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> - As sessões "
+"correntes são rastreadas e recebem um escopo por uma transação <literal>JTA</"
+"literal>. O processamento aqui é exatamente igual ao antigo processo JTA. "
+"Consulte em Javadocs para maiores detalhes."
-#: index.docbook:332
-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> - As sessões correntes são rastreadas por uma thread de execução. Novamente, consulte em Javadocs para maiores detalhes."
+#. 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> - As "
+"sessões correntes são rastreadas por uma thread de execução. Novamente, "
+"consulte em Javadocs para maiores detalhes."
-#: 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>."
-msgstr "<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> - 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>."
-#: 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."
-msgstr "As duas primeiras implementações usam o modelo de programação \"uma sessão – uma transação do banco de dados\", também conhecida e usado como <emphasis>sessão por requisição</emphasis>. O começo e o fim de uma sessão Hibernate é definida pela duração da transação do banco de dados. Se você usa demarcação programática de transação (por exemplo. em J2SE puro ou com JTA /UserTransaction/BMT), você é recomendado a usar a API Hibernate <literal>Transaction</literal> para esconder a base do sistema de transação do seu código. Se você executa em um container EJB que suporta CMT, os limites das transações são definidas declarativamente e você não necessita de qualquer transação ou operação de demarcação de sessão no seu código. Consulte o <xref linkend=\"transactions\"/> para mais informações exemplos de código."
+#. 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 ""
+"As duas primeiras implementações usam o modelo de programação \"uma sessão – "
+"uma transação do banco de dados\", também conhecida e usado como "
+"<emphasis>sessão por requisição</emphasis>. O começo e o fim de uma sessão "
+"Hibernate é definida pela duração da transação do banco de dados. Se você "
+"usa demarcação programática de transação (por exemplo. em J2SE puro ou com "
+"JTA /UserTransaction/BMT), você é recomendado a usar a API Hibernate "
+"<literal>Transaction</literal> para esconder a base do sistema de transação "
+"do seu código. Se você executa em um container EJB que suporta CMT, os "
+"limites das transações são definidas declarativamente e você não necessita "
+"de qualquer transação ou operação de demarcação de sessão no seu código. "
+"Consulte o <xref linkend=\"transactions\"/> para mais informações exemplos "
+"de código."
-#: 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\"."
-msgstr "O parâmetro de configuração <literal>hibernate.current_session_context_class</literal> define que a implementação <literal>org.hibernate.context.CurrentSessionContext</literal> deve ser usada. Note que para compatibilidade anterior, se este parâmetro de configuração não é determinado mas um <literal>org.hibernate.transaction.TransactionManagerLookup</literal> é configurado, Hibernate usará o <literal>org.hibernate.context.JTASessionContext</literal>. Tipicamente, o valor deste parâmetro nomearia apenas a classe de implementação para usar; para as duas implementações out-of-the-box, entretanto, há três pequenos nomes correspondentes, \"jta\", \"thread\", and \"managed\"."
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+#. 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 ""
+"O parâmetro de configuração <literal>hibernate."
+"current_session_context_class</literal> define que a implementação "
+"<literal>org.hibernate.context.CurrentSessionContext</literal> deve ser "
+"usada. Note que para compatibilidade anterior, se este parâmetro de "
+"configuração não é determinado mas um <literal>org.hibernate.transaction."
+"TransactionManagerLookup</literal> é configurado, Hibernate usará o "
+"<literal>org.hibernate.context.JTASessionContext</literal>. Tipicamente, o "
+"valor deste parâmetro nomearia apenas a classe de implementação para usar; "
+"para as duas implementações out-of-the-box, entretanto, há três pequenos "
+"nomes correspondentes, \"jta\", \"thread\", and \"managed\"."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/association_mapping.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,608 +1,914 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:6
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Mapeamento de Associações"
-#: index.docbook:9
+#. Tag: title
+#: association_mapping.xml:9
+#, no-c-format
msgid "Introduction"
-msgstr ""
+msgstr "Introdução"
-#: 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."
+#. 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 ""
+"Mapeamentos de associações são freqüentemente a coisa mais difícil de se "
+"acertar. Nesta seção nós passaremos pêlos casos canônicos um pôr um, "
+"começando com mapeamentos unidirecionais e considerando os casos "
+"bidirecionais. Nos vamos usar <literal>Person</literal> e <literal>Address</"
+"literal> em todos os exemplos."
-#: index.docbook:19
-msgid "We'll classify associations by whether or not they map to an intervening join table, and by multiplicity."
+#. 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 ""
+"Nós classificaremos as associações pelo seu mapeamento ou a falta do mesmo, "
+"sua intervenção na tabela associativa, e pela sua multiplicidade."
-#: 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."
+#. 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 ""
+"O uso de chaves estrangeiras não obrigatórias não é considerada uma boa "
+"prática na modelagem de dados tradicional, assim todos nossos exemplos usam "
+"chaves estrangeiras obrigatórias. Esta não é uma exigência do Hibernate, e "
+"todas as mapeamentos funcionarão se você remover as constraints de "
+"obrigatoriedade."
-#: index.docbook:34
+#. Tag: title
+#: association_mapping.xml:34
+#, no-c-format
msgid "Unidirectional associations"
-msgstr ""
+msgstr "Associações Unidirecionais"
-#: index.docbook:37, index.docbook:108
+#. Tag: title
+#: association_mapping.xml:37 association_mapping.xml:108
+#, no-c-format
msgid "many to one"
-msgstr ""
+msgstr "muitos para um"
-#: index.docbook:39
-msgid "A <emphasis>unidirectional many-to-one association</emphasis> is the most common kind of unidirectional association."
+#. 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 ""
+"Uma <emphasis>associação unidirecional muitos-para-um</emphasis> é o tipo "
+"mais comum de associação unidirecional."
-#: 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 ""
-#: 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 ""
-#: 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
+#, fuzzy, no-c-format
msgid "one to one"
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"um para um\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"um para um\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"um para um\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"one to one"
-#: 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."
+#. 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 ""
+"Uma <emphasis>associação unidirecional um-para-um em uma chave estrangeira </"
+"emphasis> é quase idêntica. A única diferença é a constraint unique na "
+"coluna."
-#: 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 ""
-#: 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 ""
-#: 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.)"
+#. 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 ""
+"Uma <emphasis>associação unidirecional um-para-um na chave primaria</"
+"emphasis> geralmente usa um gerador de id special. ( Note que nós invertemos "
+"a direção da associação nesse exemplo)."
-#: 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 ""
-#: 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 ""
-#: index.docbook:72, index.docbook:94
+#. Tag: title
+#: association_mapping.xml:72 association_mapping.xml:94
+#, no-c-format
msgid "one to many"
-msgstr ""
+msgstr "um para muitos"
-#: 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."
+#. 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 ""
+"Uma <emphasis>associação unidirecional um-para-muitos em uma chave "
+"estrangeira</emphasis> é um caso muito incomum, e realmente não é "
+"recomendada."
-#: 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 ""
-#: 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 ""
-#: 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 ""
+"Nós achamos que é melhor usar uma tabela associativa para este tipo de "
+"associação."
-#: index.docbook:91
+#. Tag: title
+#: association_mapping.xml:91
+#, no-c-format
msgid "Unidirectional associations with join tables"
-msgstr ""
+msgstr "Associações Unidirecionais com tabelas associativas"
-#: 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."
+#. 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 ""
+"Uma <emphasis>associação um-para-muitos unidirecional usando uma tabela "
+"associativa</emphasis> e o mais comum. Note que se especificarmos "
+"<literal>unique=\"true\"</literal>, estaremos modificando a cardinalidade de "
+"muitos-para-muitos para um-para-muitos."
-#: 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 ""
-#: 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 ""
-#: index.docbook:110
-msgid "A <emphasis>unidirectional many-to-one association on a join table</emphasis> is quite common when the association is optional."
+#. 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 ""
+"Uma <emphasis>associação unidirecional muitos-para-um em uma tabela "
+"associativa</emphasis> é bastante comum quando a associação for opcional."
-#: 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 ""
-#: 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 ""
-#: index.docbook:123
-msgid "A <emphasis>unidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible."
+#. 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 ""
+"Uma <emphasis>associação unidirecional um-para-um em uma tabela associativa</"
+"emphasis> é extremamente incomum, mas possível."
-#: 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 ""
-#: 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 ""
-#: index.docbook:134, index.docbook:238
+#. Tag: title
+#: association_mapping.xml:134 association_mapping.xml:238
+#, no-c-format
msgid "many to many"
-msgstr ""
+msgstr "muitos para muitos"
-#: 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 ""
+"Finalmente, nós temos a <emphasis>associação unidirecional muitos-para- "
+"muitos</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 ""
-#: 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 ""
-#: index.docbook:148
+#. Tag: title
+#: association_mapping.xml:148
+#, no-c-format
msgid "Bidirectional associations"
-msgstr ""
+msgstr "Associações Bidirecionais"
-#: 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 ""
+msgstr "um para muitos / muitos para um"
-#: 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.)"
+#. 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 ""
+"Uma <emphasis>associação bidirecional muitos-para-um</emphasis> é o tipo "
+"mais comum de associação. (Esse é o relacionamento padrão pai / filho. )"
-#: 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 ""
-#: 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>):"
+#. 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 ""
+"Se você usar uma <literal>List</literal> ( ou outra coleção indexada ), você "
+"precisa especificar a coluna <literal>chave</literal> estrangeira como not "
+"null, e deixar o Hibernate administrar a associação do lado da coleção para "
+"que seja mantido o índice de cada elemento da coleção (fazendo com que o "
+"outro lado seja virtualmente inverso setando <literal>update=\"false\"</"
+"literal> e <literal>insert=\"false\"</literal>):"
-#: 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 ""
-#: index.docbook:173
-msgid "It is important that you define <literal>not-null=\"true\"</literal> on the <literal><key></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><column></literal> element, but on the <literal><key></literal> element."
+#. Tag: para
+#: association_mapping.xml:173
+#, no-c-format
+msgid ""
+"It is important that you define <literal>not-null=\"true\"</literal> on the "
+"<literal><key></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><column></literal> element, but on the <literal><key></"
+"literal> element."
msgstr ""
+"É importante que você defina <literal>not-null=\"true\"</literal> no "
+"elemento <literal><key></literal> no mapeamento na coleção se a coluna "
+"de chave estrangeira for <literal>NOT NULL</literal>. Não declare como "
+"<literal>not-null=\"true\"</literal> apenas um elemento aninhado "
+"<literal><column></literal>, mas sim o elemento <literal><key></"
+"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 ""
+"Uma <emphasis>associação bidirecional um para um em uma chave estrangeira</"
+"emphasis> é bastante comum."
-#: 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 ""
-#: index.docbook:195
-msgid "A <emphasis>bidirectional one-to-one association on a primary key</emphasis> uses the special id generator."
+#. 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 ""
+"Uma <emphasis>associação bidirecional um para um em uma chave primária</"
+"emphasis> usa um gerador de id especial."
-#: 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 ""
-#: index.docbook:208
+#. Tag: title
+#: association_mapping.xml:208
+#, no-c-format
msgid "Bidirectional associations with join tables"
-msgstr ""
+msgstr "Associações Bidirecionais com tabelas associativas"
-#: 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."
+#. 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 ""
+"Uma <emphasis>associação bidirecional um para muitos em uma tabela "
+"associativa</emphasis>. Veja que <literal>inverse=\"true\"</literal> pode "
+"ser colocado em qualquer ponta associação, na coleção, ou no join."
-#: 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 ""
-#: 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 ""
-#: index.docbook:227
-msgid "A <emphasis>bidirectional one-to-one association on a join table</emphasis> is extremely unusual, but possible."
+#. 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 ""
+"Uma <emphasis>associação bidirecional um-para-um em uma tabela de "
+"associação</emphasis> é algo bastante incomum, mas possivel."
-#: 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 ""
-#: 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 ""
+"Finally, we have a <emphasis>bidirectional many-to-many association</"
+"emphasis>. Finalmente, nós temos uma associação bidirecional de muitos para "
+"muitos."
-#: 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 ""
-#: index.docbook:253
+#. Tag: title
+#: association_mapping.xml:253
+#, no-c-format
msgid "More complex association mappings"
-msgstr ""
+msgstr "Mapeamento de associações mais complexas"
-#: 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:"
+#. 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 ""
+"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: Joins de "
+"associações mais complexas são extremamente raros. O Hibernate torna "
+"possível tratar mapeamentos mais complexos usando fragmentos de SQL "
+"embutidos no documento de mapeamento. Por exemplo, se uma tabela com "
+"informações de dados históricos de uma conta define a coluna accountNumber, "
+"effectiveEndDate e effectiveStartDate, mapeadas assim como segue:"
-#: 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 ""
-#: index.docbook:266
-msgid "Then we can map an association to the <emphasis>current</emphasis> instance (the one with null <literal>effectiveEndDate</literal>) using:"
+#. 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 ""
+"Then we can map an association to the <emphasis>current</emphasis> instance "
+"(the one with null <literal>effectiveEndDate</literal>) using: Então nós "
+"podemos mapear uma associação para a instância corrente (aquela com a "
+"effectiveEndDate igual a null) usando:"
-#: 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 ""
-#: 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:"
+#. 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 ""
+"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: Em um exemplo mais complexo, imagine que "
+"a associação entre Employee e Organization é mantida em uma tabela "
+"Employment cheia de dados históricos do trabalho. Então a associação do "
+"funcionário mais recentemente empregado (aquele com a mais recente "
+"startDate) deve ser mapeado desta maneira:"
-#: 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 ""
-#: 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."
+#. 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"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. Você "
+"pode ser criativo com esta funcionalidade, mas geralmente é mais prático "
+"tratar estes tipos de casos, usando uma pesquisa HQL ou uma pesquisa por "
+"criteria."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/basic_mapping.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,2459 +1,5778 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Mapeamento O/R Bassico"
-#: index.docbook:8
+#. Tag: title
+#: basic_mapping.xml:8
+#, no-c-format
msgid "Mapping declaration"
-msgstr ""
+msgstr "Declaração de mapeamento"
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:23
+#. Tag: para
+#: basic_mapping.xml:23
+#, no-c-format
msgid "Lets kick off with an example mapping:"
-msgstr ""
+msgstr "Lets kick off with an example mapping:"
-#: 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 ""
-#: 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.)"
+#. 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 ""
+"Discutir agora o conteúdo deste documento de mapeamento. Iremos apenas "
+"descrever os elementos do documento e atributos que são utilizados pelo "
+"Hibernate em tempo de execução. O documento de mapeamento também contém "
+"alguns atributos adicionais e opcionais além de elementos que afetam os "
+"esquemas de banco de dados exportados pela ferramenta de exportação de "
+"esquemas. (Por exemplo, o atributo <literal>not-null</literal>)."
-#: index.docbook:40
+#. Tag: title
+#: basic_mapping.xml:40
+#, no-c-format
msgid "Doctype"
-msgstr ""
+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."
+#. 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 ""
+"Todos os mapeamentos de XML devem declarar o doctype exibido. O DTD atual "
+"pode ser encontrado na URL abaixo, no diretório <literal>hibernate-x.x.x/src/"
+"org/ hibernate </literal> ou no <literal>hibernate3.jar</literal>. O "
+"Hibernate sempre irá procurar pelo DTD inicialmente no seu classpath. Se "
+"você tentar localizar o DTD usando uma conexão de internet, compare a "
+"declaração do seu DTD com o conteúdo do seu classpath"
-#: index.docbook:52
+#. Tag: title
+#: basic_mapping.xml:52
+#, no-c-format
msgid "EntityResolver"
-msgstr ""
+msgstr "EntityResolver"
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:79
+#. Tag: para
+#: basic_mapping.xml:79
+#, no-c-format
msgid "An example of utilizing user namespacing:"
-msgstr ""
+msgstr "An example of utilizing user namespacing:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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</xref>."
-#: index.docbook:91
+#. Tag: title
+#: basic_mapping.xml:91
+#, no-c-format
msgid "hibernate-mapping"
-msgstr ""
+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."
+#. 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 ""
+"Este elemento tem diversos atributos opcionais. Os atributos "
+"<literal>schema</literal> e <literal>catalog</literal> especificam que "
+"tabelas referenciadas neste mapeamento pertencem ao esquema e/ou ao catalogo "
+"nomeado. Se especificados, os nomes das tabelas irão ser qualificados no "
+"schema ou catalog dado. Se não, os nomes das tabelas não serão qualificados. "
+"O atributo <literal>default-cascade </literal> especifica qual estilo de "
+"cascata será assumido pelas propriedades e coleções que não especificarm um "
+"atributo <literal>cascade</literal>. O atributo <literal>auto-import</"
+"literal> nos deixa utilizar nomes de classes não qualificados na linguagem "
+"de consulta, por default."
-#: 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 ""
-#: 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> (opcional): O nome do esquema do banco de dados."
-#: 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> (opcional): O nome do catálogo do banco de dados."
-#: index.docbook:127
-msgid "<literal>default-cascade</literal> (optional - defaults to <literal>none</literal>): A default cascade style."
+#. 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> (opcional – default é <literal>nenhum </"
+"literal>): Um estilo cascata default."
-#: 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>."
+#. 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> (opcional – default é <literal>property</"
+"literal>): A estratégia que o Hibernate deve utilizar para acessar todas as "
+"propridades. Pode ser uma implementação própria de "
+"<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."
+#. 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> (opcional - default é <literal>true</"
+"literal>): O valor default para atributos <literal>lazy</literal> da classe "
+"e dos mapeamentos de coleções."
-#: 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."
+#. 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> ((opcional - default é <literal>true</"
+"literal>): Especifica se nós podemos usar nomes de classess não qualificados "
+"(das classes deste mapeamento) na linguagem de consulta."
-#: index.docbook:154
-msgid "<literal>package</literal> (optional): Specifies a package prefix to assume for unqualified class names in the mapping document."
+#. 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> (opcional): Especifica um prefixo da package para "
+"assumir para nomes de classes não qualificadas no documento de mapeamento."
-#: 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."
+#. 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 ""
+"Se voce tem duas classes persistentes com o mesmo nome (não qualificadas), "
+"você deve setar <literal>auto-import=\"false\"</literal>. O Hibernate irá "
+"gerar uma exceção se você tentar setar duas classes para o mesmo nome "
+"\"importado\"."
-#: index.docbook:168
-msgid "Note that the <literal>hibernate-mapping</literal> element allows you to nest several persistent <literal><class></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>."
+#. 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><class></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 ""
+"Observe que o elemento <literal>hibernate-mapping</literal> permite a você "
+"aninhar diversos mapeamentos de <literal><class></literal> "
+"persistentes, como mostrado abaixo. Entretanto, é uma boa prática (e "
+"esperado por algumas ferramentas)o mapeamento de apenas uma classe "
+"persistente simples (ou uma hierarquia de classes simples) em um arquivo de "
+"mapeamento e nomea-la após a superclasse persistente, por exemplo: "
+"<literal>Cat.hbm.xml</literal>, <literal>Dog.hbm.xml</literal>, ou se "
+"estiver usando herança, <literal>Animal.hbm.xml</literal>."
-#: index.docbook:181
+#. Tag: title
+#: basic_mapping.xml:181
+#, no-c-format
msgid "<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 ""
+"Você pode declarar uma classe persistente utilizando o elemento "
+"<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 ""
-#: 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."
+#. 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> (opcional): O nome da classe Java inteiramente "
+"qualificado da classe persistente (ou interface); Se o atributo é ausente, "
+"assume-se que o mapeamento é para intidades não-POJO."
-#: index.docbook:221
-msgid "<literal>table</literal> (optional - defaults to the unqualified class name): The name of its database table."
+#. 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> (opcional – default para nomes de classes não "
+"qualificadas) O nome da sua tabela do banco de dados."
-#: 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>."
+#. 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> (opcional – default para o nome da "
+"classe): Um valor que distingue subclasses individuais, usadas para o "
+"comportamento polimorfico. Valores aceitos incluem <literal>null</literal> e "
+"<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."
+#. 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> (opcional - valor default <literal>true</"
+"literal>): Especifica que instancias da classe são (ou não) mutáveis"
-#: index.docbook:240, index.docbook:2204
-msgid "<literal>schema</literal> (optional): Override the schema name specified by the root <literal><hibernate-mapping></literal> element."
+#. 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><hibernate-mapping></literal> element."
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>schema</literal> (opcional): Sobrepõe o nome do esquema "
+"especificado pelo elemento root <literal><hibernate-mapping></"
+"literal>.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>schema</literal> (opcional): Sobrepõe o nome do esquema "
+"especificado pelo elemento raiz <literal><hibernate-mapping></literal>."
-#: index.docbook:246, index.docbook:2210
-msgid "<literal>catalog</literal> (optional): Override the catalog name specified by the root <literal><hibernate-mapping></literal> element."
+#. 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><hibernate-mapping></literal> element."
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo "
+"especificado pelo elemento root <literal><hibernate-mapping></"
+"literal>.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>catalog</literal> (opcional): Sobrepõe o nome do catálogo "
+"especificado pelo elemento raiz<literal><hibernate-mapping></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."
+#. 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> (opcional): Especifica um interface para ser "
+"utilizada pelos proxies de inicialização tardia. Você pode especificar o "
+"nome da própria classe."
-#: 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."
+#. 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> (opcional, valor default <literal>false</"
+"literal>): Especifica que o SQL de <literal>UPDATE</literal> deve ser gerado "
+"em tempo de execução e conter apenas aquelas colunas cujos valores foram "
+"alterados."
-#: 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."
+#. 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> (opcional, valor default <literal>false</"
+"literal>): Especifica que o SQL de <literal>INSERT</literal> deve ser gerado "
+"em tempo de execução e conter apenas aquelas colunas cujos valores não estão "
+"nulos."
-#: 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."
+#. 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> (opcional, valor default "
+"<literal>false</literal>): Especifica que o Hibernate <emphasis>never</"
+"emphasis> deve executar um SQL de <literal>UPDATE</literal> a não ser que "
+"com certeza um objeto está atualmente modificado. Em certos casos "
+"(atualmente, apenas quando um objeto transiente foi associado com uma nova "
+"sessão utilizando <literal>update()</literal>), isto significa que o "
+"Hibernate ira executar uma instrução SQL de <literal>SELECT</literal> "
+"adicional para determinar se um <literal>UPDATE</literal> é necessário nesse "
+"momento."
-#: index.docbook:282
-msgid "<literal>polymorphism</literal> (optional, defaults to <literal>implicit</literal>): Determines whether implicit or explicit query polymorphism is used."
+#. 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 ""
+"<literal>polymorphism</literal> (opcional, default para <literal>implicit</"
+"literal>): Determina se deve ser utilizado a query polimorfica implicita ou "
+"explicitamente."
-#: 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"
+#. 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> (opicional) especifica um comando SQL "
+"<literal>WHERE</literal> arbitrário para ser usado quando da recuperação de "
+"objetos desta classe."
-#: index.docbook:294
-msgid "<literal>persister</literal> (optional): Specifies a custom <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> (opcional): Espeicifca uma "
+"<literal>ClassPersister</literal> customizada."
-#: 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."
+#. 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> (opcional, valor default <literal>1</literal>) "
+"especifica um \"tamanho de lote\" para a recuperação de instancias desta "
+"classe pelo identificador."
-#: index.docbook:305
-msgid "<literal>optimistic-lock</literal> (optional, defaults to <literal>version</literal>): Determines the optimistic locking strategy."
+#. 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> (octional, valor default "
+"<literal>version</literal>): Determina a estratégia de bloqueio."
-#: index.docbook:311
-msgid "<literal>lazy</literal> (optional): Lazy fetching may be completely disabled by setting <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> (opcional): A recuperação tardia pode ser "
+"completamente desabilitada, setando <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."
+#. 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> (opcional, default para o nome da classe): O "
+"Hibernate3 permite uma classe ser mapeada multiplas vezes, (potencialmente,"
+"para diferentes tabelas), e permite mapeamentos de entidades que são "
+"representadas por Maps ou XML no nível Java. Nestes casos, você deve "
+"especificar um nome arbitrário explicitamente para a entidade. Veja <xref "
+"linkend=\"persistent-classes-dynamicmodels\"/> e <xref linkend=\"xml\"/> "
+"para maiores informações."
-#: 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."
+#. 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> (opcional): Uma expressão SQL utilizada para gerar "
+"uma constraint de <emphasis>verificação</emphasis> de múltiplas linhas para "
+"a geração automática do esquema."
-#: 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."
+#. 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> (opcional): O Hibernate poder usar as assim "
+"chamadas ROWIDs em bancos de dados que a suportam. Por exemplo, no Oracle, o "
+"Hibernate pode utilizar a coluna extra rowid para atualizações mais rápidas "
+"se você configurar esta opção para <literal>rowid</literal>. Um ROWID é uma "
+"implementação que representa de maneira detalhada a localização física de "
+"uma determinada tupla armazenado."
-#: 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."
+#. 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> (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. <literal>subselect</"
+"literal> (opcional): Mapeia uma entidade imutavel e somente de leitura para "
+"um subconjunto do banco de dados. Útil se você quiser ter uma view em vez de "
+"uma tabela. Veja abaixo para mais informações."
-#: index.docbook:348
-msgid "<literal>abstract</literal> (optional): Used to mark abstract superclasses in <literal><union-subclass></literal> hierarchies."
+#. Tag: para
+#: basic_mapping.xml:348
+#, no-c-format
+msgid ""
+"<literal>abstract</literal> (optional): Used to mark abstract superclasses "
+"in <literal><union-subclass></literal> hierarchies."
msgstr ""
+"<literal>abstract</literal> (opcional): Utilizada para marcar superclasses "
+"abstratas em hierarquias <literal><union-subclass></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><subclass></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>."
+#. 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><subclass></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 ""
+"É perfeitamente aceitável para uma classe persitente nomeada ser uma "
+"interface. Você deverá então declarar as classes implementadas desta "
+"interface utilizando o elemento <literal><subclass></literal>. Você "
+"pode persistir qualquer classe de aninhada <emphasis>estatica</emphasis>. "
+"Você deverá especificar o nome da classe usando a forma padrão, por exemplo: "
+"<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."
+#. 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 ""
+"Classes imutáveis, <literal>mutable=\"false\"</literal>, não podem ser "
+"modificadas ou excluídas pela aplicação. Isso permite ao Hibernate fazer "
+"alguns aperfeiçoamentos de performance."
-#: 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."
+#. 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 ""
+"O atributo opcional <literal>proxy</literal> habilita a inicialização tardia "
+"das instâncias persistentes da classe. O Hibernate irá retornar CGLIB "
+"proxies como implementado na interface nomeada. O objeto persistente atual "
+"será carregado quando um método do proxy for invocado. Veja \"Inicializando "
+"coleções e proxies\" abaixo."
-#: 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><class></literal> declaration as a <literal><subclass></literal> or <literal><joined-subclass></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)."
+#. 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><"
+"class></literal> declaration as a <literal><subclass></literal> or "
+"<literal><joined-subclass></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 ""
+"Polimorfismo <emphasis>implícito</emphasis> significa que instâncias de uma "
+"classe serão retornada por uma query que dá nome a qualquer superclasse ou "
+"interface implementada, ou a classe e as instancias de qualquer subclasse da "
+"classe será retornada por umq query que nomeia a classe por si. Polimorfismo "
+"<emphasis>explícito</emphasis> significa que instancias da classe serão "
+"retornadas apenas por queries que explicitamente nomeiam a classe e que "
+"queries que nomeiam as classes irão retornar apenas instancias de subclasses "
+"mapeadas dentro da declaração <literal><class></literal> como uma "
+"<literal><subclass></literal> ou <literal><joined-subclass></"
+"literal>. Para a maioria dos casos, o valor default <literal>polymorphism="
+"\"implicit\"</literal>, é apropriado. Polimorfismo explicito é útil quando "
+"duas classes distintas estão mapeadas para a mesma tabela (isso permite um "
+"classe \"peso leve\" que contem um subconjunto de colunas da tabela)."
-#: 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>)."
+#. 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 ""
+"O atributo <literal>persister</literal> deixa você customizar a estratégia "
+"de persistência utilizada para a classe. Você pode, por exemplo, especificar "
+"sua prórpia subclasse do <literal>org.hibernate.persister.EntityPersister</"
+"literal> ou você pode criar uma implementação completamente nova da "
+"interface <literal>org.hibernate.persister.ClassPersister</literal> que "
+"implementa a persistência através de, por exemplo, chamadas a stored "
+"procedeures, serialização de arquivos flat ou LDAP. Veja <literal>org."
+"hibernate.test.CustomPersister</literal> para um exemplo simples (de "
+"\"persistencia\" para uma <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><subclass></literal> or <literal><joined-subclass></literal> elements. These settings may increase performance in some cases, but might actually decrease performance in others. Use judiciously."
+#. 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><subclass></literal> or <literal><joined-"
+"subclass></literal> elements. These settings may increase performance in "
+"some cases, but might actually decrease performance in others. Use "
+"judiciously."
msgstr ""
+"Observe que as configurações <literal>dynamic-update</literal> e "
+"<literal>dynamic-insert</literal> não sao herdadas pelas subclasses e assim "
+"podem tambem ser especificadas em elementos <literal><subclass></"
+"literal> or <literal><joined-subclass></literal>. Estas configurações "
+"podem incrementar a performance em alguns casos, mas pode realmente diminuir "
+"a performance em outras. Use-as de forma bastante criteriosa."
-#: 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>."
+#. 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 ""
+"O uso de <literal>select-before-update</literal> geralmente irá diminuir a "
+"performance. Ela é muito útil para prevenir que uma trigger de atualização "
+"no banco de dados seja ativada desnecessariamente, se você reconectar um nó "
+"de uma instancia desconectada em uma <literal>Session</literal>."
-#: index.docbook:412
-msgid "If you enable <literal>dynamic-update</literal>, you will have a choice of optimistic locking strategies:"
+#. 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 ""
+"Se você ativar <literal>dynamic-update</literal>, você terá de escolher a "
+"estratégia de bloqueio otimista:"
-#: index.docbook:418
+#. Tag: para
+#: basic_mapping.xml:418
+#, no-c-format
msgid "<literal>version</literal> check the version/timestamp columns"
-msgstr ""
+msgstr "<literal>version</literal> verifica a versão e a hora das colunas"
-#: index.docbook:423
+#. Tag: para
+#: basic_mapping.xml:423
+#, no-c-format
msgid "<literal>all</literal> check all columns"
-msgstr ""
+msgstr "<literal>all</literal> cverifica todas as colunas"
-#: index.docbook:428
-msgid "<literal>dirty</literal> check the changed columns, allowing some concurrent updates"
+#. 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> verifica as colunas modificadas, permitindo alguns "
+"updates concorrentes"
-#: index.docbook:433
+#. Tag: para
+#: basic_mapping.xml:433
+#, no-c-format
msgid "<literal>none</literal> do not use optimistic locking"
-msgstr ""
+msgstr "<literal>none</literal> não utiliza o bloqueio otimista"
-#: 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)."
+#. 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 ""
+"Nós <emphasis>recomendamos</emphasis> com muita enfase que você utilize a "
+"versão e a hora das colunas para o bloqueio otimista com o Hibernate. Esta é "
+"a melhor estratégia com respeito a performance e é a única estratégia que "
+"trata corretamente as modificações efetuadas em instancias desconectadas "
+"(por exemplo, quando <literal>Session.merge()</literal> é utilizado)."
-#: 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:"
+#. 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 ""
+"Não ha diferença entre uma view e uma tabela para o mapeamento do Hibernate, "
+"e como esperado isto é transparente no nível do banco de dados (observe que "
+"alguns bancos de dados não suportam views apropriadamente, especialmente com "
+"updates). Algumas vezes, você quer utilizar uma view, ma snão pode cria-la "
+"no banco de dados (por exemplo, com um esquema legado). Neste caso, você "
+"pode mapear uma entidade imutável e de somente leitura, para uma dada "
+"expressão SQL, que representa um subselect:"
-#: 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 ""
-#: 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><subselect></literal> is available as both as an attribute and a nested mapping element."
+#. 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><subselect></literal> is available as both as "
+"an attribute and a nested mapping element."
msgstr ""
+"Declare as tabelas para sincronizar com esta entidade, garantindo que o auto-"
+"flush ocorra corretamente, e que as queries para esta entidade derivada não "
+"retornem dados desatualizados. O <literal><subselect></literal> está "
+"disponível tanto como um atributo como um elemento mapeado nested."
-#: index.docbook:465
+#. Tag: title
+#: basic_mapping.xml:465
+#, no-c-format
msgid "<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><id></literal> element defines the mapping from that property to the primary key column."
+#. 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><id></"
+"literal> element defines the mapping from that property to the primary key "
+"column."
msgstr ""
+"Classes mapeadas <emphasis>precisam</emphasis> declarar a coluna de chave "
+"primaria da tabela do banco de dados. Muitas classes irão tambem ter uma "
+"propriedade ao estilo Java-Beans declarando o identificador unico de uma "
+"instancia. O elemento <literal><id></literal> define o mapeamento "
+"desta propriedade para a chave primária."
-#: 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=\"element-name|@attribute-name|element/@attribute|.\"\n"
- "\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=\"element-name|@attribute-name|element/@attribute|.\"\n"
+"\n"
+" <generator class=\"generatorClass\"/>\n"
+"</id>]]>"
msgstr ""
-#: index.docbook:485
-msgid "<literal>name</literal> (optional): The name of the identifier property."
-msgstr ""
+#. Tag: para
+#: basic_mapping.xml:485
+#, no-c-format
+msgid ""
+"<literal>name</literal> (optional): The name of the identifier property."
+msgstr "<literal>name</literal> (opcional): O nome do identificador."
-#: 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> (opcional): Um nome que indica o tipo no Hibernate."
-#: index.docbook:495
-msgid "<literal>column</literal> (optional - defaults to the property name): The name of the primary key column."
+#. 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> (opcional – default para o a propridade name): O "
+"nome coluna chave primaria."
-#: 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."
+#. 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> (opcional - default para um valor \"sensível"
+"\"): Uma propriedade de identificação que indica que a instancia foi "
+"novamente instanciada (unsaved), diferenciando de instancias desconectadas "
+"que foram salvas ou carregadas em uma sessão anterior."
-#: 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."
+#. 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> (opcional - valor default <literal>property</"
+"literal>): A estratégia que o Hiberante deve utilizar para acessar o valor "
+"da propriedade\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional - valor default <literal>property</"
+"literal>): A estartégia Hibernate que deve ser utilizada para acessar o "
+"valor da propriedade.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional - valor default <literal>property</"
+"literal>): A estratégia Hibernate que deve ser usada para acessar o valor da "
+"propriedade.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional - valor default para <literal>property</"
+"literal>): A estretagia Hibernate que deve ser utilizada para acessar o "
+"valor da propriedade.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional – valor default <literal>property</"
+"literal>): A estratégia que o Hibernate deve utilizar para acessar o valor "
+"da propriedade\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional - valor default <literal>property</"
+"literal>): A estrategia que o Hibernate deve utilizar para acessar o valor "
+"da propriedade.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional - valor default padrão "
+"<literal>property</literal>): A estratégia que o Hibernate pode usar para "
+"acessar o valor da propriedade.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional – valor default <literal>property</"
+"literal>): A estratégia que o Hibernate pode usar para acessar o valor da "
+"propriedade.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>access</literal> (opcional – valor default <literal>property</"
+"literal>): A estratégia que o hibernate deve usar para acessar o valor da "
+"propriedade."
-#: index.docbook:517
-msgid "If the <literal>name</literal> attribute is missing, it is assumed that the class has no identifier property."
+#. 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 ""
+"Se o atributo <literal>name</literal> não for declarado, assume-se que a "
+"classe não tem a propriedade de identificação."
-#: index.docbook:522
-msgid "The <literal>unsaved-value</literal> attribute is almost never needed in Hibernate3."
+#. Tag: para
+#: basic_mapping.xml:522
+#, no-c-format
+msgid ""
+"The <literal>unsaved-value</literal> attribute is almost never needed in "
+"Hibernate3."
msgstr ""
+"O atributo <literal>unsaved-value</literal> não é mais necessário no "
+"Hibernate 3."
-#: index.docbook:526
-msgid "There is an alternative <literal><composite-id></literal> declaration to allow access to legacy data with composite keys. We strongly discourage its use for anything else."
+#. Tag: para
+#: basic_mapping.xml:526
+#, no-c-format
+msgid ""
+"There is an alternative <literal><composite-id></literal> declaration "
+"to allow access to legacy data with composite keys. We strongly discourage "
+"its use for anything else."
msgstr ""
+"Há declaração alternativa <literal><composite-id></literal> permite o "
+"acesso a dados legados com chaves compostas. Nós desencorajamos fortemente o "
+"seu uso por qualquer pessoa."
-#: index.docbook:532
+#. Tag: title
+#: basic_mapping.xml:532
+#, no-c-format
msgid "Generator"
-msgstr ""
+msgstr "Generator"
-#: index.docbook:534
-msgid "The optional <literal><generator></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><param></literal> element."
+#. Tag: para
+#: basic_mapping.xml:534
+#, no-c-format
+msgid ""
+"The optional <literal><generator></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><param></"
+"literal> element."
msgstr ""
+"O elemento filho opcional <literal><generator></literal> nomeia uma "
+"classe Java usada para gerar identificadores unicos para instancias de uma "
+"classe persistente. Se algum parâmetro é requerido para configurar ou "
+"inicializar a instancia geradora, eles são passados utilizando o elemento "
+"<literal><param></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 ""
-#: 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:"
+#. 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 ""
+"Todos os generators implementam a interface <literal>org.hibernate.id."
+"IdentifierGenerator</literal>. Esta é uma interface bem simples; algumas "
+"aplicações podem prover sua própria implementação esepecializada. "
+"Entretanto, o Hibernate disponibiliza um conjunto de implementações "
+"internamente. Há nomes de atalhos para estes generators próprios: "
+"<placeholder-1/>"
-#: index.docbook:551
+#. Tag: literal
+#: basic_mapping.xml:551
+#, no-c-format
msgid "increment"
-msgstr ""
+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>"
+#. 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 ""
+"gera identificadores dos tipos <literal>long</literal>, <literal>short</"
+"literal> ou <literal>int</literal> que são unicos apenas quando nenhum outro "
+"processo está inserindo dados na mesma tabela. <emphasis>Não utilize em "
+"ambientes de cluster.</emphasis>"
-#: index.docbook:562
+#. Tag: literal
+#: basic_mapping.xml:562
+#, no-c-format
msgid "identity"
-msgstr ""
+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>."
+#. 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 ""
+"suporta colunas de identidade em DB2, MySQL, MS SQL Server, Sybase e "
+"HypersonicSQL. O identificador retornado é do tipo <literal>long</literal>, "
+"<literal>short</literal> ou <literal>int</literal>."
-#: index.docbook:572
+#. Tag: literal
+#: basic_mapping.xml:572
+#, no-c-format
msgid "sequence"
-msgstr ""
+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>"
+#. 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 ""
+"utiliza uma sequence em DB2, PostgreSQL, Oracle, SAP DB, McKoi ou um "
+"generator no Interbase. O identificador de retorno é do tipo <literal> long</"
+"literal>, <literal>short</literal> ou <literal>int</literal>."
-#: index.docbook:582
+#. Tag: literal
+#: basic_mapping.xml:582
+#, no-c-format
msgid "hilo"
-msgstr ""
+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."
+#. 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 ""
+"utiliza um algoritmo hi/lo para gerar de forma eficiente identificadores do "
+"tipo <literal>long</literal>, <literal>short</literal> ou <literal>int</"
+"literal>, a partir de uma tabela e coluna fornecida (por default "
+"<literal>hibernate_unique_key</literal> e <literal>next_hi</literal>) como "
+"fonte para os valores hi. O algoritmo hi/lo gera identificadores que são "
+"únicos apenas para um banco de dados particular."
-#: index.docbook:594
+#. Tag: literal
+#: basic_mapping.xml:594
+#, no-c-format
msgid "seqhilo"
-msgstr ""
+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."
+#. 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 ""
+"utiliza um algoritmo hi/lo para gerar de forma eficinete identificadores do "
+"tipo <literal>long</literal>, <literal>short</literal> ou <literal>int</"
+"literal>, a partir de uma sequence de banco de dados fornecida."
-#: index.docbook:604
+#. Tag: literal
+#: basic_mapping.xml:604
+#, no-c-format
msgid "uuid"
-msgstr ""
+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."
+#. 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 ""
+"utiliza um algortimo UUID de 128-bits para gerar identificadores do tipo "
+"string, unicos em uma rede(o endereço IP é utilizado). O UUID é codificado "
+"como um string de digitos hexadecimais de tamanho 32."
-#: index.docbook:614
+#. Tag: literal
+#: basic_mapping.xml:614
+#, no-c-format
msgid "guid"
-msgstr ""
+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 ""
+"utiliza um string GUID gerado pelo banco de dados no MS SQL Server e MySQL."
-#: index.docbook:622
+#. Tag: literal
+#: basic_mapping.xml:622
+#, no-c-format
msgid "native"
-msgstr ""
+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."
+#. 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 ""
+"seleciona entre <literal>identity</literal>, <literal>sequence</literal> ou "
+"<literal>hilo</literal> dependendo das capacidades do banco de dados "
+"utilizado."
-#: index.docbook:632
+#. Tag: literal
+#: basic_mapping.xml:632
+#, no-c-format
msgid "assigned"
-msgstr ""
+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><generator></literal> element is specified."
+#. 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><generator></literal> element is specified."
msgstr ""
+"deixa a aplicação definir um identificador para o objeto antes que o "
+"<literal>save()</literal> seja chamado. Esta é a estratégia default se "
+"nenhum elemento <literal><generator></literal> é especificado."
-#: index.docbook:642
+#. Tag: literal
+#: basic_mapping.xml:642
+#, no-c-format
msgid "select"
-msgstr ""
+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."
+#. 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 ""
+"retorna a chave primaria recuperada por uma trigger do banco de dados, "
+"selecionado uma linha pela chave única e recuperando o valor da chave "
+"primária."
-#: index.docbook:651
+#. Tag: literal
+#: basic_mapping.xml:651
+#, no-c-format
msgid "foreign"
-msgstr ""
+msgstr "foreign"
-#: index.docbook:653
-msgid "uses the identifier of another associated object. Usually used in conjunction with a <literal><one-to-one></literal> primary key association."
+#. Tag: para
+#: basic_mapping.xml:653
+#, no-c-format
+msgid ""
+"uses the identifier of another associated object. Usually used in "
+"conjunction with a <literal><one-to-one></literal> primary key "
+"association."
msgstr ""
+"utiliza o identificador de um outro objeto associado. Normalmente utilizado "
+"em conjunto com uma associaçõa de chave primária do tipo <literal><one-to-"
+"one></literal>."
-#: index.docbook:660
+#. Tag: literal
+#: basic_mapping.xml:660
+#, no-c-format
msgid "sequence-identity"
-msgstr ""
+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."
+#. 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 ""
+msgstr "Algoritmo Hi/lo"
-#: 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: 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 ""
+"Os geradores <literal>hilo</literal> e <literal>seqhilo</literal> fornecem "
+"duas implementações alternativas do algoritmo hi/lo, uma solução "
+"preferencial para a geração de identificadores. A primeira implementação "
+"requer uma tabela especial do banco de dados para manter o proximo valor \"hi"
+"\" disponível. A segunda utiliza uma seqüência do estilo Oracle (quando "
+"suportado)."
-#: index.docbook:687
+#. 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>]]>"
+"<![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 ""
-#: index.docbook:689
+#. Tag: programlisting
+#: basic_mapping.xml:689
+#, 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>]]>"
+"<![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: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>."
+#. Tag: para
+#: basic_mapping.xml:691
+#, no-c-format
+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 ""
+"Infelizemente, voce não pode utilizar <literal>hilo</literal> quando estiver "
+"fornecendo sia propria <literal>Connection</literal> para o Hibernate. "
+"Quando o Hibernate está usando um datasource do servidor de aplicações para "
+"obter conexões suportadas com JTA, você precisa configurar adequadamente o "
+"<literal>hibernate.transaction.manager_lookup_class</literal>."
-#: index.docbook:700
+#. Tag: title
+#: basic_mapping.xml:700
+#, no-c-format
msgid "UUID algorithm"
-msgstr ""
+msgstr "UUID algorithm"
-#: 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."
+#. 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 ""
+"O UUID contem: o endereço IP, hora de inicio da JVM (com precisão de um "
+"quarto de segundo), a hora do sistema e um valor contador (unico dentro da "
+"JVM). Não é possivel obter o endereço MAC ou um endereço de memória do "
+"código Java, assim este é o melhor que pode ser feito sem utilizar JNI."
-#: index.docbook:710
+#. Tag: title
+#: basic_mapping.xml:710
+#, no-c-format
msgid "Identity columns and sequences"
-msgstr ""
+msgstr "Colunas de identidade e sequencias"
-#: 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: 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 ""
+"Para bancos de dados que suportam colunas de identidade (DB2, MySQL, Sybase, "
+"MS SQL), você pode utilizar uma geração de chave <literal>identity</"
+"literal>. Para bancos de dados que suportam sequencias (DB2, Oracle, "
+"PostgreSQL, Interbase, McKoi, SAP DB) voce pode utilizar a geração de chaves "
+"no estilo <literal>sequence</literal>. As duas estratégias requerem duas "
+"consultas SQL para inserir um novo objeto."
-#: index.docbook:719
+#. 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>]]>"
+"<![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 ""
-#: index.docbook:721
+#. 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>]]>"
+"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\" unsaved-value=\"0"
+"\">\n"
+" <generator class=\"identity\"/>\n"
+"</id>]]>"
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."
+#. Tag: para
+#: basic_mapping.xml:723
+#, no-c-format
+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 ""
+"Para desenvolvimento multi-plataforma, a estratégia <literal>native</"
+"literal> irá escolher entre as estratégias i <literal>identity</literal>, "
+"<literal>sequence</literal> e <literal>hilo</literal>, dependendo das "
+"capacidades do banco de dados utilizado."
-#: index.docbook:732
+#. Tag: title
+#: basic_mapping.xml:732
+#, no-c-format
msgid "Assigned identifiers"
-msgstr ""
+msgstr "Identificadores especificados"
-#: 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><generator></literal> element."
+#. 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><generator></literal> "
+"element."
msgstr ""
+"Se você quer que a aplicação especifique os identificadores (em vez do "
+"Hibernate gerá-los) você deve utilizar o gerador <literal>assigned</"
+"literal>. Este gerador especial irá utilizar o valor do identificador "
+"especificado para a propriedade de identificação do objeto. Este gerador é "
+"usado quando a chave primaria é a chave natural em vez de uma surrogate key. "
+"Este é o comportamento padrão se você não especificar um elemento "
+"<literal><generator></literal>."
-#: 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>."
+#. 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 ""
+"Escolher o gerador <literal>assigned</literal> faz com que o Hibernate "
+"utilize <literal>unsaved-value=\"undefined\"</literal>, forçando o Hibernate "
+"ir até o banco de dados para determinar se uma instância está transiente ou "
+"desasociada, a menos que haja uma versão ou uma propriedade timestamp, ou "
+"você pode definir <literal>Interceptor.isUnsaved()</literal>."
-#: index.docbook:752
+#. Tag: title
+#: basic_mapping.xml:752
+#, no-c-format
msgid "Primary keys assigned by triggers"
-msgstr ""
+msgstr "Chaves primárias geradas por triggers"
-#: index.docbook:753
-msgid "For legacy schemas only (Hibernate does not generate DDL with triggers)."
-msgstr ""
+#. Tag: para
+#: basic_mapping.xml:753
+#, no-c-format
+msgid ""
+"For legacy schemas only (Hibernate does not generate DDL with triggers)."
+msgstr "Apenas para sistemas legados (o Hibernate nao gera DDL com triggers)."
-#: index.docbook:757
+#. 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>]]>"
+"<![CDATA[<id name=\"id\" type=\"long\" column=\"person_id\">\n"
+" <generator class=\"select\">\n"
+" <param name=\"key\">socialSecurityNumber</param>\n"
+" </generator>\n"
+"</id>]]>"
msgstr ""
-#: 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."
+#. Tag: para
+#: basic_mapping.xml:759
+#, no-c-format
+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."
msgstr ""
+"No exemplo acima, há uma única propriedade com valor nomeada "
+"<literal>socialSecurityNumber</literal> definida pela classe, uma chave "
+"natural, e uma surrogate key nomeada <literal>person_id</literal> cujo valor "
+"é gerado pro uma trigger."
-#: index.docbook:771
+#. Tag: title
+#: basic_mapping.xml:771
+#, no-c-format
msgid "Enhanced identifier generators"
-msgstr ""
+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 ""
+"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:"
+#. 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."
+#. 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\"."
+#. 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 ""
+"<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?"
+#. 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."
+#. 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"
+#. 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> (opcional – valor default <literal>none</"
+"literal>): o estilo do cascade."
-#: 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:"
+#. 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."
+#. 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."
+#. 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."
+#. 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."
+#. 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."
+#. 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."
+#. 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."
+#. 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 ""
+"<literal>cascade</literal> (opcional – valor default <literal>none</"
+"literal>): o estilo do cascade."
-#: index.docbook:900
+#. Tag: title
+#: basic_mapping.xml:900
+#, no-c-format
msgid "Identifier generator optimization"
-msgstr ""
+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."
+#. 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."
+#. 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\"."
+#. 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."
+#. 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 ""
+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>]]>"
+"<![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><composite-id></literal> element accepts <literal><key-property></literal> property mappings and <literal><key-many-to-one></literal> mappings as child elements."
+#. 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><composite-id></literal> "
+"element accepts <literal><key-property></literal> property mappings "
+"and <literal><key-many-to-one></literal> mappings as child elements."
msgstr ""
+"Para tabelas com uma chave composta, você pode mapear múltiplas propriedades "
+"da classe como propriedades de identificação. O elemento <literal><"
+"composite-id></literal> aceita o mapeamento da propriedade <literal><"
+"key-property></literal> e mapeamentos <literal><key-many-to-one></"
+"literal>como elements filhos."
-#: 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 ""
-#: 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>."
+#. 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 ""
+"Sua classe persistente <emphasis>precisa</emphasis> sobre escrever "
+"<literal>equals()</literal> e <literal>hashCode()</literal> para implementar "
+"identificadores compostos igualmente. E precisa também implementar "
+"<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."
+#. 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 ""
+"Infelizmente, esta solução para um identificador composto significa que um "
+"objeto persistente é seu próprio identificador. Não há outro \"handle\" que "
+"o próprio objeto. Você mesmo precisa instanciar uma instância de outra "
+"classe persistente e preencher suas propriedades de identificação antes que "
+"você possa dar um <literal>load()</literal> para o estado persistente "
+"associado com uma chave composta. Nos chamamos esta solução de identificador "
+"composto <emphasis>embedded</emphasis> e não aconselhamos para aplicações "
+"sérias."
-#: 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><composite-id></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><"
+"composite-id></literal> element are duplicated on both the persistent "
+"class and a separate identifier class."
msgstr ""
+"Uma segunda solução é o que podemos chamar de identificador composto "
+"<emphasis>mapped</emphasis> quando a propriedades de identificação nomeadas "
+"dentro do elemento <literal><composite-id></literal> estão duplicadas "
+"tando na classe persistente como em uma classe de identificação separada."
-#: 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>]]>"
+"<![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—code duplication."
+#. 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—code "
+"duplication."
msgstr ""
+"No exemplo, ambas as classes de identificação compostas, "
+"<literal>MedicareId</literal>, e a própria classe entidade tem propriedades "
+"nomeadas <literal>medicareNumber</literal> e <literal>dependent</literal>. A "
+"classe identificadora precisa sobrepor <literal>equals()</literal> e "
+"<literal>hashCode()</literal> e implementar <literal>Serializable</literal>. "
+"A desvantagem desta solução é obvia – duplicação de código."
-#: index.docbook:982
-msgid "The following attributes are used to specify a mapped composite identifier:"
+#. Tag: para
+#: basic_mapping.xml:982
+#, no-c-format
+msgid ""
+"The following attributes are used to specify a mapped composite identifier:"
msgstr ""
+"Os seguintes atributos ão utilizados para especificar o mapeamento de um "
+"identificador composto:"
-#: 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."
+#. 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> mapped (opcional, valor default <literal>false </"
+"literal>): indica que um identificar composto mapeado é usado, e que as "
+"propriedades de mapeamento contidas refere-se tanto a classe entidade e a "
+"classe de identificação composta."
-#: index.docbook:996
-msgid "<literal>class</literal> (optional, but required for a mapped composite identifier): The class used as a composite identifier."
+#. 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> (opcional, mas requerida para um identificar "
+"composto mapeado): A classe usada como um identificador composto."
-#: 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:"
+#. 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 ""
+"Nós iremos descrever uma terceira e as vezes mais conveniente solução, onde "
+"o identificador composto é implementado como uma classe componente na <xref "
+"linkend=\"components-compositeid\"/>. Os atributos descritos abaixo aplicam-"
+"se apenas para esta solução:"
-#: 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)."
+#. 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> (opcional, requerida para esta solução): Uma "
+"propriedade do tipo componente que armazena o identificador composto (veja "
+"capítulo 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)."
+#. 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> (opcional - valor default para o tipo de "
+"propriedade determiando por reflexão) : A classe componente utilizada como "
+"um identificador composto (veja a próxima sessão)."
-#: index.docbook:1030
-msgid "This third approach, an <emphasis>identifier component</emphasis> is the one we recommend for almost all applications."
+#. 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 ""
+"Esta terceira solução, um <emphasis>componente de identificação</emphasis>, "
+"é o que nós recomendamos para a maioria das aplicações."
-#: index.docbook:1038
+#. Tag: title
+#: basic_mapping.xml:1038
+#, no-c-format
msgid "discriminator"
-msgstr ""
+msgstr "discriminator"
-#: index.docbook:1040
-msgid "The <literal><discriminator></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><discriminator></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 ""
+"O elemento <literal><discriminator></literal> é necessário para "
+"persistência polimórfica utilizando a estratégia de mapeamento table-per-"
+"class-hierarchy e declara uma coluna discriminadora da tabela. A coluna "
+"discriminadora contem valores de marcação que dizem a camada de persistência "
+"qual subclasse instanciar para uma linha particular. Um restrito conjunto de "
+"tipos que podem ser utilizados: <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"
- "/>]]>"
+"<![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."
+#. 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> (opcional - valor default <literal>class</"
+"literal>) o nome da coluna discriminadora"
-#: index.docbook:1067
-msgid "<literal>type</literal> (optional - defaults to <literal>string</literal>) a name that indicates the Hibernate type"
+#. 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> (opcional - valor default <literal>string</literal>) "
+"o nome que indica o tipo 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."
+#. 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> (opcional - valor default <literal>false</literal>) "
+"\"força\" o Hibernate a especificar valores discriminadores permitidos mesmo "
+"quando recuperando todas as instancias da classe root."
-#: 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.)"
+#. 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> (opcional - valor default para <literal>true</"
+"literal>) sete isto para <literal>false</literal> se sua coluna "
+"discriminadora é também parte do identificador composto mapeado. (Diz ao "
+"Hibernate para não incluir a coluna em comandos SQL <literal>INSERT</"
+"literal>s)."
-#: 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."
+#. 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> (opcional) uma expressão SQL arbitraria que é e "
+"xecutada quando um tipo tem que ser avaliado. Permite discriminação baseada "
+"em conteúdo."
-#: index.docbook:1096
-msgid "Actual values of the discriminator column are specified by the <literal>discriminator-value</literal> attribute of the <literal><class></literal> and <literal><subclass></literal> elements."
+#. 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><"
+"class></literal> and <literal><subclass></literal> elements."
msgstr ""
+"Valores atuais de uma coluna discriminada são especificados pelo atributo "
+"<literal>discriminator-value</literal> da <literal><class></literal> e "
+"elementos da <literal><subclass></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."
+#. 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 ""
+"O atributo <literal>force</literal> é util (apenas) em tabelas contendo "
+"linhas com valores discriminadores \"extras\" que não estão mapeados para "
+"uma classe persistente. Este não é geralmente o caso."
-#: 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:"
+#. 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 ""
+"Usando o atributo <literal>formula</literal> voce pode declarar uma "
+"expressão SQL arbitrária que sera utilizada para avaliar o tipo de uma "
+"linha :"
-#: 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 ""
-#: index.docbook:1118
+#. Tag: title
+#: basic_mapping.xml:1118
+#, no-c-format
msgid "version (optional)"
-msgstr ""
+msgstr "version (optional)"
-#: index.docbook:1120
-msgid "The <literal><version></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)."
+#. Tag: para
+#: basic_mapping.xml:1120
+#, no-c-format
+msgid ""
+"The <literal><version></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 ""
+"O elemento <literal><version></literal> é opcional e indica que a "
+"tabela possui dados versionados. Isto é particularmente útil se você planeja "
+"utilizar <emphasis>transações longas</emphasis> (veja abaixo):"
-#: 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=\"element-name|@attribute-name|element/@attribute|.\"\n"
- "/>]]>"
+"<![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=\"element-name|@attribute-name|element/@attribute|.\"\n"
+"/>]]>"
msgstr ""
-#: index.docbook:1139
-msgid "<literal>column</literal> (optional - defaults to the property name): The name of the column holding the version number."
+#. 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> (opcional - default a a propriedade name): O nome "
+"da coluna mantendo o numero da versão"
-#: index.docbook:1145
-msgid "<literal>name</literal>: The name of a property of the persistent class."
-msgstr ""
+#. 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>: O nome da propriedade da classe persistente."
-#: index.docbook:1150
-msgid "<literal>type</literal> (optional - defaults to <literal>integer</literal>): The type of the version number."
+#. 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> (opcional - valor default para <literal>integer</"
+"literal>): O tipo do numero da versão"
-#: 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.)"
+#. 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> (opcional – valor default para "
+"<literal>undefined </literal>): Um valor para a propriedade versão que "
+"indica que uma instancia é uma nova instanciada (unsaved), distinguindo de "
+"instancias desconectadas que foram salvas ou carregadas em sessões "
+"anteriores. ((<literal>undefined</literal> especifica que o valor da "
+"propriedade de identificação deve ser utilizado)."
-#: 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."
+#. 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> (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</xref>. <literal>generated</literal> (opcional - "
+"valor default <literal>never</literal>): Especifica que valor para a "
+"propriedade versão é na verdade gerado pelo banco de dados. Veja a discussão "
+"da Seção <xref linkend=\"mapping-generated\">generated properties</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>."
+#. 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> (opcional - valor default para <literal>true</"
+"literal>): Especifica se a coluna de versão deve ser incluída no comando SQL "
+"de insert. Pode ser configurado como <literal>false</literal> se a coluna do "
+"banco de dados está definida com um valor default de <literal>0</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>."
+#. 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 ""
+"Números de versão podem ser dos tipos Hibernate <literal>long</literal>, "
+"<literal>integer</literal>, <literal>short</literal>, <literal>timestamp</"
+"literal> ou <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>"
+#. 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 ""
+"A versão de uma propriedade timestamp nunca deve ser nula para uma instancia "
+"desconectada, assim o Hibernate irá identificar qualquer instância com uma "
+"versão nula ou timestamp como transiente, não importando qual estratégia "
+"para foi especificada para <literal>unsaved-value</literal>. "
+"<emphasis>Declarando uma versão nula ou a propriedade timestamp é um caminho "
+"fácil para tratar problemas com reconexões transitivas no Hibernate, "
+"especialmente úteis para pessoas utilizando identificadores assinaldados ou "
+"chaves compostas!</emphasis>"
-#: index.docbook:1204
+#. Tag: title
+#: basic_mapping.xml:1204
+#, no-c-format
msgid "timestamp (optional)"
-msgstr ""
+msgstr "timestamp (optional)"
-#: index.docbook:1206
-msgid "The optional <literal><timestamp></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."
+#. Tag: para
+#: basic_mapping.xml:1206
+#, no-c-format
+msgid ""
+"The optional <literal><timestamp></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 ""
+"O elemento opcional <literal><timestamp></literal> indica que uma "
+"tabela contém dados timestamped. Isso tem por objetivo dar uma alternativa "
+"para versionamento. Timestamps são por natureza uma implementação menos "
+"segura do locking otimista. Entretanto, algumas vezes a aplicação pode usar "
+"timestamps em outros caminhos."
-#: 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=\"element-name|@attribute-name|element/@attribute|.\"\n"
- "/>]]>"
+"<![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=\"element-name|@attribute-name|element/@attribute|.\"\n"
+"/>]]>"
msgstr ""
-#: index.docbook:1225
-msgid "<literal>column</literal> (optional - defaults to the property name): The name of a column holding the timestamp."
+#. 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> (opcional - valor default para a propriedade "
+"name): O nome da coluna que mantem o timestamp."
-#: 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."
+#. 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>: O nome da propriedade no estilo JavaBeans do tipo "
+"<literal>Date</literal> ou <literal>Timestamp</literal> da classe "
+"persistente Java."
-#: 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.)"
+#. 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> (opcional - valor default <literal>null</"
+"literal>): Uma propriedade para a versão de que indica que uma instância é "
+"uma nova instanciada (unsaved), distinguindo-a de instancias desconectadas "
+"que foram salvas ou carregadas em sessões previas. (<literal>undefined</"
+"literal> especifica que um valor de propriedade de identificação deve ser "
+"utilizado)"
-#: 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 ""
+"<literal>source</literal> (opcional - valor default para <literal>vm</"
+"literal>): De onde o Hibernate deve recuperar o valor timestamp? Do banco de "
+"dados ou da JVM corrente? Timestamps baseados em banco de dados levam a um "
+"overhead porque o Hibernate precisa acessar o banco de dados para determinar "
+"o \"próximo valor\", mas é mais seguro para uso em ambientes de \"cluster\". "
+"Observe também, que nem todos <literal>Dialect</literal>s suportam a "
+"recuperação do timestamp corrente do banco de dados, enquando outros podem "
+"não ser seguros para utilização em bloqueios pela falta de precisão (Oracle "
+"8 por exemplo)"
-#: 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."
+#. 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> (opcional - valor default <literal>never</"
+"literal>): Especifica que o valor da propriedade timestamp é gerado pelo "
+"banco de dados. Veja a discussão <xref linkend=\"mapping-generated"
+"\">generated properties</xref>."
-#: index.docbook:1274
-msgid "Note that <literal><timestamp></literal> is equivalent to <literal><version type=\"timestamp\"></literal>. And <literal><timestamp source=\"db\"></literal> is equivalent to <literal><version type=\"dbtimestamp\"></literal>"
+#. Tag: para
+#: basic_mapping.xml:1274
+#, no-c-format
+msgid ""
+"Note that <literal><timestamp></literal> is equivalent to <literal><"
+"version type=\"timestamp\"></literal>. And <literal><timestamp source="
+"\"db\"></literal> is equivalent to <literal><version type=\"dbtimestamp"
+"\"></literal>"
msgstr ""
+"Observe que <literal><timestamp></literal> é equivalente a "
+"<literal><version type=\"timestamp\"></literal>. E <literal><"
+"timestamp source=\"db\"></literal> é equivalente a <literal><version "
+"type=\"dbtimestamp\"></literal>."
-#: index.docbook:1284
+#. Tag: title
+#: basic_mapping.xml:1284
+#, no-c-format
msgid "property"
-msgstr ""
+msgstr "property"
-#: index.docbook:1286
-msgid "The <literal><property></literal> element declares a persistent, JavaBean style property of the class."
+#. Tag: para
+#: basic_mapping.xml:1286
+#, no-c-format
+msgid ""
+"The <literal><property></literal> element declares a persistent, "
+"JavaBean style property of the class."
msgstr ""
+"O elemento <literal><property></literal> declara uma propriedade "
+"persistente de uma classe, no estilo 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=\"element-name|@attribute-name|element/@attribute|.\"\n"
- " index=\"index_name\"\n"
- " unique_key=\"unique_key_id\"\n"
- " length=\"L\"\n"
- " precision=\"P\"\n"
- " scale=\"S\"\n"
- "/>]]>"
+"<![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=\"element-name|@attribute-name|element/@attribute|.\"\n"
+" 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."
+#. 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>: o nome da propriedade, iniciando com letra "
+"minúscula."
-#: 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><column></literal> element(s)."
+#. 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><column></literal> element(s)."
msgstr ""
+"<literal>column</literal> (opcional - default para a propriedade name): o "
+"nome da coluna mapeada do banco de dados, Isto pode também ser especificado "
+"pelo(s) elemento(s) <literal><column></literal> aninhados."
-#: index.docbook:1324
-msgid "<literal>type</literal> (optional): a name that indicates the Hibernate type."
+#. 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> (opcional): um nome que indica o tipo 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."
+#. 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> (opcional - valor default <literal>true</"
+"literal>): especifica que as colunas mapeadas devem ser incluidas nas "
+"instruções SQL de <literal>UPDATE</literal> e/ou <literal>INSERT</literal> . "
+"Setar ambas para to <literal>false</literal> permite uma propridade "
+"\"derivada\" pura cujo valor é inicializado de outra propriedade que mapeie "
+"a mesma coluna(s) ou por uma trigger ou outra aplicação."
-#: 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."
+#. 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> (opcional): uma expressão SQL que definie o valor "
+"para uma propriedade <emphasis>calculada</emphasis>. Propriedades calculadas "
+"nao tem uma coluna de mapeamento para elas."
-#: 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)."
+#. 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> (opcional - valor default para <literal>false</"
+"literal>): Especifica que esta propriedade deve ser trazida de forma \"lazy"
+"\" quando a instancia da variável é acessada pela primeira vez (requer "
+"instrumentação bytecode em tempo de criação)."
-#: 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>."
+#. 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> (opcional): Habilita a geração de DDL de uma unica "
+"constraint para as colunas. Assim, permite que isto seja o alvo de uma "
+"<literal>property-ref</literal>."
-#: index.docbook:1365
-msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the columns."
+#. 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> (opcional): Habilita a geração de DDL de uma "
+"constraint de nulidade para as colunas."
-#: 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."
+#. 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> (opcional - valor default <literal>true</"
+"literal>): Especifica se mudanças para esta propriedade requerem ou não "
+"bloqueio otimista. Em outras palavras, determina se um incremento de versão "
+"deve ocorrer quando esta propriedade está suja."
-#: 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."
+#. 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> (opcional - valor default <literal>never</"
+"literal>): Especifica que o valor da propriedade é na verdade gerado pelo "
+"banco de dados. Veja a discussão da seção <xref linkend=\"mapping-generated"
+"\">generated properties</xref>."
-#: index.docbook:1388
+#. Tag: para
+#: basic_mapping.xml:1388
+#, no-c-format
msgid "<emphasis>typename</emphasis> could be:"
-msgstr ""
+msgstr "<emphasis>typename</emphasis> pode ser:"
-#: index.docbook:1394
-msgid "The name of a Hibernate basic type (eg. <literal>integer, string, character, date, timestamp, float, binary, serializable, object, blob</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 ""
+"The name of a Hibernate basic type (eg. <literal>integer, string, character, "
+"date, timestamp, float, binary, serializable, object, blob</literal>). O "
+"nome do tipo basico do Hibernate (ex., <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>)."
+#. 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 ""
+"O nome da classe Java com um tipo básico default (ex. <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 ""
+msgstr "O nome da classe Java serializable"
-#: index.docbook:1411
-msgid "The class name of a custom type (eg. <literal>com.illflow.type.MyCustomType</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 ""
+"O nome da classe de um tipo customizado (ex. <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.)"
+#. 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 ""
+"Se você não especificar um tipo, o Hibernate ira utilizar reflexão sobre a "
+"propriedade nomeada para ter uma idéia do tipo Hibernate correto. O "
+"Hibernate ira tentar interpretar o nome da classe retornada, usando as "
+"regras 2, 3 e 4 nesta ordem. Entretanto, isto não é sempre suficiente Em "
+"certos casos, você ainda irá necessitar do atributo <literal>type</literal>. "
+"(Por exemplo, para distinguir entre <literal>Hibernate.DATE</literal> ou "
+"<literal>Hibernate.TIMESTAMP</literal>, ou para espcificar uma tipo "
+"ciustomizado.)"
-#: 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>."
+#. 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 ""
+"O atributo <literal>access</literal> permite voce controlar como o Hibernate "
+"irá acessar a propriedade em tempo de execução. Por default, o Hibernate irá "
+"chamar os métodos get/set da propriedades. Se voce especificar "
+"<literal>access=\"field\"</literal>, o Hibernate ira bipassar os metodos get/"
+"set, acessnado o campo diretamente, usando reflexão. Voc epode especificar "
+"sua própria estratégia para acesso da propriedade criando uma classe que "
+"implemente a interface <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:"
+#. 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 ""
+"Um recurso especialmente poderoso é o de propriedades derivadas. Estas "
+"propriedades são por definição read-only, e o valor da propriedade é "
+"calculado em tempo de execução. Você declara este calculo como uma expressão "
+"SQL, que traduz para clausula <literal>SELECT</literal> de uma subquery "
+"daquery SQL que carrega a instancia:"
-#: 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 )\"/>]]>"
+"<![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><formula></literal> mapping element if you don't like to use the attribute."
+#. 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><formula></literal> "
+"mapping element if you don't like to use the attribute."
msgstr ""
+"Observe que você pode referenciar as entidades da própria tabela, através da "
+"não declaração de um alias para uma coluna particular ( <literal>customerId</"
+"literal> no exemplo dado). Observe tambem que voce pode usar o mapeamento de "
+"elemento aninhado <literal><formula></literal>, se você não gostar de "
+"usar o atributo."
-#: 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."
+#. 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 ""
+"Uma associação ordinária para outra classe persistente é declarada usando o "
+"elemento <literal>many-to-one</literal>. O modelo relacional é uma "
+"associação many-to-one: a uma chave estrangeira de uma tabela referenciando "
+"a chave primaria da tabela destino."
-#: 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=\"element-name|@attribute-name|element/@attribute|.\"\n"
- " embed-xml=\"true|false\"\n"
- " index=\"index_name\"\n"
- " unique_key=\"unique_key_id\"\n"
- " foreign-key=\"foreign_key_name\"\n"
- "/>]]>"
+"<![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=\"element-name|@attribute-name|element/@attribute|.\"\n"
+" 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 ""
+msgstr "<literal>name</literal>: O nome da propriedade."
-#: 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><column></literal> element(s)."
+#. 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><column></literal> "
+"element(s)."
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>column</literal> (opcional): O nome da coluna foreign key. Isto "
+"pode também ser especificado através de elementos aninhados <literal><"
+"column></literal>.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+". <literal>column</literal> (opcional): O nome da coluna da chave "
+"estrangeira. Isto também pode ser especificado por aninhamento de elemento"
+"(s) <literal><column></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."
+#. 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> (opcional – default para o tipo de propriedade "
+"determinado pela reflexão). O nome da classe associada.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>class</literal> (opcional – default para o tipo da propriedade "
+"definido via reflection): O nome da classe associada."
-#: 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 ""
+"<literal>cascade</literal> (opcional): Especifica quais operações dever ser "
+"em cascata do objeto pai para o objeto associado."
-#: 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."
+#. 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> (opcional - default para <literal>select</"
+"literal>): Escolhe entre recuperação outer-join ou recuperação seqüencial.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>fetch</literal> ((opcional – valor default <literal>select</"
+"literal>): Escolhe entre outer-join fetching ou sequential select fetching."
-#: 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."
+#. 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> (opcional - valor default <literal>true</"
+"literal>): especifica que as colunas mapeadas dever ser incluidas em "
+"instruções SQL de <literal>UPDATE</literal> e/ou <literal>INSERT</literal>. "
+"Setando ambas para <literal>false</literal> você permite uma associação "
+"\"derivada\" pura cujos valores são inicializados de algumas outras "
+"propriedades que mapeiam a mesma coluna ou por uma trigger ou outra "
+"aplicação."
-#: 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."
+#. 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>: (opcional) O nome da propriedade da classe "
+"associada que faz a junção desta foreign key. Se não especificada, a chave "
+"primaria da classe associada será utilizada."
-#: 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."
+#. 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> (opcional): Habilita a geração DDL de uma "
+"constraint unique para a coluna foreign-key. Alem disso, permite ser o alvo "
+"de uma <literal>property-ref</literal>. Isso torna a associação multipla "
+"efetivamente um para um."
-#: index.docbook:1548
-msgid "<literal>not-null</literal> (optional): Enable the DDL generation of a nullability constraint for the foreign key columns."
+#. 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> (opcional): Habilita a geração DDL de uma "
+"constraint de nulidade para as foreign keys."
-#: 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."
+#. 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> (opcional - valor default <literal>true</"
+"literal>): Especifica se mudanças desta propriedade requerem ou não "
+"travamento otimista. Em outras palavras, determina se um incremento de "
+"versão deve ocorrer quando esta propriedade está suja."
-#: 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."
+#. 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>(opcional – valor default <literal>proxy</literal>): "
+"Por default, associações de ponto unico são envoltas em um proxie. "
+"<literal>lazy=\"no-proxy\"</literal> especifica que a propriedade deve ser "
+"trazida de forma tardia quando a instancia da variável é acessada pela "
+"primeira vez (requer instrumentação bytecode em tempo de criação) "
+"<literal>lazy=\"false\"</literal> especifica que a associação será sempre "
+"recuperada fortemente."
-#: 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."
+#. 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> (opcional - valor default <literal>exception</"
+"literal>): Especifica como as foreign keys que referenciam linhas ausentes "
+"serão tratadas: <literal>ignore</literal> irá tratar a linha ausente como "
+"ama associaççao de null"
-#: index.docbook:1579, index.docbook:1733
-msgid "<literal>entity-name</literal> (optional): The entity name of the associated class."
+#. Tag: para
+#: basic_mapping.xml:1579 basic_mapping.xml:1733
+#, no-c-format
+msgid ""
+"<literal>entity-name</literal> (optional): The entity name of the associated "
+"class."
msgstr ""
+"<literal>entity-name</literal> (opcional): O nome da entidade da classe "
+"associada."
-#: index.docbook:1585
-msgid "<literal>formula</literal> (optional): an SQL expression that defines the value for a <emphasis>computed</emphasis> foreign key."
+#. 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> (optional): Uma expressão SQL que define um valor "
+"para um foreign key <emphasis>computed</emphasis>."
-#: 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."
+#. 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 ""
+"Setar o valor do atributo <literal>cascade</literal> para qualquer valor "
+"significativo diferente de <literal>none</literal> irá propagar certas "
+"operações ao objeto associado. Os valores significativos são os nomes das "
+"operações básicas do Hibernate, <literal>persist, merge, delete, save-"
+"update, evict, replicate, lock, refresh</literal>, assim como os valores "
+"especiais <literal>delete-orphan</literal> e <literal>all</literal> e "
+"combinações de nomes de operações separadas por vírgula, como por exemplo, "
+"<literal>cascade=\"persist,merge,evict\"</literal> ou <literal>cascade=\"all,"
+"delete-orphan\"</literal>. Veja a seção <xref linkend=\"objectstate-"
+"transitive\"/> para uma explicação completa. Note que associações valoradas "
+"simples (associações muitos-pra-um, e um-pra-um) não suportam orphan delete."
-#: index.docbook:1605
-msgid "A typical <literal>many-to-one</literal> declaration looks as simple as this:"
+#. Tag: para
+#: basic_mapping.xml:1605
+#, no-c-format
+msgid ""
+"A typical <literal>many-to-one</literal> declaration looks as simple as this:"
msgstr ""
+"Uma típica declaração <literal>muitos-pra-um</literal> se parece com esta:"
-#: index.docbook:1609
-msgid "<![CDATA[<many-to-one name=\"product\" class=\"Product\" column=\"PRODUCT_ID\"/>]]>"
+#. 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.)"
+#. 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 ""
+"O atributo <literal>property-ref</literal> deve apenas ser usado para mapear "
+"dados legados onde uma chave estrangeira se referencia a uma chave exclusiva "
+"da tabela associada que não seja à chave primária. Este é um modelo "
+"relacional desagradável. Por exemplo, suponha que a classe <literal>Product</"
+"literal> tenha um número seqüencial exclusivo, que não é a chave primária. "
+"(O atributo <literal>unique</literal> controla a geração de DDL do Hibernate "
+"com a ferramenta SchemaExport.)"
-#: index.docbook:1620
-msgid "<![CDATA[<property name=\"serialNumber\" unique=\"true\" type=\"string\" column=\"SERIAL_NUMBER\"/>]]>"
+#. 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 ""
+msgstr "Então o mapeamento para <literal>OrderItem</literal> poderia usar:"
-#: index.docbook:1626
-msgid "<![CDATA[<many-to-one name=\"product\" property-ref=\"serialNumber\" column=\"PRODUCT_SERIAL_NUMBER\"/>]]>"
+#. 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 ""
+msgstr "Porém, isto obviamente não é indicado, nunca."
-#: 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><properties></literal> element."
+#. 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><"
+"properties></literal> element."
msgstr ""
+"Se a chave exclusiva referenciada engloba múltiplas propriedades da entidade "
+"associada, você deve mapear as propriedades referenciadas dentro de um "
+"elemento chamado <literal><properties></literal>"
-#: index.docbook:1637
-msgid "If the referenced unique key is the property of a component, you may specify a property path:"
+#. 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 ""
+"Se a chave exclusiva referenciada é a propriedade de um componente, você "
+"pode especificar um caminho para a propriedade."
-#: index.docbook:1641
-msgid "<![CDATA[<many-to-one name=\"owner\" property-ref=\"identity.ssn\" column=\"OWNER_SSN\"/>]]>"
+#. 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:1646
+#. Tag: title
+#: basic_mapping.xml:1646
+#, no-c-format
msgid "one-to-one"
-msgstr ""
+msgstr "one-to-one (um-pra-um)"
-#: index.docbook:1648
-msgid "A one-to-one association to another persistent class is declared using a <literal>one-to-one</literal> element."
+#. 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 ""
+"Uma associação um-pra-um para outra classe persistente é declarada usando um "
+"elemento <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=\"element-name|@attribute-name|element/@attribute|.\"\n"
- " embed-xml=\"true|false\"\n"
- " foreign-key=\"foreign_key_name\"\n"
- "/>]]>"
+"<![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=\"element-name|@attribute-name|element/@attribute|.\"\n"
+" 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."
+#. 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> (opcional): Especifica qual operação deve ser "
+"cascateada do objeto pai para o objeto associado."
-#: 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)."
+#. 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> (opcional): Especifica que uma chave "
+"estrangeira constraint na chave primária da tabela mapeada referencia a "
+"tabela da classe associada, Esta opção afeta a ordem em queh <literal>save()"
+"</literal> e <literal>delete()</literal> são cascateadas, e determina se a "
+"associação pode ser substituída (isto também é usado pela ferramenta schema "
+"export)."
-#: 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."
+#. 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>(opcional): O nome da propriedade da classe "
+"associada que é ligada a chave primária desta classe. Se não for "
+"especificada, a chave primária da classe associada é utilizada."
-#: 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 ""
+"<literal>formula</literal> (opcional): Quase todas associações um-pra-um "
+"mapeiam para a chave primária da entidade dona. No caso raro, que não é o "
+"caso, você pode especificar uma outra coluna, colunas ou expressões para "
+"juntar utilizando uma formula SQL. (Veja <literal>org.hibernate.test."
+"onetooneformula</literal> para exemplo)."
-#: 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>"
+#. 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> (opcional – valor default <literal>proxy</literal>): "
+"Por default, associações single point são proxied. <literal>lazy=\"no-proxy"
+"\"</literal> especifica que a propriedade deve ser fetched lazily quando o "
+"atributo é acessado pela primeira vez (requer build-time bytecode "
+"instrumentation). <literal>lazy=\"false\"</literal> especifica que a "
+"associação vai sempre ser avidamente fetched. <emphasis>Note que se "
+"<literal>constrained=\"false\"</literal>, proxing é impossível e o Hibernate "
+"vai ávido fetch a associação!</emphasis>"
-#: index.docbook:1740
+#. Tag: para
+#: basic_mapping.xml:1740
+#, no-c-format
msgid "There are two varieties of one-to-one association:"
-msgstr ""
+msgstr "Existem duas variedades de associações um-pra-um:"
-#: index.docbook:1744
+#. Tag: para
+#: basic_mapping.xml:1744
+#, no-c-format
msgid "primary key associations"
-msgstr ""
+msgstr "associações de chave primária"
-#: index.docbook:1747
+#. Tag: para
+#: basic_mapping.xml:1747
+#, no-c-format
msgid "unique foreign key associations"
-msgstr ""
+msgstr "associações de chave estrangeira exclusiva"
-#: 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!"
+#. 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 ""
+"Associações de chave primária não necessitam de uma coluna extra de tabela; "
+"se duas linhas são relacionadas pela associação então as duas linhas da "
+"tabela dividem a mesmo valor da chave primária. Assim, se você quer que dois "
+"objetos sejam relacionados por uma associação de chave primária, você deve "
+"ter certeza que eles são assinados com o mesmo valor identificador!"
-#: index.docbook:1759
-msgid "For a primary key association, add the following mappings to <literal>Employee</literal> and <literal>Person</literal>, respectively."
+#. 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 ""
+"Para uma associação de chave primária, adicione os seguintes mapeamentos em "
+"<literal>Employee</literal> e <literal>Person</literal>, respectivamente."
-#: index.docbook:1764
+#. Tag: programlisting
+#: basic_mapping.xml:1764
+#, no-c-format
msgid "<![CDATA[<one-to-one name=\"person\" class=\"Person\"/>]]>"
msgstr ""
-#: index.docbook:1765
-msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" constrained=\"true\"/>]]>"
+#. 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>:"
+#. 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 ""
+"Agora nós devemos assegurar que as chaves primárias de linhas relacionadas "
+"nas tabelas PERSON e EMPLOYEE são iguais. Nós usamos uma estratégia especial "
+"de geração de identificador do Hibernate chamada <literal>foreign</literal>:"
-#: 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>]]>"
+"<![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>."
+#. 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 ""
+"Uma nova instância de <literal>Person</literal> salva recentemente é então "
+"assinada com o mesmo valor da chave primária da instância de "
+"<literal>employee</literal> referenciada com a propriedade "
+"<literal>employee</literal> daquela <literal>Person</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:"
+#. 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 ""
+"Alternativamente, uma chave estrangeira com uma unique constraint, de "
+"<literal>Employee</literal> para <literal>Person</literal>, pode ser "
+"expressa como:"
-#: 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 ""
-#: index.docbook:1788
-msgid "And this association may be made bidirectional by adding the following to the <literal>Person</literal> mapping:"
+#. 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 ""
+"E esta associação pode ser feita de forma bi-direcional adicionando o "
+"seguinte no mapeamento de <literal>Person</literal>:"
-#: index.docbook:1793
-msgid "<![CDATA[<one-to-one name=\"employee\" class=\"Employee\" property-ref=\"person\"/>]]>"
+#. 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 ""
+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>]]>"
+"<![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><natural-id></literal> element. Hibernate will generate the necessary unique key and nullability constraints, and your mapping will be more self-documenting."
+#. 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><natural-id></literal> element. Hibernate will generate "
+"the necessary unique key and nullability constraints, and your mapping will "
+"be more self-documenting."
msgstr ""
+"Embora nós recomendemos o uso de surrogate keys como chaves primárias, você "
+"deve ainda identificar chaves naturais para todas as entidades. Uma chave "
+"natural é uma propriedade ou combinação de propriedades que é exclusiva e "
+"não nula. Se não pude ser modificada, melhor ainda. Mapeie as propriedades "
+"da chave natural dentro do elemento <literal><natural-id></literal>. O "
+"Hibernate irá gerar a chave exclusiva necessária e as constraints de "
+"nullability , e seu mapeamento será apropriadamente auto documentado."
-#: 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."
+#. 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 ""
+"Nós recomendamos com enfase que você implemente <literal>equals()</literal> "
+"e <literal>hashCode()</literal> para comparar as propriedades da chave "
+"natural da entidade."
-#: 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 ""
+"Este mapeamento não tem o objetivo de uso com entidades com natural chaves "
+"primárias."
-#: index.docbook:1822
-msgid "<literal>mutable</literal> (optional, defaults to <literal>false</literal>): By default, natural identifier properties as assumed to be immutable (constant)."
+#. 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> mutable (opcional, valor default<literal>false</"
+"literal>): Por default, propriedades naturais identificadoras são "
+"consideradas imutáveis (constante)."
-#: index.docbook:1832
+#. Tag: title
+#: basic_mapping.xml:1832
+#, no-c-format
msgid "component, dynamic-component"
-msgstr ""
+msgstr "componente, componente dinâmico"
-#: index.docbook:1834
-msgid "The <literal><component></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."
+#. Tag: para
+#: basic_mapping.xml:1834
+#, no-c-format
+msgid ""
+"The <literal><component></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 ""
+"O elemento<literal><component></literal> mapeia propriedades de um "
+"objeto filho para colunas da tabela de uma classe pai. Componentes podem, um "
+"após o outro, declarar suas próprias propriedades, componentes ou coleções. "
+"Veja \"Components\" abaixo."
-#: index.docbook:1852
+#. 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>]]>"
+"<![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: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:1860
+#, no-c-format
+msgid ""
+"<literal>class</literal> (optional - defaults to the property type "
+"determined by reflection): The name of the component (child) class."
msgstr ""
+"<literal>class</literal> (opcional – valor default para o tipo de "
+"propriedade determinada por reflection): O nome da classe (filha) do "
+"componente."
-#: index.docbook:1866, index.docbook:1955
-msgid "<literal>insert</literal>: Do the mapped columns appear in SQL <literal>INSERT</literal>s?"
+#. Tag: para
+#: basic_mapping.xml:1866 basic_mapping.xml:1955
+#, no-c-format
+msgid ""
+"<literal>insert</literal>: Do the mapped columns appear in SQL "
+"<literal>INSERT</literal>s?"
msgstr ""
+"<literal>insert</literal>: As colunas mapeadas aparecem nos SQL de "
+"<literal>INSERT</literal>s?"
-#: index.docbook:1872, index.docbook:1961
-msgid "<literal>update</literal>: Do the mapped columns appear in SQL <literal>UPDATE</literal>s?"
+#. Tag: para
+#: basic_mapping.xml:1872 basic_mapping.xml:1961
+#, no-c-format
+msgid ""
+"<literal>update</literal>: Do the mapped columns appear in SQL "
+"<literal>UPDATE</literal>s?"
msgstr ""
+"<literal>update</literal>: As colunas mapeadas aparecem nos SQL de "
+"<literal>UPDATE</literal>s?"
-#: 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)."
+#. 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> (opcional - valor default <literal>false</literal>): "
+"Especifica que este componente deve ser fetched lazily quando o atributo for "
+"acessado pela primeira vez (requer build-time bytecode instrumentation)."
-#: 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."
+#. 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> (opcional – valor default <literal>true</"
+"literal>): Especifica que atualizações para este componente requerem ou não "
+"aquisição de um lock otimista. Em outras palavras, determina se uma versão "
+"de incremento deve ocorrer quando esta propriedade estiver modificada."
-#: 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."
+#. Tag: para
+#: basic_mapping.xml:1899 basic_mapping.xml:1975
+#, fuzzy, 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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>unique</literal> (opcional – valor default <literal>false</"
+"literal>): Especifica que existe uma unique constraint em todas as colunas "
+"mapeadas do componente.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>unique</literal> (opcional – valor defautl <literal>false</"
+"literal>): Especifica que uma unique constraint existe em todas as colunas "
+"mapeadas do componente."
-#: index.docbook:1908
-msgid "The child <literal><property></literal> tags map properties of the child class to table columns."
+#. Tag: para
+#: basic_mapping.xml:1908
+#, no-c-format
+msgid ""
+"The child <literal><property></literal> tags map properties of the "
+"child class to table columns."
msgstr ""
+"A tag filha <literal><property></literal> acrescenta a propriedade de "
+"mapeamento da classe filha para colunas de uma tabela."
-#: index.docbook:1913
-msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity."
+#. Tag: para
+#: basic_mapping.xml:1913
+#, no-c-format
+msgid ""
+"The <literal><component></literal> element allows a <literal><"
+"parent></literal> subelement that maps a property of the component class "
+"as a reference back to the containing entity."
msgstr ""
+"O elemento <literal><component></literal> permite um sub-elemento "
+"<literal><parent></literal> mapeie uma propriedade da classe do "
+"componente como uma referencia de volta para a entidade que o contém."
-#: index.docbook:1919
-msgid "The <literal><dynamic-component></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><dynamic-component></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 ""
+"O elemento <literal><dynamic-component></literal> permite que um "
+"<literal>Map</literal> possa ser mapeado como um componente onde os nomes "
+"das propriedades referem-se para as chaves no mapa, veja <xref linkend="
+"\"components-dynamic\"/>."
-#: index.docbook:1928
+#. Tag: title
+#: basic_mapping.xml:1928
+#, no-c-format
msgid "properties"
-msgstr ""
+msgstr "propriedades"
-#: index.docbook:1930
-msgid "The <literal><properties></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."
+#. Tag: para
+#: basic_mapping.xml:1930
+#, no-c-format
+msgid ""
+"The <literal><properties></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 ""
+"O elemento <literal><properties></literal> permite a definição de um "
+"grupo com nome, lógico de propriedades de uma classe. O uso mais importante "
+"do construtor é que este permite uma combinação de propriedades para ser o "
+"objetivo de uma <literal>property-ref</literal>. É também um modo "
+"conveninente para definir uma unique constraint de múltiplas colunas."
-#: 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>]]>"
+"<![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."
+#. 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>:: O nome lógico do agrupamento – <emphasis>não </"
+"emphasis> é o nome atual de propriedade."
-#: 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."
+#. 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> (opcional – valor default <literal>true</"
+"literal>): Especifica que atualizações para estes componentes requerem ou "
+"não aquisição de um lock otimista. Em outras palavras, determina se uma "
+"versão de incremento deve ocorrer quando estas propriedades estiverem "
+"modificadas."
-#: index.docbook:1984
-msgid "For example, if we have the following <literal><properties></literal> mapping:"
+#. Tag: para
+#: basic_mapping.xml:1984
+#, no-c-format
+msgid ""
+"For example, if we have the following <literal><properties></literal> "
+"mapping:"
msgstr ""
+"Por exemplo, se nós temos o seguinte mapeamento de <literal><"
+"properties></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 ""
-#: 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:"
+#. 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 ""
+"Então nós podemos ter uma associação de dados herdados que referem a esta "
+"chave exclusiva da tabela <literal>Person</literal>, ao invés de se "
+"referirem a chave primária:"
-#: 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>]]>"
+"<![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."
+#. 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 ""
+"Nós não recomendamos o uso deste tipo de coisa fora do contexto de "
+"mapeamento de dados herdados."
-#: index.docbook:2005
+#. Tag: title
+#: basic_mapping.xml:2005
+#, no-c-format
msgid "subclass"
-msgstr ""
+msgstr "subclass (subclasse)"
-#: 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><subclass></literal> declaration is used."
+#. 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><subclass></literal> declaration is used."
msgstr ""
+"Finalmente, a persistência polimórfica requer a declaração de cada subclasse "
+"da classe de persistência raiz. Para a estratégia de mapeamento table-per-"
+"class-hierarchy, a declaração <literal><subclass></literal> deve ser "
+"usada."
-#: 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>]]>"
+"<![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."
+#. Tag: para
+#: basic_mapping.xml:2023 basic_mapping.xml:2081 basic_mapping.xml:2144
+#, fuzzy, no-c-format
+msgid ""
+"<literal>name</literal>: The fully qualified class name of the subclass."
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>name</literal>: O nome de classe completamente qualificada da "
+"subclasse.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>name</literal>: O nome da classe completamente qualificada da "
+"subclasse.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>name</literal>: O nome da subclasse completamente qualificada."
-#: index.docbook:2028
-msgid "<literal>discriminator-value</literal> (optional - defaults to the class name): A value that distiguishes individual subclasses."
+#. 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> (opcional – valor default o nome da "
+"classe): Um valor que distingue subclasses individuais."
-#: 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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>proxy</literal> (opcional): Especifica a classe ou interface que "
+"usará os proxies de inicialização atrasada.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>proxy</literal> (opcional): Especifica a classe ou interface para "
+"usar os proxies de recuperação atrasada.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>proxy</literal> (optional): Specifies a class or interface to use "
+"for lazy initializing proxies. <literal>proxy</literal> (opcional): "
+"Especifica a classe ou interface para usar os proxies de recuperação "
+"atrasada."
-#: 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."
+#. 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> (opcional, valor default <literal>true</literal>): "
+"Configurar <literal>lazy=\"false\"</literal> desabilitará o uso de "
+"inicialização atrasada.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>lazy</literal> (opcional, valor default <literal>true</literal>): "
+"Fixanr <literal>lazy=\"false\"</literal> desabilita o uso recuperação "
+"atrasada.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<literal>lazy</literal> (optional, defaults to <literal>true</literal>): "
+"Setting <literal>lazy=\"false\"</literal> disables the use of lazy fetching. "
+"<literal>lazy</literal> (opcional, valor default p<literal>true</literal>): "
+"Fixando <literal>lazy=\"false\"</literal> desabilita o uso da recuperação "
+"atrasada."
-#: index.docbook:2048
-msgid "Each subclass should declare its own persistent properties and subclasses. <literal><version></literal> and <literal><id></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."
+#. Tag: para
+#: basic_mapping.xml:2048
+#, no-c-format
+msgid ""
+"Each subclass should declare its own persistent properties and subclasses. "
+"<literal><version></literal> and <literal><id></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 ""
+"Cada subclasse deve declarar suas próprias propriedades persistentes e "
+"subclasses. As propriedades <literal><version></literal> e "
+"<literal><id></literal> são configuradas para serem herdades da classe "
+"raiz. Cada subclasse numa hierarquia deve definir um único "
+"<literal>discriminator-value</literal>. Se nenhum for especificado, o nome "
+"da classe Java completamente qualificada será usada."
-#: index.docbook:2056, index.docbook:2114, index.docbook:2172
-msgid "For information about inheritance mappings, see <xref linkend=\"inheritance\"/>."
+#. Tag: para
+#: basic_mapping.xml:2056 basic_mapping.xml:2114 basic_mapping.xml:2172
+#, fuzzy, no-c-format
+msgid ""
+"For information about inheritance mappings, see <xref linkend=\"inheritance"
+"\"/>."
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"Para informações sobre mapeamento de heranças, veja o <xref linkend="
+"\"inheritance\"/>.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"Para informações de mapeamentos de herança, veja <xref linkend=\"inheritance"
+"\"/>.\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"Para informações sobre mapeamentos de herança, veja <xref linkend="
+"\"inheritance\"/>."
-#: index.docbook:2063
+#. Tag: title
+#: basic_mapping.xml:2063
+#, no-c-format
msgid "joined-subclass"
-msgstr ""
+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><joined-subclass></literal> element."
+#. 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><joined-subclass></"
+"literal> element."
msgstr ""
+"Alternativamente, cada subclasse pode ser mapeada para sua própria tabela "
+"(Estratégia de mapeamento table-per-subclass). O estado herdado é devolvido "
+"por associação com a tabela da superclasse. Nós usamos o elemento "
+"<literal><joined-subclass></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>]]>"
+"<![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 ""
+msgstr "<literal>table</literal>: O nome da tabela da subclasse."
-#: 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><key></literal> element. The mapping at the start of the chapter would be re-written as:"
+#. 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><key></literal> element. The mapping at the start of the "
+"chapter would be re-written as:"
msgstr ""
+"A coluna discriminator requerida para esta estratégia de mapeamento. Porém, "
+"cada subclasse deve declarar uma coluna de tabela com o identificador do "
+"objeto usando o elemento <literal><key></literal>. O mapeamento no "
+"início do capítulo poderia ser re-escrito assim:"
-#: 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 ""
-#: index.docbook:2121
+#. Tag: title
+#: basic_mapping.xml:2121
+#, no-c-format
msgid "union-subclass"
-msgstr ""
+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><class></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><union-subclass></literal> mapping."
+#. 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><class></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><union-subclass></literal> "
+"mapping."
msgstr ""
+"Uma terceira opção é mapear para tabelas apenas as classes concretas de uma "
+"hierarquia de heranças, (a estratégia table-per-concrete-class) onde cada "
+"tabela define todos os estados persistentes da classe, incluindo estados "
+"herdados. No Hibernate, não é absolutamente necessário mapear explicitamente "
+"como hierarquia de heranças. Você pode simplesmente mapear cada classe com "
+"uma declaração <literal><class></literal> separada. Porém, se você "
+"deseja usar associações polimórficas (por exemplo: uma associação para a "
+"superclasse de sua hierarquia), você precisa usar o mapeamento <literal><"
+"union-subclass></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>]]>"
+"<![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."
+#. Tag: para
+#: basic_mapping.xml:2168
+#, no-c-format
+msgid ""
+"No discriminator column or key column is required for this mapping strategy."
msgstr ""
+"A coluna discriminatõria não é requerida para esta estratégia de mapeamento."
-#: index.docbook:2179
+#. Tag: title
+#: basic_mapping.xml:2179
+#, no-c-format
msgid "join"
-msgstr ""
+msgstr "join"
-#: index.docbook:2181
-msgid "Using the <literal><join></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."
+#. Tag: para
+#: basic_mapping.xml:2181
+#, no-c-format
+msgid ""
+"Using the <literal><join></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 ""
+"Usando o elemento <literal><join></literal>>, é possível mapear "
+"propriedades de uma classe para várias tabelas."
-#: 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>]]>"
+"<![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 ""
+msgstr "<literal>table</literal>: O nome da tabela associada."
-#: 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><join></literal> defined by a class or its superclasses and an outer join for a <literal><join></literal> defined by a subclass. If set to <literal>select</literal> then Hibernate will use a sequential select for a <literal><join></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><join></literal> defined by the class and its superclasses."
+#. 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><join></literal> defined by a class or its "
+"superclasses and an outer join for a <literal><join></literal> defined "
+"by a subclass. If set to <literal>select</literal> then Hibernate will use a "
+"sequential select for a <literal><join></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><join></literal> defined by the class and its superclasses."
msgstr ""
+"<literal>fetch</literal>(opcional – valor default <literal>join</literal>): "
+"Se setado para <literal>join</literal>, o padrão, o Hibernate irá usar um "
+"inner join para restaurar um <literal>join</literal> definido por uma classe "
+"ou suas subclasses e uma outer join para um <literal>join</literal> definido "
+"por uma subclasse. Se setado para <literal>select</literal>, então o "
+"Hibernate irá usar uma seleção seqüencial para um <literal><join></"
+"literal> definida numa subclasse, que irá ser emitido apenas se uma linha se "
+"concentrar para representar uma instância da subclasse. Inner joins irá "
+"ainda ser usado para restaurar um <literal><join></literal> definido "
+"pela classe e suas superclasses."
-#: 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: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> (opcional – valor default <literal>false</"
+"literal>): Se habilitado, o Hibernate não irá tentar inserir ou atualizar as "
+"propriedades definidas por este join."
-#: 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."
+#. 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 ""
+"<literal>optional</literal> (opcional – valor default <literal>false</"
+"literal>): Se habilitado, o Hibernate irá inserir uma linha apenas se as "
+"propriedades definidas por esta junção não forem nulas e irá sempre usar uma "
+"outer join para recuperar as propriedades."
-#: 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):"
+#. 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 ""
+"Por exemplo, a informação de endereço para uma pessoa pode ser mapeada para "
+"uma tabela separada (enquanto preservando o valor da semântica de tipos para "
+"todas as propriedades):"
-#: index.docbook:2250
+#. 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"
- " ...]]>"
+"<![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: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."
+#. Tag: para
+#: basic_mapping.xml:2252
+#, no-c-format
+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 ""
+"Esta característica é útil apenas para modelos de dados legados, nós "
+"recomendamos menos tabelas do que classes e um modelo de domínio bem "
+"granulado. Porém, é útil para ficar trocando entre estratégias de mapeamento "
+"de herança numa hierarquia simples, como explicado mais a frente."
-#: index.docbook:2262
+#. Tag: title
+#: basic_mapping.xml:2262
+#, no-c-format
msgid "<title>key</title>"
msgstr ""
-#: index.docbook:2264
-msgid "We've seen the <literal><key></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><key></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 ""
+"Nós vimos que o elemento <literal><key></literal> surgiu algumas vezes "
+"até agora. Ele aparece em qualquer lugar que o elemento pai define uma "
+"junção para a nova tabela, e define a chave estrangeira para a tabela "
+"associada, que referencia a chave primária da tabela original."
-#: 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 ""
-#: 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."
+#. 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> (opcional, valor default <literal>noaction</"
+"literal>): Especifica se a constraint da chave estrangeira no banco de dados "
+"esta habilitada para cascade delete ."
-#: 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.)"
+#. 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> (opcional): Especifica que a chave "
+"estrangeira se refere a colunas que não são chave primária da tabela "
+"original. (Util para base de dados legadas.)"
-#: 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)."
+#. 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> (opcional): Especifica que a coluna da chave "
+"estrangeira não aceita valores nulos (isto é implícito em qualquer momento "
+"que a chave estrangeira também fizer parte da chave primária)."
-#: 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)."
+#. 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> (optional): Specifies that the foreign key should "
+"never be updated (this is implied whenever the foreign key is also part of "
+"the primary key). <literal>update</literal> (opcional): Especifica que a "
+"chave estrangeira nunca deve ser atualizada (isto é implícito em qualquer "
+"momento que a chave estrangeira também fizer parte da chave primária)."
-#: 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)."
+#. 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> (opcional): Especifica que a chave estrangeira "
+"deve ter uma constraint unique (sto é implícito em qualquer momento que a "
+"chave estrangeira também fizer parte da chave primária)."
-#: 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."
+#. 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 ""
+"Nós recomendamos que para sistemas que a performance de delete seja "
+"importante, todas as chaves deve ser definida <literal>on-delete=\"cascade"
+"\"</literal>, e o Hibernate irá usar uma constraint a nível de banco de "
+"dados <literal>ON CASCADE DELETE</literal>, ao invés de muitas instruções "
+"<literal>DELETE</literal>. Esteja ciente que esta característica é um atalho "
+"da estratégia usual de optimistic locking do Hibernate para dados "
+"versionados."
-#: 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><key not-null=\"true\"></literal>."
+#. 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><key not-"
+"null=\"true\"></literal>."
msgstr ""
+"Os atributos <literal>not-null</literal> e <literal>update</literal> são "
+"úteis quando estamos mapeamos uma associação unidirecional um para muitos. "
+"Se você mapear uma asociação unidirecional um para muitos para uma chave "
+"estrangeira non-nullable, você <emphasis>deve</emphasis> declarar a coluna "
+"chave usando <literal><key not-null=\"true\"></literal>."
-#: index.docbook:2345
+#. Tag: title
+#: basic_mapping.xml:2345
+#, no-c-format
msgid "column and formula elements"
-msgstr ""
+msgstr "elementos column e formula"
-#: index.docbook:2346
-msgid "Any mapping element which accepts a <literal>column</literal> attribute will alternatively accept a <literal><column></literal> subelement. Likewise, <literal><formula></literal> is an alternative to the <literal>formula</literal> attribute."
+#. 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><column></literal> subelement. "
+"Likewise, <literal><formula></literal> is an alternative to the "
+"<literal>formula</literal> attribute."
msgstr ""
+"Qualquer elemento de mapeamente que aceita um atributo <literal>column</"
+"literal> irá aceitar alternativamente um subelemento <literal><column>"
+"</literal>. Da mesma forma, <literal>formula</literal> é uma alternativa "
+"para o atributo <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\"/>]]>"
+"<![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 ""
-#: 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."
+#. 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 ""
+"O atributo <literal>column</literal> e <literal>formula</literal> podem até "
+"ser combinados dentro da mesma propriedade ou associação mapeando para "
+"expressar, por exemplo, associações exóticas."
-#: 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>]]>"
+"<![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 ""
+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."
+#. 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 ""
+"Suponha que a sua aplicação tem duas classes persistentes com o mesmo nome, "
+"e você não quer especificar o nome qualificado (do pacote) nas queries do "
+"Hibernate. As Classes devem ser \"importadas\" explicitamente, de "
+"preferência contando com <literal>auto-import=\"true\"</literal>. Você pode "
+"até importar classes e interfaces que não estão explicitamente mapeadas."
-#: index.docbook:2376
+#. Tag: programlisting
+#: basic_mapping.xml:2376
+#, no-c-format
msgid "<![CDATA[<import class=\"java.lang.Object\" rename=\"Universe\"/>]]>"
msgstr ""
-#: index.docbook:2383
+#. Tag: programlisting
+#: basic_mapping.xml:2383
+#, no-c-format
msgid ""
- "<![CDATA[<import\n"
- " class=\"ClassName\"\n"
- " rename=\"ShortName\"\n"
- "/>]]>"
+"<![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."
+#. 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>: O nome qualificado (do pacote) de qualquer classe "
+"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."
+#. 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> (opcional – valor default, o nome da classe não "
+"qualificada): Um nome que pode ser usado numa linguagem de consulta."
-#: index.docbook:2402
+#. Tag: title
+#: basic_mapping.xml:2402
+#, no-c-format
msgid "<title>any</title>"
msgstr ""
-#: index.docbook:2404
-msgid "There is one further type of property mapping. The <literal><any></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)."
+#. Tag: para
+#: basic_mapping.xml:2404
+#, no-c-format
+msgid ""
+"There is one further type of property mapping. The <literal><any></"
+"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 ""
+"Existe mais um tipo de propriedade de mapeamento. O elemento de mapeamento "
+"<literal><any></literal> define uma associação polimórfica para "
+"classes de múltiplas tabelas. Este tipo de mapeamento sempre requer mais de "
+"uma coluna. A primeira coluna possui o tipo da entidade associada. A outra "
+"coluna que ficou possui o identificador. É impossível especificar uma "
+"restrição de chave estrangeira para este tipo de associação, assim isto "
+"claramente não é visto como um caminho usual para associações (polimórficas) "
+"de mapeamento. Você deve usar este mapeamento apenas em casos muito "
+"especiais (exemplo: audit logs, dados de sessão do usuário, etc)."
-#: 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."
+#. 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 ""
+"O atributo <literal>meta-type</literal> permite a aplicação especificar um "
+"tipo adaptado que mapeia valores de colunas de banco de dados para classes "
+"persistentes que tem propriedades identificadoras do tipo especificado "
+"através do <literal>id-type</literal>. Você deve especificar o mapeamento de "
+"valores do meta-type para nome de classes."
-#: 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>]]>"
+"<![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>]]>"
+"<![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 ""
+msgstr "<literal>name</literal>: o nome da propriedade."
-#: index.docbook:2440
+#. Tag: para
+#: basic_mapping.xml:2440
+#, no-c-format
msgid "<literal>id-type</literal>: the identifier type."
-msgstr ""
+msgstr "<literal>id-type</literal>: o tipo identificador."
-#: index.docbook:2445
-msgid "<literal>meta-type</literal> (optional - defaults to <literal>string</literal>): Any type that is allowed for a discriminator mapping."
+#. 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> (opcional – valor default <literal>string</"
+"literal>): Qualquer tipo que é permitido para um mapeamento discriminador."
-#: index.docbook:2451
-msgid "<literal>cascade</literal> (optional- defaults to <literal>none</literal>): the cascade style."
+#. 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> (opcional – valor default <literal>none</"
+"literal>): o estilo do cascade."
-#: 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."
+#. 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> (opcional - valor default<literal>true</"
+"literal>): Especifica que as atualizações para esta propriedade requerem ou "
+"não aquisição da trava otimista. Em outras palavras, define se uma versão de "
+"incremento deve ocorrer se esta propriedade está modificada."
-#: index.docbook:2478
+#. Tag: title
+#: basic_mapping.xml:2478
+#, no-c-format
msgid "Hibernate Types"
-msgstr ""
+msgstr "Tipos do Hibernate"
-#: index.docbook:2481
+#. Tag: title
+#: basic_mapping.xml:2481
+#, no-c-format
msgid "Entities and values"
-msgstr ""
+msgstr "Entidades e valores"
-#: 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:"
+#. 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 ""
+"Para entender o comportamento de vários objetos em nível de linguagem de "
+"Java a respeito do serviço de persistência, nós precisamos classificá-los em "
+"dois grupos."
-#: 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."
+#. 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 ""
+"Uma <emphasis>entidade </emphasis> existe independentemente de qualquer "
+"outro objeto guardando referências para a entidade. Em contraste com o "
+"modelo usual de Java que um objeto não referenciado é coletado pelo garbage "
+"collector. Entidades devem ser explicitamente salvas ou deletada (exceto em "
+"operações de salvamento ou deleção que possam ser executada em "
+"<emphasis>cascata</emphasis> de uma entidade pai para seus filhos). Isto é "
+"diferente do modelo ODMG de persistência do objeto por acessibilidade – e "
+"corresponde quase a como objetos de aplicações são geralmente usados em "
+"grandes sistemas. Entidades suportam referências circulares e comuns. Eles "
+"podem ser versionadas."
-#: 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."
+#. 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 ""
+"Uma entidade em estado persistente consiste de referências para outras "
+"entidades e instâncias de tipos de <emphasis>valor</emphasis>. Valores são "
+"primitivos, coleções (não o que tem dentro de uma coleção), componentes e "
+"certos objetos imutáveis. Entidades distintas, valores (em coleções e "
+"componentes particulares) <emphasis>são </emphasis> persistidos e apagados "
+"por acessibilidade. Visto que objetos value (e primitivos) são persistidos e "
+"apagados junto com as entidades que os contém e não podem ser versionados "
+"independentemente. Valores têm identidade não independente, assim eles não "
+"podem ser comuns para duas entidades ou coleções."
-#: 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."
+#. 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 ""
+"Até agora, nós estivemos usando o termo \"classe persistente\" para referir "
+"a entidades. Nós iremos continuar a fazer isto. Falando a rigor, porém, nem "
+"todas as classes definidas pelo usuário com estados persistentes são "
+"entidades. Um <emphasis>componente</emphasis> é uma classe de usuário "
+"definida com valores semânticos. Uma propriedade de Java de tipo "
+"<literal>java.lang.String</literal> também tem um valor semêntico. Dada esta "
+"definição, nós podemos dizer que todos os tipos (classes) fornecida pelo JDK "
+"tem tipo de valor semântico em Java, enquanto que tipos definidos pelo "
+"usuário pode ser mapeados com entidade ou valor de tipo semântico. Esta "
+"decisão pertence ao desenvolvedor da aplicação. Uma boa dica para uma classe "
+"entidade em um modelo de domínio são referências comuns para uma instância "
+"simples daquela classe, enquanto a composição ou agregação geralmente se "
+"traduz para um valor de tipo."
-#: index.docbook:2524
+#. Tag: para
+#: basic_mapping.xml:2524
+#, no-c-format
msgid "We'll revisit both concepts throughout the documentation."
-msgstr ""
+msgstr "Nós iremos rever ambos os conceitos durante toda a documentação."
-#: 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><class></literal>, <literal><subclass></literal> and so on. For value types we use <literal><property></literal>, <literal><component></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."
+#. 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><class></literal>, <literal><subclass></literal> and so "
+"on. For value types we use <literal><property></literal>, <literal><"
+"component></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 ""
+"O desafio pe mapear o sistema de tipo de Java (e a definição do "
+"desenvolvedor de entidades e tipos de valor) para o sistema de tipo SQL/"
+"banco de dados. A ponte entre ambos os sistemas é fornecido pelo Hibernate: "
+"para entidades que usam <literal><class></literal>, <literal><"
+"subclass></literal> e assim por diante. Para tipos de valores nós usamos "
+"<literal><property></literal>, <literal><component></literal>, "
+"etc, geralmente com um atributo <literal>type</literal>. O valor deste "
+"atributo é o nome de um <emphasis>tipo de mapeamento</emphasis> do "
+"Hibernate. O Hibernate fornece muitos mapeamentos (para tipos de valores do "
+"JDK padrão) ut of the box. Você pode escrever os seus próprios tipos de "
+"mapeamentos e implementar sua estratégia de conversão adaptada, como você "
+"verá adiante."
-#: index.docbook:2541
+#. Tag: para
+#: basic_mapping.xml:2541
+#, no-c-format
msgid "All built-in Hibernate types except collections support null semantics."
msgstr ""
+"Todos os tipos internos do hibernate exceto coleções suportam semânticas "
+"nulas."
-#: index.docbook:2548
+#. Tag: title
+#: basic_mapping.xml:2548
+#, no-c-format
msgid "Basic value types"
-msgstr ""
+msgstr "Valores de tipos básicos"
-#: index.docbook:2550
-msgid "The built-in <emphasis>basic mapping types</emphasis> may be roughly categorized into"
+#. 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 ""
+"O tipos internos de mapeamentos básicos podem ser a grosso modo categorizado "
+"como: <placeholder-1/>"
-#: index.docbook:2555
-msgid "integer, long, short, float, double, character, byte, boolean, yes_no, true_false"
+#. 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>."
+#. 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 ""
+"Tipos de mapeamentos de classes primitivas ou wrapper Java especificos "
+"(vendor-specific) para tipos de coluna SQL. Boolean, <literal>boolean, "
+"yes_no</literal> são todas codificações alternativas para um "
+"<literal>boolean</literal> ou <literal>java.lang.Boolean</literal> do Java."
-#: index.docbook:2567
+#. Tag: literal
+#: basic_mapping.xml:2567
+#, no-c-format
msgid "string"
-msgstr ""
+msgstr "string"
-#: index.docbook:2569
-msgid "A type mapping from <literal>java.lang.String</literal> to <literal>VARCHAR</literal> (or Oracle <literal>VARCHAR2</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 ""
+"Um tipo de mapeamento de <literal>java.lang.String</literal> para "
+"<literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle)."
-#: index.docbook:2576
+#. Tag: literal
+#: basic_mapping.xml:2576
+#, no-c-format
msgid "date, time, timestamp"
-msgstr ""
+msgstr "date, time, timestamp"
-#: 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)."
+#. 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 ""
+"Tipos de mapeamento de <literal>java.util.Date</literal> e suas subclasses "
+"para os tipos SQL <literal>DATE</literal>, <literal>TIME</literal> e "
+"<literal>TIMESTAMP</literal> (ou equivalente)."
-#: index.docbook:2586
+#. Tag: literal
+#: basic_mapping.xml:2586
+#, no-c-format
msgid "calendar, calendar_date"
-msgstr ""
+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)."
+#. 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 ""
+"Tipo de mapeamento de <literal>java.util.Calendar</literal> para os tipos "
+"SQL <literal>TIMESTAMP</literal> e <literal>DATE</literal> (ou equivalente)."
-#: index.docbook:2596
+#. Tag: literal
+#: basic_mapping.xml:2596
+#, no-c-format
msgid "big_decimal, big_integer"
-msgstr ""
+msgstr "big_decimal, big_integer"
-#: 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>)."
+#. 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 ""
+"Tipo de mapeamento de <literal>java.math.BigDecimal</literal> and "
+"<literal>java.math.BigInteger</literal> para <literal>NUMERIC</literal> (ou "
+"<literal>NUMBER</literal> no Oracle)."
-#: index.docbook:2606
+#. Tag: literal
+#: basic_mapping.xml:2606
+#, no-c-format
msgid "locale, timezone, currency"
-msgstr ""
+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 ""
+"Tipos de mapeamentos de <literal>java.util.Locale</literal>, <literal>java."
+"util.TimeZone</literal> e <literal>java.util.Currency</literal> para "
+"<literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). "
+"Instâncias de f <literal>Locale</literal> e <literal>Currency</literal> são "
+"mapeados para seus códigos ISO. Instâncias de <literal>TimeZone</literal> "
+"são mapeados para seu <literal>ID</literal>."
-#: index.docbook:2620
+#. Tag: literal
+#: basic_mapping.xml:2620
+#, fuzzy, no-c-format
msgid "<literal>class</literal>"
-msgstr ""
+msgstr "<literal>all</literal> cverifica todas as colunas"
-#: 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."
+#. 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 ""
+"um tipo de mapeamento de <literal>java.lang.Class</literal> para "
+"<literal>VARCHAR</literal> (ou <literal>VARCHAR2</literal> no Oracle). Uma "
+"<literal>Class</literal> é mapeada pelo seu nome qualificado (completo)."
-#: index.docbook:2630
+#. Tag: literal
+#: basic_mapping.xml:2630
+#, no-c-format
msgid "binary"
-msgstr ""
+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 "Mapeia arrays de bytes para um tipo binário de SQL apropriado."
-#: index.docbook:2638
+#. Tag: literal
+#: basic_mapping.xml:2638
+#, no-c-format
msgid "text"
-msgstr ""
+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 ""
+"Maps long Java strings to a SQL <literal>CLOB</literal> or <literal>TEXT</"
+"literal> type. Mapeia strings longas de Java para um tipo SQL <literal>CLOB</"
+"literal> ou <literal>TEXT</literal>."
-#: index.docbook:2647
+#. Tag: literal
+#: basic_mapping.xml:2647
+#, no-c-format
msgid "serializable"
-msgstr ""
+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."
+#. 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 ""
+"Mapeia tipos Java serializáveis para um tipo binário SQL apropriado. Você "
+"pode também indicar o tipo <literal>serializable</literal> do Hibernate com "
+"o nome da classe ou interface Java serializável que não é padrão para um "
+"tipo básico."
-#: index.docbook:2658
+#. Tag: literal
+#: basic_mapping.xml:2658
+#, no-c-format
msgid "clob, blob"
-msgstr ""
+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 ""
+"Tipos de mapeamentos para as classes JDBC <literal>java.sql.Clob</literal> "
+"and <literal>java.sql.Blob</literal>. Estes tipos podem ser inconveniente "
+"para algumas aplicações, visto que o objeto blob ou clob pode não ser "
+"reusado fora de uma transação. (Além disso, o suporte de driver é imcompleto "
+"e inconsistente.)"
-#: index.docbook:2670
-msgid "imm_date, imm_time, imm_timestamp, imm_calendar, imm_calendar_date, imm_serializable, imm_binary"
+#. 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."
+#. 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 ""
+"Mapeando tipos para o que geralmente são consideradas tipos mutáveis de "
+"Java, onde o Hibernate faz determinadas otimizações apropriadas somente para "
+"tipos imutáveis de Java, e a aplicação trata o objeto como imutável. Por "
+"exemplo, você não deve chamar <literal>Date.setTime()</literal> para uma "
+"instância mapeada como <literal>imm_timestamp</literal>. Para mudar o valor "
+"da propriedade, e ter a mudança feita persistente, a aplicação deve atribuir "
+"um novo objeto (nonidentical) à propriedade."
-#: 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.)"
+#. 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 ""
+"Identificadores únicos das entidades e coleções podem ser de qualquer tipo "
+"básico exceto <literal>binary</literal>, <literal>blob</literal> ou "
+"<literal>clob</literal>. (Identificadores compostos também são permitidos, "
+"veja abaixo.)"
-#: 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."
+#. 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 ""
+"Os tipos de valores básicos têm suas constantes <literal>Type</literal> "
+"correspondentes definidas em <literal>org.hibernate.Hibernate</literal>. Por "
+"exemplo, <literal>Hibernate.STRING</literal> representa o tipo "
+"<literal>string</literal>."
-#: index.docbook:2704
+#. Tag: title
+#: basic_mapping.xml:2704
+#, no-c-format
msgid "Custom value types"
-msgstr ""
+msgstr "Tipos de valores personalizados"
-#: 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>."
+#. 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 ""
+"É relativamente fácil para desenvolvedores criar seus próprios tipos de "
+"valor. Por exemplo, você pode querer persistir propriedades do tipo "
+"<literal>java.lang.BigInteger</literal> para colunas <literal>VARCHAR</"
+"literal>. O Hibernate não fornece um tipo correspondente para isso. Mas os "
+"tipos adaptados não são limitados a mapeamento de uma propriedade (ou "
+"elemento de coleção) a uma única coluna da tabela. Assim, por exemplo, você "
+"pôde ter uma propriedade Java <literal>getName()</literal>/<literal>setName()"
+"</literal> do tipo <literal>java.lang.String</literal> que é persistido para "
+"colunas <literal>FIRST_NAME</literal>, <literal>INITIAL</literal>, "
+"<literal>SURNAME</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."
+#. 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 ""
+"Para implementar um tipo personalizado, implemente <literal>org.hibernate."
+"UserType</literal> or <literal>org.hibernate.CompositeUserType</literal> e "
+"declare propriedades usando o nome qualificado da classe do tipo. Veja "
+"<literal>org.hibernate.test.DoubleStringType</literal> para ver o tipo das "
+"coisas que são possíveis."
-#: index.docbook:2725
+#. 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>]]>"
+"<![CDATA[<property name=\"twoStrings\" type=\"org.hibernate.test."
+"DoubleStringType\">\n"
+" <column name=\"first_string\"/>\n"
+" <column name=\"second_string\"/>\n"
+"</property>]]>"
msgstr ""
-#: index.docbook:2727
-msgid "Notice the use of <literal><column></literal> tags to map a property to multiple columns."
+#. Tag: para
+#: basic_mapping.xml:2727
+#, no-c-format
+msgid ""
+"Notice the use of <literal><column></literal> tags to map a property "
+"to multiple columns."
msgstr ""
+"Observe o uso da tag <literal><column></literal> para mapear uma "
+"propriedade para colunas múltiplas."
-#: 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: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 ""
+"As interfaces <literal>CompositeUserType</literal>, "
+"<literal>EnhancedUserType</literal>, <literal>UserCollectionType</literal>, "
+"e <literal>UserVersionType</literal> fornecem suporte para usos mais "
+"especializados."
-#: 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><type></literal> element in your mapping files."
+#. 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><"
+"type></literal> element in your mapping files."
msgstr ""
+"Você pode mesmo fornecer parâmetros a um <literal>UserType</literal> no "
+"arquivo de mapeamento. Para isto, seu <literal>UserType</literal> deve "
+"implementar a interface <literal>org.hibernate.usertype.ParameterizedType</"
+"literal>. Para fornecer parâmetros a seu tipo personalizado, você pode usar "
+"o elemento <literal><type></literal> em seus arquivos de mapeamento."
-#: index.docbook:2746
+#. 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>]]>"
+"<![CDATA[<property name=\"priority\">\n"
+" <type name=\"com.mycompany.usertypes.DefaultValueIntegerType\">\n"
+" <param name=\"default\">0</param>\n"
+" </type>\n"
+"</property>]]>"
msgstr ""
-#: 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."
+#. Tag: para
+#: basic_mapping.xml:2748
+#, no-c-format
+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 ""
+"O <literal>UserType</literal> pode agora recuperar o valor para o parâmetro "
+"chamado <literal>default</literal> da <literal>Propriedade</literal> do "
+"passado a ele."
-#: 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><typedef></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."
+#. 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><typedef></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 ""
+"Se você usar freqüentemente um determinado <literal>UserType</literal>, pode "
+"ser útil definir um nome mais curto para ele. Você pode fazer isto usando o "
+"elemento <literal><typedef></literal>. Typedefs atribui um nome a um "
+"tipo personalizado, e pode também conter uma lista de valores default de "
+"parâmetro se o tipo for parametrizado."
-#: 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>]]>"
+"<![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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:2785
+#. Tag: title
+#: basic_mapping.xml:2785
+#, no-c-format
msgid "Mapping a class more than once"
-msgstr ""
+msgstr "Mapping a class more than once"
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: index.docbook:2796
-msgid "Notice how associations are now specified using <literal>entity-name</literal> instead of <literal>class</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 ""
+"Notice how associations are now specified using <literal>entity-name</"
+"literal> instead of <literal>class</literal>."
-#: index.docbook:2804
+#. Tag: title
+#: basic_mapping.xml:2804
+#, no-c-format
msgid "SQL quoted identifiers"
-msgstr ""
+msgstr "SQL quoted identifiers"
-#: 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)."
+#. 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 ""
+"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)."
-#: 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 ""
-#: index.docbook:2818
+#. Tag: title
+#: basic_mapping.xml:2818
+#, no-c-format
msgid "Metadata alternatives"
-msgstr ""
+msgstr "Metadata alternatives"
-#: 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 isn't for everyone, and so there are some alternative ways to define O/R "
+"mapping metadata in Hibernate."
-#: index.docbook:2825
+#. Tag: title
+#: basic_mapping.xml:2825
+#, no-c-format
msgid "Using XDoclet markup"
-msgstr ""
+msgstr "Using XDoclet markup"
-#: index.docbook:2827
-msgid "Many Hibernate users prefer to embed mapping information directly in sourcecode using XDoclet <literal>@hibernate.tags</literal>. 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>@hibernate.tags</literal>. 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 ""
+"Many Hibernate users prefer to embed mapping information directly in "
+"sourcecode using XDoclet <literal>@hibernate.tags</literal>. 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."
-#: 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 ""
+msgstr "See the Hibernate web site for more examples of XDoclet and Hibernate."
-#: index.docbook:2843
+#. Tag: title
+#: basic_mapping.xml:2843
+#, no-c-format
msgid "Using JDK 5.0 Annotations"
-msgstr ""
+msgstr "Using JDK 5.0 Annotations"
-#: 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 ""
+"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."
-#: 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 "This is an example of a POJO class annotated as an EJB entity bean:"
-#: 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 ""
+"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."
-#: index.docbook:2871
+#. Tag: title
+#: basic_mapping.xml:2871
+#, no-c-format
msgid "Generated Properties"
-msgstr ""
+msgstr "Generated Properties"
-#: 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 ""
+"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."
-#: 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 ""
+"Properties marked as generated must additionally be non-insertable and non-"
+"updateable. Only <xref linkend=\"mapping-declaration-version\">versions</"
+"xref>, <xref linkend=\"mapping-declaration-timestamp\">timestamps</xref>, "
+"and <xref linkend=\"mapping-declaration-property\">simple properties</xref> "
+"can be marked as generated."
-#: 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> (the default) - means that the given property value "
+"is not generated within the database."
-#: 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> - 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</xref> and <xref "
+"linkend=\"mapping-declaration-timestamp\">timestamp</xref> properties can be "
+"marked as generated, this option is not available there..."
-#: 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> - states that the property value is generated both "
+"on insert and on update."
-#: index.docbook:2907
+#. Tag: title
+#: basic_mapping.xml:2907
+#, no-c-format
msgid "Auxiliary Database Objects"
-msgstr ""
+msgstr "Auxiliary Database Objects"
-#: 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 ""
+"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..."
-#: 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 ""
+"The first mode is to explicitly list the CREATE and DROP commands out in the "
+"mapping file:"
-#: 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 ""
+"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."
-#: 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 ""
+"Additionally, these database objects can be optionally scoped such that they "
+"only apply when certain dialects are used."
-#: 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/pt-BR/content/batch.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/batch.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/batch.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,281 +1,650 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Processamento de lotes"
-#: index.docbook:7
-msgid "A naive approach to inserting 100 000 rows in the database using Hibernate might look like this:"
+#. 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 ""
+"Uma alternativa para inserir 100.000 linhas no banco de dados usando o "
+"Hibernate pode ser a seguinte:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Isto irá falhar em algum lugar próximo a linha 50.000, lançando uma "
+"<literal>OutOfMemoryException</literal>. Isso ocorre devido ao fato do "
+"Hibernate fazer cache de todas as instâncias de <literal>Customer</literal> "
+"inseridas num cachê em nível de sessão."
-#: 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):"
+#. 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 ""
+"Neste capítulo veremos como contornar esse problema. Entretanto, se você vai "
+"realizar processamento de lotes, é muito importante que você habilite o uso "
+"de lotes JDBC, se você pretende obter um desempenho razoável. Defina o "
+"tamanho do lote JDBC em um valor razoável (algo entre 10-50):"
-#: index.docbook:27
+#. Tag: programlisting
+#: batch.xml:27
+#, no-c-format
msgid "<![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."
+#. 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 ""
+"Você também pode querer rodar esse tipo de processamento de lotes com o "
+"cache secundário completamente desabilitado:"
-#: 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:"
+#. 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 ""
+"Note that Hibernate disables insert batching at the JDBC level transparently "
+"if you use an <literal>identiy</literal> identifier generator."
-#: index.docbook:39
+#. Tag: programlisting
+#: batch.xml:39
+#, no-c-format
msgid "<![CDATA[hibernate.cache.use_second_level_cache false]]>"
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."
+#. 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 ""
+"Mas isto não é absolutamente necessário, desde que nós possamos ajustar o "
+"<literal>CacheMode</literal> para desabilitar a interação com o cache "
+"secundário."
-#: index.docbook:47
+#. Tag: title
+#: batch.xml:47
+#, no-c-format
msgid "Batch inserts"
-msgstr ""
+msgstr "Inserção de lotes"
-#: 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 ""
+"Quando você estiver inserindo novos objetos persistentes, vocês deve "
+"executar os métodos <literal>flush()</literal> e <literal>clear()</literal> "
+"regularmente na sessão, para controlar o tamanho do cache primário."
-#: 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();]]>"
+"<![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 ""
+msgstr "Batch updates"
-#: 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 ""
+"Para recuperar e atualizar informações a mesma idéia é válida. "
+"Adicionalmente, pode precisar usar o <literal>scroll()</literal> para usar "
+"recursos no lado do servidor em queries que retornam muita informação."
-#: 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();]]>"
+"<![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 ""
+msgstr "A interface 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 ""
+"Alternativamente, o Hibernate provê uma API orientada à comandos, usada para "
+"transmitir um fluxo de dados de e para o banco de dados na forma de objetos "
+"soltos. Uma <literal>StatelessSession</literal> não tem um contexto "
+"persistente associado e não fornece muito das semânticas de alto nível para "
+"controle do ciclo de vida. Em especial, uma StatelessSession não implemente "
+"o cache primário e nem interage com o cache secundário ou query cache. Ele "
+"não implementa salvamento transacional automatico ou checagem automática de "
+"mudanças. Operação realizadas usando uma StatelessSession não fazem nenhum "
+"tipo de cascade com as instancias associadas. As coleções são ignoradas por "
+"uma StatelessSession. Operações realizadas com um StatelessSession ignoram a "
+"arquitetura de eventos e os interceptadores. StatelessSession são "
+"vulneráveis aos efeitos do aliasing dos dados, devido a falta do cache "
+"primário. Uma StatelessSession é uma abstração de baixo nível, muito mais "
+"próxima do 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();]]>"
+"<![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."
+#. 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 ""
+"Veja neste exempo, as instancias de <literal>Customer</literal> retornadas "
+"pela query são imediatamente desvinculadas. Elas nunca serão assossiadas à "
+"um contexto persistente."
-#: 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."
+#. 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 ""
+"As operações <literal>insert(), update()</literal> e <literal>delete()</"
+"literal> definidos pela interface <literal>StatelessSession</literal> são "
+"considerados operações diretas no banco de dados (row-level operations), "
+"isso resulta em uma execução imediata de comandos SQL <literal>INSERT, "
+"UPDATE</literal> ou <literal>DELETE</literal> respectivamente. Devido a "
+"isso, eles possuem uma semântica bem diferente das operações <literal>save"
+"(), saveOrUpdate()</literal> ou <literal>delete()</literal> definidas na "
+"interface <literal>Session</literal>."
-#: index.docbook:110
+#. Tag: title
+#: batch.xml:110
+#, no-c-format
msgid "DML-style operations"
-msgstr ""
+msgstr "Operações no estilo 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)."
+#. 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 ""
+"Como já discutido, mapeamento objeto/relacional automático e transparente é "
+"conseguido com a gerência do estado do objeto. Com isto o estado daquele "
+"objeto fica disponível na memória, manipulando(usando as expressões SQL "
+"<literal>Data Manipulation Language</literal> (SQL-style DML): "
+"<literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</"
+"literal>) os dados diretamente no banco de dados não irá afetar o estado "
+"registrado em memória. Entretanto, o Hibernate provê métodos para executar "
+"queries SQL-style DML, que são totalmente executas com HQL (Hibernate Query "
+"Language) (<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:"
+#. 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 ""
+"A pseudo-sintaxe para expressões <literal>UPDATE</literal> e "
+"<literal>DELETE</literal> é: <literal>( UPDATE | DELETE ) FROM? NomeEntidade "
+"(WHERE condições_where)?</literal>. Algumas observações:"
-#: index.docbook:130
+#. Tag: para
+#: batch.xml:130
+#, no-c-format
msgid "In the from-clause, the FROM keyword is optional"
-msgstr ""
+msgstr "Na clausula from, a palavra chave FROM é opcional;"
-#: 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."
+#. 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 ""
+"Somente uma entidade pode ser chamada na clausula from; opcionalmente pode "
+"ter um alias. Se o nome da entidade for possuir um alias, então qualquer "
+"propriedade referenciada deve usar esse alias qualificado; se o nome da "
+"entidade não possuir um alias, então nenhuma das propriedade precisa usar o "
+"acesso qualificado."
-#: 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."
+#. 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 ""
+"Na <xref linkend=\"queryhql-joins-forms\">joins</xref> (ambas implícita ou "
+"explicita) pode ser especificada em um bulk HQL query. Sub-queries podem ser "
+"usadas na clausula where; as subqueries podem conter joins."
-#: index.docbook:150
+#. Tag: para
+#: batch.xml:150
+#, no-c-format
msgid "The where-clause is also optional."
-msgstr ""
+msgstr "A clausula where também é opcional."
-#: 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 ""
+"Como exemplo para executar um HQL <literal>UPDATE</literal>, use o método "
+"<literal>Query.executeUpdate()</literal>(o método ganhou o nome devido a sua "
+"familiaridade com o do JDBC <literal>PreparedStatement.executeUpdate()</"
+"literal>):"
-#: 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();]]>"
+"<![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 ""
+"HQL <literal>UPDATE</literal> statements, by default do not effect the <xref "
+"linkend=\"mapping-declaration-version\">version</xref> or the <xref linkend="
+"\"mapping-declaration-timestamp\">timestamp</xref> 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."
-#: 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();]]>"
+"<![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."
+#. 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 ""
+"Note that custom version types (<literal>org.hibernate.usertype."
+"UserVersionType</literal>) are not allowed in conjunction with a "
+"<literal>update versioned</literal> statement."
-#: 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 ""
+"Para executar um HQL <literal>DELETE</literal>, use o mesmo método "
+"<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();]]>"
+"<![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."
+#. 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 ""
+"O valor <literal>int</literal> retornado pelo método <literal>Query."
+"executeUpdate()</literal> indica o numero de entidade afetadas pela "
+"operação. Lembre-se que isso pode estar ou não relacionado ao número de "
+"linhas alteradas no banco de dados. Uma operação bulk HQL pode resultar em "
+"várias expressões SQL reais a serem executadas, por exemplo, no caso de "
+"joined-subclass. O número retornado indica a quantidade real de entidades "
+"afetadas pela expressão. Voltando ao exemplo da joined-subclass, a exclusão "
+"de uma das subclasses pode resultar numa exclusão em outra tabelas, não "
+"apenas na tabela para qual a subclasses está mapeada, mas também tabela "
+"\"root\" e possivelmente nas tabelas joined-subclass num nível hierárquico "
+"imediatamente abaixo."
-#: 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:"
+#. 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 ""
+"A pseudo-sintaxe para o comando <literal>INSERT</literal> é: <literal>INSERT "
+"INTO EntityName properties_list select_statement</literal>. Alguns pontos a "
+"observar:"
-#: index.docbook:207
-msgid "Only the INSERT INTO ... SELECT ... form is supported; not the INSERT INTO ... VALUES ... form."
+#. Tag: para
+#: batch.xml:207
+#, no-c-format
+msgid ""
+"Only the INSERT INTO ... SELECT ... form is supported; not the INSERT "
+"INTO ... VALUES ... form."
msgstr ""
+"Apenas a forma INSERT INTO ... SELECT ... é suportada; INSERT INTO ... "
+"VALUES ... não é suportada."
-#: 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."
+#. 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 ""
+"A lista de propriedade é análoga à <literal>especificação da coluna</"
+"literal> do comando SQL <literal>INSERT</literal>. Para entidades envolvidas "
+"em mapeamentos, apenas a propriedades definidas diretamente a nível da "
+"classe podem ser usandas na properties_list. Propriedades da superclass não "
+"são permitidas; e as propriedades da subclasse não faz sentido. Em outras "
+"palavras, os comandos <literal>INSERT</literal> não são polimorficos."
-#: 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."
+#. 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 ""
+"O camando select pode ser qualquer query HQL válida, que tenha um retorno "
+"compatível com o tipo com o esperado pela inclusão. Atualmente, isto é "
+"verificado durante a compilação da query, isto é melhor do que permitir que "
+"a verificação chegue ao banco de dados. Entretanto perceba que isso pode "
+"causar problemas entre os <literal>Tipo</literal> do Hibernate que são "
+"<emphasis>equivalentes</emphasis> em oposição a <emphasis>equal</emphasis>. "
+"Isso pode causar problemas nas combinações entre a propriedade definida como "
+"<literal>org.hibernate.type.DateType</literal>e um propriedade definida como "
+"<literal>org.hibernate.type.TimestampType</literal>, embora o banco de dados "
+"não possa fazer uma distinção ou possa ser capaz de manusear a conversão."
-#: 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."
+#. 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 ""
+"Para a propriedade id, a expressão insert oferece duas opções. Você pode "
+"especificar qualquer propriedade id explicitamente no properties_list (em "
+"alguns casos esse valor é obtido diretamente da expressão select) ou pode "
+"omitir do properties_list (nesse caso, um valor gerado é usado). Essa ultima "
+"opção só é válida quando são usados geradores de ids que operam no banco de "
+"dados; a tentativa de usar essa opção com geradores do tipo \"em memória\" "
+"vai causar um exceção durante a etapa de parser. Veja a finalidades desta "
+"discussão, os seguintes geradores operam com o banco de dados <literal>org."
+"hibernate.id.SequenceGenerator</literal> (e suas subclasses) e qualquer "
+"implementação de <literal>org.hibernate.id.PostInsertIdentifierGenerator</"
+"literal>. Aqui, a exceção mais notável é o <literal>org.hibernate.id."
+"TableHiLoGenerator</literal>, que não pode ser usado porque ele não dispõe "
+"de mecanismos para recuperar o seu valor."
-#: 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)."
+#. 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 ""
+"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). "
+"Para propriedades mapeadas como <literal>version</literal> ou "
+"<literal>timestamp</literal>, a expressão insert oferece a você duas opções. "
+"Você pode especificar a propriedade na properties_list (nesse caso o seu "
+"valor é obtido a partir da expressão select correspondente) ou ele pode ser "
+"omitido da properties_list (neste caso o usa o <literal>valor semente</"
+"literal> definido pela classe <literal>org.hibernate.type.VersionType</"
+"literal>)."
-#: index.docbook:257
+#. Tag: para
+#: batch.xml:257
+#, no-c-format
msgid "An example HQL <literal>INSERT</literal> statement execution:"
-msgstr ""
+msgstr "Exemplo da execução de um 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/pt-BR/content/best_practices.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/best_practices.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/best_practices.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,168 +1,454 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Boas práticas"
-#: index.docbook:9
-msgid "Write fine-grained classes and map them using <literal><component></literal>."
+#. Tag: term
+#: best_practices.xml:9
+#, no-c-format
+msgid ""
+"Write fine-grained classes and map them using <literal><component></"
+"literal>."
msgstr ""
+"Escreva classes compactas e mapeie-as usando <literal><component></"
+"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."
+#. 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 ""
+"Use uma classe <literal>Endereco</literal> para encapsular <literal>rua</"
+"literal>, <literal>bairro</literal>, <literal>estado</literal>, "
+"<literal>CEP</literal>. Isto promove a reutilização de código e simplifica o "
+"refactoring."
-#: index.docbook:19
+#. Tag: term
+#: best_practices.xml:19
+#, no-c-format
msgid "Declare identifier properties on persistent classes."
-msgstr ""
+msgstr "Declare propriedades identificadoras em classes persistentes."
-#: 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)."
+#. 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 ""
+"O Hibernate constrói propriedades identificadoras opcionais. Existem todos "
+"os tipos de razões que explicam porquê você deveria utilizá-las. Nós "
+"recomendamos que os identificadores sejam 'sintéticos' (gerados, sem "
+"significado para o negocio)."
-#: index.docbook:29
+#. Tag: term
+#: best_practices.xml:29
+#, no-c-format
msgid "Identify natural keys."
-msgstr ""
+msgstr "Identifique chaves naturais."
-#: index.docbook:31
-msgid "Identify natural keys for all entities, and map them using <literal><natural-id></literal>. Implement <literal>equals()</literal> and <literal>hashCode()</literal> to compare the properties that make up the natural key."
+#. Tag: para
+#: best_practices.xml:31
+#, no-c-format
+msgid ""
+"Identify natural keys for all entities, and map them using <literal><"
+"natural-id></literal>. Implement <literal>equals()</literal> and "
+"<literal>hashCode()</literal> to compare the properties that make up the "
+"natural key."
msgstr ""
+"Identifique chaves naturais para todas as entidades, e mapeie-as usando "
+"<literal><natural-id></literal>. Implemente <literal>equals()</"
+"literal> e <literal>hashCode()</literal> para comparar as propriedades que "
+"compõem a chave natural."
-#: index.docbook:39
+#. Tag: term
+#: best_practices.xml:39
+#, no-c-format
msgid "Place each class mapping in its own file."
-msgstr ""
+msgstr "Coloque cada classe de mapeamento em seu próprio arquivo."
-#: 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."
+#. 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 ""
+"Não use um único código de mapeamento monolítico. Mapeie <literal>com.eg."
+"Foo</literal> no arquivo <literal>com/eg/Foo.hbm.xml</literal>. Isto promove "
+"particularmente o bom senso no time de desenvolvimento."
-#: index.docbook:49
+#. Tag: term
+#: best_practices.xml:49
+#, no-c-format
msgid "Load mappings as resources."
-msgstr ""
+msgstr "Carregue os mapeamentos como recursos."
-#: index.docbook:51
+#. Tag: para
+#: best_practices.xml:51
+#, no-c-format
msgid "Deploy the mappings along with the classes they map."
-msgstr ""
+msgstr "Faça o deploy dos mapeamentos junto com as classes que eles mapeiam."
-#: index.docbook:57
+#. Tag: term
+#: best_practices.xml:57
+#, no-c-format
msgid "Consider externalising query strings."
-msgstr ""
+msgstr "Considere externalizar as strings de consultas."
-#: 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."
+#. 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 ""
+"Esta é uma boa prática se suas consultas chamam funções SQL que não sejam "
+"ANSI. Externalizar as strings de consultas para mapear arquivos irão tornar "
+"a aplicação mais portável."
-#: index.docbook:67
+#. Tag: term
+#: best_practices.xml:67
+#, no-c-format
msgid "Use bind variables."
-msgstr ""
+msgstr "Use bind variables."
-#: 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."
+#. 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 ""
+"Assim como em JDBC, sempre substitua valores não constantes por \"?\". Nunca "
+"use a manipulação de strings para concatenar valores não constantes em uma "
+"consulta! Até melhor, considere usar parâmetros nomeados nas consultas."
-#: index.docbook:77
+#. Tag: term
+#: best_practices.xml:77
+#, no-c-format
msgid "Don't manage your own JDBC connections."
-msgstr ""
+msgstr "Não gerencie suas conexões 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>."
+#. 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 ""
+"O Hibernate permite que a aplicação gerencie conexões JDBC. Esta abordagem "
+"deve ser considerada um último recurso. Se você não pode usar os provedores "
+"de conexão embutidos, considere fazer sua implementação a partir de "
+"<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 ""
+msgstr "Considere usar tipos customizados."
-#: 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."
+#. 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 ""
+"Suponha que você tenha um tipo Java, de alguma biblioteca, que precisa ser "
+"persistido mas não provê os acessórios necessários para mapeá-lo como um "
+"componente. Você deve implementar <literal>org.hibernate.UserType</literal>. "
+"Esta abordagem livra o código da aplicação de implementar transformações de/"
+"para o tipo Hibernate."
-#: index.docbook:98
+#. Tag: term
+#: best_practices.xml:98
+#, no-c-format
msgid "Use hand-coded JDBC in bottlenecks."
-msgstr ""
+msgstr "Use código manual JDBC nos gargalos."
-#: 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."
+#. 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 ""
+"Nas áreas de desempenho crítico do sistema, alguns tipos de operações podem "
+"se beneficiar do uso direto do JDBC. Mas por favor, espere até você "
+"<emphasis>saber </emphasis> se é um gargalo. E não suponha que o uso direto "
+"do JDBC é necessariamente mais rápido. Se você precisar usar diretamente o "
+"JDBC, vale a pena abrir uma <literal>Session</literal> do Hibernate e usar "
+"uma conexão JDBC. De modo que você possa ainda usar a mesma estratégia de "
+"transação e ocultar o provedor a conexão"
-#: index.docbook:110
+#. Tag: term
+#: best_practices.xml:110
+#, no-c-format
msgid "Understand <literal>Session</literal> flushing."
-msgstr ""
+msgstr "Entenda o <literal>Session</literal> flushing."
-#: 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."
+#. 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 ""
+"De tempos em tempos a sessão sincroniza seu estado persistente com o banco "
+"de dados. O desempenho será afetado se este processo ocorrer frequentemente. "
+"Você pode algumas vezes minimizar o fluxo desnecessário desabilitando o "
+"fluxo automático ou até mesmo mudando a ordem das consultas e outras "
+"operações em uma transação particular."
-#: index.docbook:121
+#. Tag: term
+#: best_practices.xml:121
+#, no-c-format
msgid "In a three tiered architecture, consider using detached objects."
msgstr ""
+"Em uma arquitetura de três camadas, considere o uso de objetos separados."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:132
+#. Tag: term
+#: best_practices.xml:132
+#, no-c-format
msgid "In a two tiered architecture, consider using long persistence contexts."
msgstr ""
+"In a two tiered architecture, consider using long persistence contexts."
-#: 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."
+#. 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 ""
+"Database Transactions have to be as short as possible for best scalability. "
+"However, it is often necessary 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."
-#: index.docbook:148
+#. Tag: term
+#: best_practices.xml:148
+#, no-c-format
msgid "Don't treat exceptions as recoverable."
-msgstr ""
+msgstr "Don't treat exceptions as recoverable."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:160
+#. Tag: term
+#: best_practices.xml:160
+#, no-c-format
msgid "Prefer lazy fetching for associations."
-msgstr ""
+msgstr "Prefer lazy fetching for associations."
-#: 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>."
+#. 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 ""
+"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>."
-#: 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."
+#. 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 ""
+"Use the <emphasis>open session in view</emphasis> pattern, or a disciplined "
+"<emphasis>assembly phase</emphasis> to avoid problems with unfetched data."
-#: 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."
+#. 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 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."
-#: index.docbook:191
+#. Tag: term
+#: best_practices.xml:191
+#, no-c-format
msgid "Consider abstracting your business logic from Hibernate."
-msgstr ""
+msgstr "Consider abstracting your business logic from 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!)"
+#. 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 ""
+"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!)"
-#: index.docbook:203
+#. Tag: term
+#: best_practices.xml:203
+#, no-c-format
msgid "Don't use exotic association mappings."
-msgstr ""
+msgstr "Don't use exotic association mappings."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:215
+#. Tag: term
+#: best_practices.xml:215
+#, no-c-format
msgid "Prefer bidirectional associations."
-msgstr ""
+msgstr "Prefer bidirectional associations."
-#: 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."
+#. 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"Unidirectional associations are more difficult to query. In a large "
+"application, almost all associations must be navigable in both directions in "
+"queries."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/collection_mapping.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,919 +1,1915 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Mapeamento de Coleções"
-#: index.docbook:8
+#. Tag: title
+#: collection_mapping.xml:8
+#, no-c-format
msgid "Persistent collections"
-msgstr ""
+msgstr "Persistent collections"
-#: index.docbook:10
-msgid "Hibernate requires that persistent collection-valued fields be declared as an interface type, for example:"
+#. 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 ""
+"Hibernate requires that persistent collection-valued fields be declared as "
+"an interface type, for example:"
-#: 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 ""
-#: 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>.)"
+#. 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 ""
+"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>.)"
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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)."
+#. 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 ""
+"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)."
-#: index.docbook:65
+#. Tag: title
+#: collection_mapping.xml:65
+#, no-c-format
msgid "Collection mappings"
-msgstr ""
+msgstr "Collection mappings"
-#: index.docbook:67
-msgid "The Hibernate mapping element used for mapping a collection depends upon the type of the interface. For example, a <literal><set></literal> element is used for mapping properties of type <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><set></literal> element "
+"is used for mapping properties of type <literal>Set</literal>."
msgstr ""
+"The Hibernate mapping element used for mapping a collection depends upon the "
+"type of the interface. For example, a <literal><set></literal> element "
+"is used for mapping properties of type <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 ""
-#: index.docbook:75
-msgid "Apart from <literal><set></literal>, there is also <literal><list></literal>, <literal><map></literal>, <literal><bag></literal>, <literal><array></literal> and <literal><primitive-array></literal> mapping elements. The <literal><map></literal> element is representative:"
+#. Tag: para
+#: collection_mapping.xml:75
+#, no-c-format
+msgid ""
+"Apart from <literal><set></literal>, there is also <literal><"
+"list></literal>, <literal><map></literal>, <literal><bag></"
+"literal>, <literal><array></literal> and <literal><primitive-"
+"array></literal> mapping elements. The <literal><map></literal> "
+"element is representative:"
msgstr ""
+"Apart from <literal><set></literal>, there is also <literal><"
+"list></literal>, <literal><map></literal>, <literal><bag></"
+"literal>, <literal><array></literal> and <literal><primitive-"
+"array></literal> mapping elements. The <literal><map></literal> "
+"element is representative:"
-#: 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 ""
-#: index.docbook:103
+#. Tag: para
+#: collection_mapping.xml:103
+#, no-c-format
msgid "<literal>name</literal> the collection property name"
-msgstr ""
+msgstr "<literal>name</literal> the collection property name"
-#: 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)"
+#. 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> (optional - defaults to property name) the name of "
+"the collection table (not used for one-to-many associations)"
-#: index.docbook:114
-msgid "<literal>schema</literal> (optional) the name of a table schema to override the schema declared on the root element"
+#. 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> (optional) the name of a table schema to override "
+"the schema declared on the root element"
-#: 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)"
+#. 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> (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)"
-#: index.docbook:129
-msgid "<literal>inverse</literal> (optional - defaults to <literal>false</literal>) mark this collection as the \"inverse\" end of a bidirectional association"
+#. 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> (optional - defaults to <literal>false</literal>) "
+"mark this collection as the \"inverse\" end of a bidirectional association"
-#: index.docbook:135
-msgid "<literal>cascade</literal> (optional - defaults to <literal>none</literal>) enable operations to cascade to child entities"
+#. 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> (optional - defaults to <literal>none</literal>) "
+"enable operations to cascade to child entities"
-#: index.docbook:141
-msgid "<literal>sort</literal> (optional) specify a sorted collection with <literal>natural</literal> sort order, or a given comparator class"
+#. 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> (optional) specify a sorted collection with "
+"<literal>natural</literal> sort order, or a given comparator class"
-#: 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>"
+#. 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> (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>"
-#: 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)"
+#. 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> (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)"
-#: 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."
+#. 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> (optional, defaults to <literal>select</literal>) "
+"Choose between outer-join fetching, fetching by sequential select, and "
+"fetching by sequential subselect."
-#: 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."
+#. 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> (optional, defaults to <literal>1</literal>) "
+"specify a \"batch size\" for lazily fetching instances of this collection."
-#: index.docbook:174
-msgid "<literal>access</literal> (optional - defaults to <literal>property</literal>): The strategy Hibernate should use for accessing the collection property value."
+#. 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> (optional - defaults to <literal>property</"
+"literal>): The strategy Hibernate should use for accessing the collection "
+"property value."
-#: 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.)"
+#. 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> (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.)"
-#: 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)."
+#. 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> (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)."
-#: index.docbook:198
+#. Tag: title
+#: collection_mapping.xml:198
+#, no-c-format
msgid "Collection foreign keys"
-msgstr ""
+msgstr "Collection foreign keys"
-#: 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><key></literal> element."
+#. 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><key></"
+"literal> element."
msgstr ""
+"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><key></"
+"literal> element."
-#: 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>."
+#. 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 ""
+"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>."
-#: index.docbook:215
+#. Tag: programlisting
+#: collection_mapping.xml:215
+#, no-c-format
msgid "<![CDATA[<key column=\"productSerialNumber\" not-null=\"true\"/>]]>"
msgstr ""
-#: index.docbook:217
-msgid "The foreign key constraint may use <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 ""
+"The foreign key constraint may use <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 ""
-#: index.docbook:223
-msgid "See the previous chapter for a full definition of the <literal><key></literal> element."
+#. Tag: para
+#: collection_mapping.xml:223
+#, no-c-format
+msgid ""
+"See the previous chapter for a full definition of the <literal><key></"
+"literal> element."
msgstr ""
+"See the previous chapter for a full definition of the <literal><key></"
+"literal> element."
-#: index.docbook:231
+#. Tag: title
+#: collection_mapping.xml:231
+#, no-c-format
msgid "Collection elements"
-msgstr ""
+msgstr "Collection elements"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:242
-msgid "The contained type is referred to as the <emphasis>collection element type</emphasis>. Collection elements are mapped by <literal><element></literal> or <literal><composite-element></literal>, or in the case of entity references, with <literal><one-to-many></literal> or <literal><many-to-many></literal>. The first two map elements with value semantics, the next two are used to map entity associations."
+#. 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><element></"
+"literal> or <literal><composite-element></literal>, or in the case of "
+"entity references, with <literal><one-to-many></literal> or "
+"<literal><many-to-many></literal>. The first two map elements with "
+"value semantics, the next two are used to map entity associations."
msgstr ""
+"The contained type is referred to as the <emphasis>collection element type</"
+"emphasis>. Collection elements are mapped by <literal><element></"
+"literal> or <literal><composite-element></literal>, or in the case of "
+"entity references, with <literal><one-to-many></literal> or "
+"<literal><many-to-many></literal>. The first two map elements with "
+"value semantics, the next two are used to map entity associations."
-#: index.docbook:254
+#. Tag: title
+#: collection_mapping.xml:254
+#, no-c-format
msgid "Indexed collections"
-msgstr ""
+msgstr "Indexed collections"
-#: 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><map-key></literal>, it may be an entity reference mapped with <literal><map-key-many-to-many></literal>, or it may be a composite type, mapped with <literal><composite-map-key></literal>. The index of an array or list is always of type <literal>integer</literal> and is mapped using the <literal><list-index></literal> element. The mapped column contains sequential integers (numbered from zero, by default)."
+#. 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><map-key></literal>, it may be an entity "
+"reference mapped with <literal><map-key-many-to-many></literal>, or it "
+"may be a composite type, mapped with <literal><composite-map-key></"
+"literal>. The index of an array or list is always of type <literal>integer</"
+"literal> and is mapped using the <literal><list-index></literal> "
+"element. The mapped column contains sequential integers (numbered from zero, "
+"by default)."
msgstr ""
+"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><map-key></literal>, it may be an entity "
+"reference mapped with <literal><map-key-many-to-many></literal>, or it "
+"may be a composite type, mapped with <literal><composite-map-key></"
+"literal>. The index of an array or list is always of type <literal>integer</"
+"literal> and is mapped using the <literal><list-index></literal> "
+"element. The mapped column contains sequential integers (numbered from zero, "
+"by default)."
-#: 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 ""
-#: 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><bag></emphasis>. A bag does not retain its order when it is retrieved from the database, but it may be optionally sorted or ordered."
+#. 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><bag></emphasis>. A bag does not retain its "
+"order when it is retrieved from the database, but it may be optionally "
+"sorted or ordered."
msgstr ""
+"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><bag></emphasis>. A bag does not retain its "
+"order when it is retrieved from the database, but it may be optionally "
+"sorted or ordered."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:364
+#. Tag: title
+#: collection_mapping.xml:364
+#, no-c-format
msgid "Collections of values and many-to-many associations"
-msgstr ""
+msgstr "Collections of values and many-to-many associations"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:373
-msgid "For a collection of values, we use the <literal><element></literal> tag."
+#. Tag: para
+#: collection_mapping.xml:373
+#, no-c-format
+msgid ""
+"For a collection of values, we use the <literal><element></literal> "
+"tag."
msgstr ""
+"For a collection of values, we use the <literal><element></literal> "
+"tag."
-#: 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><many-to-many></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><many-to-many></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>"
+"<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><many-to-many></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><many-to-many></"
+"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 ""
-#: index.docbook:480
+#. Tag: para
+#: collection_mapping.xml:480
+#, no-c-format
msgid "Some examples, first, a set of strings:"
-msgstr ""
+msgstr "Some examples, first, a set of strings:"
-#: 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 ""
-#: index.docbook:486
-msgid "A bag containing integers (with an iteration order determined by the <literal>order-by</literal> attribute):"
+#. 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 ""
+"A bag containing integers (with an iteration order determined by the "
+"<literal>order-by</literal> attribute):"
-#: 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 ""
-#: 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 ""
+msgstr "An array of entities - in this case, a many to many association:"
-#: 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 ""
-#: index.docbook:499
+#. Tag: para
+#: collection_mapping.xml:499
+#, no-c-format
msgid "A map from string indices to dates:"
-msgstr ""
+msgstr "A map from string indices to dates:"
-#: 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 ""
-#: index.docbook:505
+#. Tag: para
+#: collection_mapping.xml:505
+#, no-c-format
msgid "A list of components (discussed in the next chapter):"
-msgstr ""
+msgstr "A list of components (discussed in the next chapter):"
-#: 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 ""
-#: index.docbook:514
+#. Tag: title
+#: collection_mapping.xml:514
+#, no-c-format
msgid "One-to-many associations"
-msgstr ""
+msgstr "One-to-many associations"
-#: 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:"
+#. 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 ""
+"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:"
-#: index.docbook:524
-msgid "An instance of the contained entity class may not belong to more than one instance of the collection"
+#. 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 ""
+"An instance of the contained entity class may not belong to more than one "
+"instance of the collection"
-#: index.docbook:530
-msgid "An instance of the contained entity class may not appear at more than one value of the collection index"
+#. 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 ""
+"An instance of the contained entity class may not appear at more than one "
+"value of the collection index"
-#: 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><one-to-many></literal> tag indicates that this is a one to many association."
+#. 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><one-to-many></literal> "
+"tag indicates that this is a one to many association."
msgstr ""
+"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><one-to-many></literal> "
+"tag indicates that this is a one to many association."
-#: 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 ""
-#: index.docbook:553
+#. Tag: para
+#: collection_mapping.xml:553
+#, no-c-format
msgid "<literal>class</literal> (required): The name of the associated class."
-msgstr ""
+msgstr "<literal>class</literal> (required): The name of the associated class."
-#: 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."
+#. 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> (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."
-#: index.docbook:565
-msgid "<literal>entity-name</literal> (optional): The entity name of the associated class, as an alternative to <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> (optional): The entity name of the associated "
+"class, as an alternative to <literal>class</literal>."
-#: index.docbook:573
-msgid "Notice that the <literal><one-to-many></literal> element does not need to declare any columns. Nor is it necessary to specify the <literal>table</literal> name anywhere."
+#. Tag: para
+#: collection_mapping.xml:573
+#, no-c-format
+msgid ""
+"Notice that the <literal><one-to-many></literal> element does not need "
+"to declare any columns. Nor is it necessary to specify the <literal>table</"
+"literal> name anywhere."
msgstr ""
+"Notice that the <literal><one-to-many></literal> element does not need "
+"to declare any columns. Nor is it necessary to specify the <literal>table</"
+"literal> name anywhere."
-#: index.docbook:579
-msgid "<emphasis>Very important note:</emphasis> If the foreign key column of a <literal><one-to-many></literal> association is declared <literal>NOT NULL</literal>, you must declare the <literal><key></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."
+#. Tag: para
+#: collection_mapping.xml:579
+#, no-c-format
+msgid ""
+"<emphasis>Very important note:</emphasis> If the foreign key column of a "
+"<literal><one-to-many></literal> association is declared <literal>NOT "
+"NULL</literal>, you must declare the <literal><key></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>Very important note:</emphasis> If the foreign key column of a "
+"<literal><one-to-many></literal> association is declared <literal>NOT "
+"NULL</literal>, you must declare the <literal><key></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."
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: index.docbook:600
+#. Tag: title
+#: collection_mapping.xml:600
+#, no-c-format
msgid "Advanced collection mappings"
-msgstr ""
+msgstr "Advanced collection mappings"
-#: index.docbook:603
+#. Tag: title
+#: collection_mapping.xml:603
+#, no-c-format
msgid "Sorted collections"
-msgstr ""
+msgstr "Sorted collections"
-#: 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:"
+#. 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 supports collections implementing <literal>java.util.SortedMap</"
+"literal> and <literal>java.util.SortedSet</literal>. You must specify a "
+"comparator in the mapping file:"
-#: 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 ""
-#: 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>."
+#. 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 ""
+"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>."
-#: index.docbook:618
-msgid "Sorted collections actually behave like <literal>java.util.TreeSet</literal> or <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 ""
+"Sorted collections actually behave like <literal>java.util.TreeSet</literal> "
+"or <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."
+#. 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 ""
+"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."
-#: 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 ""
-#: index.docbook:634
-msgid "Note that the value of the <literal>order-by</literal> attribute is an SQL ordering, not a HQL ordering!"
+#. 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 ""
+"Note that the value of the <literal>order-by</literal> attribute is an SQL "
+"ordering, not a HQL ordering!"
-#: index.docbook:639
-msgid "Associations may even be sorted by some arbitrary criteria at runtime using a collection <literal>filter()</literal>."
+#. 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 ""
+"Associations may even be sorted by some arbitrary criteria at runtime using "
+"a collection <literal>filter()</literal>."
-#: index.docbook:644
-msgid "<![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 ""
+msgstr "Bidirectional associations"
-#: index.docbook:651
-msgid "A <emphasis>bidirectional association</emphasis> allows navigation from both \"ends\" of the association. Two kinds of bidirectional association are supported:"
+#. 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 ""
+"A <emphasis>bidirectional association</emphasis> allows navigation from both "
+"\"ends\" of the association. Two kinds of bidirectional association are "
+"supported: <placeholder-1/>"
-#: index.docbook:658
+#. Tag: term
+#: collection_mapping.xml:658
+#, no-c-format
msgid "one-to-many"
-msgstr ""
+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 ""
+msgstr "set or bag valued at one end, single-valued at the other"
-#: index.docbook:666
+#. Tag: term
+#: collection_mapping.xml:666
+#, no-c-format
msgid "many-to-many"
-msgstr ""
+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 ""
+msgstr "set or bag valued at both ends"
-#: 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)."
+#. 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 ""
+"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)."
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: 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:"
+#. 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 ""
+"As mudanças feitas somente de um lado da associação <emphasis>não</emphasis> "
+"são persistidas. Isto significa que o Hibernate tem duas representações na "
+"memória para cada associação bidirecional, uma associação de A para B e uma "
+"outra associação de B para A. Isto é mais fácil de compreender se você pensa "
+"sobre o modelo do objetos do Java e como nós criamos um relacionamento "
+"muitos para muitos em 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 ""
-#: index.docbook:701
-msgid "The non-inverse side is used to save the in-memory representation to the database."
+#. 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 ""
+"A outra ponta é usada salvar a representação em memória à base de dados."
-#: 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>."
+#. 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 ""
+"Você pode definir uma associação bidirecional um para muitos através de uma "
+"associação um-para-muitos indicando as mesmas colunas da tabela que à "
+"associação muitos-para-um e declarando a propriedade <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 ""
-#: 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!"
+#. 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 ""
+"Mapear apenas uma das pontas da associação com <literal>inverse=\"true\"</"
+"literal> não afeta as operações em cascata, isso é um conceito ortogonal."
-#: index.docbook:721
+#. Tag: title
+#: collection_mapping.xml:721
+#, no-c-format
msgid "Bidirectional associations with indexed collections"
-msgstr ""
+msgstr "Associações bidirecionais com coleções indexadas"
-#: index.docbook:722
-msgid "A bidirectional association where one end is represented as a <literal><list></literal> or <literal><map></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:"
+#. Tag: para
+#: collection_mapping.xml:722
+#, no-c-format
+msgid ""
+"A bidirectional association where one end is represented as a <literal><"
+"list></literal> or <literal><map></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 ""
+"Uma associação bidirecional onde uma dos lados e representa pôr uma "
+"<literal><list></literal> ou <literal><map></literal> requer uma "
+"consideração especial. Se houver uma propriedade da classe filha que faça o "
+"mapeamento da coluna do índice, sem problema, pode-se continuar usando "
+"<literal>inverse=\"true\"</literal> no mapeamento da coleção."
-#: 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 ""
-#: 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:"
+#. 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 ""
+"Mas, se não houver nenhuma propriedade na classe filha, não podemos ver essa "
+"associação como verdadeiramente bidirecional (há uma informação disponível "
+"em um lado da associação que não está disponível no extremo oposto). Nesse "
+"caso, nos não podemos mapear a coleção usando <literal>inverse=\"true\"</"
+"literal>. Nos devemos usar o seguinte mapeamento:"
-#: 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 ""
-#: 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?"
+#. 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 ""
+"Veja que neste mapeamento, que um dos lado da associação, a coleção, é "
+"responsável pela atualização da chave estrangeira. TODO: Isso realmente "
+"resulta em updates desnecessários ?."
-#: index.docbook:748
+#. Tag: title
+#: collection_mapping.xml:748
+#, no-c-format
msgid "Ternary associations"
-msgstr ""
+msgstr "Associações Ternárias"
-#: 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:"
+#. 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 ""
+"Há três meios possíveis de se mapear uma associação ternária. Uma é usar um "
+"<literal>Map</literal> com uma associação como seu índice:"
-#: 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 ""
-#: 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 ""
-#: 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."
+#. 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 ""
+"A segunda maneira é simplesmente remodelar a associação das classes da "
+"entidade. Esta é a maneira que nós usamos de uma maneira geral."
-#: index.docbook:764
-msgid "A final alternative is to use composite elements, which we will discuss later."
+#. Tag: para
+#: collection_mapping.xml:764
+#, no-c-format
+msgid ""
+"A final alternative is to use composite elements, which we will discuss "
+"later."
msgstr ""
+"Uma alternativa final é usar os elementos compostos, que nós discutiremos "
+"mais tarde."
-#: index.docbook:771
+#. Tag: literal
+#: collection_mapping.xml:771
+#, no-c-format
msgid "Using an <idbag>"
-msgstr ""
+msgstr "Usando o <idbag>"
-#: 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."
+#. 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 ""
+"Se você concorda com nossa visão que chaves compostas são uma coisa ruim e "
+"que as entidades devem ter identificadores sintéticos (surrogate keys), "
+"então você deve estar achando um pouco estranho que as associações muitos "
+"para muitos usando coleções de valores que nós mostramos estejam mapeadas "
+"com chaves compostas! Bem, este ponto é bastante discutível; um simples "
+"tabela de associação não parece se beneficiar muito de uma surrogate key "
+"(entretanto uma coleção de valores compostos <emphasis>sim</emphasis>). "
+"Opcionalmente, o Hibernate prove uma maneira de mapear uma associação muitos "
+"para muitos com uma coleção de valores para uma tabela com uma surrogate key."
-#: index.docbook:784
-msgid "The <literal><idbag></literal> element lets you map a <literal>List</literal> (or <literal>Collection</literal>) with bag semantics."
+#. Tag: para
+#: collection_mapping.xml:784
+#, no-c-format
+msgid ""
+"The <literal><idbag></literal> element lets you map a <literal>List</"
+"literal> (or <literal>Collection</literal>) with bag semantics."
msgstr ""
+"O elemento <literal><idbag></literal> permite mapear um <literal>List</"
+"literal> (ou uma <literal>Collection</literal> com uma semântica de bag."
-#: 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 ""
-#: index.docbook:791
-msgid "As you can see, an <literal><idbag></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."
+#. Tag: para
+#: collection_mapping.xml:791
+#, no-c-format
+msgid ""
+"As you can see, an <literal><idbag></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 ""
+"Como você pode ver, um <literal><idbag></literal> possui um gerador de "
+"id sintético, igual uma classe de entidade! Uma surrogate key diferente é "
+"associada para cada elemento de coleção. Porém, o Hibernate não prove nenhum "
+"mecanismo para descobrir qual a surrogate key de uma linha em particular."
-#: index.docbook:798
-msgid "Note that the update performance of an <literal><idbag></literal> is <emphasis>much</emphasis> better than a regular <literal><bag></literal>! Hibernate can locate individual rows efficiently and update or delete them individually, just like a list, map or set."
+#. Tag: para
+#: collection_mapping.xml:798
+#, no-c-format
+msgid ""
+"Note that the update performance of an <literal><idbag></literal> is "
+"<emphasis>much</emphasis> better than a regular <literal><bag></"
+"literal>! Hibernate can locate individual rows efficiently and update or "
+"delete them individually, just like a list, map or set."
msgstr ""
+"Note que o desempenho de atualização de um <literal><idbag></literal> "
+"é <emphasis>much</emphasis> melhor que um <literal><bag></literal> "
+"normal! O Hibernate pode localizar uma linha individual eficazmente e "
+"atualizar ou deletar individualmente, como um list, map ou set."
-#: index.docbook:805
-msgid "In the current implementation, the <literal>native</literal> identifier generation strategy is not supported for <literal><idbag></literal> collection identifiers."
+#. 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><idbag></literal> "
+"collection identifiers."
msgstr ""
+"Na implementação atual, a estratégia de geração de identificador "
+"<literal>native</literal> não é suportada para identificadores de coleção "
+"usando o <literal><idbag></literal>."
-#: index.docbook:829
+#. Tag: title
+#: collection_mapping.xml:829
+#, no-c-format
msgid "Collection examples"
-msgstr ""
+msgstr "Exemplos de coleções"
-#: 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 ""
+"As seções anteriores são uma grande confusão. Assim sendo vejamos uma "
+"exemplo. Essa classe:"
-#: 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 ""
-#: 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:"
+#. 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 ""
+"tem uma coleção de instancias de <literal>Child</literal>. Se cada Child "
+"tiver no máximo um parent, o mapeamento natural é uma associação um para "
+"muitos:"
-#: 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 ""
-#: index.docbook:846
+#. Tag: para
+#: collection_mapping.xml:846
+#, no-c-format
msgid "This maps to the following table definitions:"
-msgstr ""
+msgstr "Esse mapeamento gera a seguinte definição de tabelas"
-#: 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 ""
-#: index.docbook:852
-msgid "If the parent is <emphasis>required</emphasis>, use a bidirectional one-to-many association:"
+#. 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 ""
+"Se o parent for <emphasis>obrigatório</emphasis>, use uma associação "
+"bidirecional um para muitos:"
-#: 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 ""
-#: index.docbook:859
+#. Tag: para
+#: collection_mapping.xml:859
+#, no-c-format
msgid "Notice the <literal>NOT NULL</literal> constraint:"
-msgstr ""
+msgstr "Repare na constraint <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 ""
-#: 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><key></literal> mapping:"
+#. 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><key></literal> mapping:"
msgstr ""
+"Uma outra alternativa, no caso de você insistir que esta associação devea "
+"ser unidirecional, você pode declarar a constraint como <literal>NOT NULL</"
+"literal> na tag <literal><key></literal> do mapeamento:"
-#: 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 ""
-#: 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 ""
+"Por outro lado, se uma child puder ter os múltiplos parents, a associação "
+"apropriada é muitos-para-muitos:"
-#: 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 ""
-#: index.docbook:880
+#. Tag: para
+#: collection_mapping.xml:880
+#, no-c-format
msgid "Table definitions:"
-msgstr ""
+msgstr "Definições das tabelas:"
-#: 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 ""
-#: index.docbook:886
-msgid "For more examples and a complete walk-through a parent/child relationship mapping, see <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 ""
+"For more examples and a complete walk-through a parent/child relationship "
+"mapping, see <xref linkend=\"example-parentchild\"/>. Para mais exemplos e "
+"um exemplo completo de mapeamento de relacionamento de mestre/detalhe, veja "
+"<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 ""
+"Até mesmo o mapeamento de associações mais exóticas são possíveis, nós "
+"catalogaremos todas as possibilidades no próximo capítulo."
-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> (required): The name of the column holding "
+#~ "the collection index values."
-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> (optional, defaults to <literal>0</literal>): The "
+#~ "value of the index column that corresponds to the first element of the "
+#~ "list or array."
+#~ msgid ""
+#~ "<literal>column</literal> (optional): The name of the column holding the "
+#~ "collection index values."
+#~ msgstr ""
+#~ "<literal>column</literal> (optional): The name of the column holding the "
+#~ "collection index values."
+
+#~ msgid ""
+#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the "
+#~ "key of the map."
+#~ msgstr ""
+#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the "
+#~ "key of the map."
+
+#~ msgid "<literal>type</literal> (reguired): The type of the map keys."
+#~ msgstr "<literal>type</literal> (reguired): The type of the map keys."
+
+#~ msgid ""
+#~ "<literal>column</literal> (optional): The name of the foreign key column "
+#~ "for the collection index values."
+#~ msgstr ""
+#~ "<literal>column</literal> (optional): The name of the foreign key column "
+#~ "for the collection index values."
+
+#~ msgid ""
+#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the "
+#~ "foreign key of the map key."
+#~ msgstr ""
+#~ "<literal>formula</literal> (optional): A SQL formula used to evaluate the "
+#~ "foreign key of the map key."
+
+#~ msgid ""
+#~ "<literal>class</literal> (required): The entity class used as the map key."
+#~ msgstr ""
+#~ "<literal>class</literal> (required): The entity class used as the map key."
+
+#~ msgid ""
+#~ "<literal>column</literal> (optional): The name of the column holding the "
+#~ "collection element values."
+#~ msgstr ""
+#~ "<literal>column</literal> (optional): The name of the column holding the "
+#~ "collection element values."
+
+#~ msgid ""
+#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate "
+#~ "the element."
+#~ msgstr ""
+#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate "
+#~ "the element."
+
+#~ msgid ""
+#~ "<literal>type</literal> (required): The type of the collection element."
+#~ msgstr ""
+#~ "<literal>type</literal> (required): The type of the collection element."
+
+#~ msgid ""
+#~ "A <emphasis>many-to-many association</emphasis> is specified using the "
+#~ "<literal><many-to-many></literal> element."
+#~ msgstr ""
+#~ "A <emphasis>many-to-many association</emphasis> is specified using the "
+#~ "<literal><many-to-many></literal> element."
+
+#~ msgid ""
+#~ "<literal>column</literal> (optional): The name of the element foreign key "
+#~ "column."
+#~ msgstr ""
+#~ "<literal>column</literal> (optional): The name of the element foreign key "
+#~ "column."
+
+#~ msgid ""
+#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate "
+#~ "the element foreign key value."
+#~ msgstr ""
+#~ "<literal>formula</literal> (optional): An SQL formula used to evaluate "
+#~ "the element foreign key value."
+
+#~ 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><many-to-many></literal> nested element."
+#~ msgstr ""
+#~ "<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><many-to-many></literal> nested element."
+
+#~ 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> (optional): Enable the DDL generation of a "
+#~ "unique constraint for the foreign-key column. This makes the association "
+#~ "multiplicity effectively one to many."
+
+#~ 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> (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."
+
+#~ 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>: (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."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/component_mapping.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,372 +1,685 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Mapeamento de Componentes"
-#: index.docbook:7
-msgid "The notion of a <emphasis>component</emphasis> is re-used in several different contexts, for different purposes, throughout 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 ""
+"A noção de <emphasis>componente</emphasis> é reusada em vários contextos "
+"diferentes, para propósitos diferentes, pelo Hibernate."
-#: index.docbook:13
+#. Tag: title
+#: component_mapping.xml:13
+#, no-c-format
msgid "Dependent objects"
-msgstr ""
+msgstr "Objetos dependentes"
-#: 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:"
+#. 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 ""
+"Um componente é um objeto contido que é persistido como um tipo de valor, "
+"não uma referência de entidade. O termo \"componente\" refere-se à noção de "
+"composição da orientação a objetos (não a componentes no nível de "
+"arquitetura). Por exemplo, você pode modelar uma pessoa desta maneira:"
-#: 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 ""
-#: 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 ""
-#: 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."
+#. 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 ""
+"Agora <literal>Name</literal> pode ser persistido como um componente de "
+"<literal>Person</literal>. Note que <literal>Name</literal> define métodos "
+"getter e setter para suas propriedades persistentes, mas não necessita "
+"declarar nenhuma interface ou propriedades identificadoras."
-#: index.docbook:32
+#. Tag: para
+#: component_mapping.xml:32
+#, no-c-format
msgid "Our Hibernate mapping would look like:"
-msgstr ""
+msgstr "Nosso mapeamento do Hibernate seria semelhante a isso"
-#: 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 ""
-#: 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>."
+#. 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 ""
+"A tabela pessoa teria as seguintes colunas <literal>pid</literal>, "
+"<literal>birthday</literal>, <literal>initial</literal>, <literal>first</"
+"literal> and <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."
+#. 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 ""
+"Assim como todos tipos por valor, componentes não suportam referencias "
+"cruzadas. Em outras palavras, duas pessoas poderiam possuir o mesmo nome, "
+"mas os dois objetos pessoa poderiam conter dois objetos nome independentes, "
+"apenas com \"o mesmo\" por valor. A semântica dos valores null de um "
+"componente são <emphasis>ad hoc</emphasis>. No recarregameno do conteúdo do "
+"objeto, O Hibernate assumira que se todas as colunas do componente são null, "
+"então todo o componente é null. Isto seria o certo para a maioria dos "
+"propósitos."
-#: 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."
+#. 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 ""
+"As propriedades de um componente podem ser de qualquer tipo do Hibernate"
+"(collections, associações muitos-para-um, outros componentes, etc). "
+"Componentes agrupados <emphasis>não </emphasis> devem ser consideros um uso "
+"exótico. O Hibernate tem a intenção de suportar um modelo de objetos muito "
+"bem granulado."
-#: index.docbook:62
-msgid "The <literal><component></literal> element allows a <literal><parent></literal> subelement that maps a property of the component class as a reference back to the containing entity."
+#. Tag: para
+#: component_mapping.xml:62
+#, no-c-format
+msgid ""
+"The <literal><component></literal> element allows a <literal><"
+"parent></literal> subelement that maps a property of the component class "
+"as a reference back to the containing entity."
msgstr ""
+"O elemento <literal><component></literal> permite um subelemento "
+"<literal><parent></literal> que mapeia uma propriedade da classe "
+"componente como uma referência de volta para a entidade que a contém."
-#: 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 ""
-#: index.docbook:73
+#. Tag: title
+#: component_mapping.xml:73
+#, no-c-format
msgid "Collections of dependent objects"
-msgstr ""
+msgstr "Collections de objetos dependentes"
-#: 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><element></literal> tag with a <literal><composite-element></literal> tag."
+#. 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><"
+"element></literal> tag with a <literal><composite-element></"
+"literal> tag."
msgstr ""
+"Collections de componentes são suportadadas(ex. uma array de tipo "
+"<literal>Name</literal>). Declare a sua collection de componentes "
+"substituindo a tag<literal><element></literal> pela tag <literal><"
+"composite-element></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 ""
-#: 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."
+#. 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 ""
+"Nota: se você definir um <literal>Set</literal> de elementos compostos, é "
+"muito importante implementar <literal>equals()</literal> e <literal>hashCode"
+"()</literal> corretamente."
-#: index.docbook:90
-msgid "Composite elements may contain components but not collections. If your composite element itself contains components, use the <literal><nested-composite-element></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."
+#. 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><nested-"
+"composite-element></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 ""
+"Elementos compostos podem conter componentes mas não collections. Se o seu "
+"elemento composto contiver componentes , use a tag <literal><nested-"
+"composite-element></literal> . Este é um caso bastante exótico – uma "
+"collections de componentes que por si própria possui componentes. Neste "
+"momento você deve estar se perguntando se uma associação de um-para-muitos "
+"seria mais apropriada. Tente remodelar o elemento composto como uma entidade "
+"– mas note que mesmo pensando que o modelo Java é o mesmo, o modelo "
+"relacional e a semântica de persistência ainda são diferentes."
-#: index.docbook:102
-msgid "Please note that a composite element mapping doesn't support null-able properties if you're using a <literal><set></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><list></literal>, <literal><map></literal>, <literal><bag></literal> or <literal><idbag></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><set></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><list></"
+"literal>, <literal><map></literal>, <literal><bag></literal> or "
+"<literal><idbag></literal>."
msgstr ""
+"Por favor, note que um mapeamento de elemento composto não suporta "
+"propriedades capazes de serem null se você estiver usando um <literal><"
+"set></literal>. O Hibernate tem que usar cada valor das colunas para "
+"identificar um registro quando estiver deletando objetos (não existe coluna "
+"chave primária separada na tabela de elemento composto), que não é possível "
+"com valores null. Você tem que usar um dos dois, ou apenas propriedades não "
+"null em um elemento composto ou escolher uma <literal><list></"
+"literal>, <literal><map></literal>, <literal><bag></literal> ou "
+"<literal><idbag></literal>."
-#: index.docbook:113
-msgid "A special case of a composite element is a composite element with a nested <literal><many-to-one></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:"
+#. 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><many-to-one></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 ""
+"Um caso especial de elemento composto é um elemento composto com um elemento "
+"<literal><many-to-one></literal> aninhado. Um mapeamento como este "
+"permite você a mapear colunas extras de uma tabela de associação de muitos-"
+"para-muitos para a classe de elemento composto. A seguinte associação de "
+"muitos-para-muitos de <literal>Order</literal> para um <literal>Item</"
+"literal> onde <literal>purchaseDate</literal>, <literal>price</literal> e "
+"<literal>quantity</literal> são propriedades da associação:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Claro, que não pode ter uma referência para purchase no outro lado, para a "
+"navegação da associação bidirecional. Lembre-se que componentes são tipos "
+"por valor e não permitem referências compartilhadas. Uma classe "
+"<literal>Purchase</literal> simples pode estar no set de uma classe "
+"<literal>Order</literal>, mas ela não pode ser referenciada por "
+"<literal>Item</literal> no mesmo momento."
-#: index.docbook:133
+#. Tag: para
+#: component_mapping.xml:133
+#, no-c-format
msgid "Even ternary (or quaternary, etc) associations are possible:"
-msgstr ""
+msgstr "Até mesmo associações ternárias (ou quaternária, etc) são possíveis:"
-#: 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 ""
-#: index.docbook:137
-msgid "Composite elements may appear in queries using the same syntax as associations to other entities."
+#. 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 ""
+"Elementos compostos podem aparecer em pesquisas usando a mesma sintaxe assim "
+"como associações para outras entidades."
-#: index.docbook:145
+#. Tag: title
+#: component_mapping.xml:145
+#, no-c-format
msgid "Components as Map indices"
-msgstr ""
+msgstr "Componentes como índices de Map"
-#: index.docbook:147
-msgid "The <literal><composite-map-key></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."
+#. Tag: para
+#: component_mapping.xml:147
+#, no-c-format
+msgid ""
+"The <literal><composite-map-key></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 ""
+"O elemento <literal><composite-map-key></literal> permite você mapear "
+"uma classe componente como uma chave de um <literal>Map</literal>. Tenha "
+"certeza que você sobrescreveu <literal>hashCode()</literal> e <literal>equals"
+"()</literal> corretamente na classe componente."
-#: index.docbook:156
+#. Tag: title
+#: component_mapping.xml:156
+#, no-c-format
msgid "Components as composite identifiers"
-msgstr ""
+msgstr ". Componentes como identificadores compostos"
-#: index.docbook:158
-msgid "You may use a component as an identifier of an entity class. Your component class must satisfy certain requirements:"
+#. 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 ""
+"Você pode usar um componente como um identificador de uma classe entidade. "
+"Sua classe componente deve satisfazer certos requisitos:"
-#: index.docbook:165
+#. Tag: para
+#: component_mapping.xml:165
+#, no-c-format
msgid "It must implement <literal>java.io.Serializable</literal>."
-msgstr ""
+msgstr "Ele deve implementar <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."
+#. 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 ""
+"Ele deve re-implementar <literal>equals()</literal> e <literal>hashCode()</"
+"literal>, consistentemente com a noção de igualdade de chave composta do "
+"banco de dados."
-#: index.docbook:179
-msgid "Note: in Hibernate3, the second requirement is not an absolutely hard requirement of Hibernate. But do it anyway."
+#. 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 ""
+"Nota: no Hibernate 3, o segundo requisito não é um requisito absolutamente "
+"necessário. Mas atenda ele de qualquer forma."
-#: index.docbook:183
-msgid "You can't use an <literal>IdentifierGenerator</literal> to generate composite keys. Instead the application must assign its own identifiers."
+#. 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 ""
+"Você não pode usar um <literal>IdentifierGenerator</literal> para gerar "
+"chaves compostas. Ao invés disso o aplicativo deve gerenciar seus próprios "
+"identificadores."
-#: index.docbook:188
-msgid "Use the <literal><composite-id></literal> tag (with nested <literal><key-property></literal> elements) in place of the usual <literal><id></literal> declaration. For example, the <literal>OrderLine</literal> class has a primary key that depends upon the (composite) primary key of <literal>Order</literal>."
+#. Tag: para
+#: component_mapping.xml:188
+#, no-c-format
+msgid ""
+"Use the <literal><composite-id></literal> tag (with nested "
+"<literal><key-property></literal> elements) in place of the usual "
+"<literal><id></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 ""
+"Use a tag <literal><composite-id></literal> (com elementos "
+"<literal><key-property></literal> aninhados) no lugar da declaração "
+"<literal><id></literal> de costume. Por exemplo, a classe "
+"<literal>OrderLine</literal> possui uma chave primária que depende da chave "
+"primária (composta) de <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 ""
-#: 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:"
+#. 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 ""
+"Agora, qualquer chave estrangeira referenciando a tabela <literal>OrderLine</"
+"literal> também serão compostas. Você deve declarar isto em seus mapeamentos "
+"para outras classes. Uma associação para <literal>OrderLine</literal> seria "
+"mapeada dessa forma:"
-#: 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 ""
-#: index.docbook:206
-msgid "(Note that the <literal><column></literal> tag is an alternative to the <literal>column</literal> attribute everywhere.)"
+#. Tag: para
+#: component_mapping.xml:206
+#, no-c-format
+msgid ""
+"(Note that the <literal><column></literal> tag is an alternative to "
+"the <literal>column</literal> attribute everywhere.)"
msgstr ""
+"(Note que a tag <literal><column></literal> é uma alternativa para o "
+"atributo <literal>column</literal> por toda a parte.)"
-#: index.docbook:211
-msgid "A <literal>many-to-many</literal> association to <literal>OrderLine</literal> also uses the composite foreign key:"
+#. 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 ""
+"Uma associação <literal>many-to-many</literal> para <literal>many-to-many</"
+"literal> também usa a chave estrangeira composta:"
-#: 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 ""
-#: index.docbook:218
-msgid "The collection of <literal>OrderLine</literal>s in <literal>Order</literal> would use:"
+#. Tag: para
+#: component_mapping.xml:218
+#, no-c-format
+msgid ""
+"The collection of <literal>OrderLine</literal>s in <literal>Order</literal> "
+"would use:"
msgstr ""
+"A collection de <literal>OrderLine</literal>s em <literal>Order</literal> "
+"usaria:"
-#: 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 ""
-#: index.docbook:225
-msgid "(The <literal><one-to-many></literal> element, as usual, declares no columns.)"
+#. Tag: para
+#: component_mapping.xml:225
+#, no-c-format
+msgid ""
+"(The <literal><one-to-many></literal> element, as usual, declares no "
+"columns.)"
msgstr ""
+"(O elemento <literal><one-to-many></literal>, como de costume, não "
+"declara colunas.)"
-#: index.docbook:229
-msgid "If <literal>OrderLine</literal> itself owns a collection, it also has a composite foreign key."
+#. 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 ""
+"Se <literal>OrderLine</literal> possui uma collection, ela também tem uma "
+"chave estrangeira composta."
-#: 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 ""
-#: index.docbook:239
+#. Tag: title
+#: component_mapping.xml:239
+#, no-c-format
msgid "Dynamic components"
-msgstr ""
+msgstr "Componentes Dinâmicos"
-#: 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 ""
+"Você pode até mesmo mapear uma propriedade do tipo <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 ""
-#: index.docbook:247
-msgid "The semantics of a <literal><dynamic-component></literal> mapping are identical to <literal><component></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."
+#. Tag: para
+#: component_mapping.xml:247
+#, no-c-format
+msgid ""
+"The semantics of a <literal><dynamic-component></literal> mapping are "
+"identical to <literal><component></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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"A semântica de um mapeamento <literal><dynamic-component></literal> é "
+"idêntica à <literal><component></literal>. A vantagem deste tipo de "
+"mapeamento é a habilidade de determinar as propriedades atuais do bean no "
+"momento de deploy, apenas editando o documento de mapeamento. A Manipulação "
+"em tempo de execução do documento de mapeamento também é possível, usando o "
+"parser DOM. Até melhor, você pode acessar (e mudar) o metamodelo "
+"configuration-time do Hibernate através do objeto <literal>Configuration</"
+"literal>."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/configuration.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/configuration.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/configuration.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,1489 +1,3888 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Configuração"
-#: 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."
+#. 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 ""
+"Devido ao fato de o Hibernate ser projetado para operar em vários ambientes "
+"diferentes, há um grande número de parâmetros de configuração. Felizmente, a "
+"maioria tem valores default lógicos e o Hibernate é distribuído com um "
+"arquivo <literal>hibernate.properties</literal> de exemplo no <literal>etc/</"
+"literal> que mostra várias opções. Apenas coloque o arquivo de exemplo no "
+"seu classpath e personalize-o."
-#: index.docbook:16
+#. Tag: title
+#: configuration.xml:16
+#, no-c-format
msgid "Programmatic configuration"
-msgstr ""
+msgstr "1.11 Configuração programática"
-#: 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."
+#. 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 ""
+"Uma instância de <literal>org.hibernate.cfg.Configuration</literal> "
+"representa um conjunto inteiro de mapeamentos de tipos Java da aplicação "
+"para um banco de dados SQL. O <literal>Configuration</literal> é usado para "
+"construir uma <literal>SessionFactory</literal> (imutável). Os mapeamentos "
+"são compilados a partir de arquivos de mapeamento 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>:"
+#. 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 ""
+"Você pode obter uma instância <literal>Configuration</literal> intanciando- "
+"o diretamente e especificando documentos de mapeamento XML. Se o arquivo de "
+"mapeamento estão no classpath, use use <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 ""
-#: index.docbook:34
-msgid "An alternative (sometimes better) way is to specify the mapped class, and let Hibernate find the mapping document for you:"
+#. 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 ""
+"Uma alternativa (às vezes melhor) é especificar a classe mapeada, e permitir "
+"que o Hibernate encontre o documento de mapeamento para você:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Então o Hibernate procurará pelos arquivos de mapeamento chamados <literal>/"
+"org/hibernate/auction/Item.hbm.xml</literal> e <literal>/org/hibernate/"
+"auction/Bid.hbm.xml</literal> no classpath. Esta abordagem elimina qualquer "
+"nome de arquivo de difícil compreensão."
-#: index.docbook:48
-msgid "A <literal>Configuration</literal> also allows you to specify configuration properties:"
+#. Tag: para
+#: configuration.xml:48
+#, no-c-format
+msgid ""
+"A <literal>Configuration</literal> also allows you to specify configuration "
+"properties:"
msgstr ""
+"Uma <literal>Configuration</literal> também permite você especificar "
+"propriedades de configuração:"
-#: 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 ""
-#: index.docbook:55
-msgid "This is not the only way to pass configuration properties to Hibernate. The various options include:"
+#. 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 ""
+"Este não é o único caminho para passar as propriedades de configuração para "
+"o Hibernate. As várias opções incluem:"
-#: index.docbook:62
-msgid "Pass an instance of <literal>java.util.Properties</literal> to <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 ""
+"Passar uma instância de <literal>java.util.Properties</literal> para "
+"<literal>Configuration.setProperties()</literal>."
-#: index.docbook:68
-msgid "Place <literal>hibernate.properties</literal> in a root directory of the classpath."
+#. Tag: para
+#: configuration.xml:68
+#, no-c-format
+msgid ""
+"Place <literal>hibernate.properties</literal> in a root directory of the "
+"classpath."
msgstr ""
+"Colocar <literal>hibernate.properties</literal> no diretório raiz do "
+"classpath."
-#: index.docbook:74
-msgid "Set <literal>System</literal> properties using <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 ""
+"Determinar as propriedades do <literal>System</literal> usando <literal>java "
+"-Dproperty=value</literal>."
-#: index.docbook:80
-msgid "Include <literal><property></literal> elements in <literal>hibernate.cfg.xml</literal> (discussed later)."
+#. Tag: para
+#: configuration.xml:80
+#, no-c-format
+msgid ""
+"Include <literal><property></literal> elements in <literal>hibernate."
+"cfg.xml</literal> (discussed later)."
msgstr ""
+"Include <literal><property></literal> elements in <literal>hibernate."
+"cfg.xml</literal> (discussed later). Incluir elementos <literal><"
+"property></literal> no <literal>hibernate.cfg.xml</literal> (discutido "
+"mais tarde)."
-#: index.docbook:87
-msgid "<literal>hibernate.properties</literal> is the easiest approach if you want to get started quickly."
+#. 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> é o caminho mais facil se você quer "
+"começar mais rápido."
-#: 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."
+#. 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 ""
+"O <literal>Configuration</literal> é entendido como um objeto startup-time, "
+"é descartado uma vez que a <literal>SessionFactory</literal> é criada."
-#: index.docbook:100
+#. Tag: title
+#: configuration.xml:100
+#, no-c-format
msgid "Obtaining a SessionFactory"
-msgstr ""
+msgstr "Obtendo uma 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:"
+#. 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 ""
+"Quando todos os mapeamentos têm sido analisados pelo <literal>Configuration</"
+"literal>, a aplicação deve obter uma factory para as instâncias da "
+"<literal>Session</literal>. O objetivo desta factory é ser compartilhado por "
+"todas as threads da aplicação:"
-#: index.docbook:108
+#. Tag: programlisting
+#: configuration.xml:108
+#, no-c-format
msgid "<![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."
+#. 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 permite sua aplicação instanciar mais do que uma "
+"<literal>SessionFactory</literal>. Isto é útil se você está usando mais do "
+"que um banco de dados."
-#: index.docbook:119
+#. Tag: title
+#: configuration.xml:119
+#, no-c-format
msgid "JDBC connections"
-msgstr ""
+msgstr "Conexões 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:"
+#. 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 ""
+"Normalmente, você quer mandar criar a <literal>SessionFactory</literal> "
+"criar um pool de conexões JDBC para você. Se você seguir essa abordagem, a "
+"abertura de uma <literal>Session</literal> é tão simples quanto:"
-#: index.docbook:127
-msgid "<![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."
+#. 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 ""
+"Assim que você fizer algo que requer o acesso ao banco de dados, uma conexão "
+"JDBC será obtida do pool."
-#: 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."
+#. 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 ""
+"Para esse trabalho, nós necessitamos passar algumas propriedades da conexão "
+"JDBC para o Hibernate. Todos os nomes de propriedades Hibernate e semânticas "
+"são definidas <literal>org.hibernate.cfg.Environment</literal>. Nós iremos "
+"descrever agora o mais importantes configurações de conexão JDBC."
-#: index.docbook:141
-msgid "Hibernate will obtain (and pool) connections using <literal>java.sql.DriverManager</literal> if you set the following properties:"
+#. 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 ""
+"O Hibernate obterá conexões( e pool) usando <literal>java.sql.DriverManager</"
+"literal> se você determinar as seguintes propriedades:"
-#: index.docbook:147
+#. Tag: title
+#: configuration.xml:147
+#, no-c-format
msgid "Hibernate JDBC Properties"
-msgstr ""
+msgstr "Propriedades JDBC Hibernate"
-#: 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 ""
+msgstr "Nome da Propriedade"
-#: 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 ""
+msgstr "Propósito"
-#: index.docbook:160
+#. Tag: literal
+#: configuration.xml:160
+#, no-c-format
msgid "hibernate.connection.driver_class"
-msgstr ""
+msgstr "hibernate.connection.driver_class"
-#: index.docbook:163
+#. Tag: emphasis
+#: configuration.xml:163
+#, no-c-format
msgid "JDBC driver class"
-msgstr ""
+msgstr "Classe driver jdbc"
-#: index.docbook:168
+#. Tag: literal
+#: configuration.xml:168
+#, no-c-format
msgid "hibernate.connection.url"
-msgstr ""
+msgstr "hibernate.connection.url"
-#: index.docbook:171
+#. Tag: emphasis
+#: configuration.xml:171
+#, no-c-format
msgid "JDBC URL"
-msgstr ""
+msgstr "URL jdbc"
-#: index.docbook:176, index.docbook:272
+#. Tag: literal
+#: configuration.xml:176 configuration.xml:272
+#, no-c-format
msgid "hibernate.connection.username"
-msgstr ""
+msgstr "hibernate.connection.username"
-#: index.docbook:179
+#. Tag: emphasis
+#: configuration.xml:179
+#, no-c-format
msgid "database user"
-msgstr ""
+msgstr "Usuário do banco de dados"
-#: index.docbook:184, index.docbook:280
+#. Tag: literal
+#: configuration.xml:184 configuration.xml:280
+#, no-c-format
msgid "hibernate.connection.password"
-msgstr ""
+msgstr "hibernate.connection.password"
-#: index.docbook:187
+#. Tag: emphasis
+#: configuration.xml:187
+#, no-c-format
msgid "database user password"
-msgstr ""
+msgstr "Senha do usuário do banco de dados"
-#: index.docbook:192
+#. Tag: literal
+#: configuration.xml:192
+#, no-c-format
msgid "hibernate.connection.pool_size"
-msgstr ""
+msgstr "hibernate.connection.pool_size"
-#: index.docbook:195
+#. Tag: emphasis
+#: configuration.xml:195
+#, no-c-format
msgid "maximum number of pooled connections"
-msgstr ""
+msgstr "Número máximo de connecxões no pool"
-#: 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."
+#. 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 ""
+"O algoritmo de pool de conexões do próprio Hibernate entretanto é "
+"completamente rudimentar. A intenção dele e ajudar a iniciar e <emphasis>não "
+"para usar em um sistema de produção</emphasis> ou até para testar "
+"desempenho. Você deveria usar uma ferramente de pool de terceiros para "
+"conseguir melhor desempenho e estabilidade. Apenas especifique a propriedade "
+"<literal>hibernate.connection.pool_size</literal> com a definição do pool de "
+"conexões. Isto irá desligar o pool interno do Hibernate. Por exemplo, você "
+"pode gostar de usar 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."
+#. 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 ""
+"O C3P0 é um pool conexão JDBC de código aberto distribuído junto com "
+"Hibernate no diretório <literal>lib</literal>. O Hibernate usará o "
+"<literal>C3P0ConnectionProvider</literal> para o pool de conexão se você "
+"configurar a propriedade <literal>hibernate.c3p0.*</literal>. Se você gostar "
+"de usar Proxool consulte ao pacote <literal>hibernate.properties</literal> e "
+"o web site do Hibernate para mais informações."
-#: index.docbook:221
-msgid "Here is an example <literal>hibernate.properties</literal> file for C3P0:"
+#. Tag: para
+#: configuration.xml:221
+#, no-c-format
+msgid ""
+"Here is an example <literal>hibernate.properties</literal> file for C3P0:"
msgstr ""
+"Aqui é um exemplo de arquivo <literal>hibernate.properties</literal> para "
+"C3P0:"
-#: 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 ""
-#: 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:"
+#. 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 ""
+"Para usar dentro de um servidor de aplicação, você deve configurar o "
+"Hibernate para obter conexões de um application server <literal>Datasource</"
+"literal> registrado no JNDI. Você necessitará determinar pelo menos uma das "
+"seguintes propriedades:"
-#: index.docbook:235
+#. Tag: title
+#: configuration.xml:235
+#, no-c-format
msgid "Hibernate Datasource Properties"
-msgstr ""
+msgstr "Propriedades do Datasource do Hibernate"
-#: index.docbook:248
+#. Tag: literal
+#: configuration.xml:248
+#, no-c-format
msgid "hibernate.connection.datasource"
-msgstr ""
+msgstr "hibernate.connection.datasource"
-#: index.docbook:251
+#. Tag: emphasis
+#: configuration.xml:251
+#, no-c-format
msgid "datasource JNDI name"
-msgstr ""
+msgstr "Nome datasource JNDI"
-#: index.docbook:256
+#. Tag: literal
+#: configuration.xml:256
+#, no-c-format
msgid "hibernate.jndi.url"
-msgstr ""
+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 ""
+msgstr "URL do fornecedor JNDI"
-#: index.docbook:264
+#. Tag: literal
+#: configuration.xml:264
+#, no-c-format
msgid "hibernate.jndi.class"
-msgstr ""
+msgstr "hibernate.jndi.class"
-#: index.docbook:266
-msgid "<emphasis>class of the JNDI <literal>InitialContextFactory</literal></emphasis> (optional)"
+#. 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 ""
-#: index.docbook:282
+#. Tag: entry
+#: configuration.xml:282
+#, no-c-format
msgid "<emphasis>database user password</emphasis> (optional)"
msgstr ""
-#: index.docbook:290
-msgid "Here's an example <literal>hibernate.properties</literal> file for an application server provided JNDI datasource:"
+#. 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 ""
+"Eis um exemplo de arquivo <literal>hibernate.properties</literal> para um "
+"servidor de aplicação fornecedor de datasources JNDI:"
-#: 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 ""
-#: index.docbook:297
-msgid "JDBC connections obtained from a JNDI datasource will automatically participate in the container-managed transactions of the application server."
+#. 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 ""
+"Conexões JDBC obtidas de um datasource JNDI irão automaticamente irão "
+"participar das transações gerenciadas pelo container no servidor de "
+"aplicação."
-#: 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>."
+#. 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 ""
+"Arbitrariamente as propriedades de conexão podem ser acrescentandas ao "
+"\"<literal>hibernate.connnection</literal>\" ao nome da propriedade. Por "
+"exemplo, você deve especificar o <literal>charSet</literal> usando "
+"<literal>hibernate.connection.charSet</literal>.t."
-#: 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>."
+#. 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 ""
+"Você pode definir sua própria estratégia de plugin para obter conexões JDBC "
+"implementando a interface <literal>org.hibernate.connection."
+"ConnectionProvider</literal>. Você pode escolher uma implementação "
+"customizada setando <literal>hibernate.connection.provider_class</literal>."
-#: index.docbook:317
+#. Tag: title
+#: configuration.xml:317
+#, no-c-format
msgid "Optional configuration properties"
-msgstr ""
+msgstr "Propriedades opcionais de configuração"
-#: 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."
+#. 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 ""
+"Há um grande número de outras propriedades que controlam o comportamento do "
+"Hibernate em tempo de execução. Todos são opcionais e tem valores default "
+"lógicos."
-#: 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."
+#. 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>Aviso: algumas destas propriedades são somente a \"nível de sistema"
+"\".</emphasis> Propriedades nível de sistema podem ser determinados somente "
+"via <literal>java -Dproperty=value</literal> ou <literal>hibernate."
+"properties</literal>. Elas <emphasis>não</emphasis>podem ser configuradas "
+"por outras técnicas descritas abaixo."
-#: index.docbook:332
+#. Tag: title
+#: configuration.xml:332
+#, no-c-format
msgid "Hibernate Configuration Properties"
-msgstr ""
+msgstr "Hibernate Configuration Properties"
-#: index.docbook:345
+#. Tag: literal
+#: configuration.xml:345
+#, no-c-format
msgid "hibernate.dialect"
-msgstr ""
+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."
+#. 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 ""
+"O nome da classe de um <placeholder-1/> que permite o Hibernate gerar SQL "
+"otimizado para um banco de dados relacional em particular. <placeholder-2/>"
-#: index.docbook:351
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:359
+#. Tag: literal
+#: configuration.xml:359
+#, no-c-format
msgid "hibernate.show_sql"
-msgstr ""
+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>."
+#. 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 ""
+"Escreve todas as instruções SQL no console. Esta é uma alternativa a "
+"configurar a categoria de log <placeholder-1/> para <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>"
+#. 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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:373
+#. Tag: literal
+#: configuration.xml:373
+#, no-c-format
msgid "hibernate.format_sql"
-msgstr ""
+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 ""
+msgstr "Imprime o SQL formatado no log e console. <placeholder-1/>"
-#: index.docbook:385
+#. Tag: literal
+#: configuration.xml:385
+#, no-c-format
msgid "hibernate.default_schema"
-msgstr ""
+msgstr "hibernate.default_schema"
-#: index.docbook:387
-msgid "Qualify unqualified table names with the given schema/tablespace in generated SQL."
+#. Tag: entry
+#: configuration.xml:387
+#, fuzzy, no-c-format
+msgid ""
+"Qualify unqualified table names with the given schema/tablespace in "
+"generated SQL."
msgstr ""
+"Qualifica no sql gerado, os nome das tabelas sem qualificar com schena/"
+"tablespace dado <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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:398
+#. Tag: literal
+#: configuration.xml:398
+#, no-c-format
msgid "hibernate.default_catalog"
-msgstr ""
+msgstr "hibernate.default_catalog"
-#: index.docbook:400
-msgid "Qualify unqualified table names with the given catalog in generated SQL."
+#. Tag: entry
+#: configuration.xml:400
+#, fuzzy, no-c-format
+msgid ""
+"Qualify unqualified table names with the given catalog in generated SQL."
msgstr ""
+"Qualifica no sql gerado, os nome das tabelas sem qualificar com catálogo "
+"dado <placeholder-1/>"
-#: index.docbook:403
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:411
+#. Tag: literal
+#: configuration.xml:411
+#, no-c-format
msgid "hibernate.session_factory_name"
-msgstr ""
+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."
+#. 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 ""
+"O <placeholder-1/> irá automaticamente se ligar a este nome no JNDI depois "
+"de ter sido criado. <placeholder-2/>"
-#: index.docbook:416, index.docbook:859
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:424
+#. Tag: literal
+#: configuration.xml:424
+#, no-c-format
msgid "hibernate.max_fetch_depth"
-msgstr ""
+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."
+#. 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 ""
+"Estabelece a \"profundidade\" máxima para árvore outer join fetch para "
+"associações finais únicas(one-to-one,many-to-one). Um <placeholder-1/> "
+"desativa por default a busca outer join. <placeholder-2/>"
-#: index.docbook:430
-msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>0</literal> and <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\">eg.</emphasis> Valores recomendados "
+"entre<literal>0</literal> e <literal>3</literal>"
-#: index.docbook:439
+#. Tag: literal
+#: configuration.xml:439
+#, no-c-format
msgid "hibernate.default_batch_fetch_size"
-msgstr ""
+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 ""
+"Determina um tamanho default para busca de associações em lotes do Hibernate "
+"<placeholder-1/>"
-#: index.docbook:443
-msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values <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\">eg.</emphasis> Valores recomendados <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 ""
+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>"
+#. 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 ""
+"Determina um modo default para representação de entidades para todas as "
+"sessões abertas desta <placeholder-1/><placeholder-2/>"
-#: index.docbook:457
-msgid "<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 ""
+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."
+#. 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 ""
+"Força o Hibernate a ordenar os updates SQL pelo valor da chave primária dos "
+"itens a serem atualizados. Isto resultará em menos deadlocks nas transações "
+"em sistemas altamente concorrente. <placeholder-1/>"
-#: index.docbook:479
+#. Tag: literal
+#: configuration.xml:479
+#, no-c-format
msgid "hibernate.generate_statistics"
-msgstr ""
+msgstr "hibernate.generate_statistics"
-#: index.docbook:481
-msgid "If enabled, Hibernate will collect statistics useful for performance tuning."
+#. Tag: entry
+#: configuration.xml:481
+#, fuzzy, no-c-format
+msgid ""
+"If enabled, Hibernate will collect statistics useful for performance tuning."
msgstr ""
+"If enabled, Hibernate will collect statistics useful for performance tuning. "
+"Se habilitado, o Hibernate coletará estatísticas úties para performance "
+"tuning dos bancos. <placeholder-1/>"
-#: index.docbook:492
+#. Tag: literal
+#: configuration.xml:492
+#, no-c-format
msgid "hibernate.use_identifier_rollback"
-msgstr ""
+msgstr "hibernate.use_identifer_rollback"
-#: index.docbook:494
-msgid "If enabled, generated identifier properties will be reset to default values when objects are deleted."
+#. 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 ""
+"Se habilitado, propriedades identificadoras geradas serão zeradas para os "
+"valores default quando os objetos forem apagados. <placeholder-1/>"
-#: index.docbook:505
+#. Tag: literal
+#: configuration.xml:505
+#, no-c-format
msgid "hibernate.use_sql_comments"
-msgstr ""
+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>."
+#. 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 ""
+"Se ligado, o Hibernate irá gerar comentários dentro do SQL, para facilitar o "
+"debugging, o valor default é <placeholder-1/>. <placeholder-2/>"
-#: index.docbook:521
+#. Tag: title
+#: configuration.xml:521
+#, no-c-format
msgid "Hibernate JDBC and Connection Properties"
-msgstr ""
+msgstr "JDBC Hibernate e Propriedades de Conexão"
-#: index.docbook:536
+#. Tag: literal
+#: configuration.xml:536
+#, no-c-format
msgid "hibernate.jdbc.fetch_size"
-msgstr ""
+msgstr "hibernate.jdbc.fetch_size"
-#: index.docbook:538
-msgid "A non-zero value determines the JDBC fetch size (calls <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 ""
+"Um valor maior que zero determina o tamanho do fetch do JDBC( chamadas "
+"<placeholder-1/>)."
-#: index.docbook:545
+#. Tag: literal
+#: configuration.xml:545
+#, no-c-format
msgid "hibernate.jdbc.batch_size"
-msgstr ""
+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 ""
+"Um valor maior que zero habilita uso de batch updates JDBC2 pelo Hibernate. "
+"<placeholder-1/>"
-#: index.docbook:549
-msgid "<emphasis role=\"strong\">eg.</emphasis> recommended values between <literal>5</literal> and <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\">Ex.</emphasis> valores recomentados entre "
+"<literal>5</literal> e <literal>30</literal>"
-#: index.docbook:557
+#. Tag: literal
+#: configuration.xml:557
+#, no-c-format
msgid "hibernate.jdbc.batch_versioned_data"
-msgstr ""
+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>."
+#. 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 ""
+"Sete esta propriedade como <placeholder-1/> se seu driver JDBC retorna o "
+"número correto de linhas no <placeholder-2/> ( É usualmente seguro tornar "
+"esta opção ligada). O Hibernate então irá usar betched DML para "
+"automaticamente versionar dados. <placeholder-3/> por default. <placeholder-"
+"4/>"
-#: index.docbook:572
+#. Tag: literal
+#: configuration.xml:572
+#, no-c-format
msgid "hibernate.jdbc.factory_class"
-msgstr ""
+msgstr "hibernate.jdbc.factory_class"
-#: index.docbook:574
-msgid "Select a custom <literal>Batcher</literal>. Most applications will not need this configuration property."
+#. 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 ""
+"Escolher um <placeholder-1/> customizado. Muitas aplicações não irão "
+"necessitar desta propriedade de configuração <placeholder-2/>"
-#: index.docbook:577
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</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 ""
+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."
+#. 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 ""
+"Habilita o uso de JDBC2 scrollable resultsets pelo Hibernate. Essa "
+"propriedade somente é necessaria quando se usa Conexeções JDBC providas pelo "
+"usuário, caso contrário o Hibernate os os metadados da conexão. <placeholder-"
+"1/>"
-#: index.docbook:599
+#. Tag: literal
+#: configuration.xml:599
+#, no-c-format
msgid "hibernate.jdbc.use_streams_for_binary"
-msgstr ""
+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)."
+#. 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 ""
+"Use streams para escrever/ler tipos <placeholder-1/> ou <placeholder-2/> "
+"para/a o JDBC( propriedade a nível de sistema). <placeholder-3/>"
-#: index.docbook:613
+#. Tag: literal
+#: configuration.xml:613
+#, no-c-format
msgid "hibernate.jdbc.use_get_generated_keys"
-msgstr ""
+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."
+#. 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 ""
+"Possibilita o uso <placeholder-1/> do JDBC3 para recuperar chaves geradas "
+"nativamente depois da inserçãp. Requer driver JDBC3+ e JRE1.4+, determine "
+"para false se seu driver tem problemas com gerador de indentificadores "
+"Hibernate. Por default, tente determinar o driver capaz de usar metadados da "
+"conexão. <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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:629
+#. Tag: literal
+#: configuration.xml:629
+#, no-c-format
msgid "hibernate.connection.provider_class"
-msgstr ""
+msgstr "hibernate.connection.provider_class"
-#: index.docbook:631
-msgid "The classname of a custom <literal>ConnectionProvider</literal> which provides JDBC connections to Hibernate."
+#. 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 ""
+"O nome da classe de um <placeholder-1/> personalizado o qual proverá "
+"conexões JDBC para o Hibernate. <placeholder-2/>"
-#: index.docbook:634
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:642
+#. Tag: literal
+#: configuration.xml:642
+#, no-c-format
msgid "hibernate.connection.isolation"
-msgstr ""
+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."
+#. 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 ""
+"Determina o nível de isolamento de uma transação JDBC. Verifique "
+"<placeholder-1/> para valores siginificativos mas note que a maior parte dos "
+"bancos de dados não suportam todos os níveis de isolamento. <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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:656
+#. Tag: literal
+#: configuration.xml:656
+#, no-c-format
msgid "hibernate.connection.autocommit"
-msgstr ""
+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 ""
+"Habilita autocommit para conexões no pool JDBC( não recomendado). "
+"<placeholder-1/>"
-#: index.docbook:668
+#. Tag: literal
+#: configuration.xml:668
+#, no-c-format
msgid "hibernate.connection.release_mode"
-msgstr ""
+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."
+#. 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 ""
+"Especifica quando o Hibernate deve liberar conexões JDBC. Por default, uma "
+"conexão JDBC é retida até a sessão está explicitamente fechada ou "
+"desconectada. Para um datasource JTA do servidor de aplicação, você deve "
+"usar <placeholder-1/> para forçar s liberação da conexões depois de todas as "
+"chamadas JDBC. Para uma conexão não-JTA, freqüentemente faz sentido liberar "
+"a conexão ao fim de cada transação, usando <placeholder-2/>. <placeholder-3/"
+"> escolheremos <placeholder-4/> para as estratégias de transaçãoes JTA e CMT "
+"e <placeholder-5/> para as estratégias de transação JDBC <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>"
+#. 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\">Ex.</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"
+#. 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 ""
+"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 <xref linkend=\"architecture-current-session"
+"\"/>"
-#: index.docbook:698
-msgid "hibernate.connection.<emphasis><propertyName></emphasis>"
+#. Tag: entry
+#: configuration.xml:697
+#, no-c-format
+msgid ""
+"<literal>hibernate.connection.</literal><emphasis><propertyName></"
+"emphasis>"
msgstr ""
-#: index.docbook:700
-msgid "Pass the JDBC property <literal>propertyName</literal> to <literal>DriverManager.getConnection()</literal>."
+#. Tag: entry
+#: configuration.xml:700
+#, no-c-format
+msgid ""
+"Pass the JDBC property <emphasis><propertyName></emphasis> to "
+"<literal>DriverManager.getConnection()</literal>."
msgstr ""
-#: index.docbook:707
-msgid "hibernate.jndi.<emphasis><propertyName></emphasis>"
+#. Tag: entry
+#: configuration.xml:706
+#, no-c-format
+msgid ""
+"<literal>hibernate.jndi.</literal><emphasis><propertyName></emphasis>"
msgstr ""
-#: index.docbook:709
-msgid "Pass the property <literal>propertyName</literal> to the JNDI <literal>InitialContextFactory</literal>."
+#. Tag: entry
+#: configuration.xml:709
+#, no-c-format
+msgid ""
+"Pass the property <emphasis><propertyName></emphasis> to the JNDI "
+"<literal>InitialContextFactory</literal>."
msgstr ""
-#: index.docbook:719
+#. Tag: title
+#: configuration.xml:719
+#, no-c-format
msgid "Hibernate Cache Properties"
-msgstr ""
+msgstr "Propriedades de Cachê do Hibernate"
-#: index.docbook:732
+#. Tag: literal
+#: configuration.xml:732
+#, no-c-format
msgid "hibernate.cache.provider_class"
-msgstr ""
+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 ""
+msgstr "O nome da classe de um <placeholder-1/> customizado. <placeholder-2/>"
-#: index.docbook:736
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</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 ""
+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."
+#. 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 ""
+"Otimizar operação de cachê de segundo nível para minimizar escritas, ao "
+"custo de leituras mais frequantes. Esta configuração é mais útil para cachês "
+"clusterizados e, no Hibernate3, é habilitado por default para implementações "
+"de cachê clusterizar. <placeholder-1/>"
-#: index.docbook:759
+#. Tag: literal
+#: configuration.xml:759
+#, no-c-format
msgid "hibernate.cache.use_query_cache"
-msgstr ""
+msgstr "hibernate.cache.use_query_cache"
-#: index.docbook:761
-msgid "Enable the query cache, individual queries still have to be set cachable."
+#. Tag: entry
+#: configuration.xml:761
+#, fuzzy, no-c-format
+msgid ""
+"Enable the query cache, individual queries still have to be set cachable."
msgstr ""
+"Habilita a cache de consultas, Mesmo assim, consultas individuais ainda tem "
+"que ser habilitadas para o cache. <placeholder-1/>"
-#: index.docbook:771
+#. Tag: literal
+#: configuration.xml:771
+#, no-c-format
msgid "hibernate.cache.use_second_level_cache"
-msgstr ""
+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><cache></literal> mapping."
+#. 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><cache></literal> "
+"mapping."
msgstr ""
+"Pode ser usada para desabilitar completamente ocache de segundo nível, o "
+"qual está habilitado por default para classes que especificam um mapeamento "
+"<placeholder-1/>. <placeholder-2/>"
-#: index.docbook:785
+#. Tag: literal
+#: configuration.xml:785
+#, no-c-format
msgid "hibernate.cache.query_cache_factory"
-msgstr ""
+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>."
+#. 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 ""
+"O nome de uma classe que implementa a interface <placeholder-1/> "
+"personalizada, por default, um <placeholder-2/> criado automaticamente. "
+"<placeholder-3/>"
-#: index.docbook:790
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:798
+#. Tag: literal
+#: configuration.xml:798
+#, no-c-format
msgid "hibernate.cache.region_prefix"
-msgstr ""
+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 ""
+"Um prefixo para usar nos nomes da área especial do cachê de segundo nível. "
+"<placeholder-1/>"
-#: index.docbook:802
+#. Tag: para
+#: configuration.xml:802
+#, fuzzy, no-c-format
msgid "<emphasis role=\"strong\">eg.</emphasis> <literal>prefix</literal>"
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</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 ""
+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."
+#. 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 ""
+"Forces Hibernate to store data in the second-level cache in a more human-"
+"friendly format. Força o Hibernate armazenar dados no cachê se segundo nível "
+"em um formato mais legivel. <placeholder-1/>"
-#: index.docbook:826
+#. Tag: title
+#: configuration.xml:826
+#, no-c-format
msgid "Hibernate Transaction Properties"
-msgstr ""
+msgstr "Propriedades de Transação do Hibernate"
-#: index.docbook:839
+#. Tag: literal
+#: configuration.xml:839
+#, no-c-format
msgid "hibernate.transaction.factory_class"
-msgstr ""
+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>)."
+#. 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 ""
+"O nome da clase de um a <placeholder-1/> para usar com API <placeholder-2/> "
+"( por default <placeholder-3/>). <placeholder-4/>"
-#: index.docbook:845
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:853
+#. Tag: literal
+#: configuration.xml:853
+#, no-c-format
msgid "jta.UserTransaction"
-msgstr ""
+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."
+#. 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 ""
+"Um nome JNDI usado pelo <placeholder-1/> para obter uma <placeholder-2/> JTA "
+"a partir do servidor de aplicação. <placeholder-3/>"
-#: index.docbook:867
+#. Tag: literal
+#: configuration.xml:867
+#, no-c-format
msgid "hibernate.transaction.manager_lookup_class"
-msgstr ""
+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."
+#. 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 ""
+"O nome da classe de um <placeholder-1/> – requerido quando caching a nível "
+"JVM esta habilitado ou quando estivermos usando um generator hilo em um "
+"ambiente JTA. <placeholder-2/>"
-#: index.docbook:873
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</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 ""
+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\"/>."
+#. 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 ""
+"Se habilitado, a sessão será automaticamente limpa antes da fase de "
+"conclusão da transação. É preferivel a gerência interna e automática do "
+"contexto da sessão, veja <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 ""
+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\"/>."
+#. 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 ""
+"Se habilitado, a sessão será automaticamente fechada após a fase de "
+"conclusão da transação. É preferivel a gerência interna e automática do "
+"contexto da sessão, veja <xref linkend=\"architecture-current-session\"/"
+"><placeholder-1/>"
-#: index.docbook:914
+#. Tag: title
+#: configuration.xml:914
+#, no-c-format
msgid "Miscellaneous Properties"
-msgstr ""
+msgstr "Propriedades Variadas"
-#: index.docbook:927
+#. Tag: literal
+#: configuration.xml:927
+#, no-c-format
msgid "hibernate.current_session_context_class"
-msgstr ""
+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."
+#. 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 ""
+"Forneçe uma estratégia (personalizada) para extensão da <placeholder-1/> "
+"\"corrente\". Veja <xref linkend=\"architecture-current-session\"/> para "
+"mais informação sobre estratégias internas. <placeholder-2/>"
-#: index.docbook:934
-msgid "<emphasis role=\"strong\">eg.</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\">Ex.</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 ""
+msgstr "hibernate.query.factory_class"
-#: index.docbook:945
+#. Tag: entry
+#: configuration.xml:945
+#, fuzzy, no-c-format
msgid "Chooses the HQL parser implementation."
-msgstr ""
+msgstr "Escolha a implementação de análise 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>"
+#. 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\">eg.</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 ""
+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)."
+#. 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 ""
+"Mapeamento a partir de símbolos em consultas HQL para símbolos SQL( símbolos "
+"devem ser funções ou nome literais , por exemplo). <placeholder-1/>"
-#: index.docbook:961
-msgid "<emphasis role=\"strong\">eg.</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 ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">eg.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"<emphasis role=\"strong\">Ex.</emphasis><literal>true</literal> | "
+"<literal>false</literal>"
-#: index.docbook:969
+#. Tag: literal
+#: configuration.xml:969
+#, no-c-format
msgid "hibernate.hbm2ddl.auto"
-msgstr ""
+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."
+#. 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 ""
+"Automaticamente valida ou exporta schema DDL para o banco de dados quando o "
+"<placeholder-1/> é criads. Com <placeholder-2/>, o schema do banco de dados "
+"será excluido quando a <placeholder-3/> for fechada esplicitamente. "
+"<placeholder-4/>"
-#: index.docbook:977
-msgid "<emphasis role=\"strong\">eg.</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\">Ex.</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 ""
+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>."
+#. 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 ""
+"Habilita o uso de CGLIB em vez de reflexão em tempo de execução "
+"( propriedade a nível de sistema). Reflexão pode algumas vezes ser ú til "
+"quando controlar erros, note que o Hibernate sempre irá requerer a CGLIB "
+"mesmo se você desligar o otimizador. Você não pode determinar esta "
+"propriedade no <placeholder-1/>. <placeholder-2/>"
-#: index.docbook:1004
+#. Tag: title
+#: configuration.xml:1004
+#, no-c-format
msgid "SQL Dialects"
-msgstr ""
+msgstr "Dialetos SQL"
-#: 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."
+#. 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 ""
+"Você deve sempre determinar a propriedade <literal>hibernate.dialect</"
+"literal> para a subclasse de <literal>org.hibernate.dialect.Dialect</"
+"literal> correta de seu banco de dados. Se você especificar um dialeto, "
+"Hibernate usará defaults lógicos para qualquer um das outras propriedades "
+"listadas abaixo, reduzindo o esforço de especificá-los manualmente."
-#: index.docbook:1014
+#. Tag: title
+#: configuration.xml:1014
+#, no-c-format
msgid "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)"
-msgstr ""
+msgstr "Hibernate SQL Dialects (<literal>hibernate.dialect</literal>)"
-#: index.docbook:1022
+#. Tag: entry
+#: configuration.xml:1022
+#, no-c-format
msgid "RDBMS"
-msgstr ""
+msgstr "RDBMS"
-#: index.docbook:1023
+#. Tag: entry
+#: configuration.xml:1023
+#, fuzzy, no-c-format
msgid "Dialect"
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"Dialeto\n"
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"Dialect"
-#: index.docbook:1028
+#. Tag: entry
+#: configuration.xml:1028
+#, no-c-format
msgid "<entry>DB2</entry>"
msgstr ""
-#: index.docbook:1028
+#. Tag: literal
+#: configuration.xml:1028
+#, no-c-format
msgid "org.hibernate.dialect.DB2Dialect"
-msgstr ""
+msgstr "org.hibernate.dialect.DB2Dialect"
-#: index.docbook:1031
+#. Tag: entry
+#: configuration.xml:1031
+#, no-c-format
msgid "DB2 AS/400"
-msgstr ""
+msgstr "DB2 AS/400"
-#: index.docbook:1031
+#. Tag: literal
+#: configuration.xml:1031
+#, no-c-format
msgid "org.hibernate.dialect.DB2400Dialect"
-msgstr ""
+msgstr "org.hibernate.dialect.DB2400Dialect"
-#: index.docbook:1034
+#. Tag: entry
+#: configuration.xml:1034
+#, no-c-format
msgid "DB2 OS390"
-msgstr ""
+msgstr "DB2 OS390"
-#: index.docbook:1034
+#. Tag: literal
+#: configuration.xml:1034
+#, no-c-format
msgid "org.hibernate.dialect.DB2390Dialect"
-msgstr ""
+msgstr "org.hibernate.dialect.DB2390Dialect"
-#: index.docbook:1037
+#. Tag: entry
+#: configuration.xml:1037
+#, no-c-format
msgid "PostgreSQL"
-msgstr ""
+msgstr "PostgreSQL"
-#: index.docbook:1037
+#. Tag: literal
+#: configuration.xml:1037
+#, no-c-format
msgid "org.hibernate.dialect.PostgreSQLDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.PostgreSQLDialect"
-#: index.docbook:1040
+#. Tag: entry
+#: configuration.xml:1040
+#, no-c-format
msgid "MySQL"
-msgstr ""
+msgstr "MySQL"
-#: index.docbook:1040
+#. Tag: literal
+#: configuration.xml:1040
+#, no-c-format
msgid "org.hibernate.dialect.MySQLDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.MySQLDialect"
-#: index.docbook:1043
+#. Tag: entry
+#: configuration.xml:1043
+#, no-c-format
msgid "MySQL with InnoDB"
-msgstr ""
+msgstr "MySQL with InnoDB"
-#: index.docbook:1043
+#. Tag: literal
+#: configuration.xml:1043
+#, no-c-format
msgid "org.hibernate.dialect.MySQLInnoDBDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.MySQLInnoDBDialect"
-#: index.docbook:1046
+#. Tag: entry
+#: configuration.xml:1046
+#, no-c-format
msgid "MySQL with MyISAM"
-msgstr ""
+msgstr "MySQL with MyISAM"
-#: index.docbook:1046
+#. Tag: literal
+#: configuration.xml:1046
+#, no-c-format
msgid "org.hibernate.dialect.MySQLMyISAMDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.MySQLMyISAMDialect"
-#: index.docbook:1049
+#. Tag: entry
+#: configuration.xml:1049
+#, no-c-format
msgid "Oracle (any version)"
-msgstr ""
+msgstr "Oracle (any version)"
-#: index.docbook:1049
+#. Tag: literal
+#: configuration.xml:1049
+#, no-c-format
msgid "org.hibernate.dialect.OracleDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.OracleDialect"
-#: index.docbook:1052
+#. Tag: entry
+#: configuration.xml:1052
+#, no-c-format
msgid "Oracle 9i/10g"
-msgstr ""
+msgstr "Oracle 9i/10g"
-#: index.docbook:1052
+#. Tag: literal
+#: configuration.xml:1052
+#, no-c-format
msgid "org.hibernate.dialect.Oracle9Dialect"
-msgstr ""
+msgstr "org.hibernate.dialect.Oracle9Dialect"
-#: index.docbook:1055
+#. Tag: entry
+#: configuration.xml:1055
+#, no-c-format
msgid "Sybase"
-msgstr ""
+msgstr "Sybase"
-#: index.docbook:1055
+#. Tag: literal
+#: configuration.xml:1055
+#, no-c-format
msgid "org.hibernate.dialect.SybaseDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.SybaseDialect"
-#: index.docbook:1058
+#. Tag: entry
+#: configuration.xml:1058
+#, no-c-format
msgid "Sybase Anywhere"
-msgstr ""
+msgstr "Sybase Anywhere"
-#: index.docbook:1058
+#. Tag: literal
+#: configuration.xml:1058
+#, no-c-format
msgid "org.hibernate.dialect.SybaseAnywhereDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.SybaseAnywhereDialect"
-#: index.docbook:1061
+#. Tag: entry
+#: configuration.xml:1061
+#, no-c-format
msgid "Microsoft SQL Server"
-msgstr ""
+msgstr "Microsoft SQL Server"
-#: index.docbook:1061
+#. Tag: literal
+#: configuration.xml:1061
+#, no-c-format
msgid "org.hibernate.dialect.SQLServerDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.SQLServerDialect"
-#: index.docbook:1064
+#. Tag: entry
+#: configuration.xml:1064
+#, no-c-format
msgid "SAP DB"
-msgstr ""
+msgstr "SAP DB"
-#: index.docbook:1064
+#. Tag: literal
+#: configuration.xml:1064
+#, no-c-format
msgid "org.hibernate.dialect.SAPDBDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.SAPDBDialect"
-#: index.docbook:1067
+#. Tag: entry
+#: configuration.xml:1067
+#, no-c-format
msgid "Informix"
-msgstr ""
+msgstr "Informix"
-#: index.docbook:1067
+#. Tag: literal
+#: configuration.xml:1067
+#, no-c-format
msgid "org.hibernate.dialect.InformixDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.InformixDialect"
-#: index.docbook:1070
+#. Tag: entry
+#: configuration.xml:1070
+#, no-c-format
msgid "HypersonicSQL"
-msgstr ""
+msgstr "HypersonicSQL"
-#: index.docbook:1070
+#. Tag: literal
+#: configuration.xml:1070
+#, no-c-format
msgid "org.hibernate.dialect.HSQLDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.HSQLDialect"
-#: index.docbook:1073
+#. Tag: entry
+#: configuration.xml:1073
+#, no-c-format
msgid "Ingres"
-msgstr ""
+msgstr "Ingres"
-#: index.docbook:1073
+#. Tag: literal
+#: configuration.xml:1073
+#, no-c-format
msgid "org.hibernate.dialect.IngresDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.IngresDialect"
-#: index.docbook:1076
+#. Tag: entry
+#: configuration.xml:1076
+#, no-c-format
msgid "Progress"
-msgstr ""
+msgstr "Progress"
-#: index.docbook:1076
+#. Tag: literal
+#: configuration.xml:1076
+#, no-c-format
msgid "org.hibernate.dialect.ProgressDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.ProgressDialect"
-#: index.docbook:1079
+#. Tag: entry
+#: configuration.xml:1079
+#, no-c-format
msgid "Mckoi SQL"
-msgstr ""
+msgstr "Mckoi SQL"
-#: index.docbook:1079
+#. Tag: literal
+#: configuration.xml:1079
+#, no-c-format
msgid "org.hibernate.dialect.MckoiDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.MckoiDialect"
-#: index.docbook:1082
+#. Tag: entry
+#: configuration.xml:1082
+#, no-c-format
msgid "Interbase"
-msgstr ""
+msgstr "Interbase"
-#: index.docbook:1082
+#. Tag: literal
+#: configuration.xml:1082
+#, no-c-format
msgid "org.hibernate.dialect.InterbaseDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.InterbaseDialect"
-#: index.docbook:1085
+#. Tag: entry
+#: configuration.xml:1085
+#, no-c-format
msgid "Pointbase"
-msgstr ""
+msgstr "Pointbase"
-#: index.docbook:1085
+#. Tag: literal
+#: configuration.xml:1085
+#, no-c-format
msgid "org.hibernate.dialect.PointbaseDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.PointbaseDialect"
-#: index.docbook:1088
+#. Tag: entry
+#: configuration.xml:1088
+#, no-c-format
msgid "FrontBase"
-msgstr ""
+msgstr "FrontBase"
-#: index.docbook:1088
+#. Tag: literal
+#: configuration.xml:1088
+#, no-c-format
msgid "org.hibernate.dialect.FrontbaseDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.FrontbaseDialect"
-#: index.docbook:1091
+#. Tag: entry
+#: configuration.xml:1091
+#, no-c-format
msgid "Firebird"
-msgstr ""
+msgstr "Firebird"
-#: index.docbook:1091
+#. Tag: literal
+#: configuration.xml:1091
+#, no-c-format
msgid "org.hibernate.dialect.FirebirdDialect"
-msgstr ""
+msgstr "org.hibernate.dialect.FirebirdDialect"
-#: index.docbook:1100
+#. Tag: title
+#: configuration.xml:1100
+#, no-c-format
msgid "Outer Join Fetching"
-msgstr ""
+msgstr "Recuperação por união externa (Outer Join Fetching)"
-#: 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>."
+#. 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 ""
+"Se seu banco de dados suporta Recuperação por união externa (Outer Join "
+"Fetching) no estilo ANSI, Oracle ou Sybase, A recuperação por união externa "
+"(Outer Join Fetching) frequentemente aumentará o desempenho limitando o "
+"número de chamadas (round trips) ao banco de dados( ao custo de "
+"possivelmente mais trabalho desempenhado pelo próprio banco de dados). A "
+"recuperação por união externa (Outer Join Fetching)permite um gráfico "
+"completo de objetos conectados por muitos-para-um, um-para-muitos, muitos-"
+"para-muitos e associações um-para-um para ser recuperadas em um simples "
+"instrução SQL SELECT ."
-#: 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>."
+#. 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 ""
+"A recuperação por união externa (Outer Join Fetching) pode ser desabilitado "
+"<emphasis>globalmente</emphasis> setando a propriedade <literal>hibernate."
+"max_fetch_depth</literal> para <literal>0</literal>. Uma valor 1 ou maior "
+"habilita o outer join fetching para associações um-para-um e muitos-para-"
+"umos cujos quais tem sido mapeado com <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 ""
+msgstr "Veja <xref linkend=\"performance-fetching\"/> para mais informações."
-#: index.docbook:1126
+#. Tag: title
+#: configuration.xml:1126
+#, no-c-format
msgid "Binary Streams"
-msgstr ""
+msgstr "Fluxos Binários (Binary Streams)"
-#: 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>"
+#. 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 ""
+"O Oracle limita o tamanho de arrays de <literal>byte</literal> que pode ser "
+"passado para/de o driver JDBC. Se você desejar usar grandes instâncias de "
+"tipos <literal>binary</literal> ou <literal>serializable</literal>, você "
+"deve habilitar <literal>hibernate.jdbc.use_streams_for_binary</literal>. "
+"<emphasis>Essa é uma configuração que só pode ser feita a nível de sistema.</"
+"emphasis>"
-#: index.docbook:1139
+#. Tag: title
+#: configuration.xml:1139
+#, no-c-format
msgid "Second-level and query cache"
-msgstr ""
+msgstr "Cachê de segundo nível e query"
-#: 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."
+#. 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 ""
+"As propriedades prefixadas pelo <literal>hibernate.cache</literal> permite "
+"você usar um sistema de cachê de segundo nível em um processo executado em "
+"clustercom Hibernate. Veja <xref linkend=\"performance-cache\"/> para mais "
+"detalhes."
-#: index.docbook:1151
+#. Tag: title
+#: configuration.xml:1151
+#, no-c-format
msgid "Query Language Substitution"
-msgstr ""
+msgstr "Substituições na Linguagem de Consulta"
-#: index.docbook:1153
-msgid "You may define new Hibernate query tokens using <literal>hibernate.query.substitutions</literal>. For example:"
+#. 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 ""
+"Você pode definir novos símbolos de consulta Hibernate usando "
+"<literal>hibernate.query.substitutions</literal>. Por exemplo:"
-#: index.docbook:1158
+#. Tag: programlisting
+#: configuration.xml:1158
+#, no-c-format
msgid "hibernate.query.substitutions true=1, false=0"
-msgstr ""
+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."
+#. 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 ""
+"Faria com que os símbolos <literal>true</literal> e <literal>false</literal> "
+"passasem a ser traduzidos para literais inteiro no SQL gerado."
-#: index.docbook:1165
+#. Tag: programlisting
+#: configuration.xml:1165
+#, no-c-format
msgid "hibernate.query.substitutions toLowercase=LOWER"
-msgstr ""
+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 ""
+msgstr "permitirá você renomear a função <literal>LOWER</literal> no SQL."
-#: index.docbook:1174
+#. Tag: title
+#: configuration.xml:1174
+#, no-c-format
msgid "Hibernate statistics"
-msgstr ""
+msgstr "Estatísticas do 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."
+#. 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 ""
+"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. "
+"Se você habilitar <literal>hibernate.generate_statistics</literal>, o "
+"Hibernate exibirá um número de métricas bastante útil ao ajustar um sistema "
+"via <literal>SessionFactory.getStatistics()</literal>. O Hibernate pode até "
+"ser configurado para exibir essas estatísticas via JMX. Leia o Javadoc da "
+"interface <literal>org.hibernate.stats</literal> para mais informações."
-#: index.docbook:1188
+#. Tag: title
+#: configuration.xml:1188
+#, no-c-format
msgid "Logging"
-msgstr ""
+msgstr "Logging"
-#: index.docbook:1190
+#. Tag: para
+#: configuration.xml:1190
+#, no-c-format
msgid "Hibernate logs various events using Apache commons-logging."
-msgstr ""
+msgstr "Hibernate registra vários eventos usando Apache commons-logging."
-#: 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."
+#. 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 ""
+"O serviço commons-logging direcionará a saída para o Apache Log4j ( se você "
+"incluir <literal>log4j.jar</literal>r no seu classpath) ou JDK1.4 logging"
+"( se estiver em uso JDK1.4 ou maior). Você pode fazer o download do Log4j a "
+"partir de <literal>http://jakarta.apache.org</literal>. Para usar Log4j você "
+"necessitará colocar um arquivo <literal>log4j.properties</literal> no seu "
+"classpath, um exemplo de arquivo de propriedades é distribuído com o "
+"Hibernate no diretório <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:"
+#. 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 ""
+"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: Nós recomendamos enfaticamente que você se familiarize-se com "
+"mensagens de log do Hibernate. Uma parte do trabalho tem sido posto em fazer "
+"o log Hibernate tão detalhado quanto possível, sem fazê-lo ilegível. É um "
+"essencial dispositivos de controle de erros. As categorias de log mais "
+"interessantes são as seguintes:"
-#: index.docbook:1213
+#. Tag: title
+#: configuration.xml:1213
+#, no-c-format
msgid "Hibernate Log Categories"
-msgstr ""
+msgstr "Categorias de Log do Hibernate"
-#: index.docbook:1219
+#. Tag: entry
+#: configuration.xml:1219
+#, no-c-format
msgid "Category"
-msgstr ""
+msgstr "Categoria"
-#: index.docbook:1220
+#. Tag: entry
+#: configuration.xml:1220
+#, no-c-format
msgid "Function"
-msgstr ""
+msgstr "Função"
-#: index.docbook:1225
+#. Tag: literal
+#: configuration.xml:1225
+#, no-c-format
msgid "org.hibernate.SQL"
-msgstr ""
+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 ""
+msgstr "Registra todas as instruções SQL DML a medida que elas são executadas"
-#: index.docbook:1229
+#. Tag: literal
+#: configuration.xml:1229
+#, no-c-format
msgid "org.hibernate.type"
-msgstr ""
+msgstr "org.hibernate.type"
-#: index.docbook:1230
+#. Tag: entry
+#: configuration.xml:1230
+#, no-c-format
msgid "Log all JDBC parameters"
-msgstr ""
+msgstr "Registra todos os parâmetros JDBC"
-#: index.docbook:1233
+#. Tag: literal
+#: configuration.xml:1233
+#, no-c-format
msgid "org.hibernate.tool.hbm2ddl"
-msgstr ""
+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 ""
+msgstr "Registra todas as instruções SQL DDL a medida que elas são executadas"
-#: index.docbook:1237
+#. Tag: literal
+#: configuration.xml:1237
+#, no-c-format
msgid "org.hibernate.pretty"
-msgstr ""
+msgstr "org.hibernate.pretty"
-#: index.docbook:1238
-msgid "Log the state of all entities (max 20 entities) associated with the session at flush time"
+#. 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 ""
+"Log the state of all entities (max 20 entities) associated with the session "
+"at flush time Registra o estado de todas as entidades (máximo 20 entidades) "
+"associadas a session no momento da limpeza (flush)."
-#: index.docbook:1244
+#. Tag: literal
+#: configuration.xml:1244
+#, no-c-format
msgid "org.hibernate.cache"
-msgstr ""
+msgstr "org.hibernate.cache"
-#: index.docbook:1245
+#. Tag: entry
+#: configuration.xml:1245
+#, no-c-format
msgid "Log all second-level cache activity"
-msgstr ""
+msgstr "Registra todas as atividades de cachê de segundo nível"
-#: index.docbook:1248
+#. Tag: literal
+#: configuration.xml:1248
+#, no-c-format
msgid "org.hibernate.transaction"
-msgstr ""
+msgstr "org.hibernate.transaction"
-#: index.docbook:1249
+#. Tag: entry
+#: configuration.xml:1249
+#, no-c-format
msgid "Log transaction related activity"
-msgstr ""
+msgstr "Registra atividades relacionada a transação"
-#: index.docbook:1252
+#. Tag: literal
+#: configuration.xml:1252
+#, no-c-format
msgid "org.hibernate.jdbc"
-msgstr ""
+msgstr "org.hibernate.jdbc"
-#: index.docbook:1253
+#. Tag: entry
+#: configuration.xml:1253
+#, no-c-format
msgid "Log all JDBC resource acquisition"
-msgstr ""
+msgstr "Registra todas as requisições de recursos JDBC"
-#: index.docbook:1256
+#. Tag: literal
+#: configuration.xml:1256
+#, no-c-format
msgid "org.hibernate.hql.ast.AST"
-msgstr ""
+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 ""
+msgstr "Registra instruções SQL e HQL durante a análise da consultas"
-#: index.docbook:1262
+#. Tag: literal
+#: configuration.xml:1262
+#, no-c-format
msgid "org.hibernate.secure"
-msgstr ""
+msgstr "org.hibernate.secure"
-#: index.docbook:1263
+#. Tag: entry
+#: configuration.xml:1263
+#, no-c-format
msgid "Log all JAAS authorization requests"
-msgstr ""
+msgstr "Registra todas as requisições de autorização JAAS"
-#: index.docbook:1266
+#. Tag: literal
+#: configuration.xml:1266
+#, no-c-format
msgid "org.hibernate"
-msgstr ""
+msgstr "org.hibernate"
-#: index.docbook:1267
-msgid "Log everything (a lot of information, but very useful for troubleshooting)"
+#. Tag: entry
+#: configuration.xml:1267
+#, no-c-format
+msgid ""
+"Log everything (a lot of information, but very useful for troubleshooting)"
msgstr ""
+"Registra tudo ( uma parte das informações, mas muito útil para controle de "
+"erros )"
-#: 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."
+#. 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 ""
+"Quando desenvolver aplicações com Hibernate, você deve quase sempre "
+"trabalhar com debug <literal>debug</literal> para a categoria <literal>org."
+"hibernate.SQL</literal>, ou, alternativamente, a com a propriedade "
+"<literal>hibernate.show_sql</literal> habilitada."
-#: index.docbook:1286
+#. Tag: title
+#: configuration.xml:1286
+#, no-c-format
msgid "Implementing a <literal>NamingStrategy</literal>"
-msgstr ""
+msgstr "Implementado uma <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."
+#. 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 ""
+"A interface <literal>org.hibernate.cfg.NamingStrategy</literal> permite você "
+"especificar um \"padrão de nomeação\" para objetos do banco de dados e "
+"elementos schema."
-#: 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."
+#. 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 ""
+"Você deve criar regras para a geração automaticamente de identificadores do "
+"banco de dados a partir de identificadores Java ou para processar colunas "
+"\"computadas\" e nomes de tabelas dado o arquivo de mapeamento para nomes "
+"\"físicos\" de tabelas e colunas. Esta característica ajuda a reduzir a "
+"verbosidade do documento de mapeamento, eliminando interferências repetitivas"
+"( <literal>TBL_</literal>prefixos, por exemplo). A estratégia default usada "
+"pelo Hibernate é completamente mínima."
-#: index.docbook:1302
-msgid "You may specify a different strategy by calling <literal>Configuration.setNamingStrategy()</literal> before adding mappings:"
+#. 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 ""
+"Você pode especificar uma estratégia diferente ao chamar "
+"<literal>Configuration.setNamingStrategy()</literal> antes de adicionar os "
+"mapeamentos:"
-#: 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 ""
-#: 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."
+#. 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> é uma estratégia "
+"interna que pode ser um ponto de começo útil para algumas aplicações."
-#: index.docbook:1317
+#. Tag: title
+#: configuration.xml:1317
+#, no-c-format
msgid "XML configuration file"
-msgstr ""
+msgstr "Arquivo de configuração 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."
+#. 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 ""
+"Uma maneira alternativa de configuração é especificar uma configuração "
+"completa em um arquivo chamado <literal>hibernate.cfg.xml</literal>. Este "
+"arquivo pode ser usado como um substituto para o arquivo <literal>hibernate."
+"properties</literal> ou, se ambos estão presentes, sobrescrever propriedades."
-#: 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:"
+#. 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 ""
+"The XML configuration file is by default expected to be in the root o your "
+"<literal>CLASSPATH</literal>. Here is an example: O arquivo XML de "
+"configuração é por default esperado para estar na raiz do seu "
+"<literal>CLASSPATH</literal>. Veja um exemplo:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Como você pode ver, a vantagem deste enfoque é a externalização dos nomes "
+"dos arquivos de mapeamento para configuração. O <literal>hibernate.cfg.xml</"
+"literal> também é mais conveniente caso você tenha que ajustar o cache do "
+"Hibernate. Note que a escolha é sua em usar <literal>hibernate.properties</"
+"literal> ou <literal>hibernate.cfg.xml</literal>, ambos são equivalente, à "
+"exceção dos benefícios acima mencionados de usar a sintaxe de 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 ""
+"Com a configuração do XML, iniciar o Hibernate é então tão simples como"
-#: index.docbook:1346
-msgid "<![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 ""
+msgstr "You can pick a different XML configuration file using"
-#: 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 ""
-#: index.docbook:1357
+#. Tag: title
+#: configuration.xml:1357
+#, no-c-format
msgid "J2EE Application Server integration"
-msgstr ""
+msgstr "Integração com servidores de aplicação J2EE"
-#: index.docbook:1359
+#. Tag: para
+#: configuration.xml:1359
+#, no-c-format
msgid "Hibernate has the following integration points for J2EE infrastructure:"
msgstr ""
+"O Hibernate tem os seguintes pontos da integração para o infraestrutura de "
+"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."
+#. 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>DataSources gerenciados pelo container</emphasis>: O Hibernate "
+"pode usar conexões JDBC gerenciadas pelo Container e fornecidas pela JNDI. "
+"Geralmente, um <literal>TransactionManager</literal> compatível com JTA e um "
+"<literal>ResourceManager</literal> cuidam do gerenciamento da transação "
+"( CMT ), especialmente em transações distribuídas manipuladas através de "
+"vários DataSources. Naturalmente, você também pode demarcar os limites das "
+"transações programaticamente (BMT) ou você poderia querer usar a API "
+"opcional do Hibernate <literal>Transaction</literal> para esta manter seu "
+"código portável."
-#: index.docbook:1380
-msgid "<emphasis>Automatic JNDI binding</emphasis>: Hibernate can bind its <literal>SessionFactory</literal> to JNDI after startup."
+#. 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>Ligação (binding) automática a JNDI</emphasis>: O Hibernate pode "
+"associar sua <literal>SessionFactory</literal> a JNDI depois de iniciado."
-#: 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)."
+#. 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>Ligação (binding) Session na JTA:</emphasis> A <literal>Session</"
+"literal> do Hibernate pode automaticamente ser ligada ao escopo da "
+"transações JTA. Simplesmente localizando a <literal>SessionFactory</literal> "
+"da JNDI e obtendo a<literal>Session</literal> corrente. Deixe o Hibernate "
+"cuidar da limpeza e encerramento da <literal>Session</literal> quando as "
+"transações JTA terminarem. A Demarcação de transação pode ser declarativa "
+"(CMT) ou programática(BMT/Transação do usuário)."
-#: 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)."
+#. 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 deployment:</emphasis> Se você usa um JMX servidor de "
+"aplicações capaz (ex. Jboss AS), você pode fazer a instação do Hibernate "
+"como um Mbean controlado. Isto evita ter que iniciar uma linha de código "
+"para construir sua <literal>SessionFactory</literal> de uma "
+"<literal>Configuration</literal>. O container iniciará seu "
+"<literal>HibernateService</literal>, e idealmente também cuidará das "
+"dependências de serviços (DataSources, têm que estar disponíveis antes do "
+"Hibernate iniciar, etc.)."
-#: 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."
+#. 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 ""
+"Dependendo em seu ambiente, você poderia ter que ajustar a opção de "
+"configuração <literal>hibernate.connection.aggressive_release</literal> para "
+"verdadeiro ( true ), se seu servidor de aplicações lançar exeções \"retenção "
+"de conecção\"."
-#: index.docbook:1420
+#. Tag: title
+#: configuration.xml:1420
+#, no-c-format
msgid "Transaction strategy configuration"
-msgstr ""
+msgstr "Configuração de estratégia de transação"
-#: 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."
+#. 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 ""
+"A API Hibernate <literal>Session</literal> é independente de qualquer "
+"sistema de demarcação de transação em sua arquitetura. Se você deixar o "
+"Hibernate usar a JDBC diretamente, através de um pool de conexões, você pode "
+"inicializar e encerrar suas transações chamando a API JDBC. Se você rodar em "
+"um servidor de aplicações J2EE, você poderá usar transações controladas por "
+"beans e chamar a API JTA e <literal>UserTransaction</literal> quando "
+"necessário."
-#: 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>."
+#. 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 ""
+"Para manter seu código portável entre estes dois ( e outros ) ambientes, "
+"recomendamos a API Hibernate <literal>Transaction</literal>, que envolve e "
+"esconde o sistema subjacente. Você tem que especificar um classe construtora "
+"para <literal>Transaction</literal> instanciar ajustando a propriedade de "
+"configuração do <literal>hibernate.transaction.factory_class</literal>."
-#: index.docbook:1437
+#. Tag: para
+#: configuration.xml:1437
+#, no-c-format
msgid "There are three standard (built-in) choices:"
-msgstr ""
+msgstr "Existem três escolhas (internas) padrões:"
-#: index.docbook:1443
+#. Tag: literal
+#: configuration.xml:1443
+#, no-c-format
msgid "org.hibernate.transaction.JDBCTransactionFactory"
-msgstr ""
+msgstr "org.hibernate.transaction.JDBCTransactionFactory"
-#: index.docbook:1445
+#. Tag: para
+#: configuration.xml:1445
+#, no-c-format
msgid "delegates to database (JDBC) transactions (default)"
-msgstr ""
+msgstr "delegada as transações (JDBC)a bases de dados (Padrão)"
-#: index.docbook:1449
+#. Tag: literal
+#: configuration.xml:1449
+#, no-c-format
msgid "org.hibernate.transaction.JTATransactionFactory"
-msgstr ""
+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."
+#. 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 ""
+"delegada a transação a um container gerenciador se a transação existente "
+"estiver de acordo neste contexto (ex: método bean sessão EJB), se não uma "
+"nova transação é iniciada e uma transação controlado por um bean é usada."
-#: index.docbook:1459
+#. Tag: literal
+#: configuration.xml:1459
+#, no-c-format
msgid "org.hibernate.transaction.CMTTransactionFactory"
-msgstr ""
+msgstr "org.hibernate.transaction.CMTTransactionFactory"
-#: index.docbook:1461
+#. Tag: para
+#: configuration.xml:1461
+#, no-c-format
msgid "delegates to container-managed JTA transactions"
-msgstr ""
+msgstr "delega para um container gerenciador de transações JTA"
-#: index.docbook:1466
-msgid "You may also define your own transaction strategies (for a CORBA transaction service, for example)."
+#. 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 ""
+"Você também pode definir suas próprias estratégias de transação ( para um "
+"serviço de transação CORBA por exemplo)."
-#: 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:"
+#. 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 ""
+"Algumas características no Hibernate (ex., o cache de segundo nível, sessões "
+"contextuais com JTA, etc.) requerem acesso a JTA "
+"<literal>TransactionManager</literal> em um ambiente controlado. Em um "
+"servidor de aplicação você tem que especificar como o Hibernate pode obter "
+"uma referência para a <literal>TransactionManager</literal>, pois o J2EE não "
+"padronize um mecanismo simples :"
-#: index.docbook:1479
+#. Tag: title
+#: configuration.xml:1479
+#, no-c-format
msgid "JTA TransactionManagers"
-msgstr ""
+msgstr "Gerenciadores de transações JTA"
-#: index.docbook:1485
+#. Tag: entry
+#: configuration.xml:1485
+#, no-c-format
msgid "Transaction Factory"
-msgstr ""
+msgstr "Transaction Factory"
-#: index.docbook:1486
+#. Tag: entry
+#: configuration.xml:1486
+#, no-c-format
msgid "Application Server"
-msgstr ""
+msgstr "Application Server"
-#: index.docbook:1491
+#. Tag: literal
+#: configuration.xml:1491
+#, no-c-format
msgid "org.hibernate.transaction.JBossTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.JBossTransactionManagerLookup"
-#: index.docbook:1492
+#. Tag: entry
+#: configuration.xml:1492
+#, no-c-format
msgid "JBoss"
-msgstr ""
+msgstr "JBoss"
-#: index.docbook:1495
+#. Tag: literal
+#: configuration.xml:1495
+#, no-c-format
msgid "org.hibernate.transaction.WeblogicTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.WeblogicTransactionManagerLookup"
-#: index.docbook:1496
+#. Tag: entry
+#: configuration.xml:1496
+#, no-c-format
msgid "Weblogic"
-msgstr ""
+msgstr "Weblogic"
-#: index.docbook:1499
+#. Tag: literal
+#: configuration.xml:1499
+#, no-c-format
msgid "org.hibernate.transaction.WebSphereTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.WebSphereTransactionManagerLookup"
-#: index.docbook:1500
+#. Tag: entry
+#: configuration.xml:1500
+#, no-c-format
msgid "WebSphere"
-msgstr ""
+msgstr "WebSphere"
-#: index.docbook:1503
+#. Tag: literal
+#: configuration.xml:1503
+#, no-c-format
msgid "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.WebSphereExtendedJTATransactionLookup"
-#: index.docbook:1504
+#. Tag: entry
+#: configuration.xml:1504
+#, no-c-format
msgid "WebSphere 6"
-msgstr ""
+msgstr "WebSphere 6"
-#: index.docbook:1507
+#. Tag: literal
+#: configuration.xml:1507
+#, no-c-format
msgid "org.hibernate.transaction.OrionTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.OrionTransactionManagerLookup"
-#: index.docbook:1508
+#. Tag: entry
+#: configuration.xml:1508
+#, no-c-format
msgid "Orion"
-msgstr ""
+msgstr "Orion"
-#: index.docbook:1511
+#. Tag: literal
+#: configuration.xml:1511
+#, no-c-format
msgid "org.hibernate.transaction.ResinTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.ResinTransactionManagerLookup"
-#: index.docbook:1512
+#. Tag: entry
+#: configuration.xml:1512
+#, no-c-format
msgid "Resin"
-msgstr ""
+msgstr "Resin"
-#: index.docbook:1515
+#. Tag: literal
+#: configuration.xml:1515
+#, no-c-format
msgid "org.hibernate.transaction.JOTMTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.JOTMTransactionManagerLookup"
-#: index.docbook:1516
+#. Tag: entry
+#: configuration.xml:1516
+#, no-c-format
msgid "JOTM"
-msgstr ""
+msgstr "JOTM"
-#: index.docbook:1519
+#. Tag: literal
+#: configuration.xml:1519
+#, no-c-format
msgid "org.hibernate.transaction.JOnASTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.JOnASTransactionManagerLookup"
-#: index.docbook:1520
+#. Tag: entry
+#: configuration.xml:1520
+#, no-c-format
msgid "JOnAS"
-msgstr ""
+msgstr "JOnAS"
-#: index.docbook:1523
+#. Tag: literal
+#: configuration.xml:1523
+#, no-c-format
msgid "org.hibernate.transaction.JRun4TransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.JRun4TransactionManagerLookup"
-#: index.docbook:1524
+#. Tag: entry
+#: configuration.xml:1524
+#, no-c-format
msgid "JRun4"
-msgstr ""
+msgstr "JRun4"
-#: index.docbook:1527
+#. Tag: literal
+#: configuration.xml:1527
+#, no-c-format
msgid "org.hibernate.transaction.BESTransactionManagerLookup"
-msgstr ""
+msgstr "org.hibernate.transaction.BESTransactionManagerLookup"
-#: index.docbook:1528
+#. Tag: entry
+#: configuration.xml:1528
+#, no-c-format
msgid "Borland ES"
-msgstr ""
+msgstr "Borland ES"
-#: index.docbook:1537
+#. Tag: title
+#: configuration.xml:1537
+#, no-c-format
msgid "JNDI-bound <literal>SessionFactory</literal>"
-msgstr ""
+msgstr "<literal>SessionFactory</literal> ligada a 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!"
+#. 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 ""
+"Uma <literal>SessionFactory</literal> de Hibernate ligada a JNDI pode "
+"simplificar a localização da fabrica e a criação de novas <literal>Session</"
+"literal>s. Observe que isto não relacionado a um <literal>Datasource</"
+"literal> ligado a JNDI, simplemente ambos usam o mesmo registro!"
-#: 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.)"
+#. 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 ""
+"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.)"
-#: 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."
+#. 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 ""
+"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."
-#: 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)."
+#. 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 ""
+"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)."
-#: 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."
+#. 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 ""
+"If you use a JNDI <literal>SessionFactory</literal>, an EJB or any other "
+"class may obtain the <literal>SessionFactory</literal> using a JNDI lookup."
-#: 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—see chapter 1."
+#. 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—see chapter 1."
msgstr ""
+"We recommend that you bind the <literal>SessionFactory</literal> to JNDI in "
+"a managend 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—see chapter 1."
-#: index.docbook:1585
+#. Tag: title
+#: configuration.xml:1585
+#, no-c-format
msgid "Current Session context management with JTA"
-msgstr ""
+msgstr "Current Session context management with 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."
+#. 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 ""
+"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</xref>. 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."
-#: index.docbook:1610
+#. Tag: title
+#: configuration.xml:1610
+#, no-c-format
msgid "JMX deployment"
-msgstr ""
+msgstr "JMX deployment"
-#: 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>."
+#. 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 ""
+"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>."
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
+#~ msgid "<placeholder-1/> (optional)"
+#~ msgstr "<placeholder-1/> (opcional)"
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
+#~ msgid "InitialContextFactory"
+#~ msgstr "InitialContextFactory"
+#~ msgid "class of the JNDI <placeholder-1/>"
+#~ msgstr "Classe do JNDI <placeholder-1/>"
+
+#, fuzzy
+#~ msgid "eg."
+#~ msgstr ""
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "Ex.\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "eg."
+
+#~ 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"
+
+#, fuzzy
+#~ msgid "SessionFactory"
+#~ msgstr ""
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "SessionFactory\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "SessionFactory\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "SessionFactory\n"
+#~ "#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+#~ "create-drop"
+
+#~ 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 "true"
+
+#~ msgid "executeBatch()"
+#~ msgstr "executeBatch()"
+
+#~ 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 "<propertyName>"
+
+#, fuzzy
+#~ msgid "<propertyName>"
+#~ 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 "Passa a propriedade JDBC <placeholder-1/> para <placeholder-2/>."
+
+#~ msgid "hibernate.jndi."
+#~ msgstr "<propertyName>"
+
+#~ msgid "Pass the property <placeholder-1/> to the JNDI <placeholder-2/>."
+#~ msgstr "Passar a propriedade <placeholder-1/> para o <placeholder-2/> JNDI."
+
+#~ msgid "CacheProvider"
+#~ msgstr "CacheProvider"
+
+#~ msgid "classname.of.CacheProvider"
+#~ msgstr "classname.of.CacheProvider"
+
+#~ msgid "<cache>"
+#~ msgstr "<cache>"
+
+#~ msgid "QueryCache"
+#~ msgstr "QueryCache"
+
+#~ msgid "StandardQueryCache"
+#~ msgstr "StandardQueryCache"
+
+#~ msgid "classname.of.QueryCache"
+#~ msgstr "classname.of.QueryCache"
+
+#~ msgid "prefix"
+#~ msgstr "prefix"
+
+#~ msgid "TransactionFactory"
+#~ msgstr "TransactionFactory"
+
+#~ msgid "Transaction"
+#~ msgstr "Transaction"
+
+#~ msgid "JDBCTransactionFactory"
+#~ msgstr "JDBCTransactionFactory"
+
+#~ msgid "classname.of.TransactionFactory"
+#~ msgstr "classname.of.TransactionFactory"
+
+#~ msgid "JTATransactionFactory"
+#~ msgstr "JTATransactionFactory"
+
+#~ msgid "UserTransaction"
+#~ msgstr "UserTransaction"
+
+#~ 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/pt-BR/content/events.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/events.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/events.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,245 +1,481 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Interceptadores e Eventos"
-#: 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."
+#. 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 ""
+"É muito útil quando a aplicação precisa executar alguma \"coisa\" no momento "
+"em que o Hibernate executa uma de suas ações. Isso permite a implementação "
+"de certas funções genéricas, assim como permite estender as funcionalidades "
+"do Hibernate"
-#: index.docbook:14
+#. Tag: title
+#: events.xml:14
+#, no-c-format
msgid "Interceptors"
-msgstr ""
+msgstr "Interceptadores"
-#: 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."
+#. 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 ""
+"A interface <literal>Interceptor</literal> permite fornecer informações da "
+"session para o aplicativo, permitindo ao aplicativo inspecionar e/ou "
+"manipular as propriedades de um objeto persistente antes de ser salvo, "
+"atualizado, excluído ou salvo. Um dos possíveis usos é gerar informações de "
+"auditoria. Por exemplo, o seguinte <literal>Interceptor</literal> seta "
+"automaticamente o atributo <literal>createTimestamp</literal> quando um "
+"<literal>Auditable</literal> é criada e atualiza o atributo "
+"<literal>lastUpdateTimestamp</literal> quando um <literal>Auditable</"
+"literal> é atualizado."
-#: index.docbook:27
-msgid "You may either implement <literal>Interceptor</literal> directly or (better) extend <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 ""
+"Você pode implementar <literal>Auditable</literal> diretamente ou pode "
+"estender <literal>EmptyInterceptor</literal>, sendo que a segunda é "
+"considerada a melhor opção."
-#: 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 ""
-#: index.docbook:34
-msgid "Interceptors come in two flavors: <literal>Session</literal>-scoped and <literal>SessionFactory</literal>-scoped."
+#. Tag: para
+#: events.xml:34
+#, no-c-format
+msgid ""
+"Interceptors come in two flavors: <literal>Session</literal>-scoped and "
+"<literal>SessionFactory</literal>-scoped."
msgstr ""
+"Os interceptadores podem ser aplicados em dois diferentes escopos: No escopo "
+"da <literal>Session</literal> e no escopo <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>."
+#. 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 ""
+"Um interceptador no escopo da <literal>Session</literal> é definido quando "
+"uma sessão é aberta usando o método sobrecarregado da SessionFactory."
+"openSession() que aceita um <literal>Interceptor</literal> como parâmetro."
-#: index.docbook:45
+#. Tag: programlisting
+#: events.xml:45
+#, no-c-format
msgid "<![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."
+#. 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 ""
+"Um interceptador no escopo da <literal>SessionFactory</literal> é definido "
+"no objeto <literal>Configuration</literal> antes da <literal>SessionFactory</"
+"literal> ser instanciada. Nesse caso, o interceptador fornecido será "
+"aplicado para todas as sessões abertas por aquela <literal>SessionFactory</"
+"literal>; Isso apenas não ocorrerá caso seja especificado um interceptador "
+"no momento em que a sessão for aberta. Um interceptador no escopo de "
+"<literal>SessionFactory</literal> deve ser thread safe, tomando-se o cuidado "
+"de não armazenar atributos de estado específicos da sessão, pois, "
+"provavelmente, múltiplas sessões irão utilizar esse interceptador "
+"simultaneamente."
-#: index.docbook:56
-msgid "<![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 ""
+msgstr "Sistema de Eventos"
-#: 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."
+#. 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 ""
+"Se você precisa executar uma ação em determinados eventos da camada de "
+"persistência, você também pode usar a arquitetura de <emphasis>event</"
+"emphasis> do Hibernate3. Um evento do sistema pode ser utilizado como "
+"complemento ou em substituição a um interceptador."
-#: 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>."
+#. 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 ""
+"Essencialmente todos os métodos da interface <literal>Session</literal> "
+"possuem um evento correlacionado. Se você tiver um <literal>LoadEvent</"
+"literal>, um <literal>LoadEvent</literal>, etc (consulte o DTD do XML de "
+"configuração ou o pacote <literal>org.hibernate.event</literal> para a lista "
+"completa dos tipos de eventos). Quando uma requisição é feita em um desses "
+"métodos, a <literal>Session</literal> do hibernate gera um evento apropriado "
+"e o envia para o listener de evento correspondente àquele tipo de evento. "
+"Esses listeners implementam a mesma lógica que aqueles métodos, trazendo os "
+"mesmos resultados. Entretanto, você é livre para implementar uma "
+"customização de um desses listeners (isto é, o <literal>LoadEvent</literal> "
+"é processado pela implementação registrada da interface "
+"<literal>LoadEventListener</literal>), então sua implementação vai ficar "
+"responsável por processar qualquer requisição <literal>load()</literal> "
+"feita pela <literal>Session</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."
+#. 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 ""
+"Para todos os efeitos esses listeners deve ser considerados singletons; ou "
+"seja, eles são compartilhados entre as requisições, e assim sendo, não devem "
+"salvar nenhum estado das variáveis instanciadas."
-#: 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:"
+#. 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 ""
+"Um listener personalizado deve implementar a interface referente ao evento a "
+"ser processado e/ou deve estender a classes base equivalente (ou mesmo os "
+"listeners padrões usados pelo Hibernate, eles não são declarados como finais "
+"com esse objetivo). O listener personalizado pode ser registrado "
+"programaticamente no objeto <literal>Configuration</literal>, ou "
+"declarativamente no XML de configuração do Hibernate (o registro do listener "
+"no propertie de configuração não é suportado). Aqui temos um exemplo de como "
+"carregar um listener personalizado:"
-#: 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 ""
-#: 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 ""
+"Você também precisa adicionar uma entrada no XML de configuração do "
+"Hibernate para registrar declarativamente qual listener deve se utilizado em "
+"conjunto com o listener padrão:"
-#: 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 ""
-#: index.docbook:108
+#. Tag: para
+#: events.xml:108
+#, no-c-format
msgid "Instead, you may register it programmatically:"
-msgstr ""
+msgstr "Ou, você pode registrar o listener programaticamente:"
-#: 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 ""
-#: index.docbook:114
-msgid "Listeners registered declaratively cannot share instances. If the same class name is used in multiple <literal><listener/></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."
+#. 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><listener/></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 ""
+"Listeners registrados declarativamente não compartilham da mesma instancia. "
+"Se o mesmo nome da classe é utilizado em vários elementos e <literal><"
+"listener/></literal>, cada um vai resultar em uma instancia separada "
+"dessa classe. Se você tem a necessidade de compartilhar uma instancia de um "
+"listener entre diversos tipos de listeners você deve registrar o listener "
+"programaticamente."
-#: 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."
+#. 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 ""
+"Mas porque implementar uma interface e definir o tipo específico durante a "
+"configuração? Bem, um listener pode implementar vários listeners de evento. "
+"Com o tipo sendo definido durante o registro, fica fácil ligar ou desligar "
+"listeners personalizados durante a configuração."
-#: index.docbook:132
+#. Tag: title
+#: events.xml:132
+#, no-c-format
msgid "Hibernate declarative security"
-msgstr ""
+msgstr "Hibernate declarative security"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:139
-msgid "First, you must configure the appropriate event listeners, to enable the use of JAAS authorization."
+#. 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 ""
+"First, you must configure the appropriate event listeners, to enable the use "
+"of JAAS authorization."
-#: 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 ""
-#: index.docbook:146
-msgid "Note that <literal><listener type=\"...\" class=\"...\"/></literal> is just a shorthand for <literal><event type=\"...\"><listener class=\"...\"/></event></literal> when there is exactly one listener for a particular event type."
+#. Tag: para
+#: events.xml:146
+#, no-c-format
+msgid ""
+"Note that <literal><listener type=\"...\" class=\"...\"/></literal> is "
+"just a shorthand for <literal><event type=\"...\"><listener class="
+"\"...\"/></event></literal> when there is exactly one listener for "
+"a particular event type."
msgstr ""
+"Note that <literal><listener type=\"...\" class=\"...\"/></literal> is "
+"just a shorthand for <literal><event type=\"...\"><listener class="
+"\"...\"/></event></literal> when there is exactly one listener for "
+"a particular event type."
-#: index.docbook:152
-msgid "Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to roles:"
+#. Tag: para
+#: events.xml:152
+#, no-c-format
+msgid ""
+"Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to "
+"roles:"
msgstr ""
+"Next, still in <literal>hibernate.cfg.xml</literal>, bind the permissions to "
+"roles:"
-#: 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 ""
-#: index.docbook:158
+#. Tag: para
+#: events.xml:158
+#, no-c-format
msgid "The role names are the roles understood by your JACC provider."
-msgstr ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+msgstr "The role names are the roles understood by your JACC provider."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/example_mappings.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,653 +1,802 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:20
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Exemplo: Vários Mapeamentos"
-#: index.docbook:22
+#. Tag: para
+#: example_mappings.xml:22
+#, no-c-format
msgid "This chapters shows off some more complex association mappings."
-msgstr ""
+msgstr "Este capitulo mostra algums mapeamentos de associações mais complexos."
-#: index.docbook:27
+#. Tag: title
+#: example_mappings.xml:27
+#, no-c-format
msgid "Employer/Employee"
-msgstr ""
+msgstr "Employer/Employee"
-#: 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."
+#. 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 ""
+"O modelo de seguinte relacionamento entre <literal>Employer</literal> e "
+"<literal>Employee</literal> utiliza uma entidade de classe atual "
+"(<literal>Employment</literal>) para representar a associação. Isto é feito "
+"porque pode-ser ter mais do que um período de trabalho para as duas partes "
+"envolvidas. Outros Componentes são usados para modelar valores monetários e "
+"os nomes do empregado."
-#: index.docbook:46
+#. Tag: para
+#: example_mappings.xml:46
+#, no-c-format
msgid "Heres a possible mapping document:"
-msgstr ""
+msgstr "Abaixo o código de um possível mapeamento:"
-#: 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 ""
-#: 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 ""
+"E abaixo o esquema da tabela gerado pelo <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 ""
-#: index.docbook:61
+#. Tag: title
+#: example_mappings.xml:61
+#, no-c-format
msgid "Author/Work"
-msgstr ""
+msgstr "Author/Work"
-#: 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>."
+#. 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 ""
+"Considere o seguinte modelo de relacionamento entre <literal>Work</literal>, "
+"<literal>Author</literal> e <literal>Person</literal>. Nós representamos o "
+"relacionamento entre <literal>Work</literal> e <literal>Author</literal> "
+"como uma associação muitos-para-muitos. Nós escolhemos representar o "
+"relacionamento entre <literal>Author</literal> e <literal>Person</literal> "
+"como uma associação um-para-um. Outra possibilidade seria ter "
+"<literal>Author</literal> extendendo <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 ""
+"O mapeamento do código seguinte representa corretamente estes "
+"relacionamentos:"
-#: 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 ""
-#: 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>."
+#. 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 ""
+"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>. Existem quatro tabelas neste "
+"mapeamento. <literal>works</literal>, <literal>authors</literal> e "
+"<literal>persons</literal> recebem os dados de work, author e person, "
+"respectivamente. <literal>author_work</literal> é uma tabela de associação "
+"que liga authors à works. Abaixo o esquema das tabelas, gerados pelo "
+"<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 ""
-#: index.docbook:100
+#. Tag: title
+#: example_mappings.xml:100
+#, no-c-format
msgid "Customer/Order/Product"
-msgstr ""
+msgstr "Customer/Order/Product"
-#: 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."
+#. 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 ""
+"Agora considere um modelo de relacionamento entre <literal>Customer</"
+"literal>, <literal>Order</literal> e <literal>LineItem</literal> e "
+"<literal>Product</literal>. Existe uma associação um-para-muitos entre "
+"<literal>Customer</literal> e <literal>Order</literal>, mas como devemos "
+"representar <literal>Order</literal> / <literal>LineItem</literal> / "
+"<literal>Product</literal>? Eu escolhi mapear LineItem como uma classe de "
+"associação representando a associação muitos-para-muitos entre "
+"<literal>Order</literal> and <literal>Product</literal>. No Hibernate, isto "
+"é conhecido como um elemento composto."
-#: index.docbook:122
+#. Tag: para
+#: example_mappings.xml:122
+#, no-c-format
msgid "The mapping document:"
-msgstr ""
+msgstr "O código do mapeamento:"
-#: 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 ""
-#: 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."
+#. 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> e <literal>products</literal> recebem os dados "
+"de customer, order, line_item e product, respectivamente. "
+"<literal>line_items</literal> também atua como uma tabela de associação "
+"ligando orders com products."
-#: 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 ""
-#: index.docbook:140
+#. Tag: title
+#: example_mappings.xml:140
+#, no-c-format
msgid "Miscellaneous example mappings"
-msgstr ""
+msgstr "Exemplos variados de mapeamento"
-#: 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."
+#. 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 ""
+"Todos estes exemplos são retirados do conjunto de testes do Hibernate. Lá, "
+"você encontrará vários outros exemplos úteis de mapeamentos. Verifique o "
+"diretorio <literal>test</literal> da distribuição do Hibernate."
-#: index.docbook:148
+#. Tag: para
+#: example_mappings.xml:148
+#, no-c-format
msgid "TODO: put words around this stuff"
-msgstr ""
+msgstr "TODO: put words around this stuff"
-#: index.docbook:151
+#. Tag: title
+#: example_mappings.xml:151
+#, no-c-format
msgid "\"Typed\" one-to-one association"
-msgstr ""
+msgstr "Associação um-para-um \"Tipadas\""
-#: 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 ""
-#: index.docbook:156
+#. Tag: title
+#: example_mappings.xml:156
+#, no-c-format
msgid "Composite key example"
-msgstr ""
+msgstr "Exemplo de chave composta"
-#: 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 ""
-#: index.docbook:161
+#. Tag: title
+#: example_mappings.xml:161
+#, no-c-format
msgid "Many-to-many with shared composite key attribute"
-msgstr ""
+msgstr "Mmuitos-para-muitos com atributo de chave composta compartilhada"
-#: 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 ""
-#: index.docbook:166
+#. Tag: title
+#: example_mappings.xml:166
+#, no-c-format
msgid "Content based discrimination"
-msgstr ""
+msgstr "Conteúdo baseado em descriminação"
-#: 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 ""
-#: index.docbook:171
+#. Tag: title
+#: example_mappings.xml:171
+#, no-c-format
msgid "Associations on alternate keys"
-msgstr ""
+msgstr "Associações em chaves alternativas"
-#: 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
Modified: core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/example_parentchild.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,287 +1,605 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Example: Parent/Child"
-#: 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><one-to-many></literal> association from <literal>Parent</literal> to <literal>Child</literal>. (The alternative approach is to declare the <literal>Child</literal> as a <literal><composite-element></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!"
+#. 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><one-to-many></literal> "
+"association from <literal>Parent</literal> to <literal>Child</literal>. (The "
+"alternative approach is to declare the <literal>Child</literal> as a "
+"<literal><composite-element></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 ""
+"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><one-to-many></literal> "
+"association from <literal>Parent</literal> to <literal>Child</literal>. (The "
+"alternative approach is to declare the <literal>Child</literal> as a "
+"<literal><composite-element></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!"
-#: index.docbook:21
+#. Tag: title
+#: example_parentchild.xml:21
+#, no-c-format
msgid "A note about collections"
-msgstr ""
+msgstr "A note about collections"
-#: 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:"
+#. 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 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:"
-#: index.docbook:30
-msgid "When we remove / add an object from / to a collection, the version number of the collection owner is incremented."
+#. 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 ""
+"When we remove / add an object from / to a collection, the version number of "
+"the collection owner is incremented."
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:64
+#. Tag: title
+#: example_parentchild.xml:64
+#, no-c-format
msgid "Bidirectional one-to-many"
-msgstr ""
+msgstr "Bidirectional one-to-many"
-#: index.docbook:66
-msgid "Suppose we start with a simple <literal><one-to-many></literal> association from <literal>Parent</literal> to <literal>Child</literal>."
+#. Tag: para
+#: example_parentchild.xml:66
+#, no-c-format
+msgid ""
+"Suppose we start with a simple <literal><one-to-many></literal> "
+"association from <literal>Parent</literal> to <literal>Child</literal>."
msgstr ""
+"Suppose we start with a simple <literal><one-to-many></literal> "
+"association from <literal>Parent</literal> to <literal>Child</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 ""
-#: index.docbook:73
+#. Tag: para
+#: example_parentchild.xml:73
+#, no-c-format
msgid "If we were to execute the following code"
-msgstr ""
+msgstr "If we were to execute the following code"
-#: 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 ""
-#: index.docbook:79
+#. Tag: para
+#: example_parentchild.xml:79
+#, no-c-format
msgid "Hibernate would issue two SQL statements:"
-msgstr ""
+msgstr "Hibernate would issue two SQL statements:"
-#: index.docbook:85
-msgid "an <literal>INSERT</literal> to create the record for <literal>c</literal>"
+#. Tag: para
+#: example_parentchild.xml:85
+#, no-c-format
+msgid ""
+"an <literal>INSERT</literal> to create the record for <literal>c</literal>"
msgstr ""
+"an <literal>INSERT</literal> to create the record for <literal>c</literal>"
-#: index.docbook:88
-msgid "an <literal>UPDATE</literal> to create the link from <literal>p</literal> to <literal>c</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 ""
+"an <literal>UPDATE</literal> to create the link from <literal>p</literal> to "
+"<literal>c</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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: index.docbook:103
+#. Tag: para
+#: example_parentchild.xml:103
+#, no-c-format
msgid "However, this is not the recommended solution."
-msgstr ""
+msgstr "However, this is not the recommended solution."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:113
-msgid "<![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.)"
+#. 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 ""
+"(We also need to add the <literal>parent</literal> property to the "
+"<literal>Child</literal> class.)"
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: 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 ""
+msgstr "The following code would be used to add a new <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 ""
-#: 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 ""
+msgstr "And now, only one SQL <literal>INSERT</literal> would be issued!"
-#: index.docbook:136
-msgid "To tighten things up a bit, we could create an <literal>addChild()</literal> method of <literal>Parent</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 ""
+"To tighten things up a bit, we could create an <literal>addChild()</literal> "
+"method of <literal>Parent</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 ""
-#: 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 ""
+msgstr "Now, the code to add a <literal>Child</literal> looks like"
-#: 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 ""
-#: index.docbook:152
+#. Tag: title
+#: example_parentchild.xml:152
+#, no-c-format
msgid "Cascading life cycle"
-msgstr ""
+msgstr "Cascading life cycle"
-#: index.docbook:154
-msgid "The explicit call to <literal>save()</literal> is still annoying. We will address this by using cascades."
+#. 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 ""
+"The explicit call to <literal>save()</literal> is still annoying. We will "
+"address this by using cascades."
-#: 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 ""
-#: index.docbook:161
+#. Tag: para
+#: example_parentchild.xml:161
+#, no-c-format
msgid "This simplifies the code above to"
-msgstr ""
+msgstr "This simplifies the code above to"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: index.docbook:174
+#. Tag: para
+#: example_parentchild.xml:174
+#, no-c-format
msgid "However, this code"
-msgstr ""
+msgstr "However, this code"
-#: 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 ""
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: 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>."
+#. 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 ""
+"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>."
-#: index.docbook:206
+#. Tag: title
+#: example_parentchild.xml:206
+#, no-c-format
msgid "Cascades and <literal>unsaved-value</literal>"
-msgstr ""
+msgstr "Cascades and <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>"
+#. 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 ""
+"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>"
-#: index.docbook:220
-msgid "The following code will update <literal>parent</literal> and <literal>child</literal> and insert <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 ""
+"The following code will update <literal>parent</literal> and <literal>child</"
+"literal> and insert <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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:260
+#. Tag: title
+#: example_parentchild.xml:260
+#, no-c-format
msgid "Conclusion"
-msgstr ""
+msgstr "Conclusion"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:267
-msgid "We mentioned an alternative in the first paragraph. None of the above issues exist in the case of <literal><composite-element></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."
+#. 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><composite-element></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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"We mentioned an alternative in the first paragraph. None of the above issues "
+"exist in the case of <literal><composite-element></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."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/example_weblog.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,450 +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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Example: Weblog Application"
-#: index.docbook:8
+#. Tag: title
+#: example_weblog.xml:8
+#, no-c-format
msgid "Persistent Classes"
-msgstr ""
+msgstr "Persistent Classes"
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: 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 ""
-#: index.docbook:23
+#. Tag: title
+#: example_weblog.xml:23
+#, no-c-format
msgid "Hibernate Mappings"
-msgstr ""
+msgstr "Hibernate Mappings"
-#: index.docbook:25
+#. Tag: para
+#: example_weblog.xml:25
+#, no-c-format
msgid "The XML mappings should now be quite straightforward."
-msgstr ""
+msgstr "The XML mappings should now be quite straightforward."
-#: 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 ""
-#: 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 ""
-#: index.docbook:36
+#. Tag: title
+#: example_weblog.xml:36
+#, no-c-format
msgid "Hibernate Code"
-msgstr ""
+msgstr "Hibernate Code"
-#: index.docbook:38
-msgid "The following class demonstrates some of the kinds of things we can do with these classes, using Hibernate."
+#. Tag: para
+#: example_weblog.xml:38
+#, no-c-format
+msgid ""
+"The following class demonstrates some of the kinds of things we can do with "
+"these classes, using Hibernate."
msgstr ""
+"The following class demonstrates some of the kinds of things we can do with "
+"these classes, using Hibernate."
-#: index.docbook:43
+#. 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"
- "}]]>"
+"<![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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
Modified: core/trunk/documentation/manual/translations/pt-BR/content/filters.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/filters.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/filters.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,149 +1,290 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Filtrando dados"
-#: 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."
+#. 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 ""
+"O Hibernate3 provê um novo método inovador para manusear dados com regras de "
+"\"visibilidade\". Um <emphasis>Filtro do Hibernate</emphasis> é um filtro "
+"global, nomeado e parametrizado que pode se habilitado ou não dentro de um "
+"Session do Hibernate."
-#: index.docbook:14
+#. Tag: title
+#: filters.xml:14
+#, no-c-format
msgid "Hibernate filters"
-msgstr ""
+msgstr "Filtros do 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."
+#. 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 ""
+"O Hibernate tem a habilidade de pré definir os critérios do filtro e anexar "
+"esses filtros no nível da classe e no nível da coleção. Um critério do "
+"filtro é a habilidade de definir uma cláusula restritiva muito semelhante ao "
+"atributo \"where\" disponível para a classe e várias coleções. A não ser que "
+"essas condições de filtros podem ser parametrizadas. A aplicação pode, "
+"então, fazer uma decisão em tempo de execução se os filtros definidos devem "
+"estar habilitados e quais valores seus parâmetros devem ter. Os filtros "
+"podem ser usados como Views de bancos de dados, mas com parametros internos "
+"à aplicação."
-#: 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><filter-def/></literal> element within a <literal><hibernate-mapping/></literal> element:"
+#. 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><"
+"filter-def/></literal> element within a <literal><hibernate-mapping/"
+"></literal> element:"
msgstr ""
+"Para usar esses filtros, eles primeiramente devem ser definidos e anexados "
+"aos elementos do mapeamento apropriados. Para definir um filtro, use o "
+"elemento <literal><filter-def/></literal> dentro do elemento "
+"<literal><hibernate-mapping/></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 ""
-#: index.docbook:34
+#. Tag: para
+#: filters.xml:34
+#, no-c-format
msgid "Then, this filter can be attached to a class:"
-msgstr ""
+msgstr "Então esse filtro pode ser anexo à uma classe:"
-#: 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 ""
-#: index.docbook:40
+#. Tag: para
+#: filters.xml:40
+#, no-c-format
msgid "or, to a collection:"
-msgstr ""
+msgstr "ou em uma coleção:"
-#: 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 ""
-#: 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 ""
+msgstr "ou mesmo para ambos (ou muitos de cada) ao mesmo tempo."
-#: 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:"
+#. 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 ""
+"Os métodos na <literal>Session</literal> são: <literal>enableFilter(String "
+"filterName)</literal>, <literal>getEnabledFilter(String filterName)</"
+"literal>, e <literal>disableFilter(String filterName)</literal>. Por padrão, "
+"os filtros não são habilitados dentro de qualquer session; Eles devem ser "
+"explicitamente habilitados usando o método <literal>Session.enabledFilter()</"
+"literal>, que retorna uma instância da interface <literal>Filter</literal>. "
+"Usando o filtro simples definido acima, o código se pareceria com o seguinte:"
-#: index.docbook:59
-msgid "<![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."
+#. 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 ""
+"Veja que os métodos da interface org.hibernate.Filter permite o encadeamento "
+"de funções, comum à maioria das funções do 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 ""
+"Um exemplo completo, usando dados temporais com um padrão efetivo de "
+"registro de datas:"
-#: 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 ""
-#: 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:"
+#. Tag: para
+#: filters.xml:71
+#, no-c-format
+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 ""
+"Para garantir que você sempre tenha registro efetivos, simplesmente habilite "
+"o filtro na session antes de recuperar os dados dos empregados:"
-#: index.docbook:76
+#. 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"
- "]]>"
+"<![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: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."
+#. Tag: para
+#: filters.xml:78
+#, no-c-format
+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 ""
+"No HQL acima, mesmo que mencionamos apenas uma restrição de salário nos "
+"resultados, por causa do filtro habilitado, a consulta retornará apenas os "
+"funcionários ativos cujo salário é maior que um milhão de dólares."
-#: 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."
+#. 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 ""
+"Nota: se você planeja usar filtros com outer join (por HQL ou por load "
+"fetching) seja cuidadoso na direção da expressão de condição. É mais seguro "
+"configura-lo com para um left outer join; geralmente, coloque o parâmetro "
+"primeiro seguido pelo nome da coluna após o operador."
-#: 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><filter-def/></literal> allows defining a default condition, either as an attribute or CDATA:"
-msgstr ""
+#. 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><filter-def/></"
+"literal> allows defining a default condition, either as an attribute or "
+"CDATA:"
+msgstr "translator-credits"
-#: index.docbook:98
+#. 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>]]>"
+"<![CDATA[<filter-def name=\"myFilter\" condition=\"abc > xyz\">...</filter-"
+"def>\n"
+"<filter-def name=\"myOtherFilter\">abc=xyz</filter-def>]]>"
msgstr ""
-#: 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: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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
Modified: core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/inheritance_mapping.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,477 +1,851 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Mapeamento de Herança"
-#: index.docbook:8
+#. Tag: title
+#: inheritance_mapping.xml:8
+#, no-c-format
msgid "The Three Strategies"
-msgstr ""
+msgstr "As três estratégias"
-#: index.docbook:10
+#. Tag: para
+#: inheritance_mapping.xml:10
+#, no-c-format
msgid "Hibernate supports the three basic inheritance mapping strategies:"
msgstr ""
+"O Hibernate suporta as três estratégias básicas de mapeamento de herança:"
-#: index.docbook:16
+#. Tag: para
+#: inheritance_mapping.xml:16
+#, no-c-format
msgid "table per class hierarchy"
-msgstr ""
+msgstr "tabela por hierarquia de classes"
-#: index.docbook:21
+#. Tag: para
+#: inheritance_mapping.xml:21
+#, fuzzy, no-c-format
msgid "<para>table per subclass</para>"
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"tabela por subclasse\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 ""
+msgstr "tabela por classe concreta"
-#: index.docbook:32
-msgid "In addition, Hibernate supports a fourth, slightly different kind of polymorphism:"
+#. Tag: para
+#: inheritance_mapping.xml:32
+#, no-c-format
+msgid ""
+"In addition, Hibernate supports a fourth, slightly different kind of "
+"polymorphism:"
msgstr ""
+"Adicionalmente, o Hibernate suporta uma quarta, um tipo levemente diferente "
+"de polimorfismo:"
-#: index.docbook:39
+#. Tag: para
+#: inheritance_mapping.xml:39
+#, no-c-format
msgid "implicit polymorphism"
-msgstr ""
+msgstr "polimorfismo implícito"
-#: 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><subclass></literal>, and <literal><joined-subclass></literal> and <literal><union-subclass></literal> mappings under the same root <literal><class></literal> element. It is possible to mix together the table per hierarchy and table per subclass strategies, under the the same <literal><class></literal> element, by combining the <literal><subclass></literal> and <literal><join></literal> elements (see below)."
+#. 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><subclass></literal>, and <literal><"
+"joined-subclass></literal> and <literal><union-subclass></literal> "
+"mappings under the same root <literal><class></literal> element. It is "
+"possible to mix together the table per hierarchy and table per subclass "
+"strategies, under the the same <literal><class></literal> element, by "
+"combining the <literal><subclass></literal> and <literal><join></"
+"literal> elements (see below)."
msgstr ""
+"É possível usar diferentes estratégias de mapeamento para diferentes "
+"ramificações da mesma hierarquia de herança, e então fazer uso do "
+"polimorfismo implícito para alcançar polimorfismo através da hierarquia "
+"completa. De qualquer forma, O Hibernate não suporta a mistura de "
+"mapeamentos <literal><subclass></literal>, and <literal><joined-"
+"subclass></literal> e <literal><union-subclass></literal> dentro do "
+"mesmo elemento raiz <literal><class></literal>. É possível usar junto "
+"às estratégias tabela por hierarquia e a tabela por subclasse, abaixo do "
+"mesmo elemento <literal><class></literal>, combinando os elementos "
+"<literal><subclass></literal> e <literal><join></literal> (veja "
+"abaixo)."
-#: 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."
+#. 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 ""
+"É possível definir mapeamentos <literal>subclass</literal>, <literal>union-"
+"subclass</literal>, e <literal>joined-subclass</literal> em documentos de "
+"mapeamento separados, diretamente abaixo de <literal>hibernate-mapping</"
+"literal>. Isso permite a você estender uma hierarquia de classes apenas "
+"adicionando um novo arquivo de mapeamento. Você deve especificar um atributo "
+"<literal>extends</literal> no mapeamento da subclasse, nomeando uma "
+"superclasse previamente mapeada. Nota: Anteriormente esta característica "
+"fazia o ordenamento dos documentos de mapeamento importantes. Desde o "
+"Hibernate3, o ordenamento dos arquivos de mapeamento não importa quando "
+"usamos a palavra chave extends. O ordenamento dentro de um arquivo de "
+"mapeamento simples ainda necessita ser definido como superclasse antes de "
+"subclasse."
-#: 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 ""
-#: index.docbook:74
+#. Tag: title
+#: inheritance_mapping.xml:74
+#, no-c-format
msgid "Table per class hierarchy"
-msgstr ""
+msgstr "Tabela por hierarquia de classes"
-#: 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:"
+#. 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 ""
+"Suponha que tenhamos uma interface <literal>Payment</literal>, com sua "
+"implementação <literal>CreditCardPayment</literal>, <literal>CashPayment</"
+"literal>, <literal>ChequePayment</literal>. O mapeamento da tabela por "
+"hierarquia seria parecido com:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:94
+#. Tag: title
+#: inheritance_mapping.xml:94
+#, no-c-format
msgid "Table per subclass"
-msgstr ""
+msgstr "Tabela por subclasse"
-#: index.docbook:96
+#. Tag: para
+#: inheritance_mapping.xml:96
+#, no-c-format
msgid "A table per subclass mapping would look like:"
-msgstr ""
+msgstr "Um mapeamento de tabela por subclasse seria parecido com:"
-#: 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 ""
-#: 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)."
+#. 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 ""
+"Quatro tabelas são necessárias. As três tabelas subclasses possuem "
+"associação de chave primária para a tabela de superclasse (então o modelo "
+"relacional é atualmente uma associação de um-para-um)."
-#: index.docbook:111
+#. Tag: title
+#: inheritance_mapping.xml:111
+#, no-c-format
msgid "Table per subclass, using a discriminator"
-msgstr ""
+msgstr "Tabela por subclasse, usando um discriminador"
-#: 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><subclass></literal> and <literal><join></literal>, as follow:"
+#. 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><subclass></"
+"literal> and <literal><join></literal>, as follow:"
msgstr ""
+"Note que a implementação de tabela por subclasse do Hibernate não necessita "
+"de coluna de discriminador. Outro mapeador objeto/relacional usa uma "
+"implementação diferente de tabela por subclasse, que necessita uma coluna "
+"com o tipo discriminador na tabela da superclasse. A abordagem escolhida "
+"pelo Hibernate é muito mais difícil de implementar, porém de forma "
+"argumentável mais correto de um ponto de vista relacional. Se você deseja "
+"utilizar uma coluna discriminadora com a estratégia tabela por subclasse, "
+"você pode combinar o uso de <literal><subclass></literal> e "
+"<literal><join></literal>, dessa maneira:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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. A declaração opcional "
+"fetch=”select” diz ao Hibernate para não buscar os dados da subclasse "
+"ChequePayment, quando usar um outer join pesquisando pela superclasse."
-#: index.docbook:136
+#. Tag: title
+#: inheritance_mapping.xml:136
+#, no-c-format
msgid "Mixing table per class hierarchy with table per subclass"
-msgstr ""
+msgstr ". Misturando tabela por hierarquia de classes com tabela por subclasse"
-#: index.docbook:138
-msgid "You may even mix the table per hierarchy and table per subclass strategies using this approach:"
+#. 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 ""
+"Você pode até mesmo misturar a estratégia de tabela por hierarquia e tabela "
+"por subclasse usando esta abordagem:"
-#: 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 ""
-#: index.docbook:145
-msgid "For any of these mapping strategies, a polymorphic association to the root <literal>Payment</literal> class is mapped using <literal><many-to-one></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><many-to-one>"
+"</literal>."
msgstr ""
+"Para qualquer uma dessas estratégias de mapeamento, uma associação "
+"polimórfica para a classe raiz <literal>Payment</literal> deve ser mapeada "
+"usando <literal><many-to-one></literal>."
-#: index.docbook:151
-msgid "<![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 ""
+msgstr "Tabela por classe concreta"
-#: 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><union-subclass></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><union-subclass></literal>."
msgstr ""
+"Existem duas formas que poderíamos usar a respeito da estratégia de "
+"mapeamento de tabela por classe concreta. A primeira é usar <literal><"
+"union-subclass></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 ""
-#: index.docbook:165
-msgid "Three tables are involved for the subclasses. Each table defines columns for all properties of the class, including inherited properties."
+#. 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 ""
+"Três tabelas estão envolvidas para as subclasses. Cada tabela define colunas "
+"para todas as propriedades da classe, incluindo propriedades herdadas."
-#: 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."
+#. 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 ""
+"A limitação dessa abordagem é que se uma propriedade é mapeada na "
+"superclasse, o nome da coluna deve ser o mesmo em todas as tabelas das "
+"subclasses. (Nós devemos melhorar isto em um futuro release do Hibernate). A "
+"estratégia do gerador de identidade não é permitida em união de subclasses"
+"(union-subclass) herdadas, na verdade a fonte de chave primária deve ser "
+"compartilhada através de todas subclasses unidas da hierarquia."
-#: 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."
+#. 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 ""
+"Se sua superclasse é abstrata, mapeie ela com <literal>abstract=\"true\"</"
+"literal>. Claro, que se ela não for abstrata, uma tabela (padrão para "
+"<literal>PAYMENT</literal> no exemplo acima) adicional é necessária para "
+"segurar as instâncias da superclasse."
-#: index.docbook:189
+#. Tag: title
+#: inheritance_mapping.xml:189
+#, no-c-format
msgid "Table per concrete class, using implicit polymorphism"
-msgstr ""
+msgstr "Tabela por classe concreta, usando polimorfismo implícito"
-#: index.docbook:191
+#. Tag: para
+#: inheritance_mapping.xml:191
+#, no-c-format
msgid "An alternative approach is to make use of implicit polymorphism:"
-msgstr ""
+msgstr "Uma abordagem alternativa é fazer uso de polimorfismo implícito:"
-#: 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 ""
-#: 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>[ <!ENTITY allproperties SYSTEM \"allproperties.xml\"> ]</literal> in the <literal>DOCTYPE</literal> declartion and <literal>&allproperties;</literal> in the mapping)."
+#. 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>[ <!ENTITY allproperties SYSTEM "
+"\"allproperties.xml\"> ]</literal> in the <literal>DOCTYPE</literal> "
+"declartion and <literal>&allproperties;</literal> in the mapping)."
msgstr ""
+"Veja que em nenhum lugar mencionamos a interface <literal>Payment</literal> "
+"explicitamente. Também preste atenção que propriedades de <literal>Payment</"
+"literal> são mapeadas em cada uma das subclasses. Se você quer evitar "
+"duplicação, considere usar entidades de XML (ex. (e.g. <literal>[ <!"
+"ENTITY allproperties SYSTEM \"allproperties.xml\"> ]</literal> na "
+"declaração do <literal>DOCTYPE</literal> e <literal>&allproperties;</"
+"literal> no mapeamento)."
-#: index.docbook:207
-msgid "The disadvantage of this approach is that Hibernate does not generate SQL <literal>UNION</literal>s when performing polymorphic queries."
+#. 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 ""
+"A desvantagem dessa abordagem é que o Hibernate não gera <literal>UNION</"
+"literal>s SQL quando executa pesquisas polimórficas."
-#: index.docbook:212
-msgid "For this mapping strategy, a polymorphic association to <literal>Payment</literal> is usually mapped using <literal><any></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><any></literal>."
msgstr ""
+"Para essa estratégia, uma associação polimórfica para <literal>Payment</"
+"literal> geralmente é mapeada usando <literal><any></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 ""
-#: index.docbook:222
+#. Tag: title
+#: inheritance_mapping.xml:222
+#, no-c-format
msgid "Mixing implicit polymorphism with other inheritance mappings"
-msgstr ""
+msgstr "Misturando polimorfismo implícito com outros mapeamentos de herança"
-#: index.docbook:224
-msgid "There is one further thing to notice about this mapping. Since the subclasses are each mapped in their own <literal><class></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.)"
+#. 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><class></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 ""
+"Ainda existe uma coisa para ser observada com respeito a este mapeamento. "
+"Desde que as subclasses sejam mapeadas em seu próprio elemento <literal><"
+"class></literal> (e desde que <literal>Payment</literal> seja apenas uma "
+"interface), cada uma das subclasses pode ser facilmente parte de uma outra "
+"hierarquia de herança! (E você ainda pode usar pesquisas polimórficas em "
+"cima da interface <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 ""
-#: 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>."
+#. 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 ""
+"Mais uma vez, nós não mencionamos <literal>Payment</literal> explicitamente. "
+"Se nós executarmos uma pesquisa em cima da interface <literal>Payment</"
+"literal> – por exemplo, <literal>from Payment</literal> – o Hibernate "
+"retorna automaticamente instâncias de <literal>CreditCardPayment</literal> "
+"(e suas subclasses, desde que elas também implementem <literal>Payment</"
+"literal>), <literal>CashPayment</literal> e <literal>ChequePayment</literal> "
+"mas não as instâncias de <literal>NonelectronicTransaction</literal>."
-#: index.docbook:249
+#. Tag: title
+#: inheritance_mapping.xml:249
+#, no-c-format
msgid "Limitations"
-msgstr ""
+msgstr "Limitações"
-#: 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><union-subclass></literal> mappings."
+#. 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><union-subclass></literal> "
+"mappings."
msgstr ""
+"Existem certas limitações para a abordagem do \"polimorfismo implícito\" "
+"comparada com a estratégia de mapeamento da tabela por classe concreta. "
+"Existe uma limitação um tanto menos restritiva para mapeamentos <literal><"
+"union-subclass></literal>."
-#: index.docbook:258
-msgid "The following table shows the limitations of table per concrete-class mappings, and of implicit polymorphism, in Hibernate."
+#. 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 ""
+"A tabela seguinte demonstra as limitações do mapeamento de tabela por classe "
+"concreta e do polimorfismo implícito no Hibernate."
-#: index.docbook:264
+#. Tag: title
+#: inheritance_mapping.xml:264
+#, no-c-format
msgid "Features of inheritance mappings"
-msgstr ""
+msgstr "Features of inheritance mappings"
-#: index.docbook:276
+#. Tag: entry
+#: inheritance_mapping.xml:276
+#, no-c-format
msgid "Inheritance strategy"
-msgstr ""
+msgstr "Estratégia de Herança"
-#: index.docbook:277
+#. Tag: entry
+#: inheritance_mapping.xml:277
+#, no-c-format
msgid "Polymorphic many-to-one"
-msgstr ""
+msgstr "muitos-para-um Polimórfico"
-#: index.docbook:278
+#. Tag: entry
+#: inheritance_mapping.xml:278
+#, no-c-format
msgid "Polymorphic one-to-one"
-msgstr ""
+msgstr "um-para-um Polimórfico"
-#: index.docbook:279
+#. Tag: entry
+#: inheritance_mapping.xml:279
+#, no-c-format
msgid "Polymorphic one-to-many"
-msgstr ""
+msgstr "um-para-muitos Polimórfico"
-#: index.docbook:280
+#. Tag: entry
+#: inheritance_mapping.xml:280
+#, no-c-format
msgid "Polymorphic many-to-many"
-msgstr ""
+msgstr "muitos-para-muitos Polimórfico"
-#: index.docbook:281
+#. Tag: entry
+#: inheritance_mapping.xml:281
+#, no-c-format
msgid "Polymorphic <literal>load()/get()</literal>"
msgstr ""
-#: index.docbook:282
+#. Tag: entry
+#: inheritance_mapping.xml:282
+#, no-c-format
msgid "Polymorphic queries"
-msgstr ""
+msgstr "Pesquisas Polimórficas"
-#: index.docbook:283
+#. Tag: entry
+#: inheritance_mapping.xml:283
+#, no-c-format
msgid "Polymorphic joins"
-msgstr ""
+msgstr "Joins polimórficos"
-#: index.docbook:284
+#. Tag: entry
+#: inheritance_mapping.xml:284
+#, no-c-format
msgid "Outer join fetching"
-msgstr ""
+msgstr "Outer join fetching"
-#: index.docbook:289
+#. Tag: entry
+#: inheritance_mapping.xml:289
+#, no-c-format
msgid "table per class-hierarchy"
-msgstr ""
+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 "<many-to-one>"
-msgstr ""
+msgstr "<many-to-one>"
-#: 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 "<one-to-one>"
-msgstr ""
+msgstr "<one-to-one>"
-#: index.docbook:292, index.docbook:303
+#. Tag: literal
+#: inheritance_mapping.xml:292 inheritance_mapping.xml:303
+#, no-c-format
msgid "<one-to-many>"
-msgstr ""
+msgstr "<one-to-many>"
-#: 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 "<many-to-many>"
-msgstr ""
+msgstr "<many-to-many>"
-#: 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 ""
+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 ""
+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 ""
+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 ""
+msgstr "supported"
-#: index.docbook:300
+#. Tag: entry
+#: inheritance_mapping.xml:300
+#, fuzzy, no-c-format
msgid "<entry>table per subclass</entry>"
msgstr ""
+"#-#-#-#-# - (PACKAGE VERSION) #-#-#-#-#\n"
+"tabela por subclasse\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 ""
+msgstr "table per concrete-class (union-subclass)"
-#: index.docbook:314
-msgid "<literal><one-to-many></literal> (for <literal>inverse=\"true\"</literal> only)"
+#. Tag: entry
+#: inheritance_mapping.xml:314
+#, no-c-format
+msgid ""
+"<literal><one-to-many></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 ""
+msgstr "table per concrete class (implicit polymorphism)"
-#: index.docbook:323
+#. Tag: literal
+#: inheritance_mapping.xml:323
+#, no-c-format
msgid "<any>"
-msgstr ""
+msgstr "<any>"
-#: 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 ""
+msgstr "not supported"
-#: index.docbook:326
+#. Tag: literal
+#: inheritance_mapping.xml:326
+#, no-c-format
msgid "<many-to-any>"
-msgstr ""
+msgstr "<many-to-any>"
-#: index.docbook:327
-msgid "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/> Polimórfico"
+#~ 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/pt-BR/content/performance.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/performance.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/performance.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,1068 +1,2584 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Aumentando a performance"
-#: index.docbook:8
+#. Tag: title
+#: performance.xml:8
+#, no-c-format
msgid "Fetching strategies"
-msgstr ""
+msgstr "Estratégias de Fetching"
-#: 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."
+#. 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 ""
+"Uma <emphasis>estratégia de fetching</emphasis> é a estratégia que o "
+"Hibernate irá usar para buscar objetos associados se a aplicação precisar "
+"navegar pela associação. Estratégias de Fetch podem ser declaradas nos "
+"metadados de mapeamento O/R, ou sobrescritos por uma query HQL ou query com "
+"<literal>Criteria</literal>."
-#: index.docbook:17
+#. Tag: para
+#: performance.xml:17
+#, no-c-format
msgid "Hibernate3 defines the following fetching strategies:"
-msgstr ""
+msgstr "Hibernate3 define as seguintes estratégias de fetching:"
-#: 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>."
+#. 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>Join fetching</emphasis> - o Hibernate busca o objeto ou coleção "
+"associada no mesmo <literal>SELECT</literal>, usando um <literal>OUTER JOIN</"
+"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."
+#. 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>Select fetching</emphasis> - um segundo <literal>SELECT</literal> "
+"é usado para buscar a entidade ou coleção associada. A menos que você "
+"desabilite lazy fetching especificando <literal>lazy=\"false\"</literal>, "
+"esse segundo SELECT será executado apenas quando você acessar a associação."
-#: 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."
+#. 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>Subselect fetching</emphasis> - um segundo <literal>SELECT</"
+"literal> será usado para buscar as coleções associadas de todas as entidades "
+"buscadas na query ou fetch anterior. A menos que você desabilite lazy "
+"fetching especificando <literal>lazy=\"false\"</literal>, esse segundo "
+"SELECT será executado apenas quando você acessar a associação."
-#: 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."
+#. 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>Batch fetching</emphasis> - uma opção de otimização para o Select "
+"Fetching – O Hibernate busca um lote de instâncias ou entidades usando um "
+"único <literal>SELECT</literal>, especificando uma lista de chaves primárias "
+"ou chaves estrangeiras."
-#: index.docbook:57
+#. Tag: para
+#: performance.xml:57
+#, no-c-format
msgid "Hibernate also distinguishes between:"
-msgstr ""
+msgstr "O Hibernate distingue também entre:"
-#: index.docbook:63
-msgid "<emphasis>Immediate fetching</emphasis> - an association, collection or attribute is fetched immediately, when the owner is loaded."
+#. 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>Immediate fetching</emphasis> - uma associação, coleção ou "
+"atributo é buscado como ela é carregada (Qual SQL é usado). Não se confuda "
+"com eles! Nós usamos fetch para melhorar a performance. Nós podemos usar "
+"lazy para definir um contrato para qual dado é sempre disponível em qualquer "
+"instância desanexada de uma classe qualquer. imediatamente, quando o pai é "
+"carregado."
-#: 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.)"
+#. 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>Lazy collection fetching</emphasis> - a coleção é buscada quando a "
+"aplicação invoca uma operação sobre aquela coleção (Esse é o padrão para "
+"coleções)"
-#: 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)"
+#. 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>\"Extra-lazy\" collection fetching</emphasis> - elementos "
+"individuais de uma coleção são acessados do banco de dados quando preciso. O "
+"Hibernate tenta não buscar a coleção inteira dentro da memória ao menos que "
+"seja absolutamente preciso. (indicado para coleções muito grandes)"
-#: 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."
+#. 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>Proxy fetching</emphasis> - uma associação de um valor é carregada "
+"quando um método diferente do getter do identificador é invocado sobre o "
+"objeto associado."
-#: 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."
+#. 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>\"No-proxy\" fetching</emphasis> - uma associação de um valor é "
+"carregada quando a variável da instância é carregada. Comparada com a proxy "
+"fetching, esse método é menos preguiçoso (lazy)(a associação é carregada "
+"somente quando o identificador é acessada) mas é mais transparente, já que "
+"não há proxies visíveis para a aplicação. Esse método requer instrumentação "
+"de bytecodes em build-time e é raramente necessário."
-#: 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."
+#. 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>Lazy attribute fetching</emphasis> - um atributo ou associação de "
+"um valor é carregada quanto a varíavel da instância é acessada. Esse método "
+"requer instrumentação de bytecodes em build-time e é raramente necessário."
-#: 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."
+#. 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 ""
+"Nós temos aqui duas noções ortogonais: <emphasis>quando</emphasis> a "
+"associação é carregada e <emphasis>como </emphasis> ela é carregada (Qual "
+"SQL é usado). Não se confuda com eles! Nós usamos <literal>fetch</literal> "
+"para melhorar a performance. Nós podemos usar lazy para definir um contrato "
+"para qual dado é sempre disponível em qualquer instância desconectada de uma "
+"classe qualquer."
-#: index.docbook:119
+#. Tag: title
+#: performance.xml:119
+#, no-c-format
msgid "Working with lazy associations"
-msgstr ""
+msgstr "Inicializando coleções e proxies"
-#: 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."
+#. 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 ""
+"Por padrão, o Hibernate3 usa busca preguiçosa para coleções e busca "
+"preguiçosa com proxy para associações de um valor. Esses padrões fazem "
+"sentido para quase todas as associações em quase todas a aplicações."
-#: 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)."
+#. 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>Veja:</emphasis> se voce setar <literal>hibernate."
+"default_batch_fetch_size</literal>, O Hibernate irá usar otimização de "
+"carregamento em lote para o carregamento preguiçoso(Essa otimização pode ser "
+"também habilitada em um nível mais fino)."
-#: 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:"
+#. 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 ""
+"Porém, a busca preguiçosa tem um problema que você precisar saber. Acesso a "
+"associações preguiçosas fora do contexto de uma sessão aberta do Hibernate "
+"irá resultar numa exceção. Por exemplo:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Como a coleção de permissões não foi inicializada quando a <literal>Session</"
+"literal> foi fechada, a coleção não poderá carregar o seu estado. O "
+"Hibernate não suporta inicialização preguiçosa para objetos desconectados. "
+"Para consertar isso, é necessário mover o código que carrega a coleção para "
+"antes da transação ser comitada."
-#: 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!"
+#. 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 ""
+"Alternativamente, nós podemos usar uma coleção ou associação não preguiçosa, "
+"especificando <literal>lazy=\"false\"</literal> para o mapeamento da "
+"associação. Porém, é pretendido que a inicialização preguiçosa seja usada "
+"por quase todas as coleções e associações. Se você definir muitas "
+"associações não preguiçosas em seu modelo de objetos, o Hibernate irá "
+"precisar carregar o banco de dados inteiro na memória em cada transação!"
-#: 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."
+#. 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 ""
+"Por outro lado, nós geralmente escolhemos join fetching (que é não "
+"preguiçosa por natureza) ao invés de select fetching em uma transação "
+"particular. Nós iremos ver como customizar a estratégoa de busca. No "
+"Hibernate3, os mecanismos para escolher a estratégia de fetching são "
+"identicos para as associações simples e para coleções."
-#: index.docbook:170
+#. Tag: title
+#: performance.xml:170
+#, no-c-format
msgid "Tuning fetch strategies"
-msgstr ""
+msgstr "Personalizando as estratégias de busca"
-#: 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:"
+#. 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 ""
+"O select fetching (o padrão) é extremamente vunerável para N+1 problemas em "
+"select, então nós iremos querer habilitar o join fetching no documento de "
+"mapeamento:"
-#: 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 ""
-#: index.docbook:179
+#. Tag: programlisting
+#: performance.xml:179
+#, no-c-format
msgid "<![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:"
+#. Tag: para
+#: performance.xml:181
+#, no-c-format
+msgid ""
+"The <literal>fetch</literal> strategy defined in the mapping document "
+"affects:"
msgstr ""
+"A estratégia de <literal>fetch</literal> definida no documento de mapeamento "
+"afeta:"
-#: index.docbook:187
+#. Tag: para
+#: performance.xml:187
+#, no-c-format
msgid "retrieval via <literal>get()</literal> or <literal>load()</literal>"
-msgstr ""
+msgstr "recupera via <literal>get()</literal> ou <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 ""
+"Recuperações que acontecem implicitamente quando navegamos por uma associação"
-#: index.docbook:197
+#. Tag: para
+#: performance.xml:197
+#, no-c-format
msgid "<literal>Criteria</literal> queries"
-msgstr ""
+msgstr "<literal>Criteria</literal> queries"
-#: index.docbook:202
+#. Tag: para
+#: performance.xml:202
+#, no-c-format
msgid "HQL queries if <literal>subselect</literal> fetching is used"
-msgstr ""
+msgstr "buscas por HQL se buscar por <literal>subselect</literal> for usado"
-#: 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."
+#. 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 ""
+"Independentemente da estratégia de busca que você usar, o grafo não "
+"preguiçoso definido será garantidamente carregado na memória. Note que isso "
+"irá resultar em diversos selects imediatos sendo usados em um HQL em "
+"particular."
-#: 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>."
+#. 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 ""
+"Usualmente não usamos documentos de mapeamento para customizar as buscas. Ao "
+"invés disso, nós deixamos o comportamento padrão e sobrescrevemos isso em "
+"uma transação em particular, usando <literal>left join fetch</literal> no "
+"HQL. Isso diz ao Hibernate para buscar a associação inteira no primeiro "
+"select, usando um outer join. Na API de busca <literal>Criteria</literal>, "
+"você irá usar <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:"
+#. 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 ""
+"Se você quiser mudar a estratégia de busca usada pelo <literal>get()</"
+"literal> ou <literal>load()</literal>, simplesmente use uma query "
+"<literal>Criteria</literal>, por exemplo:"
-#: 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 ""
-#: index.docbook:231
-msgid "(This is Hibernate's equivalent of what some ORM solutions call a \"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 ""
+"(Isto é o equivalente do Hibernate para o que algumas soluções ORM chamam de "
+"\"plano de busca\")"
-#: index.docbook:235
-msgid "A completely different way to avoid problems with N+1 selects is to use the second-level cache."
+#. 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 ""
+"Um meio totalmente diferente de evitar problemas com selects N+1 é usar um "
+"cache de segundo nível."
-#: index.docbook:243
+#. Tag: title
+#: performance.xml:243
+#, no-c-format
msgid "Single-ended association proxies"
-msgstr ""
+msgstr "Proxies de associação single-ended"
-#: 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)."
+#. 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 ""
+"A recuperação preguiçosa para coleções é implementada usando uma "
+"implementação própria do Hibernate para coleções persistentes. Porém, um "
+"mecanismo diferente é necessário para comportamento preguiçoso para "
+"associações de um lado só. A entidade alvo da associação precisa usar um "
+"proxy. O Hibernate implementa proxies para inicialização preguiçosa em "
+"objetos persistentes usando manipulação de bytecode (via a excelente "
+"biblioteca 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."
+#. 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 ""
+"Por padrão, o Hibernate3 gera proxies (na inicialização) para todas as "
+"classes persistentes que usem eles para habilitar recuperaçãopreguiçosa de "
+"associações <literal>many-to-one</literal> e <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>"
+#. 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 ""
+"O arquivo de mapeamento deve declaram uma interface para usar como interface "
+"de proxy para aquela classe, com o atributo <literal>proxy</literal>. Por "
+"padrão, o Hibernate usa uma subclasse dessa classe. <emphasis>Note que a "
+"classe a ser usada via proxy precisa implementar o construtor padrão com "
+"pelo menos visibilidade de package. Nós recomendamos esse construtor para "
+"todas as classes persistentes!</emphasis>"
-#: index.docbook:266
-msgid "There are some gotchas to be aware of when extending this approach to polymorphic classes, eg."
+#. 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 ""
+"Existe alguns truques que você deve saber quando extender esse comportamento "
+"para classes polimórficas, dessa maneira:"
-#: 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 ""
-#: 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>:"
+#. 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 ""
+"Primeiramente, instâncias de <literal>Cat</literal> nunca seráo convertidas "
+"para <literal>DomesticCat</literal>, mesmo que a instância em questão seja "
+"uma estância de <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 ""
-#: index.docbook:281
+#. Tag: para
+#: performance.xml:281
+#, no-c-format
msgid "Secondly, it is possible to break proxy <literal>==</literal>."
-msgstr ""
+msgstr "É possível quebrar o proxy <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 ""
-#: 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:"
+#. 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 ""
+"Porém a situação não é tão ruim como parece. Mesmo quando temos duas "
+"referências para objetos proxies diferentes, a instância deles será o mesmo "
+"objeto"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Terceiro, Você não pode usar um proxy CGLIB em uma classe <literal>final</"
+"literal> ou com qualquer método <literal>final</literal>."
-#: 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."
+#. 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 ""
+"Finalmente, se o seu objeto persistente adquirir qualquer recursto durante a "
+"instanciação (em inicializadores ou construtor padrão), então esses recursos "
+"serão adquiridos pelo proxy também. A classe de proxy é uma subclasse da "
+"classe persistente."
-#: 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."
+#. 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 ""
+"Esses problemas são todos devido a limitação fundamental do modelo de "
+"herança simples do Java. Se você quiser evitar esse problemas em suas "
+"classes persistentes você deve imeplementar uma interface que declare seus "
+"métodos de negócio. Você deve especificar essas interfaces no arquivo de "
+"mapeamento. Ex:"
-#: 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 ""
-#: 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.)"
+#. 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 ""
+"onde <literal>CatImpl</literal> implementa a interface <literal>Cat</"
+"literal> e <literal>DomesticCatImpl</literal> implementa a interface "
+"<literal>DomesticCat</literal>. Então proxies para instâncias de "
+"<literal>Cat</literal> e <literal>DomesticCat</literal> serão retornadas por "
+"<literal>load()</literal> ou <literal>iterate()</literal>. (Note que "
+"<literal>list()</literal> geralmente não retorna proxies)."
-#: 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 ""
-#: 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>."
+#. 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 ""
+"Relacionamentos são também carregados preguiçosamente. Isso significa que "
+"você precisa declarar qualquer propriedade como sendo do tipo <literal>Cat</"
+"literal>, e não <literal>CatImpl</literal>."
-#: index.docbook:328
-msgid "Certain operations do <emphasis>not</emphasis> require proxy initialization"
+#. Tag: para
+#: performance.xml:328
+#, no-c-format
+msgid ""
+"Certain operations do <emphasis>not</emphasis> require proxy initialization"
msgstr ""
+"Algumas operações <emphasis>não</emphasis> requerem inicialização por proxy:"
-#: index.docbook:334
-msgid "<literal>equals()</literal>, if the persistent class does not override <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>, se a classe persistente não sobrescrever "
+"<literal>equals()</literal>"
-#: index.docbook:340
-msgid "<literal>hashCode()</literal>, if the persistent class does not override <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>, se a classe persistente não sobrescrever "
+"<literal>hashCode()</literal>"
-#: index.docbook:346
+#. Tag: para
+#: performance.xml:346
+#, no-c-format
msgid "The identifier getter method"
-msgstr ""
+msgstr "O método getter do identificador"
-#: index.docbook:352
-msgid "Hibernate will detect persistent classes that override <literal>equals()</literal> or <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 ""
+"O Hibernate irá detectar classes persistentes que sobrescrevem "
+"<literal>equals()</literal> ou <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."
+#. 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 ""
+"Escolhendo <literal>lazy=\"no-proxy\"</literal> ao invés do padrão "
+"<literal>lazy=\"proxy\"</literal>, podemos evitar problemas associados com "
+"typecasting. Porém, iremos precisar de instrumentação de bytecode em tempo "
+"de compilação e todas as operações irão resultar em iniciazações de proxy "
+"imediatas."
-#: index.docbook:367
+#. Tag: title
+#: performance.xml:367
+#, no-c-format
msgid "Initializing collections and proxies"
-msgstr ""
+msgstr "Inicializando coleções e proxies"
-#: 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."
+#. 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 ""
+"Será lançada uma <literal>LazyInitializationException</literal> se uma "
+"coleção não inicializada ou proxy é acessado fora do escopo da "
+"<literal>Session</literal>, isto é, quando a entidade que contém a coleção "
+"ou tem a referência ao proxy estiver no estado destachado."
-#: 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."
+#. 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 ""
+"Algumas vezes precisamos garantir qie o proxy ou coleção é inicializado "
+"antes de se fechar a <literal>Session</literal>. Claro que sempre podemos "
+"forçar a inicialização chamando <literal>cat.getSex()</literal> ou "
+"<literal>cat.getKittens().size()</literal>, por exemplo. Mas isto parece "
+"confuso para quem lê o código e não é conveniente para códigos genéricos."
-#: 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."
+#. 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 ""
+"Os métodos estáticos <literal>Hibernate.initialize()</literal> e "
+"<literal>Hibernate.isInitialized()</literal> possibilitam a aplicação uma "
+"maneira conveniente de trabalhar com coleções inicializadas preguiçosamente "
+"e proxies. <literal>Hibernate.initialize(cat)</literal> irá forçar a "
+"inicialização de um proxy, <literal>cat</literal>, contanto que a "
+"<literal>Session</literal> esteja ainda aberta. <literal>Hibernate.initialize"
+"( cat.getKittens() )</literal> tem um efeito similar para a coleção de "
+"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:"
+#. 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 ""
+"Outra opção é manter a <literal>Session</literal> aberta até que todas as "
+"coleções e proxies necessários sejam carregados. Em algumas arquiteturas de "
+"aplicações, particularmente onde o código que acessa os dados usando "
+"Hibernate e o código que usa os dados estão em diferentes camadas da "
+"aplicação ou diferentes processos físicos, será um problema garantir que a "
+"<literal>Session</literal> esteja aberta quando uma coleção for "
+"inicializada. Existem dois caminhos básicos para lidar com esse problema:"
-#: 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."
+#. 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 ""
+"Em aplicações web, um filtro servlet pode ser usado para fechar a "
+"<literal>Session</literal> somente no final da requisição do usuário, já que "
+"a renderização da visão estará completa (o pattern <emphasis>Open Session In "
+"View</emphasis>). Claro, que isto cria a necessidade de um correto manuseio "
+"de exceções na infraestrutura de sua aplicação. É vitalmente importante que "
+"a <literal>Session</literal> esteja fechada e a transação terminada antes de "
+"retornar para o usuário, mesmo que uma exceção ocorra durante a renderização "
+"da view. Veja o Wiki do Hibernate para exemplos do pattern \"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>."
+#. 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 ""
+"Em uma aplicação com uma camada de negócios separada, a lógica de negócios "
+"deve \"preparar\" todas as coleções que serão usadas pela camada web antes "
+"de retornar. Isto sgnifica que a camada de negócios deve carregar todos os "
+"dados e retorná-los já inicializados para a camada de apresentação. "
+"Usualmente a aplicação chama <literal>Hibernate.initialize()</literal> para "
+"cada coleção que será usada pela camada web (essa chamada de método deve "
+"ocorrer antes da sessão ser fechada ou retornar a coleção usando uma "
+"consulta Hibernate com uma cláusula <literal>FETCH</literal> ou um "
+"<literal>FetchMode.JOIN</literal> na <literal>Criteria</literal>. Fica muito "
+"mais fácil se você adotar o pattern <emphasis>Command</emphasis> ao invés do "
+"<emphasis>Session Facade</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!"
+#. 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 ""
+"Você também pode anexar um objeto prevaimente carregado em uma nova "
+"<literal>Session</literal><literal>merge()</literal> or <literal>lock()</"
+"literal> antes de acessar coleções não inicializadas (ou outros proxies). O "
+"Hibernate não faz e certamente <literal>não deve</literal> isso "
+"automaticamente pois isso introduziria semantica em transações ad hoc."
-#: 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."
+#. 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 ""
+"As vezes você não quer inicializar uma coleção muito grande, mas precisa de "
+"algumas informações (como o tamanho) ou alguns de seus dados."
-#: index.docbook:445
-msgid "You can use a collection filter to get the size of a collection without initializing it:"
+#. 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 ""
+"Você pode usar um filtro de coleção para saber seu tamanho sem a inicializar:"
-#: index.docbook:449
-msgid "<![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:"
+#. 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 ""
+"O método <literal>createFilter()</literal> é usado também para retornar "
+"algus dados de uma coleção eficientemente sem precisar inicializar a coleção "
+"inteira:"
-#: index.docbook:456
-msgid "<![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 ""
+msgstr "Usando busca em lote"
-#: 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."
+#. 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 ""
+"O Hibernate pode fazer uso eficiente de busca em lote, isto é, o Hibernate "
+"pode carregar diversos proxies não inicializados se um proxy é acessado (ou "
+"coleções. A busca em lote é uma otimização da estratégia de select "
+"fetching). Existe duas maneiras em que você pode usar busca em lote: no "
+"nível da classe ou no nível da coleção."
-#: 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>:"
+#. 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 ""
+"A recuperação em lote para classes/entidades é mais fácil de entender. "
+"Imagine que você tem a seguinte situação em tempo de execução: Você tem 25 "
+"instâncias de <literal>Cat</literal> carregadas em uma <literal>Session</"
+"literal>, cada <literal>Cat</literal> tem uma referência ao seu "
+"<literal>owner</literal>, que é da classe <literal>Person</literal>. A "
+"classe <literal>Person</literal> é mapeada com um proxy, <literal>lazy=\"true"
+"\"</literal>. Se você iterar sobre todos os Cat's e chamar <literal>getOwner"
+"()</literal> em cada, o Hibernate irá por padrão executar 25 comandos "
+"<literal>SELECT()</literal>, para buscar os proxies de owners. Você pode "
+"melhorar esse comportamento especificando um <literal>batch-size</literal> "
+"no mapeamento da classe <literal>Person</literal>:"
-#: index.docbook:479
+#. Tag: programlisting
+#: performance.xml:479
+#, no-c-format
msgid "<![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."
+#. Tag: para
+#: performance.xml:481
+#, no-c-format
+msgid ""
+"Hibernate will now execute only three queries, the pattern is 10, 10, 5."
msgstr ""
+"O Hibernate irá executar agora apenas três consultas, buscando por vez, 10, "
+"10 e 5 Person."
-#: 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:"
+#. 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 ""
+"Você também pode habilitar busca em lote de uma coleção. Por exemplo, se "
+"cada <literal>Person</literal> tem uma coleção preguiçosa de <literal>Cat</"
+"literal>s, e 10 pessoas estão já carregados em uma <literal>Sesssion</"
+"literal>, serão gerados 10 <literal>SELECT</literal>s ao se iterar todas as "
+"pessoas, um para cada chamada de <literal>getCats()</literal>.. Se você "
+"habilitar busca em lote para a coleção de <literal>cats</literal> no "
+"mapeamento da classe <literal>Person</literal>, o Hibernate pode fazer uma "
+"pré carga das coleções:"
-#: 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 ""
-#: 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>."
+#. 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 ""
+"Com um <literal>batch-size</literal> de 3, o Hibernate irá carregar 3, 3, 3, "
+"1 coleções em 4 <literal>SELECT</literal>s. Novamente, o valor do atributo "
+"depende do número esperado de coleções não inicialiadas em determinada "
+"<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.)"
+#. 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 ""
+"A busca em lote de coleções é particularmente útil quando você tem uma "
+"árvore encadeada de items, ex. o típico padrão bill-of-materials (Se bem que "
+"um <emphasis>conjunto encadeado</emphasis> ou <emphasis>caminho "
+"materializado </emphasis> pode ser uma opção melhor para árvores com mais "
+"leitura)"
-#: index.docbook:511
+#. Tag: title
+#: performance.xml:511
+#, no-c-format
msgid "Using subselect fetching"
-msgstr ""
+msgstr "Usando subselect fetching"
-#: 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."
+#. 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 ""
+"Se uma coleção ou proxy simples precisa ser recuperado, o Hibernate carrega "
+"todos eles rodando novamente a query original em um subselect. Isso funciona "
+"da mesma maneira que busca em lote, sem carregar tanto."
-#: index.docbook:524
+#. Tag: title
+#: performance.xml:524
+#, no-c-format
msgid "Using lazy property fetching"
-msgstr ""
+msgstr "Usando busca preguiçosa de propriedade"
-#: 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."
+#. 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 ""
+"O Hibernate3 suporta a carga posterior de propriedades individuais. Essa "
+"técnica de otimização também conhecida como <emphasis>fetch groups</"
+"emphasis>. Veja que isso é mais uma funcionalidade de marketing já que na "
+"prática, é mais importante otimização nas leituras dos registros do que na "
+"leitura das colunas. Porém, carregar apenas algumas propriedades de uma "
+"classe pode ser útil em casos extremos, onde tabelas legadas podem ter "
+"centenas de colunas e o modelo de dados não pode ser melhorado."
-#: index.docbook:535
-msgid "To enable lazy property loading, set the <literal>lazy</literal> attribute on your particular property mappings:"
+#. 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 ""
+"Para habilitar a carga posterior de propriedade, é preciso setar o atributo "
+"<literal>lazy</literal> no seu mapeamento de propriedade:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"A carga posterior de propriedades requer instrumentação de bytecode! Se suas "
+"classes persistentes não forem melhoradas, o Hibernate irá ignorar "
+"silenciosamente essa configuração e usará busca imediatamente."
-#: index.docbook:548
+#. Tag: para
+#: performance.xml:548
+#, no-c-format
msgid "For bytecode instrumentation, use the following Ant task:"
-msgstr ""
+msgstr "Para instrumentação de bytecode, use a seguinte tarefa do 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:561
-msgid "You may force the usual eager fetching of properties using <literal>fetch all properties</literal> in HQL."
+#. 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 ""
+"You may force the usual eager fetching of properties using <literal>fetch "
+"all properties</literal> in HQL."
-#: index.docbook:571
+#. Tag: title
+#: performance.xml:571
+#, no-c-format
msgid "The Second Level Cache"
-msgstr ""
+msgstr "The Second Level Cache"
-#: 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)."
+#. 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 ""
+"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)."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:592
+#. Tag: title
+#: performance.xml:592
+#, no-c-format
msgid "Cache Providers"
-msgstr ""
+msgstr "Cache Providers"
-#: index.docbook:601, index.docbook:774
+#. Tag: entry
+#: performance.xml:601 performance.xml:774
+#, no-c-format
msgid "Cache"
-msgstr ""
+msgstr "Cache"
-#: index.docbook:602
+#. Tag: entry
+#: performance.xml:602
+#, no-c-format
msgid "Provider class"
-msgstr ""
+msgstr "Provider class"
-#: index.docbook:603
+#. Tag: entry
+#: performance.xml:603
+#, no-c-format
msgid "Type"
-msgstr ""
+msgstr "Type"
-#: index.docbook:604
+#. Tag: entry
+#: performance.xml:604
+#, no-c-format
msgid "Cluster Safe"
-msgstr ""
+msgstr "Cluster Safe"
-#: index.docbook:605
+#. Tag: entry
+#: performance.xml:605
+#, no-c-format
msgid "Query Cache Supported"
-msgstr ""
+msgstr "Query Cache Supported"
-#: 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 ""
+msgstr "Hashtable (not intended for production use)"
-#: index.docbook:611
+#. Tag: literal
+#: performance.xml:611
+#, no-c-format
msgid "org.hibernate.cache.HashtableCacheProvider"
-msgstr ""
+msgstr "org.hibernate.cache.HashtableCacheProvider"
-#: index.docbook:612
+#. Tag: entry
+#: performance.xml:612
+#, no-c-format
msgid "memory"
-msgstr ""
+msgstr "memory"
-#: 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 ""
-#: index.docbook:617, index.docbook:790
+#. Tag: entry
+#: performance.xml:617 performance.xml:790
+#, no-c-format
msgid "EHCache"
-msgstr ""
+msgstr "EHCache"
-#: index.docbook:618
+#. Tag: literal
+#: performance.xml:618
+#, no-c-format
msgid "org.hibernate.cache.EhCacheProvider"
-msgstr ""
+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 ""
+msgstr "memory, disk"
-#: index.docbook:624, index.docbook:797
+#. Tag: entry
+#: performance.xml:624 performance.xml:797
+#, no-c-format
msgid "OSCache"
-msgstr ""
+msgstr "OSCache"
-#: index.docbook:625
+#. Tag: literal
+#: performance.xml:625
+#, no-c-format
msgid "org.hibernate.cache.OSCacheProvider"
-msgstr ""
+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 ""
+msgstr "SwarmCache"
-#: index.docbook:632
+#. Tag: literal
+#: performance.xml:632
+#, no-c-format
msgid "org.hibernate.cache.SwarmCacheProvider"
-msgstr ""
+msgstr "org.hibernate.cache.SwarmCacheProvider"
-#: index.docbook:633
+#. Tag: entry
+#: performance.xml:633
+#, no-c-format
msgid "clustered (ip multicast)"
-msgstr ""
+msgstr "clustered (ip multicast)"
-#: index.docbook:634
+#. Tag: entry
+#: performance.xml:634
+#, no-c-format
msgid "yes (clustered invalidation)"
-msgstr ""
+msgstr "yes (clustered invalidation)"
-#: index.docbook:638, index.docbook:811
+#. Tag: entry
+#: performance.xml:638 performance.xml:811
+#, no-c-format
msgid "JBoss TreeCache"
-msgstr ""
+msgstr "JBoss TreeCache"
-#: index.docbook:639
+#. Tag: literal
+#: performance.xml:639
+#, no-c-format
msgid "org.hibernate.cache.TreeCacheProvider"
-msgstr ""
+msgstr "org.hibernate.cache.TreeCacheProvider"
-#: index.docbook:640
+#. Tag: entry
+#: performance.xml:640
+#, no-c-format
msgid "clustered (ip multicast), transactional"
-msgstr ""
+msgstr "clustered (ip multicast), transactional"
-#: index.docbook:641
+#. Tag: entry
+#: performance.xml:641
+#, no-c-format
msgid "yes (replication)"
-msgstr ""
+msgstr "yes (replication)"
-#: index.docbook:642
+#. Tag: entry
+#: performance.xml:642
+#, no-c-format
msgid "yes (clock sync req.)"
-msgstr ""
+msgstr "yes (clock sync req.)"
-#: index.docbook:649
+#. Tag: title
+#: performance.xml:649
+#, no-c-format
msgid "Cache mappings"
-msgstr ""
+msgstr "Cache mappings"
-#: index.docbook:651
-msgid "The <literal><cache></literal> element of a class or collection mapping has the following form:"
+#. Tag: para
+#: performance.xml:651
+#, no-c-format
+msgid ""
+"The <literal><cache></literal> element of a class or collection "
+"mapping has the following form:"
msgstr ""
+"The <literal><cache></literal> element of a class or collection "
+"mapping has the following form:"
-#: index.docbook:662
+#. 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"
- "/>]]>"
+"<![CDATA[<cache \n"
+" usage=\"transactional|read-write|nonstrict-read-write|read-only\"\n"
+" region=\"RegionName\"\n"
+" include=\"all|non-lazy\"\n"
+"/>]]>"
msgstr ""
-#: 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: 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:674
-msgid "<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: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"
+#. 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:691
-msgid "Alternatively (preferrably?), you may specify <literal><class-cache></literal> and <literal><collection-cache></literal> elements in <literal>hibernate.cfg.xml</literal>."
+#. Tag: para
+#: performance.xml:691
+#, no-c-format
+msgid ""
+"Alternatively (preferrably?), you may specify <literal><class-cache></"
+"literal> and <literal><collection-cache></literal> elements in "
+"<literal>hibernate.cfg.xml</literal>."
msgstr ""
+"Alternatively (preferrably?), you may specify <literal><class-cache></"
+"literal> and <literal><collection-cache></literal> elements in "
+"<literal>hibernate.cfg.xml</literal>."
-#: index.docbook:696
-msgid "The <literal>usage</literal> attribute specifies a <emphasis>cache concurrency strategy</emphasis>."
+#. Tag: para
+#: performance.xml:696
+#, no-c-format
+msgid ""
+"The <literal>usage</literal> attribute specifies a <emphasis>cache "
+"concurrency strategy</emphasis>."
msgstr ""
+"The <literal>usage</literal> attribute specifies a <emphasis>cache "
+"concurrency strategy</emphasis>."
-#: index.docbook:703
+#. Tag: title
+#: performance.xml:703
+#, no-c-format
msgid "Strategy: read only"
-msgstr ""
+msgstr "Strategy: read only"
-#: 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."
+#. Tag: para
+#: performance.xml:705
+#, no-c-format
+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 ""
+"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."
-#: index.docbook:711
+#. Tag: programlisting
+#: performance.xml:711
+#, no-c-format
msgid ""
- "<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n"
- " <cache usage=\"read-only\"/>\n"
- " ....\n"
- "</class>]]>"
+"<![CDATA[<class name=\"eg.Immutable\" mutable=\"false\">\n"
+" <cache usage=\"read-only\"/>\n"
+" ....\n"
+"</class>]]>"
msgstr ""
-#: index.docbook:717
+#. Tag: title
+#: performance.xml:717
+#, no-c-format
msgid "Strategy: read/write"
-msgstr ""
+msgstr "Strategy: read/write"
-#: 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: para
+#: performance.xml:719
+#, no-c-format
+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>."
msgstr ""
+"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>."
-#: index.docbook:730
+#. 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>]]>"
+"<![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 ""
-#: index.docbook:735
+#. Tag: title
+#: performance.xml:735
+#, no-c-format
msgid "Strategy: nonstrict read/write"
-msgstr ""
+msgstr "Strategy: nonstrict read/write"
-#: 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: 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 ""
+"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."
-#: index.docbook:749
+#. Tag: title
+#: performance.xml:749
+#, no-c-format
msgid "Strategy: transactional"
-msgstr ""
+msgstr "Strategy: transactional"
-#: 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>."
+#. 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 ""
+"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>."
-#: 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."
+#. 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 ""
+"None of the cache providers support all of the cache concurrency strategies. "
+"The following table shows which providers are compatible with which "
+"concurrency strategies."
-#: index.docbook:765
+#. Tag: title
+#: performance.xml:765
+#, no-c-format
msgid "Cache Concurrency Strategy Support"
-msgstr ""
+msgstr "Cache Concurrency Strategy Support"
-#: 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 ""
+msgstr "nonstrict-read-write"
-#: index.docbook:777
+#. Tag: entry
+#: performance.xml:777
+#, no-c-format
msgid "read-write"
-msgstr ""
+msgstr "read-write"
-#: index.docbook:778
+#. Tag: entry
+#: performance.xml:778
+#, no-c-format
msgid "transactional"
-msgstr ""
+msgstr "transactional"
-#: index.docbook:824
+#. Tag: title
+#: performance.xml:824
+#, no-c-format
msgid "Managing the caches"
-msgstr ""
+msgstr "Managing the caches"
-#: 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>."
+#. 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 ""
+"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>."
-#: 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."
+#. Tag: para
+#: performance.xml:833
+#, no-c-format
+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 ""
+"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."
-#: index.docbook:841
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: 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 ""
+"The <literal>Session</literal> also provides a <literal>contains()</literal> "
+"method to determine if an instance belongs to the session cache."
-#: index.docbook:848
-msgid "To completely evict all objects from the session cache, call <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 ""
+"To completely evict all objects from the session cache, call "
+"<literal>Session.clear()</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."
+#. Tag: para
+#: performance.xml:852
+#, no-c-format
+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 ""
+"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."
-#: index.docbook:858
+#. 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]]>"
+"<![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 ""
-#: index.docbook:860
-msgid "The <literal>CacheMode</literal> controls how a particular session interacts with the second-level cache."
+#. 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 ""
+"The <literal>CacheMode</literal> controls how a particular session interacts "
+"with the second-level cache."
-#: index.docbook:867
-msgid "<literal>CacheMode.NORMAL</literal> - read items from and write items to the second-level cache"
+#. 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> - read items from and write items to the "
+"second-level cache"
-#: 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"
+#. 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> - read items from the second-level cache, "
+"but don't write to the second-level cache except when updating data"
-#: index.docbook:878
-msgid "<literal>CacheMode.PUT</literal> - write items to the second-level cache, but don't read from the second-level cache"
+#. 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> - write items to the second-level cache, "
+"but don't read from the second-level cache"
-#: 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"
+#. 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> - 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"
-#: index.docbook:892
-msgid "To browse the contents of a second-level or query cache region, use the <literal>Statistics</literal> API:"
+#. Tag: para
+#: performance.xml:892
+#, no-c-format
+msgid ""
+"To browse the contents of a second-level or query cache region, use the "
+"<literal>Statistics</literal> API:"
msgstr ""
+"To browse the contents of a second-level or query cache region, use the "
+"<literal>Statistics</literal> API:"
-#: index.docbook:897
+#. Tag: programlisting
+#: performance.xml:897
+#, no-c-format
msgid ""
- "<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n"
- " .getSecondLevelCacheStatistics(regionName)\n"
- " .getEntries();]]>"
+"<![CDATA[Map cacheEntries = sessionFactory.getStatistics()\n"
+" .getSecondLevelCacheStatistics(regionName)\n"
+" .getEntries();]]>"
msgstr ""
-#: 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: para
+#: performance.xml:899
+#, no-c-format
+msgid ""
+"You'll need to enable statistics, and, optionally, force Hibernate to keep "
+"the cache entries in a more human-understandable format:"
msgstr ""
+"You'll need to enable statistics, and, optionally, force Hibernate to keep "
+"the cache entries in a more human-understandable format:"
-#: index.docbook:904
+#. Tag: programlisting
+#: performance.xml:904
+#, no-c-format
msgid ""
- "<![CDATA[hibernate.generate_statistics true\n"
- "hibernate.cache.use_structured_entries true]]>"
+"<![CDATA[hibernate.generate_statistics true\n"
+"hibernate.cache.use_structured_entries true]]>"
msgstr ""
-#: index.docbook:909
+#. Tag: title
+#: performance.xml:909
+#, no-c-format
msgid "The Query Cache"
-msgstr ""
+msgstr "The Query Cache"
-#: 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: 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 ""
+"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:"
-#: index.docbook:916
+#. Tag: programlisting
+#: performance.xml:916
+#, no-c-format
msgid "<![CDATA[hibernate.cache.use_query_cache true]]>"
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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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>."
+#. 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 ""
+"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>."
-#: 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();]]>"
+"<![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 ""
+"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>."
-#: index.docbook:955
+#. Tag: title
+#: performance.xml:955
+#, no-c-format
msgid "Understanding Collection performance"
-msgstr ""
+msgstr "Understanding Collection performance"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:964
+#. Tag: title
+#: performance.xml:964
+#, no-c-format
msgid "Taxonomy"
-msgstr ""
+msgstr "Taxonomy"
-#: index.docbook:966
+#. Tag: para
+#: performance.xml:966
+#, no-c-format
msgid "Hibernate defines three basic kinds of collections:"
-msgstr ""
+msgstr "Hibernate defines three basic kinds of collections:"
-#: index.docbook:970
+#. Tag: para
+#: performance.xml:970
+#, no-c-format
msgid "collections of values"
-msgstr ""
+msgstr "collections of values"
-#: index.docbook:973
+#. Tag: para
+#: performance.xml:973
+#, no-c-format
msgid "one to many associations"
-msgstr ""
+msgstr "one to many associations"
-#: index.docbook:976
+#. Tag: para
+#: performance.xml:976
+#, no-c-format
msgid "many to many associations"
-msgstr ""
+msgstr "many to many associations"
-#: 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:"
+#. 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 ""
+"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:"
-#: index.docbook:991
+#. Tag: para
+#: performance.xml:991
+#, no-c-format
msgid "indexed collections"
-msgstr ""
+msgstr "indexed collections"
-#: index.docbook:994
+#. Tag: para
+#: performance.xml:994
+#, no-c-format
msgid "sets"
-msgstr ""
+msgstr "sets"
-#: index.docbook:997
+#. Tag: para
+#: performance.xml:997
+#, no-c-format
msgid "bags"
-msgstr ""
+msgstr "bags"
-#: index.docbook:1001
-msgid "All indexed collections (maps, lists, arrays) have a primary key consisting of the <literal><key></literal> and <literal><index></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."
+#. Tag: para
+#: performance.xml:1001
+#, no-c-format
+msgid ""
+"All indexed collections (maps, lists, arrays) have a primary key consisting "
+"of the <literal><key></literal> and <literal><index></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 ""
+"All indexed collections (maps, lists, arrays) have a primary key consisting "
+"of the <literal><key></literal> and <literal><index></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."
-#: index.docbook:1009
-msgid "Sets have a primary key consisting of <literal><key></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><set></literal> for you, you must declare all columns as <literal>not-null=\"true\"</literal>.)"
+#. Tag: para
+#: performance.xml:1009
+#, no-c-format
+msgid ""
+"Sets have a primary key consisting of <literal><key></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><set></literal> for you, you must "
+"declare all columns as <literal>not-null=\"true\"</literal>.)"
msgstr ""
+"Sets have a primary key consisting of <literal><key></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><set></literal> for you, you must "
+"declare all columns as <literal>not-null=\"true\"</literal>.)"
-#: index.docbook:1020
-msgid "<literal><idbag></literal> mappings define a surrogate key, so they are always very efficient to update. In fact, they are the best case."
+#. Tag: para
+#: performance.xml:1020
+#, no-c-format
+msgid ""
+"<literal><idbag></literal> mappings define a surrogate key, so they "
+"are always very efficient to update. In fact, they are the best case."
msgstr ""
+"<literal><idbag></literal> mappings define a surrogate key, so they "
+"are always very efficient to update. In fact, they are the best case."
-#: 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."
+#. 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 ""
+"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."
-#: 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.)"
+#. 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 ""
+"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.)"
-#: index.docbook:1043
-msgid "Lists, maps, idbags and sets are the most efficient collections to update"
+#. Tag: title
+#: performance.xml:1043
+#, no-c-format
+msgid ""
+"Lists, maps, idbags and sets are the most efficient collections to update"
msgstr ""
+"Lists, maps, idbags and sets are the most efficient collections to update"
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:1078
+#. Tag: title
+#: performance.xml:1078
+#, no-c-format
msgid "Bags and lists are the most efficient inverse collections"
-msgstr ""
+msgstr "Bags and lists are the most efficient inverse collections"
-#: 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."
+#. 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 ""
+"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."
-#: 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();]]>"
+"<![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 ""
+msgstr "One shot delete"
-#: 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 ""
+"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!"
-#: 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."
+#. 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 ""
+"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."
-#: 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"
+#. 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 ""
+"However, suppose that we remove eighteen elements, leaving two and then add "
+"thee new elements. There are two possible ways to proceed"
-#: index.docbook:1117
+#. Tag: para
+#: performance.xml:1117
+#, no-c-format
msgid "delete eighteen rows one by one and then insert three rows"
-msgstr ""
+msgstr "delete eighteen rows one by one and then insert three rows"
-#: index.docbook:1120
-msgid "remove the whole collection (in one SQL <literal>DELETE</literal>) and insert all five current elements (one by one)"
+#. 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 ""
+"remove the whole collection (in one SQL <literal>DELETE</literal>) and "
+"insert all five current elements (one by one)"
-#: 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.)"
+#. 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 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.)"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:1137
-msgid "Of course, one-shot-delete does not apply to collections mapped <literal>inverse=\"true\"</literal>."
+#. 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 ""
+"Of course, one-shot-delete does not apply to collections mapped "
+"<literal>inverse=\"true\"</literal>."
-#: index.docbook:1146
+#. Tag: title
+#: performance.xml:1146
+#, no-c-format
msgid "Monitoring performance"
-msgstr ""
+msgstr "Monitoring performance"
-#: 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>."
+#. 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 ""
+"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>."
-#: index.docbook:1155
+#. Tag: title
+#: performance.xml:1155
+#, no-c-format
msgid "Monitoring a SessionFactory"
-msgstr ""
+msgstr "Monitoring a 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."
+#. 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 ""
+"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."
-#: 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:"
+#. 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 ""
+"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:"
-#: 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]]>"
+"<![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]]>"
+"<![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 ""
+"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>"
-#: 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 ""
+"You can (de)activate the monitoring for a <literal>SessionFactory</literal>"
-#: index.docbook:1185
-msgid "at configuration time, set <literal>hibernate.generate_statistics</literal> to <literal>false</literal>"
+#. Tag: para
+#: performance.xml:1185
+#, no-c-format
+msgid ""
+"at configuration time, set <literal>hibernate.generate_statistics</literal> "
+"to <literal>false</literal>"
msgstr ""
+"at configuration time, set <literal>hibernate.generate_statistics</literal> "
+"to <literal>false</literal>"
-#: index.docbook:1192
-msgid "at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> or <literal>hibernateStatsBean.setStatisticsEnabled(true)</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 ""
+"at runtime: <literal>sf.getStatistics().setStatisticsEnabled(true)</literal> "
+"or <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."
+#. 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 ""
+"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."
-#: index.docbook:1208
+#. Tag: title
+#: performance.xml:1208
+#, no-c-format
msgid "Metrics"
-msgstr ""
+msgstr "Metrics"
-#: 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:"
+#. 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 ""
+"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:"
-#: index.docbook:1217
-msgid "Metrics related to the general <literal>Session</literal> usage, such as number of open sessions, retrieved JDBC connections, etc."
+#. 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 ""
+"Metrics related to the general <literal>Session</literal> usage, such as "
+"number of open sessions, retrieved JDBC connections, etc."
-#: index.docbook:1223
-msgid "Metrics related to he entities, collections, queries, and caches as a whole (aka global metrics),"
+#. 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 ""
+"Metrics related to he entities, collections, queries, and caches as a whole "
+"(aka global metrics),"
-#: index.docbook:1229
-msgid "Detailed metrics related to a particular entity, collection, query or cache region."
+#. Tag: para
+#: performance.xml:1229
+#, no-c-format
+msgid ""
+"Detailed metrics related to a particular entity, collection, query or cache "
+"region."
msgstr ""
+"Detailed metrics related to a particular entity, collection, query or cache "
+"region."
-#: 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."
+#. Tag: para
+#: performance.xml:1236
+#, no-c-format
+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 ""
+"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."
-#: 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:"
+#. 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 ""
+"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:"
-#: index.docbook:1253
+#. 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\" );]]>"
+"<![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 ""
-#: 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>."
+#. 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 ""
+"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>."
-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/pt-BR/content/persistent_classes.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/persistent_classes.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/persistent_classes.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,446 +1,858 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Persistent Classes"
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:23
+#. Tag: title
+#: persistent_classes.xml:23
+#, no-c-format
msgid "A simple POJO example"
-msgstr ""
+msgstr "A simple POJO example"
-#: index.docbook:25
+#. Tag: para
+#: persistent_classes.xml:25
+#, no-c-format
msgid "Most Java applications require a persistent class representing felines."
msgstr ""
+"Most Java applications require a persistent class representing felines."
-#: 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 ""
-#: index.docbook:31
+#. Tag: para
+#: persistent_classes.xml:31
+#, no-c-format
msgid "There are four main rules to follow here:"
-msgstr ""
+msgstr "There are four main rules to follow here:"
-#: index.docbook:37
+#. Tag: title
+#: persistent_classes.xml:37
+#, no-c-format
msgid "Implement a no-argument constructor"
-msgstr ""
+msgstr "Implement a no-argument constructor"
-#: 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."
+#. 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> 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."
-#: index.docbook:49
+#. Tag: title
+#: persistent_classes.xml:49
+#, no-c-format
msgid "Provide an identifier property (optional)"
-msgstr ""
+msgstr "Provide an identifier property (optional)"
-#: 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.)"
+#. 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> 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.)"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:65
-msgid "In fact, some functionality is available only to classes which declare an identifier property:"
+#. 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 ""
+"In fact, some functionality is available only to classes which declare an "
+"identifier property:"
-#: index.docbook:72
-msgid "Transitive reattachment for detached objects (cascade update or cascade merge) - see"
+#. Tag: para
+#: persistent_classes.xml:72
+#, fuzzy, no-c-format
+msgid ""
+"Transitive reattachment for detached objects (cascade update or cascade "
+"merge) - see"
msgstr ""
+"Transitive reattachment for detached objects (cascade update or cascade "
+"merge) - see <xref linkend=\"objectstate-transitive\"/>"
-#: index.docbook:79
+#. Tag: literal
+#: persistent_classes.xml:79
+#, no-c-format
msgid "Session.saveOrUpdate()"
-msgstr ""
+msgstr "Session.saveOrUpdate()"
-#: index.docbook:84
+#. Tag: literal
+#: persistent_classes.xml:84
+#, no-c-format
msgid "Session.merge()"
-msgstr ""
+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."
+#. 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 ""
+"We recommend you declare consistently-named identifier properties on "
+"persistent classes. We further recommend that you use a nullable (ie. non-"
+"primitive) type."
-#: index.docbook:96
+#. Tag: title
+#: persistent_classes.xml:96
+#, no-c-format
msgid "Prefer non-final classes (optional)"
-msgstr ""
+msgstr "Prefer non-final classes (optional)"
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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>."
+#. 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 ""
+"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 proying by setting "
+"<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 ""
+msgstr "Declare accessors and mutators for persistent fields (optional)"
-#: 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."
+#. 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> 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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:138
+#. Tag: title
+#: persistent_classes.xml:138
+#, no-c-format
msgid "Implementing inheritance"
-msgstr ""
+msgstr "Implementing inheritance"
-#: 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>."
+#. 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 ""
+"A subclass must also observe the first and second rules. It inherits its "
+"identifier property from the superclass, <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 ""
-#: 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 ""
+"Implementing <literal>equals()</literal> and <literal>hashCode()</literal>"
-#: index.docbook:151
-msgid "You have to override the <literal>equals()</literal> and <literal>hashCode()</literal> methods if you"
+#. 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 ""
+"You have to override the <literal>equals()</literal> and <literal>hashCode()"
+"</literal> methods if you"
-#: 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>"
+#. 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 ""
+"intend to put instances of persistent classes in a <literal>Set</literal> "
+"(the recommended way to represent many-valued associations) <emphasis>and</"
+"emphasis>"
-#: index.docbook:164
+#. Tag: para
+#: persistent_classes.xml:164
+#, no-c-format
msgid "intend to use reattachment of detached instances"
-msgstr ""
+msgstr "intend to use reattachment of detached instances"
-#: 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."
+#. 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 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."
-#: 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."
+#. 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 ""
+"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."
-#: 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):"
+#. 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 ""
+"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):"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:212
+#. Tag: title
+#: persistent_classes.xml:212
+#, no-c-format
msgid "Dynamic models"
-msgstr ""
+msgstr "Dynamic models"
-#: index.docbook:215
-msgid "Note that the following features are currently considered experimental and may change in the near future."
+#. 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 ""
+"Note that the following features are currently considered experimental and "
+"may change in the near future."
-#: 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."
+#. 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 ""
+"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."
-#: 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\"/>."
+#. 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 ""
+"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\"/>."
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:265
-msgid "Entity representation modes can also be set on a per <literal>Session</literal> basis:"
+#. 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 ""
+"Entity representation modes can also be set on a per <literal>Session</"
+"literal> basis:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:283
-msgid "More information about the XML representation capabilities can be found in <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 ""
+"More information about the XML representation capabilities can be found in "
+"<xref linkend=\"xml\"/>."
-#: index.docbook:291
+#. Tag: title
+#: persistent_classes.xml:291
+#, no-c-format
msgid "Tuplizers"
-msgstr ""
+msgstr "Tuplizers"
-#: 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."
+#. 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>, 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.EntityTuplizer</literal> and "
+"<literal>org.hibernate.tuple.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."
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: index.docbook:322
-msgid "TODO: Document user-extension framework in the property and proxy packages"
+#. Tag: para
+#: persistent_classes.xml:322
+#, no-c-format
+msgid ""
+"TODO: Document user-extension framework in the property and proxy packages"
msgstr ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"TODO: Document user-extension framework in the property and proxy packages"
Modified: core/trunk/documentation/manual/translations/pt-BR/content/preface.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/preface.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/preface.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,68 +1,204 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:21
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Prefácio"
-#: 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."
+#. 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 ""
+"Trabalhando com software orientado a objetos e banco de dados relacional, "
+"podemos ter alguns incômodos hoje em dia em ambientes empresariais. "
+"Hibernate é uma ferramenta que mapeia o objeto/relacional para o ambiente "
+"Java. O termo de mapeamento de objeto/relacional (ou ORM – Object/Relational "
+"Mapping) se refere a técnica de mapear uma representação de dados de um "
+"modelo de objeto para dados de modelo relacional com o esquema baseado em 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."
+#. 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 ""
+"O Hibernate não somente cuida do mapeamento de classes em Java para tabelas "
+"de banco de dados (e de tipos de dados em Java para tipos de dados em SQL), "
+"como também fornece facilidade de consultas e recuperação de dados, podendo "
+"também reduzir significantemente o tempo de desenvolvimento gasto com a "
+"manipulação manual de dados no SQL e 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."
+#. 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 ""
+"O objetivo do Hibernate é de aliviar o desenvolvedor de 95 por cento das "
+"tarefas de programação relacionadas aos dados comuns de persistência. O "
+"Hibernate talvez não seja a melhor solução para aplicações de dados-data-"
+"centric que somente usa stored-procedures para implementar a lógica de "
+"negócio no banco de dados, isto é muito utilizado com o domínio de modelos "
+"orientado a objetos e lógicas de negócio em camadas do meio (middle-tier) "
+"baseadas em Java. Porém, o Hibernate poderá certamente ajuda-lo a remover ou "
+"encapsular o código SQL de um vendedor específico, ajudando também com a "
+"tarefa comum da tradução do resultado ajustado de uma representação para um "
+"gráfico de objetos."
-#: index.docbook:48
-msgid "If you are new to Hibernate and Object/Relational Mapping or even Java, please follow these steps:"
+#. 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 ""
+"Se você for novo no Hibernate e no mapeamento Objeto/Relacional, ou até "
+"mesmo em Java, por favor, siga os seguintes passos."
-#: 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."
+#. 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 ""
+"Leia <xref linkend=\"tutorial\"/> para um tutorial com instruções passo-a-"
+"passo. O código fonte para do tutorial está incluído na distribuição no "
+"diretório <literal>doc/reference/tutorial/</literal>."
-#: index.docbook:63
-msgid "Read <xref linkend=\"architecture\"/> to understand the environments where Hibernate can be used."
+#. Tag: para
+#: preface.xml:63
+#, no-c-format
+msgid ""
+"Read <xref linkend=\"architecture\"/> to understand the environments where "
+"Hibernate can be used."
msgstr ""
+"Leia o <xref linkend=\"architecture\"/> para entender o ambiente onde o "
+"Hibernate pode ser utilizado."
-#: 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>."
+#. 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 ""
+"Dê uma olhada no diretório de exemplo <literal>eg/</literal> da distribuição "
+"do Hibernate, ele contém uma simples aplicação standalone. Copie seu driver "
+"JDBC para o diretório <literal>lib/</literal> e edite o arquivo <literal>etc/"
+"hibernate.properties</literal>, especificando corretamente os valores para "
+"seu banco de dados. Usando o prompt de commando no diretorio de "
+"distribuicao, digite <literal>ant eg</literal> (usando Ant), ou no Windows, "
+"digite <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."
+#. 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 ""
+"Use esta documentação de referencia como sua fonte primaria de informação. "
+"Considere ler também o livro <emphasis>Java Persistence with Hibernate</"
+"emphasis> (http://www.manning.com/bauer2) caso você precise de mais ajuda "
+"com o desenvolvimento de aplicações ou caso prefira um tutorial passo-a-"
+"passo. Também visite o site http://caveatemptor.hibernate.org e faça o "
+"download da aplicação de exemplo do Java Persistence with Hibernate."
-#: index.docbook:90
+#. Tag: para
+#: preface.xml:90
+#, no-c-format
msgid "FAQs are answered on the Hibernate website."
msgstr ""
+"FAQs (perguntas feitas com mais freqüência) estão respondidas no site do "
+"Hibernate"
-#: index.docbook:95
-msgid "Third party demos, examples, and tutorials are linked on the Hibernate website."
+#. Tag: para
+#: preface.xml:95
+#, no-c-format
+msgid ""
+"Third party demos, examples, and tutorials are linked on the Hibernate "
+"website."
msgstr ""
+"Demonstrações, exemplos e tutorials estão disponíveis no site do 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.)."
+#. 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 ""
+"A Área da comunidade no site do Hibernate é uma boa fonte de recursos para "
+"padrões de projeto e várias soluções de integração (Tomcat, JBoss AS, "
+"Struts, EJB, etc.)."
-#: 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."
+#. 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 ""
+"Caso você tenha dúvidas, use o fórum dos usuários encontrado no site do "
+"Hibernate. Nós também fornecemos um sistema para controle de bug’s (JIRA) "
+"para relatórios de erros e requisições de features. Se você está interessado "
+"no desenvolvimento do Hibernate, junte-se a lista de e-mail dos "
+"desenvolvedores."
-#: 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."
+#. 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"Suporte comercial de desenvolvimento, suporte de produção e treinamento para "
+"o Hibernate está disponível através do JBoss Inc. (veja http://www.hibernate."
+"org/SupportTraining). O Hibernate é um Projeto Profissional de Código Aberto "
+"e um componente crítico da suíte de produtos JBoss Enterprise Middleware "
+"System (JEMS)."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/query_criteria.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,484 +1,772 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Consultas por critérios"
-#: index.docbook:7
+#. Tag: para
+#: query_criteria.xml:7
+#, no-c-format
msgid "Hibernate features an intuitive, extensible criteria query API."
-msgstr ""
+msgstr "O Hibernate provê uma intuitiva e extensível API de critério de query."
-#: index.docbook:12
+#. Tag: title
+#: query_criteria.xml:12
+#, no-c-format
msgid "Creating a <literal>Criteria</literal> instance"
-msgstr ""
+msgstr "Criando uma instancia <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."
+#. 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 ""
+"A interface <literal>org.hibernate.Criteria</literal> representa a query ao "
+"invés de uma classe persistente particular. A sessão é uma fábrica para "
+"intancias de <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 ""
-#: index.docbook:25
+#. Tag: title
+#: query_criteria.xml:25
+#, no-c-format
msgid "Narrowing the result set"
-msgstr ""
+msgstr "Limitando o result set"
-#: 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."
+#. 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 ""
+"Um critério individual de query é uma instancia da interface <literal>org."
+"hibernate.criterion.Criterion</literal>. A classe <literal>org.hibernate."
+"criterion.Restrictions</literal> define os métodos da fábrica para obter "
+"certos tipos pré fabricados de <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 ""
-#: index.docbook:37
+#. Tag: para
+#: query_criteria.xml:37
+#, no-c-format
msgid "Restrictions may be grouped logically."
-msgstr ""
+msgstr "Restrições podem ser logicamente agrupadas."
-#: 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 ""
-#: 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 ""
-#: 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."
+#. 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 ""
+"Existe um grande número de critérios pré fabricados (subclasses de "
+"<literal>Restrictions</literal>), mas um é especialmente útil pois permite "
+"especificar o SQL diretamente."
-#: 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 ""
-#: index.docbook:52
-msgid "The <literal>{alias}</literal> placeholder with be replaced by the row alias of the queried entity."
+#. 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 ""
+"O parametro <literal>{alias}</literal> será substituido pelo alias da "
+"entidade procurada."
-#: 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>."
+#. 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 ""
+"Uma maneira alternativa de obter um critério é pegá-lo de uma instancia de "
+"<literal>Property</literal>. Você pode criar uma <literal>Property</literal> "
+"chamando <literal>Property.forName()</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 ""
-#: index.docbook:68
+#. Tag: title
+#: query_criteria.xml:68
+#, no-c-format
msgid "Ordering the results"
-msgstr ""
+msgstr "Ordering the results"
-#: index.docbook:70
-msgid "You may order the results using <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 ""
+"You may order the results using <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 ""
-#: 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 ""
-#: index.docbook:81
+#. Tag: title
+#: query_criteria.xml:81
+#, no-c-format
msgid "Associations"
-msgstr ""
+msgstr "Associations"
-#: index.docbook:83
-msgid "You may easily specify constraints upon related entities by navigating associations using <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 ""
+"You may easily specify constraints upon related entities by navigating "
+"associations using <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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:96
+#. Tag: para
+#: query_criteria.xml:96
+#, no-c-format
msgid "The following, alternate form is useful in certain circumstances."
-msgstr ""
+msgstr "The following, alternate form is useful in certain circumstances."
-#: 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 ""
-#: index.docbook:102
-msgid "(<literal>createAlias()</literal> does not create a new instance of <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> does not create a new instance of "
+"<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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: index.docbook:119
+#. Tag: title
+#: query_criteria.xml:119
+#, no-c-format
msgid "Dynamic association fetching"
-msgstr ""
+msgstr "Dynamic association fetching"
-#: index.docbook:121
-msgid "You may specify association fetching semantics at runtime using <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 ""
+"You may specify association fetching semantics at runtime using "
+"<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 ""
-#: 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."
+#. 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 ""
+"This query will fetch both <literal>mate</literal> and <literal>kittens</"
+"literal> by outer join. See <xref linkend=\"performance-fetching\"/> for "
+"more information."
-#: index.docbook:136
+#. Tag: title
+#: query_criteria.xml:136
+#, no-c-format
msgid "Example queries"
-msgstr ""
+msgstr "Example queries"
-#: index.docbook:138
-msgid "The class <literal>org.hibernate.criterion.Example</literal> allows you to construct a query criterion from a given instance."
+#. 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 ""
+"The class <literal>org.hibernate.criterion.Example</literal> allows you to "
+"construct a query criterion from a given instance."
-#: 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 ""
-#: index.docbook:145
-msgid "Version properties, identifiers and associations are ignored. By default, null valued properties are excluded."
+#. 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 ""
+"Version properties, identifiers and associations are ignored. By default, "
+"null valued properties are excluded."
-#: index.docbook:150
+#. Tag: para
+#: query_criteria.xml:150
+#, no-c-format
msgid "You can adjust how the <literal>Example</literal> is applied."
-msgstr ""
+msgstr "You can adjust how the <literal>Example</literal> is applied."
-#: 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 ""
-#: 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 ""
+msgstr "You can even use examples to place criteria upon associated objects."
-#: 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 ""
-#: index.docbook:165
+#. Tag: title
+#: query_criteria.xml:165
+#, no-c-format
msgid "Projections, aggregation and grouping"
-msgstr ""
+msgstr "Projections, aggregation and grouping"
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: 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 ""
-#: 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:"
+#. 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 ""
+"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:"
-#: 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 ""
-#: 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 ""
-#: 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 ""
+"You can also use <literal>Property.forName()</literal> to express "
+"projections:"
-#: 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 ""
-#: 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 ""
-#: index.docbook:214
+#. Tag: title
+#: query_criteria.xml:214
+#, no-c-format
msgid "Detached queries and subqueries"
-msgstr ""
+msgstr "Detached queries and subqueries"
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: 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 ""
-#: index.docbook:232
+#. Tag: para
+#: query_criteria.xml:232
+#, no-c-format
msgid "Even correlated subqueries are possible:"
-msgstr ""
+msgstr "Even correlated subqueries are possible:"
-#: 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 ""
-#: index.docbook:245
+#. Tag: title
+#: query_criteria.xml:245
+#, no-c-format
msgid "Queries by natural identifier"
-msgstr ""
+msgstr "Queries by natural identifier"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:255
-msgid "First, you should map the natural key of your entity using <literal><natural-id></literal>, and enable use of the second-level cache."
+#. Tag: para
+#: query_criteria.xml:255
+#, no-c-format
+msgid ""
+"First, you should map the natural key of your entity using <literal><"
+"natural-id></literal>, and enable use of the second-level cache."
msgstr ""
+"First, you should map the natural key of your entity using <literal><"
+"natural-id></literal>, and enable use of the second-level cache."
-#: 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 ""
-#: index.docbook:262
-msgid "Note that this functionality is not intended for use with entities with <emphasis>mutable</emphasis> natural keys."
+#. 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 ""
+"Note that this functionality is not intended for use with entities with "
+"<emphasis>mutable</emphasis> natural keys."
-#: index.docbook:267
+#. Tag: para
+#: query_criteria.xml:267
+#, no-c-format
msgid "Next, enable the Hibernate query cache."
-msgstr ""
+msgstr "Next, enable the Hibernate query cache."
-#: index.docbook:271
-msgid "Now, <literal>Restrictions.naturalId()</literal> allows us to make use of the more efficient cache algorithm."
+#. 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 ""
+"Now, <literal>Restrictions.naturalId()</literal> allows us to make use of "
+"the more efficient cache algorithm."
-#: 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
Modified: core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/query_hql.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,1275 +1,2437 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "HQL: A linguagem de Queries do Hibernate"
-#: 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."
+#. 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 ""
+"O Hibernate vem com uma poderosa linguagem que é (intencionalmente) muito "
+"parecida com o SQL. Mas não seja enganado pela sintaxe; a HQL é totalmente "
+"orientada à objetos, requer conhecimentos de herança, polimorfismo e "
+"associações."
-#: index.docbook:14
+#. Tag: title
+#: query_hql.xml:14
+#, no-c-format
msgid "Case Sensitivity"
-msgstr ""
+msgstr "Case Sensitíve"
-#: 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>."
+#. 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 ""
+"As Queries não são case-sensitive, exceto pelo nomes das classes e "
+"propriedades Java. <literal>sELEct</literal> e o mesmo que <literal>SELECT</"
+"literal> mas <literal>org.hibernate.eg.FOO</literal> não é <literal>org."
+"hibernate.eg.Foo</literal> e <literal>foo.barSet</literal> não é "
+"<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."
+#. 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 ""
+"Esse manual usa as palavras chave HQL em letras minúsculas. Alguns usuários "
+"acham que com letras maiúsculas as queries ficam mais legíveis, mas nós "
+"achamos essa convenção feia dentro do código Java."
-#: index.docbook:35
+#. Tag: title
+#: query_hql.xml:35
+#, no-c-format
msgid "The from clause"
-msgstr ""
+msgstr "A clausula from"
-#: index.docbook:37
+#. Tag: para
+#: query_hql.xml:37
+#, no-c-format
msgid "The simplest possible Hibernate query is of the form:"
-msgstr ""
+msgstr "A mais simples query possível do Hibernate é a assim:"
-#: index.docbook:41
+#. Tag: programlisting
+#: query_hql.xml:41
+#, no-c-format
msgid "<![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:"
+#. 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 ""
+"Ela irá retornar todas as instancias da classe <literal>eg.Cat</literal>. "
+"Necessariamente não precisamos qualificar o nome da classe, pois é realizado "
+"<literal>auto-import</literal> por padrão. Por isso na maior parte do tempos "
+"nós simplesmente escrevemos:"
-#: index.docbook:49
+#. Tag: programlisting
+#: query_hql.xml:49
+#, no-c-format
msgid "<![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."
+#. 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 ""
+"Na maior parte do tempo, você precisará atribuir um <emphasis>alias</"
+"emphasis>, desde que você queira se referia ao <literal>Cat</literal> em "
+"outras partes da query."
-#: 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 ""
-#: 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:"
+#. 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 ""
+"Essa query atribui um alias a <literal>cat</literal> para as instancias de "
+"<literal>Cat</literal>, então nós podemos usar esse alias depois na query. A "
+"palavra chave as é opcional; poderíamos escrever assim:"
-#: index.docbook:65
+#. Tag: programlisting
+#: query_hql.xml:65
+#, no-c-format
msgid "<![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 ""
+"Múltiplas classes pode ser envolvidas, resultando em um produto cartesiano "
+"ou \"cross\" join."
-#: index.docbook:71
+#. Tag: programlisting
+#: query_hql.xml:71
+#, no-c-format
msgid "<![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 ""
-#: 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>)."
+#. 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 ""
+"É considerada uma boa prática os nomes dos aliases começarem com letra "
+"minúscula, aderente com os padrões Java para variáveis locais (ex: "
+"<literal>domesticCat</literal>)."
-#: index.docbook:83
+#. Tag: title
+#: query_hql.xml:83
+#, no-c-format
msgid "Associations and joins"
-msgstr ""
+msgstr "Associações e joins"
-#: 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>."
+#. 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 ""
+"Nós também podemos querer atribuir aliases em uma entidade associada, ou "
+"mesmo em elementos de uma coleção de valores, usando um <literal>join</"
+"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 ""
-#: 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 ""
-#: index.docbook:94
+#. Tag: programlisting
+#: query_hql.xml:94
+#, no-c-format
msgid "<![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 ""
+msgstr "Os tipos de joins suportados foram inspirados no SQL ANSI:"
-#: index.docbook:103
+#. Tag: literal
+#: query_hql.xml:103
+#, no-c-format
msgid "inner join"
-msgstr ""
+msgstr "inner join"
-#: index.docbook:108
+#. Tag: literal
+#: query_hql.xml:108
+#, no-c-format
msgid "left outer join"
-msgstr ""
+msgstr "left outer join"
-#: index.docbook:113
+#. Tag: literal
+#: query_hql.xml:113
+#, no-c-format
msgid "right outer join"
-msgstr ""
+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 ""
+msgstr "<literal>full join</literal> (geralmente não é útil)"
-#: index.docbook:123
-msgid "The <literal>inner join</literal>, <literal>left outer join</literal> and <literal>right outer join</literal> constructs may be abbreviated."
+#. 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 ""
+"The <literal>inner join</literal>, <literal>left outer join</literal> and "
+"<literal>right outer join</literal> constructs may be abbreviated. As "
+"construções <literal>inner join</literal>, <literal>left outer join</"
+"literal> e <literal>right outer join</literal> podem ser abreviadas."
-#: 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 ""
-#: index.docbook:130
-msgid "You may supply extra join conditions using the HQL <literal>with</literal> keyword."
+#. Tag: para
+#: query_hql.xml:130
+#, no-c-format
+msgid ""
+"You may supply extra join conditions using the HQL <literal>with</literal> "
+"keyword."
msgstr ""
+"Você pode fornecer condições extras de join usando a palavra chave do 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 ""
-#: 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."
+#. 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 ""
+"Adicionalmente, um \"fetch\" join permite que associações ou coleções de "
+"valores sejam inicializadas junto com o objeto pai, usando apenas um select. "
+"Isso é muito útil no caso das coleções. Isso efetivamente sobre escreve as "
+"declarações outer join e lazy do arquivo mapeamento para associações e "
+"coleções. Veja a seção <xref linkend=\"performance-fetching\"/> para mais "
+"informações."
-#: 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 ""
-#: 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:"
+#. 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 ""
+"Usualmente, um <literal>fetch</literal>join não precisa atribuir um alias, "
+"pois o objeto associado não deve ser usado na clausula <literal>where</"
+"literal> (ou em qualquer outra clausula). Também, os objetos associados não "
+"são retornados diretamente nos resultados da query. Ao invés disso, eles "
+"devem ser acessados usando o objeto pai. A única razão que nós podemos "
+"necessitar de um alias é quando fazemos um fech join recursivamente em uma "
+"coleção adicional:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Observe que a construção <literal>fetch</literal> não deve ser usada em "
+"queries invocadas usando <literal>iterate()</literal> (embora possa ser "
+"usado com <literal>scroll()</literal>). O <literal>fetch</literal> também "
+"não deve ser usado junto com o <literal>setMaxResults()</literal> ou "
+"<literal>setFirstResult()</literal> pois essas operações são baseadas nas "
+"linhas retornadas, que normalmente contem duplicidade devido ao fetching das "
+"coleções, então o número de linhas pode não ser o que você espera. O "
+"<literal>fetch</literal> não deve ser usado junto com uma condição "
+"<literal>with</literal> em uma condição <literal>with</literal> ad hoc. É "
+"possível que seja criado um produto cartesiano pelo join fetching em mais do "
+"que uma coleção em uma query, então tome cuidado nesses casos. Um join "
+"fetching em varias coleções pode trazer resultados inesperados para "
+"mapeamentos do tipo bag, tome cuidado na hora de formular queries como "
+"essas. Finalmente, observe o seguinte, o <literal>full join fetch</literal> "
+"e <literal>right join fetch</literal> não são significativos."
-#: 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>."
+#. 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 ""
+"Se está usando o nível de propriedade lazy (<literal>com</literal> "
+"instrumentação de bytecode), é possível forçar o Hibernate a "
+"<literal>buscar</literal> as propriedades lazy imediatamente (na primeira "
+"query), usando <literal>fetch all properties </literal>."
-#: index.docbook:178
+#. Tag: programlisting
+#: query_hql.xml:178
+#, no-c-format
msgid "<![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%']]>"
+#. 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 ""
+msgstr "Formas e sintaxe de joins"
-#: index.docbook:186
-msgid "HQL supports two forms of association joining: <literal>implicit</literal> and <literal>explicit</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 ""
+"O HQL suporta duas formas de associação para união: <literal>implícita</"
+"literal> e <literal>explicita</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."
+#. 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 ""
+"As queries apresentadas na seção anterior usam a forma <literal>explicita</"
+"literal>, onde a palavra chave \"join\" é explicitamente usada na clausula "
+"\"from\". Essa é a forma recomendada."
-#: 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."
+#. 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 ""
+"A forma <literal>implícita</literal> não usa a palavra chave \"join\". "
+"Entretanto, as associações são diferenciadas usando pontuação (\".\" - "
+"dotnation). Uniões implícitas podem aparecer em qualquer das clausulas HQL. "
+"A união <literal>implícita</literal> resulta em declarações SQL que contem "
+"inner joins."
-#: 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 ""
-#: index.docbook:206
+#. Tag: title
+#: query_hql.xml:206
+#, no-c-format
msgid "Refering to identifier property"
-msgstr ""
+msgstr "Refering to identifier property"
-#: index.docbook:208
-msgid "There are, generally speaking, 2 ways to refer to an entity's identifier property:"
+#. 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 ""
+"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."
+#. 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."
+#. 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."
+#. 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 ""
+msgstr "Clausula select"
-#: index.docbook:244
-msgid "The <literal>select</literal> clause picks which objects and properties to return in the query result set. Consider:"
+#. 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 ""
+"A clausula <literal>select</literal> seleciona quais obetos e propriedades "
+"retornam no resultado da query. Considere:"
-#: index.docbook:249
+#. 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]]>"
+"<![CDATA[select mate\n"
+"from Cat as cat\n"
+" inner join cat.mate as mate]]>"
msgstr ""
-#: 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:"
+#. Tag: para
+#: query_hql.xml:251
+#, no-c-format
+msgid ""
+"The query will select <literal>mate</literal>s of other <literal>Cat</"
+"literal>s. Actually, you may express this query more compactly as:"
msgstr ""
+"A query selecionará <literal>mate</literal>s (companheiros), de outros "
+"<literal>Cat</literal>s. Atualmente, podemos expressar a query de forma mais "
+"compacta como:"
-#: index.docbook:256
+#. Tag: programlisting
+#: query_hql.xml:256
+#, no-c-format
msgid "<![CDATA[select cat.mate from Cat cat]]>"
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 ""
+"Queries podem retornar propriedades de qualquer tipo de valor, incluindo "
+"propriedades de tipo de componente:"
-#: 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%']]>"
+"<![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 ""
-#: index.docbook:266
-msgid "Queries may return multiple objects and/or properties as an array of type <literal>Object[]</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 ""
+"Queries podem retornar múltiplos objetos e/ou propriedades como um array do "
+"tipo Object[],"
-#: 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]]>"
+"<![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 ""
+msgstr "ou como um <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]]>"
+"<![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 ""
+msgstr "ou como um objeto Java typesafe,"
-#: index.docbook:283
+#. 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]]>"
+"<![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 ""
-#: index.docbook:285
-msgid "assuming that the class <literal>Family</literal> has an appropriate constructor."
+#. Tag: para
+#: query_hql.xml:285
+#, no-c-format
+msgid ""
+"assuming that the class <literal>Family</literal> has an appropriate "
+"constructor."
msgstr ""
+"assumindo que a classe <literal>Family</literal> tenha um construtor "
+"apropriado."
-#: index.docbook:289
-msgid "You may assign aliases to selected expressions using <literal>as</literal>:"
+#. Tag: para
+#: query_hql.xml:289
+#, no-c-format
+msgid ""
+"You may assign aliases to selected expressions using <literal>as</literal>:"
msgstr ""
+"Pode-se designar referencias a expressões selecionadas, <literal>as</"
+"literal>:"
-#: 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 ""
-#: index.docbook:295
-msgid "This is most useful when used together with <literal>select new map</literal>:"
+#. Tag: para
+#: query_hql.xml:295
+#, no-c-format
+msgid ""
+"This is most useful when used together with <literal>select new map</"
+"literal>:"
msgstr ""
+"Isto é bem mais útil quando usado junto <literal>com</"
+"literal><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]]>"
+"<![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."
+#. Tag: para
+#: query_hql.xml:301
+#, no-c-format
+msgid ""
+"This query returns a <literal>Map</literal> from aliases to selected values."
msgstr ""
+"Esta query retorna um <literal>Map</literal> de referencias para valores "
+"selecionados."
-#: index.docbook:308
+#. Tag: title
+#: query_hql.xml:308
+#, no-c-format
msgid "Aggregate functions"
-msgstr ""
+msgstr "Funções de agregação"
-#: index.docbook:310
-msgid "HQL queries may even return the results of aggregate functions on properties:"
+#. Tag: para
+#: query_hql.xml:310
+#, no-c-format
+msgid ""
+"HQL queries may even return the results of aggregate functions on properties:"
msgstr ""
+"As queries HQL podem retornar o resultado de funções agregadas nas "
+"propriedades."
-#: 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 ""
-#: index.docbook:325
+#. Tag: para
+#: query_hql.xml:325
+#, no-c-format
msgid "The supported aggregate functions are"
-msgstr ""
+msgstr "As funções agregadas suportadas são:"
-#: index.docbook:332
+#. Tag: literal
+#: query_hql.xml:332
+#, no-c-format
msgid "avg(...), sum(...), min(...), max(...)"
-msgstr ""
+msgstr "avg(...), sum(...), min(...), max(...)"
-#: index.docbook:337
+#. Tag: literal
+#: query_hql.xml:337
+#, no-c-format
msgid "count(*)"
-msgstr ""
+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:"
+#. 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 ""
+"Pode-se usar operadores aritiméticos, concatenação e funções SQL "
+"reconhecidas na clausula select:"
-#: 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]]>"
+"<![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]]>"
+#. 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."
+#. 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 ""
+"As palavras <literal>distinct</literal> e <literal>all</literal> podem ser "
+"usadas e têm a mesma semântica como no SQL."
-#: 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]]>"
+"<![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 ""
+msgstr "Queries polimórficas"
-#: index.docbook:368
+#. Tag: para
+#: query_hql.xml:368
+#, no-c-format
msgid "A query like:"
-msgstr ""
+msgstr "A query:"
-#: 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:"
+#. 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 ""
+"retorna instancias não só de <literal>Cat</literal>, mas também de "
+"subclasses como <literal>DomesticCat</literal>. As queries do Hibernate "
+"podem nomear qualquer classe Java ou interface na clausula <literal>from</"
+"literal>. A query retornará instancias de toda classe persistente que "
+"extenda a determinada classe ou implemente a determinada interface. A "
+"query , a seguir, pode retornar todo objeto persistente:"
-#: index.docbook:382
+#. Tag: programlisting
+#: query_hql.xml:382
+#, no-c-format
msgid "<![CDATA[from java.lang.Object o]]>"
msgstr ""
-#: index.docbook:384
-msgid "The interface <literal>Named</literal> might be implemented by various persistent classes:"
+#. Tag: para
+#: query_hql.xml:384
+#, no-c-format
+msgid ""
+"The interface <literal>Named</literal> might be implemented by various "
+"persistent classes:"
msgstr ""
+"A interface <literal>Named</literal> pode ser implementada por várias "
+"classes persistentes:"
-#: 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 ""
-#: 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>.)"
+#. 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 ""
+"Note que as duas últimas queries requerem mais de um SQL SELECT . Isto "
+"significa que a clausula <literal>order by</literal> não ordena corretamente "
+"todo o resultado. (Isso também significa que você não pode chamar essas "
+"queries usando <literal>Query.scroll()</literal>.)"
-#: index.docbook:400
+#. Tag: title
+#: query_hql.xml:400
+#, no-c-format
msgid "The where clause"
-msgstr ""
+msgstr "A clausula where"
-#: 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:"
+#. 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 ""
+"A clausula <literal>where</literal> permite estreitar a lista de instancias "
+"retornada. Se não houver referencia alguma, pode-se referir a propriedades "
+"pelo nome:"
-#: index.docbook:407
+#. Tag: programlisting
+#: query_hql.xml:407
+#, no-c-format
msgid "<![CDATA[from Cat where name='Fritz']]>"
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 ""
+msgstr "Se houver uma referência, use o nome da propriedade qualificada:"
-#: index.docbook:413
+#. Tag: programlisting
+#: query_hql.xml:413
+#, no-c-format
msgid "<![CDATA[from Cat as cat where cat.name='Fritz']]>"
msgstr ""
-#: index.docbook:415
+#. Tag: para
+#: query_hql.xml:415
+#, no-c-format
msgid "returns instances of <literal>Cat</literal> named 'Fritz'."
-msgstr ""
+msgstr "retorna instancias de <literal>Cat</literal> com nome ‘Fritz’."
-#: 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]]>"
+"<![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:"
+#. 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 ""
+"retornará todas as instancias de <literal>Foo</literal>, para cada um que "
+"tiver uma instancia de <literal>bar</literal> com a propriedade "
+"<literal>date</literal> igual a propriedade <literal>startDate</literal> de "
+"<literal>Foo</literal>. Expressões de filtro compostas fazem da clausula "
+"<literal>where</literal>, extremamente poderosa. Consideremos:"
-#: 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 ""
-#: index.docbook:432
-msgid "This query translates to an SQL query with a table (inner) join. If you were to write something like"
+#. 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 ""
+"Esta query traduzida para uma query SQL <literal>com</literal> uma tabela "
+"(inner) join. Se fosse escrever algo como:"
-#: 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 ""
-#: index.docbook:439
-msgid "you would end up with a query that would require four table joins in SQL."
+#. 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 ""
+"Poderia-se terminar <literal>com</literal> uma query que necessitasse de "
+"join de quatro tabelas, no SQL."
-#: index.docbook:443
-msgid "The <literal>=</literal> operator may be used to compare not only properties, but also instances:"
+#. 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 ""
+"O operador <literal>=</literal> pode ser uasdo para comparar não apenas "
+"propriedades, mas também instancias:"
-#: 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 ""
-#: 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 ""
-#: 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."
+#. 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 ""
+"A propriedade especial (lowercase) <literal>id</literal> pode ser usada para "
+"referenciar o identificador único de um objeto. (Pode-se usar também o nome "
+"de sua propriedade)"
-#: 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]]>"
+"<![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 ""
+msgstr "A Segunda query é eficiente. Nenhuma união de tabelas é necessária!"
-#: 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."
+#. 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 ""
+"As propriedades de identificadores compostas também podem ser usadas. "
+"Suponha que <literal>Person</literal> tenha um identificador composto que "
+"consiste de <literal>country</literal> e <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 ""
-#: 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]]>"
+"<![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 ""
+msgstr "Mais uma vez, a Segunda query não precisa de nenhum join de tabela."
-#: 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."
+#. 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 ""
+"Assim mesmo, a propriedade especial <literal>class</literal> acessa o valor "
+"discriminador da instancia, no caso de persistência polimórfica. O nome de "
+"uma classe Java inclusa em uma clausula \"where\", será traduzida para seu "
+"valor descriminante."
-#: index.docbook:485
+#. Tag: programlisting
+#: query_hql.xml:485
+#, no-c-format
msgid "<![CDATA[from Cat cat where cat.class = DomesticCat]]>"
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."
+#. 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 ""
+"Pode-se também especificar as propriedades dos components ou tipos de "
+"usuário composto (e de componentes de componentes). Nunca tente usar uma "
+"expressão de filtro que termine na propriedade de um tipo de componente (ao "
+"contrário de uma propriedade de um componente). Por exemplo, se store.owner "
+"é uma entidade <literal>com</literal> um componente <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><any></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><any></literal>)."
msgstr ""
+"Um tipo \"any\" tem as propriedades <literal>id</literal> e <literal>class</"
+"literal> especiais, nôs permitindo expressar um join da seguinte forma (onde "
+"<literal>AuditLog.item</literal> é uma propriedade mapeada <literal>com</"
+"literal><literal><any></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]]>"
+"<![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."
+#. 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 ""
+"Veja que <literal>log.item.class</literal> e <literal>payment.class</"
+"literal> podem referir-se a valores de colunas de banco de dados "
+"completamente diferentes, na query acima."
-#: index.docbook:508
+#. Tag: title
+#: query_hql.xml:508
+#, no-c-format
msgid "Expressions"
-msgstr ""
+msgstr "Expressões"
-#: index.docbook:510
-msgid "Expressions allowed in the <literal>where</literal> clause include most of the kind of things you could write in SQL:"
+#. 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 ""
+"As expressões permitidas na cláusula <literal>where</literal> inclui a "
+"maioria das coisas que você poderia escrever no SQL:"
-#: index.docbook:517
+#. Tag: para
+#: query_hql.xml:517
+#, no-c-format
msgid "mathematical operators <literal>+, -, *, /</literal>"
-msgstr ""
+msgstr "operadores matemáticos <literal>+, -, *, /</literal>"
-#: index.docbook:522
-msgid "binary comparison operators <literal>=, >=, <=, <>, !=, like</literal>"
+#. Tag: para
+#: query_hql.xml:522
+#, no-c-format
+msgid ""
+"binary comparison operators <literal>=, >=, <=, <>, !=, like</"
+"literal>"
msgstr ""
+"operadores de comparação binários <literal>=, >=, <=, <>, !=, "
+"like</literal>"
-#: index.docbook:527
+#. Tag: para
+#: query_hql.xml:527
+#, no-c-format
msgid "logical operations <literal>and, or, not</literal>"
-msgstr ""
+msgstr "operadores lógicos <literal>and, or, not</literal>"
-#: index.docbook:532
+#. Tag: para
+#: query_hql.xml:532
+#, no-c-format
msgid "Parentheses <literal>( )</literal>, indicating grouping"
-msgstr ""
+msgstr "parenteses <literal>( )</literal>, indicating grouping"
-#: 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>"
+#. 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>"
+#. 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 \"simples\" , <literal>case ... when ... then ... else ... end</"
+"literal>, and \"searched\" case, <literal>case when ... then ... else ... "
+"end</literal>"
-#: index.docbook:556
-msgid "string concatenation <literal>...||...</literal> or <literal>concat(...,...)</literal>"
+#. Tag: para
+#: query_hql.xml:556
+#, no-c-format
+msgid ""
+"string concatenation <literal>...||...</literal> or <literal>concat(...,...)"
+"</literal>"
msgstr ""
+"concatenação de string <literal>...||...</literal> ou <literal>concat"
+"(...,...)</literal>"
-#: index.docbook:561
-msgid "<literal>current_date()</literal>, <literal>current_time()</literal>, <literal>current_timestamp()</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>,"
+#. 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>"
+#. 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 ""
+"qualquer funcao ou operador definida pela EJB-QL 3.0: <literal>substring(), "
+"trim(), lower(), upper(), length(), locate(), abs(), sqrt(), bit_length(), "
+"mod()</literal>"
-#: index.docbook:580
+#. Tag: para
+#: query_hql.xml:580
+#, no-c-format
msgid "<literal>coalesce()</literal> and <literal>nullif()</literal>"
-msgstr ""
+msgstr "<literal>coalesce()</literal> and <literal>nullif()</literal>"
-#: index.docbook:585
-msgid "<literal>str()</literal> for converting numeric or temporal values to a readable string"
+#. Tag: para
+#: query_hql.xml:585
+#, no-c-format
+msgid ""
+"<literal>str()</literal> for converting numeric or temporal values to a "
+"readable string"
msgstr ""
+"<literal>str()</literal> para converter valores numericos ou temporais para "
+"string"
-#: 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"
+#. 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 ""
+"<literal>cast(... as ...)</literal>, onde o segundo argumento é o nome do "
+"tipo hibernate, e<literal>extract(... from ...)</literal> se ANSI "
+"<literal>cast()</literal> e <literal>extract()</literal> é suportado pele "
+"banco de dados usado"
-#: index.docbook:599
-msgid "the HQL <literal>index()</literal> function, that applies to aliases of a joined indexed collection"
+#. 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 ""
+"A função HQL <literal>index()</literal> , que se aplicam a referencias de "
+"coleçôes associadas e indexadas"
-#: 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>."
+#. 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 ""
+"As funções hql que retornam expressões de coleções de valores: <literal>size"
+"(), minelement(), maxelement(), minindex(), maxindex()</literal>, "
+"<literal>junto</literal> com o elemento especial, <literal>elements()</"
+"literal>, e funções de <literal>índice</literal> que podem ser quantificadas "
+"usando <literal>some, all, exists, any, in</literal>."
-#: index.docbook:613
-msgid "Any database-supported SQL scalar function like <literal>sign()</literal>, <literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</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 ""
+"Qualquer funçâo escalar pelo bando de dados como <literal>sign()</literal>, "
+"<literal>trunc()</literal>, <literal>rtrim()</literal>, <literal>sin()</"
+"literal>"
-#: index.docbook:619
+#. Tag: para
+#: query_hql.xml:619
+#, no-c-format
msgid "JDBC-style positional parameters <literal>?</literal>"
-msgstr ""
+msgstr "Parametros posicionais ao estilo JDBC <literal>?</literal>"
-#: index.docbook:624
-msgid "named parameters <literal>:name</literal>, <literal>:start_date</literal>, <literal>:x1</literal>"
+#. Tag: para
+#: query_hql.xml:624
+#, no-c-format
+msgid ""
+"named parameters <literal>:name</literal>, <literal>:start_date</literal>, "
+"<literal>:x1</literal>"
msgstr ""
+"Parametros nomeados <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>"
+#. 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 ""
+"Literais 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>"
+#. Tag: para
+#: query_hql.xml:635
+#, no-c-format
+msgid ""
+"Java <literal>public static final</literal> constants <literal>eg.Color."
+"TABBY</literal>"
msgstr ""
+"Constantes Java <literal>public static final</literal><literal>ex: Color."
+"TABBY</literal>"
-#: index.docbook:641
-msgid "<literal>in</literal> and <literal>between</literal> may be used as follows:"
+#. 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> e <literal>between</literal> podem ser usadas da "
+"seguinte maneira:"
-#: 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 ""
-#: index.docbook:647
-msgid "<![CDATA[from DomesticCat cat where cat.name in ( 'Foo', 'Bar', 'Baz' )]]>"
+#. 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 ""
+msgstr "e as formas negativas podem ser escritas"
-#: 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 ""
-#: index.docbook:655
-msgid "<![CDATA[from DomesticCat cat where cat.name not in ( 'Foo', 'Bar', 'Baz' )]]>"
+#. 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."
+#. 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 ""
+"Likewise, <literal>is null</literal> and <literal>is not null</literal> may "
+"be used to test for null values. Assim mesmo, , <literal>is null</literal> e "
+"<literal>is not null</literal> podem ser usados para testar valores nulos."
-#: index.docbook:662
-msgid "Booleans may be easily used in expressions by declaring HQL query substitutions in Hibernate configuration:"
+#. 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 ""
+"Booleanos podem ser facilmente usados em expressões, declarando as "
+"substituições da HQL query, na configuração do Hibernate"
-#: index.docbook:667
-msgid "<![CDATA[<property name=\"hibernate.query.substitutions\">true 1, false 0</property>]]>"
+#. 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:"
+#. 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 ""
+"Isso irá substituir as palavras chave <literal>true</literal> e "
+"<literal>false</literal><literal>pelos</literal> literais <literal>1</"
+"literal> e <literal>0</literal> na tradução do HQL para SQL."
-#: index.docbook:674
+#. Tag: programlisting
+#: query_hql.xml:674
+#, no-c-format
msgid "<![CDATA[from Cat cat where cat.alive = true]]>"
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."
+#. 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 ""
+"Pode-se testar o tamanho de uma coleção <literal>com</literal> a propriedade "
+"especial <literal>size</literal>, ou a função especial <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 ""
-#: index.docbook:683
+#. Tag: programlisting
+#: query_hql.xml:683
+#, no-c-format
msgid "<![CDATA[from Cat cat where size(cat.kittens) > 0]]>"
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 ""
+"Para coleções indexadas, você pode se referir aos índices máximo e mínimo, "
+"usando as funções <literal>minindex</literal> e <literal>maxindex</literal>. "
+"Similarmente, pode-se referir aos elementos máximo e mínimo de uma coleção "
+"de tipos básicos usando as funções <literal>minelement</literal> e "
+"<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 ""
-#: index.docbook:695
+#. Tag: programlisting
+#: query_hql.xml:695
+#, no-c-format
msgid "<![CDATA[from Order order where maxindex(order.items) > 100]]>"
msgstr ""
-#: index.docbook:697
+#. Tag: programlisting
+#: query_hql.xml:697
+#, no-c-format
msgid "<![CDATA[from Order order where minelement(order.items) > 10000]]>"
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)."
+#. 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 ""
+"As funções SQL <literal>any, some, all, exists, in</literal> são suportadas "
+"quando passado o elemento ou o conjunto de índices de uma coleção "
+"(<literal>elements</literal> e <literal>indices</literal> de funções), ou o "
+"resultado de uma subquery (veja abaixo)."
-#: 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)]]>"
+"<![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)]]>"
+"<![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 ""
-#: index.docbook:711
+#. Tag: programlisting
+#: query_hql.xml:711
+#, no-c-format
msgid "<![CDATA[from Player p where 3 > all elements(p.scores)]]>"
msgstr ""
-#: index.docbook:713
+#. Tag: programlisting
+#: query_hql.xml:713
+#, no-c-format
msgid "<![CDATA[from Show show where 'fizard' in indices(show.acts)]]>"
msgstr ""
-#: 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 ""
+"Note que essas construções - <literal>size</literal>, <literal>elements</"
+"literal>, <literal>indices</literal>, <literal>minindex</literal>, "
+"<literal>maxindex</literal>, <literal>minelement</literal>, "
+"<literal>maxelement</literal>– só podem ser usados na clausula where do "
+"Hibernate3."
-#: index.docbook:722
-msgid "Elements of indexed collections (arrays, lists, maps) may be referred to by index (in a where clause only):"
+#. 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 ""
+"Elementos de coleções com índice (arrays, lists, maps), podem ser "
+"referenciadas pelo índice (apenas na clausula 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 ""
-#: 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]]>"
+"<![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 ""
-#: 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]]>"
+"<![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."
+#. Tag: para
+#: query_hql.xml:735
+#, no-c-format
+msgid ""
+"The expression inside <literal>[]</literal> may even be an arithmetic "
+"expression."
msgstr ""
+"A expressão entre colchetes <literal>[]</literal>, pode ser até uma "
+"expressão aritimética."
-#: 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]]>"
+"<![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 ""
+"O HQL também provê a função interna <literal>index()</literal>, para "
+"elementos de associação um-pra-muitos ou coleção de valores."
-#: 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]]>"
+"<![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 ""
+msgstr "Funções escalares SQL, suportadas pelo banco de dados subjacente."
-#: index.docbook:752
+#. Tag: programlisting
+#: query_hql.xml:752
+#, no-c-format
msgid "<![CDATA[from DomesticCat cat where upper(cat.name) like 'FRI%']]>"
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:"
+#. 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 ""
+"Se ainda ainda não está totalmente convencido, pense o quão maior e menos "
+"legível poderia ser a query a seguir, em 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 ""
-#: index.docbook:761
+#. Tag: para
+#: query_hql.xml:761
+#, no-c-format
msgid "<emphasis>Hint:</emphasis> something like"
-msgstr ""
+msgstr "<emphasis>Hint:</emphasis> something like"
-#: 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"
- " )]]>"
+"<![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 "A clausula 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 ""
+"A lista retornada pela query pode ser ordenada por qualquer propriedade da "
+"classe ou componente retornado:"
-#: 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 ""
-#: index.docbook:778
-msgid "The optional <literal>asc</literal> or <literal>desc</literal> indicate ascending or descending order respectively."
+#. 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 ""
+"As opções <literal>asc</literal> ou <literal>desc</literal> indicam ordem "
+"crescente ou decrescente, respectivamente."
-#: index.docbook:785
+#. Tag: title
+#: query_hql.xml:785
+#, no-c-format
msgid "The group by clause"
-msgstr ""
+msgstr "A clausula group by"
-#: index.docbook:787
-msgid "A query that returns aggregate values may be grouped by any property of a returned class or components:"
+#. 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 ""
+"Uma query que retorne valores agregados, podem ser agrupados por qualquer "
+"propriedade de uma classe ou componente retornado:"
-#: 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 ""
-#: 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]]>"
+"<![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 "Uma clausula <literal>having</literal> também é permitida."
-#: 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)]]>"
+"<![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 ""
+"Funções SQL e funções agregadas são permitidas nas clausulas "
+"<literal>having</literal> e <literal>order by</literal>, se suportadas pelo "
+"banco de dados subjacente (ex: não no 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 ""
-#: 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 ""
+"Note que, nem a clausula <literal>group by</literal> ou <literal>order by</"
+"literal>, podem conter expressões aritiméticas."
-#: index.docbook:821
+#. Tag: title
+#: query_hql.xml:821
+#, no-c-format
msgid "Subqueries"
-msgstr ""
+msgstr "Subqueries"
-#: 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 ""
+"Para bancos de dados que suportem subselects, o Hibernate suporta subqueries "
+"dentro de queries. Uma subquery precisa estar entre parênteses (normalmente "
+"uma chamada de função agregada SQL). Mesmo subqueries co-relacionadas "
+"(subqueries que fazem referência à alias de outras queries), são aceitas."
-#: 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"
- ")]]>"
+"<![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"
- ")]]>"
+"<![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 ""
-#: 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"
- ")]]>"
+"<![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]]>"
+"<![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 ""
+"Note que HQL subqueries podem aparecer apenas dentro de clausulas select ou "
+"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."
+#. 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 ""
+msgstr "Exemplos de HQL"
-#: 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!"
+#. 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 ""
+"As queries do Hibernate, podem ser muito poderosas e complexas. De fato, o "
+"poder da linguagem de querie é um dos pontos principais na distribuição do "
+"Hibernate. Aqui temos algumas queries de exemplo, muito similares a queries "
+"que usei em um projeto recente. Note que a maioria das queries que você irá "
+"escrever, são mais simples que estas."
-#: 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."
+#. Tag: para
+#: query_hql.xml:859
+#, no-c-format
+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 ""
+"A query a seguir retorna o id de order, numero de itens e o valor total do "
+"order para todos os orders não pagos para um freguês particular e valor "
+"total mínimo dado, ordenando os resultados por valor total. Ao determinar os "
+"preços, é usado o catalogo corrente. A query SQL resultante, usando tabelas "
+"<literal>ORDER</literal>, <literal>ORDER_LINE</literal>, <literal>PRODUCT</"
+"literal>, <literal>CATALOG</literal> e <literal>PRICE</literal>, tem quatro "
+"inner joins e um (não correlacionado) subselect."
-#: index.docbook:868
+#. 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]]>"
+"<![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 ""
-#: 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: para
+#: query_hql.xml:870
+#, no-c-format
+msgid ""
+"What a monster! Actually, in real life, I'm not very keen on subqueries, so "
+"my query was really more like this:"
msgstr ""
+"Que monstro! Atualmente, na vida real, eu não sou muito afeiçoado a "
+"subqueries, então minha query seria mais parecida com isto:"
-#: index.docbook:875
+#. 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]]>"
+"<![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 ""
-#: 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: para
+#: query_hql.xml:877
+#, no-c-format
+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."
msgstr ""
+"A próxima query conta o número de pagamentos em cada status, tirando todos "
+"os pagamentos com status <literal>AWAITING_APPROVAL</literal>, onde a mais "
+"recente mudança de status foi feita pelo usuário corrente. Traduz-se para "
+"uma query SQL <literal>com</literal> dois inner joins e um subselect "
+"correlacionado, nas tabelas <literal>PAYMENT</literal>, "
+"<literal>PAYMENT_STATUS</literal> e <literal>PAYMENT_STATUS_CHANGE</"
+"literal> ."
-#: index.docbook:885
+#. 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]]>"
+"<![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 ""
-#: 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: para
+#: query_hql.xml:887
+#, no-c-format
+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."
msgstr ""
+"Se eu tivesse mapeado a Collection <literal>statusChanges</literal> como um "
+"List, ao invés de um Set, a query teria sido muito mais simples de escrever."
-#: index.docbook:892
+#. 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]]>"
+"<![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 ""
-#: 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: para
+#: query_hql.xml:894
+#, no-c-format
+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."
msgstr ""
+"A próxima query usa a função <literal>isNull()</literal> do MS SQL Server, "
+"para retornar todas as contas e pagamentos não pagos para a organização, "
+"para cada usuário corrente pertencente. Traduz-se para uma query SQL "
+"<literal>com</literal> três inner joins, um outer join e um subselect nas "
+"tabelas <literal>ACCOUNT</literal>, <literal>PAYMENT</literal>, "
+"<literal>PAYMENT_STATUS</literal>,<literal>ACCOUNT_TYPE</literal>, "
+"<literal>ORGANIZATION</literal> e <literal>ORG_USER</literal> ."
-#: index.docbook:903
+#. 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]]>"
+"<![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 ""
-#: index.docbook:905
-msgid "For some databases, we would need to do away with the (correlated) subselect."
+#. Tag: para
+#: query_hql.xml:905
+#, no-c-format
+msgid ""
+"For some databases, we would need to do away with the (correlated) subselect."
msgstr ""
+"Para alguns bancos de dados, precisaremos eleminar o subselect "
+"(correlacionado)."
-#: index.docbook:909
+#. 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]]>"
+"<![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 ""
-#: index.docbook:914
+#. Tag: title
+#: query_hql.xml:914
+#, no-c-format
msgid "Bulk update and delete"
-msgstr ""
+msgstr "update e delete em lote"
-#: 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: 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 ""
+"Agora o HQL suporta declarações, <literal>update</literal>, <literal>delete</"
+"literal> e <literal>insert ... select ...</literal> Veja <xref linkend="
+"\"batch-direct\"/>, para mais detalhes."
-#: index.docbook:924
+#. Tag: title
+#: query_hql.xml:924
+#, no-c-format
msgid "Tips & Tricks"
-msgstr ""
+msgstr "Dicas e Truques"
-#: index.docbook:926
-msgid "You can count the number of query results without actually returning them:"
+#. Tag: para
+#: query_hql.xml:926
+#, no-c-format
+msgid ""
+"You can count the number of query results without actually returning them:"
msgstr ""
+"Pode-se contar o número de resultados da query, sem realmente retorna-los."
-#: index.docbook:930
-msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue()]]>"
+#. Tag: programlisting
+#: query_hql.xml:930
+#, no-c-format
+msgid ""
+"<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\")."
+"iterate().next() ).intValue()]]>"
msgstr ""
-#: index.docbook:932
+#. 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 ""
+"Para ordenar um resultado pelo tamanho de uma Collection, use a query a "
+"seguir."
-#: 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)]]>"
+"<![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 ""
+"Se seu banco de dados suporta subselects, pode-se colocar uma condição sobre "
+"tamanho de seleção na cláusula where da sua query:"
-#: index.docbook:943
+#. Tag: programlisting
+#: query_hql.xml:943
+#, no-c-format
msgid "<![CDATA[from User usr where size(usr.messages) >= 1]]>"
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 ""
+msgstr "Se seu banco de dados não suporta subselects, use a query a seguir:"
-#: 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]]>"
+"<![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 ""
+"Com essa solução não se pode retornar um <literal>User</"
+"literal><literal>com</literal> sem nenhuma menssagem, por causa do \"inner "
+"join\", a forma a seguir também é útil."
-#: 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]]>"
+"<![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 ""
+"As propriedades de um JavaBean podem ser limitadas à parâmetros nomeados da "
+"query:"
-#: 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();]]>"
+"<![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 ""
+"As Collections são paginaveis, usando a interface <literal>Query</"
+"literal><literal>com</literal> um filtro:"
-#: 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();]]>"
+"<![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 ""
+"Os elementos da Collection podem ser ordenados ou agrupados usando um filtro "
+"de query:"
-#: 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\" );]]>"
+"<![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 ""
+msgstr "Pode-se achar o tamanho de uma Collection sem inicializa-la:"
-#: index.docbook:980
-msgid "<![CDATA[( (Integer) session.createQuery(\"select count(*) from ....\").iterate().next() ).intValue();]]>"
+#. Tag: programlisting
+#: query_hql.xml:980
+#, no-c-format
+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 ""
+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/pt-BR/content/query_sql.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/query_sql.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/query_sql.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,818 +1,1485 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Native 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."
+#. 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 ""
+"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."
-#: index.docbook:13
-msgid "Hibernate3 allows you to specify handwritten SQL (including stored procedures) for all create, update, delete, and load operations."
+#. 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 allows you to specify handwritten SQL (including stored "
+"procedures) for all create, update, delete, and load operations."
-#: index.docbook:17
+#. Tag: title
+#: query_sql.xml:17
+#, no-c-format
msgid "Using a <literal>SQLQuery</literal>"
-msgstr ""
+msgstr "Using a <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."
+#. 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 ""
+"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."
-#: index.docbook:25
+#. Tag: title
+#: query_sql.xml:25
+#, no-c-format
msgid "Scalar queries"
-msgstr ""
+msgstr "Scalar queries"
-#: 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 ""
+msgstr "The most basic SQL query is to get a list of scalars (values)."
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: 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 ""
+msgstr "This query specified:"
-#: 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 ""
+msgstr "the SQL query string"
-#: index.docbook:51
+#. Tag: para
+#: query_sql.xml:51
+#, no-c-format
msgid "the columns and types to return"
-msgstr ""
+msgstr "the columns and types to return"
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
+"It is possible to leave out the type information for all or some of the "
+"scalars."
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:80
+#. Tag: title
+#: query_sql.xml:80
+#, no-c-format
msgid "Entity queries"
-msgstr ""
+msgstr "Entity queries"
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: index.docbook:97
+#. Tag: para
+#: query_sql.xml:97
+#, no-c-format
msgid "the entity returned by the query"
-msgstr ""
+msgstr "the entity returned by the query"
-#: 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."
+#. 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 ""
+"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."
-#: 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>:"
+#. 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 ""
+"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>:"
-#: 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 ""
-#: index.docbook:115
+#. Tag: para
+#: query_sql.xml:115
+#, no-c-format
msgid "This will allow cat.getDog() to function properly."
-msgstr ""
+msgstr "This will allow cat.getDog() to function properly."
-#: index.docbook:119
+#. Tag: title
+#: query_sql.xml:119
+#, no-c-format
msgid "Handling associations and collections"
-msgstr ""
+msgstr "Handling associations and collections"
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:146
+#. Tag: title
+#: query_sql.xml:146
+#, no-c-format
msgid "Returning multiple entities"
-msgstr ""
+msgstr "Returning multiple entities"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:153
-msgid "Column alias injection is needed in the following query (which most likely will fail):"
+#. 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 is needed in the following query (which most likely "
+"will fail):"
-#: 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 ""
-#: 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\")."
+#. 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 ""
+"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\")."
-#: index.docbook:165
+#. Tag: para
+#: query_sql.xml:165
+#, no-c-format
msgid "The following form is not vulnerable to column name duplication:"
-msgstr ""
+msgstr "The following form is not vulnerable to column name duplication:"
-#: 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 ""
-#: index.docbook:174
-msgid "the SQL query string, with placeholders for Hibernate to inject column aliases"
+#. Tag: para
+#: query_sql.xml:174
+#, no-c-format
+msgid ""
+"the SQL query string, with placeholders for Hibernate to inject column "
+"aliases"
msgstr ""
+"the SQL query string, with placeholders for Hibernate to inject column "
+"aliases"
-#: index.docbook:179
+#. Tag: para
+#: query_sql.xml:179
+#, no-c-format
msgid "the entities returned by the query"
-msgstr ""
+msgstr "the entities returned by the query"
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: index.docbook:195
+#. Tag: title
+#: query_sql.xml:195
+#, no-c-format
msgid "Alias and property references"
-msgstr ""
+msgstr "Alias and property references"
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:208
+#. Tag: title
+#: query_sql.xml:208
+#, no-c-format
msgid "Alias injection names"
-msgstr ""
+msgstr "Alias injection names"
-#: index.docbook:219
+#. Tag: entry
+#: query_sql.xml:219
+#, no-c-format
msgid "Description"
-msgstr ""
+msgstr "Description"
-#: index.docbook:221
+#. Tag: entry
+#: query_sql.xml:221
+#, no-c-format
msgid "Syntax"
-msgstr ""
+msgstr "Syntax"
-#: index.docbook:223
+#. Tag: entry
+#: query_sql.xml:223
+#, no-c-format
msgid "Example"
-msgstr ""
+msgstr "Example"
-#: index.docbook:229
+#. Tag: entry
+#: query_sql.xml:229
+#, no-c-format
msgid "A simple property"
-msgstr ""
+msgstr "A simple property"
-#: index.docbook:231
+#. Tag: literal
+#: query_sql.xml:231
+#, no-c-format
msgid "{[aliasname].[propertyname]"
-msgstr ""
+msgstr "{[aliasname].[propertyname]"
-#: index.docbook:233
+#. Tag: literal
+#: query_sql.xml:233
+#, no-c-format
msgid "A_NAME as {item.name}"
-msgstr ""
+msgstr "A_NAME as {item.name}"
-#: index.docbook:237
+#. Tag: entry
+#: query_sql.xml:237
+#, no-c-format
msgid "A composite property"
-msgstr ""
+msgstr "A composite property"
-#: index.docbook:239
+#. Tag: literal
+#: query_sql.xml:239
+#, no-c-format
msgid "{[aliasname].[componentname].[propertyname]}"
-msgstr ""
+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 ""
+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 ""
+msgstr "Discriminator of an entity"
-#: index.docbook:248
+#. Tag: literal
+#: query_sql.xml:248
+#, no-c-format
msgid "{[aliasname].class}"
-msgstr ""
+msgstr "{[aliasname].class}"
-#: index.docbook:250
+#. Tag: literal
+#: query_sql.xml:250
+#, no-c-format
msgid "DISC as {item.class}"
-msgstr ""
+msgstr "DISC as {item.class}"
-#: index.docbook:254
+#. Tag: entry
+#: query_sql.xml:254
+#, no-c-format
msgid "All properties of an entity"
-msgstr ""
+msgstr "All properties of an entity"
-#: index.docbook:256, index.docbook:304
+#. Tag: literal
+#: query_sql.xml:256 query_sql.xml:304
+#, no-c-format
msgid "{[aliasname].*}"
-msgstr ""
+msgstr "{[aliasname].*}"
-#: index.docbook:258
+#. Tag: literal
+#: query_sql.xml:258
+#, no-c-format
msgid "{item.*}"
-msgstr ""
+msgstr "{item.*}"
-#: index.docbook:262
+#. Tag: entry
+#: query_sql.xml:262
+#, no-c-format
msgid "A collection key"
-msgstr ""
+msgstr "A collection key"
-#: index.docbook:264
+#. Tag: literal
+#: query_sql.xml:264
+#, no-c-format
msgid "{[aliasname].key}"
-msgstr ""
+msgstr "{[aliasname].key}"
-#: index.docbook:266
+#. Tag: literal
+#: query_sql.xml:266
+#, no-c-format
msgid "ORGID as {coll.key}"
-msgstr ""
+msgstr "ORGID as {coll.key}"
-#: index.docbook:270
+#. Tag: entry
+#: query_sql.xml:270
+#, no-c-format
msgid "The id of an collection"
-msgstr ""
+msgstr "The id of an collection"
-#: index.docbook:272
+#. Tag: literal
+#: query_sql.xml:272
+#, no-c-format
msgid "{[aliasname].id}"
-msgstr ""
+msgstr "{[aliasname].id}"
-#: index.docbook:274
+#. Tag: literal
+#: query_sql.xml:274
+#, no-c-format
msgid "EMPID as {coll.id}"
-msgstr ""
+msgstr "EMPID as {coll.id}"
-#: index.docbook:278
+#. Tag: entry
+#: query_sql.xml:278
+#, no-c-format
msgid "The element of an collection"
-msgstr ""
+msgstr "The element of an collection"
-#: index.docbook:280
+#. Tag: literal
+#: query_sql.xml:280
+#, no-c-format
msgid "{[aliasname].element}"
-msgstr ""
+msgstr "{[aliasname].element}"
-#: index.docbook:282
+#. Tag: literal
+#: query_sql.xml:282
+#, no-c-format
msgid "XID as {coll.element}"
-msgstr ""
+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 ""
+msgstr "roperty of the element in the collection"
-#: index.docbook:288
+#. Tag: literal
+#: query_sql.xml:288
+#, no-c-format
msgid "{[aliasname].element.[propertyname]}"
-msgstr ""
+msgstr "{[aliasname].element.[propertyname]}"
-#: index.docbook:290
+#. Tag: literal
+#: query_sql.xml:290
+#, no-c-format
msgid "NAME as {coll.element.name}"
-msgstr ""
+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 ""
+msgstr "All properties of the element in the collection"
-#: index.docbook:296
+#. Tag: literal
+#: query_sql.xml:296
+#, no-c-format
msgid "{[aliasname].element.*}"
-msgstr ""
+msgstr "{[aliasname].element.*}"
-#: index.docbook:298
+#. Tag: literal
+#: query_sql.xml:298
+#, no-c-format
msgid "{coll.element.*}"
-msgstr ""
+msgstr "{coll.element.*}"
-#: index.docbook:302
+#. Tag: entry
+#: query_sql.xml:302
+#, no-c-format
msgid "All properties of the the collection"
-msgstr ""
+msgstr "All properties of the the collection"
-#: index.docbook:306
+#. Tag: literal
+#: query_sql.xml:306
+#, no-c-format
msgid "{coll.*}"
-msgstr ""
+msgstr "{coll.*}"
-#: index.docbook:315
+#. Tag: title
+#: query_sql.xml:315
+#, no-c-format
msgid "Returning non-managed entities"
-msgstr ""
+msgstr "Returning non-managed entities"
-#: index.docbook:317
-msgid "It is possible to apply a ResultTransformer to native sql queries. Allowing it to e.g. return non-managed entities."
+#. 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 ""
+"It is possible to apply a ResultTransformer to native sql queries. Allowing "
+"it to e.g. return non-managed entities."
-#: 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 ""
-#: index.docbook:329
+#. Tag: para
+#: query_sql.xml:329
+#, no-c-format
msgid "a result transformer"
-msgstr ""
+msgstr "a result transformer"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:340
+#. Tag: title
+#: query_sql.xml:340
+#, no-c-format
msgid "Handling inheritance"
-msgstr ""
+msgstr "Handling inheritance"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:348
+#. Tag: title
+#: query_sql.xml:348
+#, no-c-format
msgid "Parameters"
-msgstr ""
+msgstr "Parameters"
-#: index.docbook:350
+#. Tag: para
+#: query_sql.xml:350
+#, no-c-format
msgid "Native sql queries support positional as well as named parameters:"
-msgstr ""
+msgstr "Native sql queries support positional as well as named parameters:"
-#: 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 ""
-#: index.docbook:361
+#. Tag: title
+#: query_sql.xml:361
+#, no-c-format
msgid "Named SQL queries"
-msgstr ""
+msgstr "Named SQL queries"
-#: 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>."
+#. 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 ""
+"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>."
-#: 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 ""
-#: 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 ""
-#: index.docbook:372
-msgid "The <literal><return-join></literal> and <literal><load-collection></literal> elements are used to join associations and define queries which initialize collections, respectively."
+#. Tag: para
+#: query_sql.xml:372
+#, no-c-format
+msgid ""
+"The <literal><return-join></literal> and <literal><load-"
+"collection></literal> elements are used to join associations and define "
+"queries which initialize collections, respectively."
msgstr ""
+"The <literal><return-join></literal> and <literal><load-"
+"collection></literal> elements are used to join associations and define "
+"queries which initialize collections, respectively."
-#: 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 ""
-#: 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><return-scalar></literal> element:"
+#. 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><return-scalar></literal> "
+"element:"
msgstr ""
+"A named SQL query may return a scalar value. You must declare the column "
+"alias and Hibernate type using the <literal><return-scalar></literal> "
+"element:"
-#: 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 ""
-#: index.docbook:385
-msgid "You can externalize the resultset mapping informations in a <literal><resultset></literal> element to either reuse them accross several named queries or through the <literal>setResultSetMapping()</literal> API."
+#. Tag: para
+#: query_sql.xml:385
+#, no-c-format
+msgid ""
+"You can externalize the resultset mapping informations in a <literal><"
+"resultset></literal> element to either reuse them accross several named "
+"queries or through the <literal>setResultSetMapping()</literal> API."
msgstr ""
+"You can externalize the resultset mapping informations in a <literal><"
+"resultset></literal> element to either reuse them accross several named "
+"queries or through the <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 ""
-#: index.docbook:392
-msgid "You can alternatively use the resultset mapping information in your hbm files directly in java code."
+#. 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 ""
+"You can alternatively use the resultset mapping information in your hbm "
+"files directly in java code."
-#: 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 ""
-#: index.docbook:398
+#. Tag: title
+#: query_sql.xml:398
+#, no-c-format
msgid "Using return-property to explicitly specify column/alias names"
-msgstr ""
+msgstr "Using return-property to explicitly specify column/alias names"
-#: index.docbook:401
-msgid "With <literal><return-property></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."
+#. Tag: para
+#: query_sql.xml:401
+#, no-c-format
+msgid ""
+"With <literal><return-property></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 ""
+"With <literal><return-property></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."
-#: 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 ""
-#: index.docbook:408
-msgid "<literal><return-property></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."
+#. Tag: para
+#: query_sql.xml:408
+#, no-c-format
+msgid ""
+"<literal><return-property></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><return-property></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."
-#: 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 ""
-#: index.docbook:415
-msgid "Notice that in this example we used <literal><return-property></literal> in combination with the <literal>{}</literal>-syntax for injection. Allowing users to choose how they want to refer column and properties."
+#. Tag: para
+#: query_sql.xml:415
+#, no-c-format
+msgid ""
+"Notice that in this example we used <literal><return-property></"
+"literal> in combination with the <literal>{}</literal>-syntax for injection. "
+"Allowing users to choose how they want to refer column and properties."
msgstr ""
+"Notice that in this example we used <literal><return-property></"
+"literal> in combination with the <literal>{}</literal>-syntax for injection. "
+"Allowing users to choose how they want to refer column and properties."
-#: index.docbook:420
-msgid "If your mapping has a discriminator you must use <literal><return-discriminator></literal> to specify the discriminator column."
+#. Tag: para
+#: query_sql.xml:420
+#, no-c-format
+msgid ""
+"If your mapping has a discriminator you must use <literal><return-"
+"discriminator></literal> to specify the discriminator column."
msgstr ""
+"If your mapping has a discriminator you must use <literal><return-"
+"discriminator></literal> to specify the discriminator column."
-#: index.docbook:426
+#. Tag: title
+#: query_sql.xml:426
+#, no-c-format
msgid "Using stored procedures for querying"
-msgstr ""
+msgstr "Using stored procedures for querying"
-#: 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:"
+#. 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 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:"
-#: 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 ""
-#: 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 ""
+msgstr "To use this query in Hibernate you need to map it via a named query."
-#: 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 ""
-#: index.docbook:441
-msgid "Notice stored procedures currently only return scalars and entities. <literal><return-join></literal> and <literal><load-collection></literal> are not supported."
+#. Tag: para
+#: query_sql.xml:441
+#, no-c-format
+msgid ""
+"Notice stored procedures currently only return scalars and entities. "
+"<literal><return-join></literal> and <literal><load-collection></"
+"literal> are not supported."
msgstr ""
+"Notice stored procedures currently only return scalars and entities. "
+"<literal><return-join></literal> and <literal><load-collection></"
+"literal> are not supported."
-#: index.docbook:446
+#. Tag: title
+#: query_sql.xml:446
+#, no-c-format
msgid "Rules/limitations for using stored procedures"
-msgstr ""
+msgstr "Rules/limitations for using stored procedures"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:455
-msgid "Stored procedure queries can't be paged with <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 ""
+"Stored procedure queries can't be paged with <literal>setFirstResult()/"
+"setMaxResults()</literal>."
-#: index.docbook:458
-msgid "Recommended call form is standard SQL92: <literal>{ ? = call functionName(<parameters>) }</literal> or <literal>{ ? = call procedureName(<parameters>}</literal>. Native call syntax is not supported."
+#. Tag: para
+#: query_sql.xml:458
+#, no-c-format
+msgid ""
+"Recommended call form is standard SQL92: <literal>{ ? = call functionName"
+"(<parameters>) }</literal> or <literal>{ ? = call procedureName(<"
+"parameters>}</literal>. Native call syntax is not supported."
msgstr ""
+"Recommended call form is standard SQL92: <literal>{ ? = call functionName"
+"(<parameters>) }</literal> or <literal>{ ? = call procedureName(<"
+"parameters>}</literal>. Native call syntax is not supported."
-#: index.docbook:463
+#. Tag: para
+#: query_sql.xml:463
+#, no-c-format
msgid "For Oracle the following rules apply:"
-msgstr ""
+msgstr "For Oracle the following rules apply:"
-#: 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."
+#. 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 ""
+"A funçãp deve retornar um result set. O primeiro parâmetro da procedure "
+"dever ser uma <literal>SAÍDA</literal> que retorne um result set. Isto é "
+"feito usando o tipo a <literal>SYS_REFCURSOR</literal> no Oracle 9 ou 10. No "
+"Oracle é necessário definir o tipo <literal>REF CURSOR</literal>, veja a "
+"documentação do 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 ""
+msgstr "For Sybase or MS SQL server the following rules apply:"
-#: 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."
+#. 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 ""
+"A procedure deve retornar um result set. Veja que este servidor pode "
+"retornar múltiplos result sets e update counts. O Hibernate ira iterar os "
+"resultados e pegar o primeiro resultado que é o valor de retorno do result "
+"set. O resto será descartado."
-#: 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."
+#. 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 ""
+"Se você habilitar <literal>SET NOCOUNT ON</literal> na sua procedure, ela "
+"provavelmente será mais eficiente. Mas, isto não é obrigatório"
-#: index.docbook:498
+#. Tag: title
+#: query_sql.xml:498
+#, no-c-format
msgid "Custom SQL for create, update and delete"
-msgstr ""
+msgstr "SQL customizado para create, update e delete"
-#: 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><sql-insert></literal>, <literal><sql-delete></literal>, and <literal><sql-update></literal> override these strings:"
+#. 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><sql-insert></literal>, "
+"<literal><sql-delete></literal>, and <literal><sql-update></"
+"literal> override these strings:"
msgstr ""
+"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><sql-insert></literal>, "
+"<literal><sql-delete></literal>, and <literal><sql-update></"
+"literal> override these strings: Hibernate3 pode usar SQL customizado para "
+"operações de create, update e delete. A persistência de classe e collection "
+"no hibernate já contem alguma strings de configurações (insertsql, "
+"deletesql, updatesql etc.). O mapaemento das tags <literal><sql-insert>"
+"</literal>, <literal><sql-delete></literal>, e <literal><sql-"
+"update></literal> sobreecreve essas strings:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"O SQL é executado diretamente no seu banco de dados, então você pode usar "
+"qualquer linguagem que quiser. Isto com certeza reduzira a portabilidade do "
+"seu mapeamento se você utilizar um SQL para um banco de dados especifico."
-#: index.docbook:514
-msgid "Stored procedures are supported if the <literal>callable</literal> attribute is set:"
+#. Tag: para
+#: query_sql.xml:514
+#, no-c-format
+msgid ""
+"Stored procedures are supported if the <literal>callable</literal> attribute "
+"is set:"
msgstr ""
+"Stored Procedures são suportadas se o atributo the <literal>callable</"
+"literal> estiver ativado:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"A ordem de posições dos parâmetros são vitais, pois eles devem estar na "
+"mesma seqüência esperada pelo 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.)"
+#. 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 ""
+"Você pode ver a ordem esperada ativando o debug logging no nível "
+"<literal>org.hibernate.persister.entity</literal>. Com este nível ativado, o "
+"Hibernate irá imprimir o SQL estático que foi usado para create, update, "
+"delete, etc. Entidades. (Para ver a seqüência esperada, lembre-se de não "
+"incluir seu SQL customizado no arquivo de mapeamento, pois ele irá "
+"sobreecreve o SQL estático gerado pelo Hibernate)."
-#: 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:"
+#. 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 ""
+"As stored procedures são na maioria dos casos (leia: melhor não fazer) "
+"requeridas para retornar o numero de linhas inseridas/atualizadas/deletadas. "
+"O hibernate tem algumas verificações em tempo de execução para o sucesso da "
+"declaração. Hibernate sempre registra o primeiro parâmetro da declaração "
+"como uma saída numérica para operações CRUD."
-#: 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 ""
-#: index.docbook:539
+#. Tag: title
+#: query_sql.xml:539
+#, no-c-format
msgid "Custom SQL for loading"
-msgstr ""
+msgstr "SQL customizado para carga"
-#: 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 ""
+"Você pode declarar sua própria query SQL (ou HQL) para iniciar entidades:"
-#: 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 ""
-#: index.docbook:546
-msgid "This is just a named query declaration, as discussed earlier. You may reference this named query in a class mapping:"
+#. 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 ""
+"Este é apenas uma declaração de query com nome, como discutido "
+"anteriormente. Você pode referenciar esta query com nome em um mapeamento de "
+"classe:"
-#: 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 ""
-#: index.docbook:551
+#. Tag: para
+#: query_sql.xml:551
+#, no-c-format
msgid "This even works with stored procedures."
-msgstr ""
+msgstr "Isto também funciona com stored procedures."
-#: index.docbook:553
+#. Tag: para
+#: query_sql.xml:553
+#, no-c-format
msgid "You may even define a query for collection loading:"
-msgstr ""
+msgstr "Você pode tembém definir uma query para iniciar collection:"
-#: 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 ""
-#: 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 ""
-#: index.docbook:559
-msgid "You could even define an entity loader that loads a collection by join fetching:"
+#. 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 ""
+"You could even define an entity loader that loads a collection by join "
+"fetching:"
-#: 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
Modified: core/trunk/documentation/manual/translations/pt-BR/content/session_api.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/session_api.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/session_api.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,982 +1,2231 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Trabalhando com objetos"
-#: 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."
+#. 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 ""
+"O Hibernate é uma solução completa de mapeamento objeto/relacional que não "
+"apenas poupa o desenvolvedor dos detalhes de baixo nível do sistema de "
+"gerenciamento do banco de dados, mas também oferece um "
+"<emphasis>gerenciamento de estado </emphasis> para objetos. Isto é, ao "
+"contrário do gerenciamento de <literal>instruções </literal> SQL em camadas "
+"de persistência JDBC/SQL comuns, uma visão natural da persistência orientada "
+"a objetos em aplicações 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."
+#. 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 ""
+"Em outras palavras, desenvolvedores de aplicações Hibernate podem sempre "
+"pensar em relação ao <emphasis>estado</emphasis> de seus objetos, e não "
+"necessariamente em relação a execução de instruções SQL. Este parte é "
+"responsabilidade do Hibernate e é relevante aos desenvolvedores de "
+"aplicações apenas quando estão ajustando a performance do sistema."
-#: index.docbook:24
+#. Tag: title
+#: session_api.xml:24
+#, no-c-format
msgid "Hibernate object states"
-msgstr ""
+msgstr "Estado dos objetos no Hibernate"
-#: index.docbook:26
+#. Tag: para
+#: session_api.xml:26
+#, no-c-format
msgid "Hibernate defines and supports the following object states:"
-msgstr ""
+msgstr "O Hibernate define e suporta os seguintes estados de um objetos:"
-#: 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)."
+#. 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> - um objeto é transiente se ele foi "
+"instanciando usando apenas o operador <literal>new</literal>, e não foi "
+"associado com uma <literal>Session</literal> do Hibernate. Ele não terá uma "
+"representação persistente no banco de dados e nenhum identificador será "
+"atribuído para ele. Instâncias transientes serão destruídas pelo coletor de "
+"lixo se a aplicação não manter sua referência. Use uma <literal>Session</"
+"literal> do Hibernate para tornar o objeto persistente ( e deixe o Hibernate "
+"gerenciar as instruções SQL que serão necessárias para executar esta "
+"transição)."
-#: 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."
+#. 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> -– uma instância persistente possui uma "
+"representação no banco de dados e um identificador. Ele pode ter sido salvo "
+"ou carregado, assim, ele está por definição no escopo de uma "
+"<literal>Session</literal>. O Hibernate irá detectar qualquer mudança feita "
+"a um objeto persistente e sincronizar o seu estado com o banco de dados "
+"quando completar a unidade de trabalho. Desenvolvedores não executam "
+"instruções manuais de <literal>UPDATE</literal>, ou instruções de "
+"<literal>DELETE</literal> quando o objeto deve ser passado para transiente."
-#: 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."
+#. 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> – uma instância desaclopada é um objeto que "
+"foi persistido, mas sua <literal>Session</literal> foi fechada. A referência "
+"ao objeto continua válida, é claro, e a instância destacada desaclopada pode "
+"ser acoplada a uma nova <literal>Session</literal> no futuro, fazendo-o ( e "
+"todas as modificações sofridas) persistente novamente. Essa característica "
+"possibilita um modelo de programação para unidades de trabalho que rodam "
+"durante muito tempo que requer um pensamento por tempo do usuário. Podemos "
+"chamar-las de <emphasis>transações da aplicação</emphasis>, i.e. uma unidade "
+"de trabalho do ponto de vista do usuário."
-#: index.docbook:69
-msgid "We'll now discuss the states and state transitions (and the Hibernate methods that trigger a transition) in more detail."
+#. 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 ""
+"Agora iremos discutir os estados e suas transições ( e os métodos do "
+"Hibernate que disparam uma transição) em mais detalhes."
-#: index.docbook:77
+#. Tag: title
+#: session_api.xml:77
+#, no-c-format
msgid "Making objects persistent"
-msgstr ""
+msgstr "Tornando os objetos persistentes"
-#: 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:"
+#. 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 ""
+"Instâncias recentemente instanciadas de uma classe persistente são "
+"consideradas <emphasis>transientes </emphasis> pelo Hibernate. Podemos "
+"tornar uma instância transiente em <emphasis>persistente</emphasis> "
+"associando-a a uma sessão:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Se <literal>Cat</literal> possui um identificador gerado, o identificador é "
+"gerado e atribuído a <literal>cat</literal> quando <literal>save()</literal> "
+"for chamada. Se <literal>Cat</literal> possuir um identificador "
+"<literal>Associado</literal>, ou uma chave composta, o identificador deve "
+"ser atribuído à instância de <literal>cat</literal> antes que <literal>save()"
+"</literal> seja chamado. Pode-se usar também <literal>persist()</literal> ao "
+"invés de <literal>save()</literal>, com a semântica definada no novo esboço "
+"do EJB3."
-#: 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."
+#. 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 ""
+"<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>."
+#. 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 ""
+"Alternativamente, pode-se atribuir o identificador usando uma versão "
+"sobrecarregada de <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) );]]>"
+"<![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."
+#. 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 ""
+"Se o objeto persistido possuir objetos associados (e.g. a coleção "
+"<literal>kittens</literal> no exemplo anterior), esses objetos podem ser "
+"tornar persistente em qualquer ordem que se queira ao menos que se tenha uma "
+"restrição <literal>NOT NULL</literal> em uma coluna de chave estrangeira. "
+"Nunca há risco de violação de restrições de chave estrangeira. Assim, pode-"
+"se violar uma restrição <literal>NOT NULL</literal> se <literal>save()</"
+"literal> for usada nos objetos em uma ordem errada."
-#: 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."
+#. 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 ""
+"Geralmente você não deve se importar com esses detalhes, muito provavelmente "
+"se usará a característica de <emphasis>persistência transitiva </emphasis> "
+"do Hibernate para salvar os objetos associados automaticamente. Então, "
+"enquanto uma restrição <literal>NOT NULL</literal> não ocorrer – Hibernate "
+"tomará conta de tudo. Persistência transitiva será discutida futuramente "
+"nesse capítulo."
-#: index.docbook:149
+#. Tag: title
+#: session_api.xml:149
+#, no-c-format
msgid "Loading an object"
-msgstr ""
+msgstr "Carregando o objetos"
-#: 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 ""
+"O método <literal>load()</literal> de uma <literal> Session</literal> nos "
+"fornece um meio para recuperar uma instância persistente se o identificador "
+"for conhecido. <literal>load()</literal> recebe uma classe do objeto e "
+"carregará o estado em uma instância mais recente dessa classe, no estado "
+"persistente."
-#: index.docbook:158
+#. Tag: programlisting
+#: session_api.xml:158
+#, no-c-format
msgid "<![CDATA[Cat fritz = (Cat) sess.load(Cat.class, generatedId);]]>"
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 ""
-#: index.docbook:162
+#. Tag: para
+#: session_api.xml:162
+#, no-c-format
msgid "Alternatively, you can load state into a given instance:"
msgstr ""
+"Alternatively, you can load state into a given instance: Alternativamente, "
+"pode-se carregar um estado em uma instância dada:"
-#: 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();]]>"
+"<![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 ""
+"Repare que <literal>load()</literal> irá lançar uma exceção irrecuperável se "
+"não houver na tabela no banco de dados um registro que combine. Se a classe "
+"for mapeada com um proxy, <literal>load()</literal> simplesmente retorna um "
+"proxy não inicializado e realmente não chamará o banco de dados até que um "
+"método do proxy seja invocado. Esse comportamento é muito útil se deseja-se "
+"criar uma associação com um objeto sem que realmente o carregue do bando de "
+"dados. Isto também permite que sejam carregadas múltiplas instâncias como um "
+"grupo se <literal>batch-size</literal> estiver para o mapeamento da classe."
-#: 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."
+#. 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 ""
+"Se você não tiver certeza da existencia do registro no banco, você deve usar "
+"o metodo <literal>get()</literal>, que consulta o banco imediantamente e "
+"retorna um null se não existir o registro."
-#: 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;]]>"
+"<![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."
+#. 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 ""
+"Também pode-se carregar um objeto usando <literal>SELECT ... FOR UPDATE</"
+"literal>, usando um <literal>LockMode</literal>. Veja a documentação da API "
+"para maiores informações."
-#: 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 ""
-#: 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 ""
+"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."
-#: 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."
+#. 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 ""
+"O recarregamento de um objeto e todas as suas coleções é possível a qualquer "
+"momento, usando o método <literal>refresh()</literal>. Util quando as "
+"triggers do banco de dados são usados para inicializar algumas propriedades "
+"do objeto."
-#: 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)]]>"
+"<![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\"/>."
+#. 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 ""
+"Uma importante questão geralmente aparece neste ponto: O quanto Hibernate "
+"carrega do banco de dados e quantos SQL <literal>SELECT</literal> ele irá "
+"usar? Isto depende da estratégia de <emphasis>recuperação</emphasis>usada e "
+"explicada na <xref linkend=\"performance-fetching\"/>."
-#: index.docbook:219
+#. Tag: title
+#: session_api.xml:219
+#, no-c-format
msgid "Querying"
-msgstr ""
+msgstr "Consultando"
-#: 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."
+#. 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 ""
+"Se o identificador do objeto que se está buscando não for conhecido, uma "
+"consulta será necessária. O Hibernate suporta uma linguagem de consulta "
+"(HQL) orientada a objetos fácil mas poderosa. Para criação via programação "
+"de consultas, o Hibernate suporta características sofisticadas de consulta "
+"por Critério e Exemplo (QBCe QBE). Pode-se também expressar a consulta por "
+"meio de SQL nativa do banco de dados, com suporte opcional do Hibernate para "
+"conversão do conjunto de reultados em objetos."
-#: index.docbook:231
+#. Tag: title
+#: session_api.xml:231
+#, no-c-format
msgid "Executing queries"
-msgstr ""
+msgstr "Executando consultas"
-#: 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>:"
+#. 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 ""
+"Consultas HQL e SQL nativa são representadas por uma instância de "
+"<literal>org.hibernate.Query</literal>. Esta interface oferece métodos para "
+"associação de parâmetros, tratamento de conjunto de resultados, e para a "
+"execução de consultas reais. Você pode obter uma <literal>Query</literal> "
+"usando a <literal>Session</literal> atual:"
-#: index.docbook:240
+#. 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());]]>"
+"<![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: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>."
+#. Tag: para
+#: session_api.xml:242
+#, no-c-format
+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 ""
+"Geralmente uma consulta é executada ao invocar <literal>list()</literal>, o "
+"resultado da consulta será carregado completamente em uma coleção na "
+"memória. Instâncias de entidades recuperadas por uma consulta estão no "
+"estado persistente. O <literal>uniqueResult()</literal> oferece um atalho se "
+"você souber de previamente que a consulta retornará apenas um único objeto. "
+"Repare que consultas que fazem uso de buscas de coleções de forma ansiosa "
+"(eager) geralmente retornam duplicatas dos objetos raiz ( mas com suas "
+"coleções inicializadas ). Pode-se filtrar estas duplicatas através de um "
+"simples <literal>Set</literal>."
-#: index.docbook:254
+#. Tag: title
+#: session_api.xml:254
+#, no-c-format
msgid "Iterating results"
-msgstr ""
+msgstr "Interagindo com resultados"
-#: 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: 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 ""
+"Ocasionalmente, deves-se ser capaz de atingir performances melhores com a "
+"execução de consultas usando o método <literal>iterate()</literal>. "
+"Geralmente isso será o caso esperado apenas se as instâncias dos entidades "
+"reais retornadas pela consulta já estiverem na sessão ou no caché de segundo "
+"nível. Caso elas ainda não tenham sido armazenadas, <literal>iterate()</"
+"literal> será mais devagar do que <literal>list()</literal> e pode ser "
+"necessário vários acessos ao banco de dados para um simples consulta, "
+"geralmente <emphasis>1</emphasis> para a seleção inicial que retorna apenas "
+"identificadores, e <emphasis>n</emphasis> consultas adicionais para "
+"inicializar as instâncias reais."
-#: index.docbook:268
+#. 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"
- "}]]>"
+"<![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 ""
-#: index.docbook:272
+#. Tag: title
+#: session_api.xml:272
+#, no-c-format
msgid "Queries that return tuples"
-msgstr ""
+msgstr "Consultas que retornam tuplas"
-#: index.docbook:274
-msgid "Hibernate queries sometimes return tuples of objects, in which case each tuple is returned as an array:"
+#. Tag: para
+#: session_api.xml:274
+#, no-c-format
+msgid ""
+"Hibernate queries sometimes return tuples of objects, in which case each "
+"tuple is returned as an array:"
msgstr ""
+"Algumas vezes as consultas do Hibernate retornam tuplas de objetos, nesse "
+"caso cada tupla é retornada como um array:"
-#: index.docbook:279
+#. 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"
- "}]]>"
+"<![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 ""
-#: index.docbook:284
+#. Tag: title
+#: session_api.xml:284
+#, no-c-format
msgid "Scalar results"
-msgstr ""
+msgstr "Resultados escalares"
-#: 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: para
+#: session_api.xml:286
+#, no-c-format
+msgid ""
+"Queries may specify a property of a class in the <literal>select</literal> "
+"clause. They may even call SQL aggregate functions. Properties or aggregates "
+"are considered \"scalar\" results (and not entities in persistent state)."
msgstr ""
+"Consultas devem especificar uma propriedade da classe na clausula "
+"<literal>select</literal>. Elas também podem chamar funções SQL de "
+"agregaçãos. Propriedades ou agregações são considerados resultados agregados "
+"( e não entidades no estado persistente)."
-#: index.docbook:292
+#. 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"
- "}]]>"
+"<![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 ""
-#: index.docbook:297
+#. Tag: title
+#: session_api.xml:297
+#, no-c-format
msgid "Bind parameters"
-msgstr ""
+msgstr "Bind parameters"
-#: 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:299
+#, no-c-format
+msgid ""
+"Methods on <literal>Query</literal> are provided for binding values to named "
+"parameters or JDBC-style <literal>?</literal> parameters. <emphasis>Contrary "
+"to JDBC, Hibernate numbers parameters from zero.</emphasis> Named parameters "
+"are identifiers of the form <literal>:name</literal> in the query string. "
+"The advantages of named parameters are:"
msgstr ""
+"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:"
-#: index.docbook:309
-msgid "named parameters are insensitive to the order they occur in the query string"
+#. Tag: para
+#: session_api.xml:309
+#, no-c-format
+msgid ""
+"named parameters are insensitive to the order they occur in the query string"
msgstr ""
+"named parameters are insensitive to the order they occur in the query string"
-#: index.docbook:315
+#. Tag: para
+#: session_api.xml:315
+#, no-c-format
msgid "they may occur multiple times in the same query"
-msgstr ""
+msgstr "they may occur multiple times in the same query"
-#: index.docbook:320
+#. Tag: para
+#: session_api.xml:320
+#, no-c-format
msgid "they are self-documenting"
-msgstr ""
+msgstr "they are self-documenting"
-#: index.docbook:326
+#. 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();]]>"
+"<![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 ""
-#: index.docbook:328
+#. 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();]]>"
+"<![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 ""
-#: index.docbook:330
+#. Tag: programlisting
+#: session_api.xml:330
+#, no-c-format
msgid ""
- "<![CDATA[//named parameter list\n"
- "List names = new ArrayList();\n"
- "names.add(\"Izi\");\n"
- "names.add(\"Fritz\");\n"
- "Query q = sess.createQuery(\"from DomesticCat cat where cat.name in (:namesList)\");\n"
- "q.setParameterList(\"namesList\", names);\n"
- "List cats = q.list();]]>"
+"<![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 ""
-#: index.docbook:335
+#. Tag: title
+#: session_api.xml:335
+#, no-c-format
msgid "Pagination"
-msgstr ""
+msgstr "Pagination"
-#: 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:"
+#. Tag: para
+#: session_api.xml:337
+#, no-c-format
+msgid ""
+"If you need to specify bounds upon your result set (the maximum number of "
+"rows you want to retrieve and / or the first row you want to retrieve) you "
+"should use methods of the <literal>Query</literal> interface:"
msgstr ""
+"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:"
-#: index.docbook:343
+#. 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();]]>"
+"<![CDATA[Query q = sess.createQuery(\"from DomesticCat cat\");\n"
+"q.setFirstResult(20);\n"
+"q.setMaxResults(10);\n"
+"List cats = q.list();]]>"
msgstr ""
-#: index.docbook:345
-msgid "Hibernate knows how to translate this limit query into the native SQL of your DBMS."
+#. 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 ""
+"Hibernate knows how to translate this limit query into the native SQL of "
+"your DBMS."
-#: index.docbook:353
+#. Tag: title
+#: session_api.xml:353
+#, no-c-format
msgid "Scrollable iteration"
-msgstr ""
+msgstr "Scrollable iteration"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:362
+#. 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()]]>"
+"<![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 ""
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:373
+#. Tag: title
+#: session_api.xml:373
+#, no-c-format
msgid "Externalizing named queries"
-msgstr ""
+msgstr "Externalizing named queries"
-#: 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.)"
+#. 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 ""
+"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.)"
-#: index.docbook:381
+#. 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>]]>"
+"<![CDATA[<query name=\"ByNameAndMaximumWeight\"><![CDATA[\n"
+" from eg.DomesticCat as cat\n"
+" where cat.name = ?\n"
+" and cat.weight > ?\n"
+"] ]></query>]]>"
msgstr ""
-#: index.docbook:383
+#. Tag: para
+#: session_api.xml:383
+#, no-c-format
msgid "Parameter binding and executing is done programatically:"
-msgstr ""
+msgstr "Parameter binding and executing is done programatically:"
-#: index.docbook:387
+#. Tag: programlisting
+#: session_api.xml:387
+#, no-c-format
msgid ""
- "<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n"
- "q.setString(0, name);\n"
- "q.setInt(1, minWeight);\n"
- "List cats = q.list();]]>"
+"<![CDATA[Query q = sess.getNamedQuery(\"ByNameAndMaximumWeight\");\n"
+"q.setString(0, name);\n"
+"q.setInt(1, minWeight);\n"
+"List cats = q.list();]]>"
msgstr ""
-#: 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: 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 ""
+"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."
-#: index.docbook:395
-msgid "Also note that a query declaration inside a <literal><hibernate-mapping></literal> element requires a global unique name for the query, while a query declaration inside a <literal><class></literal> element is made unique automatically by prepending the fully qualified name of the class, for example <literal>eg.Cat.ByNameAndMaximumWeight</literal>."
+#. Tag: para
+#: session_api.xml:395
+#, no-c-format
+msgid ""
+"Also note that a query declaration inside a <literal><hibernate-"
+"mapping></literal> element requires a global unique name for the query, "
+"while a query declaration inside a <literal><class></literal> element "
+"is made unique automatically by prepending the fully qualified name of the "
+"class, for example <literal>eg.Cat.ByNameAndMaximumWeight</literal>."
msgstr ""
+"Also note that a query declaration inside a <literal><hibernate-"
+"mapping></literal> element requires a global unique name for the query, "
+"while a query declaration inside a <literal><class></literal> element "
+"is made unique automatically by prepending the fully qualified name of the "
+"class, for example <literal>eg.Cat.ByNameAndMaximumWeight</literal>."
-#: index.docbook:408
+#. Tag: title
+#: session_api.xml:408
+#, no-c-format
msgid "Filtering collections"
-msgstr ""
+msgstr "Filtering collections"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:415
+#. 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"
- ");]]>"
+"<![CDATA[Collection blackKittens = session.createFilter(\n"
+" pk.getKittens(), \n"
+" \"where this.color = ?\")\n"
+" .setParameter( Color.BLACK, Hibernate.custom(ColorUserType.class) )\n"
+" .list()\n"
+");]]>"
msgstr ""
-#: 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: 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 ""
+"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)."
-#: 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."
+#. Tag: para
+#: session_api.xml:423
+#, no-c-format
+msgid ""
+"Observe that filters do not require a <literal>from</literal> clause (though "
+"they may have one if required). Filters are not limited to returning the "
+"collection elements themselves."
msgstr ""
+"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."
-#: index.docbook:428
+#. 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();]]>"
+"<![CDATA[Collection blackKittenMates = session.createFilter(\n"
+" pk.getKittens(), \n"
+" \"select this.mate where this.color = eg.Color.BLACK.intValue\")\n"
+" .list();]]>"
msgstr ""
-#: index.docbook:430
-msgid "Even an empty filter query is useful, e.g. to load a subset of elements in a huge collection:"
+#. 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 ""
+"Even an empty filter query is useful, e.g. to load a subset of elements in a "
+"huge collection:"
-#: index.docbook:435
+#. Tag: programlisting
+#: session_api.xml:435
+#, no-c-format
msgid ""
- "<![CDATA[Collection tenKittens = session.createFilter(\n"
- " mother.getKittens(), \"\")\n"
- " .setFirstResult(0).setMaxResults(10)\n"
- " .list();]]>"
+"<![CDATA[Collection tenKittens = session.createFilter(\n"
+" mother.getKittens(), \"\")\n"
+" .setFirstResult(0).setMaxResults(10)\n"
+" .list();]]>"
msgstr ""
-#: index.docbook:440
+#. Tag: title
+#: session_api.xml:440
+#, no-c-format
msgid "Criteria queries"
-msgstr ""
+msgstr "Criteria queries"
-#: 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:"
+#. Tag: para
+#: session_api.xml:442
+#, no-c-format
+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 ""
+"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:"
-#: index.docbook:448
+#. 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();]]>"
+"<![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 ""
-#: index.docbook:450
-msgid "The <literal>Criteria</literal> and the associated <literal>Example</literal> API are discussed in more detail in <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 ""
+"The <literal>Criteria</literal> and the associated <literal>Example</"
+"literal> API are discussed in more detail in <xref linkend=\"querycriteria\"/"
+">."
-#: index.docbook:458
+#. Tag: title
+#: session_api.xml:458
+#, no-c-format
msgid "Queries in native SQL"
-msgstr ""
+msgstr "Queries in native SQL"
-#: 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: 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 ""
+"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:"
-#: index.docbook:468
+#. 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();]]>"
+"<![CDATA[List cats = session.createSQLQuery(\"SELECT {cat.*} FROM CAT {cat} "
+"WHERE ROWNUM<10\")\n"
+" .addEntity(\"cat\", Cat.class)\n"
+".list();]]>"
msgstr ""
-#: index.docbook:470
+#. 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()]]>"
+"<![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 ""
-#: 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\"/>."
+#. Tag: para
+#: session_api.xml:472
+#, no-c-format
+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 ""
+"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\"/>."
-#: index.docbook:483
+#. Tag: title
+#: session_api.xml:483
+#, no-c-format
msgid "Modifying persistent objects"
-msgstr ""
+msgstr "Modifying persistent objects"
-#: 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:"
+#. 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>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:"
-#: index.docbook:496
+#. 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]]>"
+"<![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 ""
-#: 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: 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 ""
+"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."
-#: 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."
+#. Tag: emphasis
+#: session_api.xml:506
+#, fuzzy, no-c-format
+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 ""
+"Note that Hibernate does not offer its own API for direct execution of "
+"<placeholder-1/> or <placeholder-2/> statements. Hibernate is a <placeholder-"
+"3/> service, you don't have to think in <placeholder-4/> to use it. JDBC is "
+"a perfect API for executing SQL statements, you can get a JDBC <placeholder-"
+"5/> at any time by calling <placeholder-6/>. 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."
-#: index.docbook:521
+#. Tag: title
+#: session_api.xml:521
+#, no-c-format
msgid "Modifying detached objects"
-msgstr ""
+msgstr "Modifying detached objects"
-#: 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: 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 ""
+"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."
-#: 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:"
+#. 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 supports this model by providing for reattachment of detached "
+"instances using the <literal>Session.update()</literal> or <literal>Session."
+"merge()</literal> methods:"
-#: index.docbook:536
+#. 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]]>"
+"<![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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. Tag: para
+#: session_api.xml:544
+#, no-c-format
+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 ""
+"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."
-#: 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: 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 ""
+"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\"/>."
-#: 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!"
+#. 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 ""
+"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!"
-#: index.docbook:565
+#. 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);]]>"
+"<![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 ""
-#: 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: 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 ""
+"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>."
-#: index.docbook:574
-msgid "Other models for long units of work are discussed in <xref linkend=\"transactions-optimistic\"/>."
+#. Tag: para
+#: session_api.xml:574
+#, no-c-format
+msgid ""
+"Other models for long units of work are discussed in <xref linkend="
+"\"transactions-optimistic\"/>."
msgstr ""
+"Other models for long units of work are discussed in <xref linkend="
+"\"transactions-optimistic\"/>."
-#: index.docbook:581
+#. Tag: title
+#: session_api.xml:581
+#, no-c-format
msgid "Automatic state detection"
-msgstr ""
+msgstr "Automatic state detection"
-#: 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."
+#. 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 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."
-#: index.docbook:590
+#. 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)]]>"
+"<![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 ""
-#: 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: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 ""
+"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."
-#: index.docbook:600
-msgid "Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are used in the following scenario:"
+#. Tag: para
+#: session_api.xml:600
+#, no-c-format
+msgid ""
+"Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are "
+"used in the following scenario:"
msgstr ""
+"Usually <literal>update()</literal> or <literal>saveOrUpdate()</literal> are "
+"used in the following scenario:"
-#: index.docbook:607
+#. Tag: para
+#: session_api.xml:607
+#, no-c-format
msgid "the application loads an object in the first session"
-msgstr ""
+msgstr "the application loads an object in the first session"
-#: index.docbook:612
+#. Tag: para
+#: session_api.xml:612
+#, no-c-format
msgid "the object is passed up to the UI tier"
-msgstr ""
+msgstr "the object is passed up to the UI tier"
-#: index.docbook:617
+#. Tag: para
+#: session_api.xml:617
+#, no-c-format
msgid "some modifications are made to the object"
-msgstr ""
+msgstr "some modifications are made to the object"
-#: index.docbook:622
+#. Tag: para
+#: session_api.xml:622
+#, no-c-format
msgid "the object is passed back down to the business logic tier"
-msgstr ""
+msgstr "the object is passed back down to the business logic tier"
-#: index.docbook:627
-msgid "the application persists these modifications by calling <literal>update()</literal> in a second session"
+#. 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 ""
+"the application persists these modifications by calling <literal>update()</"
+"literal> in a second session"
-#: index.docbook:634
+#. Tag: para
+#: session_api.xml:634
+#, no-c-format
msgid "<literal>saveOrUpdate()</literal> does the following:"
-msgstr ""
+msgstr "<literal>saveOrUpdate()</literal> does the following:"
-#: 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 ""
+msgstr "if the object is already persistent in this session, do nothing"
-#: index.docbook:645
-msgid "if another object associated with the session has the same identifier, throw an exception"
+#. 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 ""
+"if another object associated with the session has the same identifier, throw "
+"an exception"
-#: 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 ""
+msgstr "if the object has no identifier property, <literal>save()</literal> it"
-#: index.docbook:656
-msgid "if the object's identifier has the value assigned to a newly instantiated object, <literal>save()</literal> it"
+#. 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 ""
+"if the object's identifier has the value assigned to a newly instantiated "
+"object, <literal>save()</literal> it"
-#: index.docbook:662
-msgid "if the object is versioned (by a <literal><version></literal> or <literal><timestamp></literal>), and the version property value is the same value assigned to a newly instantiated object, <literal>save()</literal> it"
+#. Tag: para
+#: session_api.xml:662
+#, no-c-format
+msgid ""
+"if the object is versioned (by a <literal><version></literal> or "
+"<literal><timestamp></literal>), and the version property value is the "
+"same value assigned to a newly instantiated object, <literal>save()</"
+"literal> it"
msgstr ""
+"if the object is versioned (by a <literal><version></literal> or "
+"<literal><timestamp></literal>), and the version property value is the "
+"same value assigned to a newly instantiated object, <literal>save()</"
+"literal> it"
-#: index.docbook:670
+#. Tag: para
+#: session_api.xml:670
+#, no-c-format
msgid "otherwise <literal>update()</literal> the object"
-msgstr ""
+msgstr "otherwise <literal>update()</literal> the object"
-#: index.docbook:676
+#. Tag: para
+#: session_api.xml:676
+#, no-c-format
msgid "and <literal>merge()</literal> is very different:"
-msgstr ""
+msgstr "and <literal>merge()</literal> is very different:"
-#: 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"
+#. 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 ""
+"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"
-#: 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"
+#. 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 ""
+"if there is no persistent instance currently associated with the session, "
+"try to load it from the database, or create a new persistent instance"
-#: index.docbook:695
+#. Tag: para
+#: session_api.xml:695
+#, no-c-format
msgid "the persistent instance is returned"
-msgstr ""
+msgstr "the persistent instance is returned"
-#: index.docbook:700
-msgid "the given instance does not become associated with the session, it remains detached"
+#. Tag: para
+#: session_api.xml:700
+#, no-c-format
+msgid ""
+"the given instance does not become associated with the session, it remains "
+"detached"
msgstr ""
+"the given instance does not become associated with the session, it remains "
+"detached"
-#: index.docbook:710
+#. Tag: title
+#: session_api.xml:710
+#, no-c-format
msgid "Deleting persistent objects"
-msgstr ""
+msgstr "Deleting persistent objects"
-#: 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."
+#. 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> 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."
-#: index.docbook:719
+#. Tag: programlisting
+#: session_api.xml:719
+#, no-c-format
msgid "<![CDATA[sess.delete(cat);]]>"
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."
+#. 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 ""
+"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."
-#: index.docbook:732
+#. Tag: title
+#: session_api.xml:732
+#, no-c-format
msgid "Replicating object between two different datastores"
-msgstr ""
+msgstr "Replicating object between two different datastores"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:740
+#. 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();]]>"
+"<![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:742
-msgid "The <literal>ReplicationMode</literal> determines how <literal>replicate()</literal> will deal with conflicts with existing rows in the database."
+#. Tag: para
+#: session_api.xml:742
+#, no-c-format
+msgid ""
+"The <literal>ReplicationMode</literal> determines how <literal>replicate()</"
+"literal> will deal with conflicts with existing rows in the database."
msgstr ""
+"The <literal>ReplicationMode</literal> determines how <literal>replicate()</"
+"literal> will deal with conflicts with existing rows in the database."
-#: index.docbook:749
-msgid "<literal>ReplicationMode.IGNORE</literal> - ignore the object when there is an existing database row with the same identifier"
+#. 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> - ignore the object when there is "
+"an existing database row with the same identifier"
-#: index.docbook:755
-msgid "<literal>ReplicationMode.OVERWRITE</literal> - overwrite any existing database row with the same identifier"
+#. 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> - overwrite any existing "
+"database row with the same identifier"
-#: index.docbook:761
-msgid "<literal>ReplicationMode.EXCEPTION</literal> - throw an exception if there is an existing database row with the same identifier"
+#. 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> - throw an exception if there "
+"is an existing database row with the same identifier"
-#: 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"
+#. 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> - overwrite the row if its "
+"version number is earlier than the version number of the object, or ignore "
+"the object otherwise"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:784
+#. Tag: title
+#: session_api.xml:784
+#, no-c-format
msgid "Flushing the Session"
-msgstr ""
+msgstr "Flushing the Session"
-#: 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"
+#. 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 ""
+"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"
-#: index.docbook:795
+#. Tag: para
+#: session_api.xml:795
+#, no-c-format
msgid "before some query executions"
-msgstr ""
+msgstr "before some query executions"
-#: index.docbook:800
+#. Tag: para
+#: session_api.xml:800
+#, no-c-format
msgid "from <literal>org.hibernate.Transaction.commit()</literal>"
-msgstr ""
+msgstr "from <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 ""
+msgstr "from <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 "The SQL statements are issued in the following order"
-#: index.docbook:817
-msgid "all entity insertions, in the same order the corresponding objects were saved using <literal>Session.save()</literal>"
+#. 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 ""
+"all entity insertions, in the same order the corresponding objects were "
+"saved using <literal>Session.save()</literal>"
-#: index.docbook:823
+#. Tag: para
+#: session_api.xml:823
+#, no-c-format
msgid "all entity updates"
-msgstr ""
+msgstr "all entity updates"
-#: index.docbook:828
+#. Tag: para
+#: session_api.xml:828
+#, no-c-format
msgid "all collection deletions"
-msgstr ""
+msgstr "all collection deletions"
-#: index.docbook:833
+#. Tag: para
+#: session_api.xml:833
+#, no-c-format
msgid "all collection element deletions, updates and insertions"
-msgstr ""
+msgstr "all collection element deletions, updates and insertions"
-#: index.docbook:838
+#. Tag: para
+#: session_api.xml:838
+#, no-c-format
msgid "all collection insertions"
-msgstr ""
+msgstr "all collection insertions"
-#: index.docbook:843
-msgid "all entity deletions, in the same order the corresponding objects were deleted using <literal>Session.delete()</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 ""
+"all entity deletions, in the same order the corresponding objects were "
+"deleted using <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.)"
+#. 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 ""
+"(An exception is that objects using <literal>native</literal> ID generation "
+"are inserted when they are saved.)"
-#: 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 ""
+"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."
-#: 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\"/>)."
+#. 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 ""
+"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\"/>)."
-#: 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();]]>"
+"<![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\"/>."
+#. 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 ""
+"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\"/>."
-#: index.docbook:884
+#. Tag: title
+#: session_api.xml:884
+#, no-c-format
msgid "Transitive persistence"
-msgstr ""
+msgstr "Transitive persistence"
-#: 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:"
+#. 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 ""
+"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:"
-#: 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: 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:"
+#. 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 ""
+"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:"
-#: index.docbook:921
+#. Tag: programlisting
+#: session_api.xml:921
+#, no-c-format
msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist\"/>]]>"
msgstr ""
-#: index.docbook:923
+#. Tag: para
+#: session_api.xml:923
+#, no-c-format
msgid "Cascade styles my be combined:"
-msgstr ""
+msgstr "Cascade styles my be combined:"
-#: index.docbook:927
-msgid "<![CDATA[<one-to-one name=\"person\" cascade=\"persist,delete,lock\"/>]]>"
+#. 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."
+#. 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 ""
+"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."
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:942
+#. Tag: para
+#: session_api.xml:942
+#, no-c-format
msgid "Recommendations:"
-msgstr ""
+msgstr "Recommendations:"
-#: index.docbook:948
-msgid "It doesn't usually make sense to enable cascade on a <literal><many-to-one></literal> or <literal><many-to-many></literal> association. Cascade is often useful for <literal><one-to-one></literal> and <literal><one-to-many></literal> associations."
+#. Tag: para
+#: session_api.xml:948
+#, no-c-format
+msgid ""
+"It doesn't usually make sense to enable cascade on a <literal><many-to-"
+"one></literal> or <literal><many-to-many></literal> association. "
+"Cascade is often useful for <literal><one-to-one></literal> and "
+"<literal><one-to-many></literal> associations."
msgstr ""
+"It doesn't usually make sense to enable cascade on a <literal><many-to-"
+"one></literal> or <literal><many-to-many></literal> association. "
+"Cascade is often useful for <literal><one-to-one></literal> and "
+"<literal><one-to-many></literal> associations."
-#: 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>."
+#. 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 ""
+"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>."
-#: 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>."
+#. 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 ""
+"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>."
-#: 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."
+#. 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 ""
+"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."
-#: 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><one-to-many></literal> association mapped with <literal>cascade=\"delete-orphan\"</literal>. The precise semantics of cascading operations for a parent/child relationship are as follows:"
+#. 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><one-to-many></"
+"literal> association mapped with <literal>cascade=\"delete-orphan\"</"
+"literal>. The precise semantics of cascading operations for a parent/child "
+"relationship are as follows:"
msgstr ""
+"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><one-to-many></"
+"literal> association mapped with <literal>cascade=\"delete-orphan\"</"
+"literal>. The precise semantics of cascading operations for a parent/child "
+"relationship are as follows:"
-#: index.docbook:988
-msgid "If a parent is passed to <literal>persist()</literal>, all children are passed to <literal>persist()</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 ""
+"If a parent is passed to <literal>persist()</literal>, all children are "
+"passed to <literal>persist()</literal>"
-#: index.docbook:994
-msgid "If a parent is passed to <literal>merge()</literal>, all children are passed to <literal>merge()</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 ""
+"If a parent is passed to <literal>merge()</literal>, all children are passed "
+"to <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>"
+#. 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 ""
+"If a parent is passed to <literal>save()</literal>, <literal>update()</"
+"literal> or <literal>saveOrUpdate()</literal>, all children are passed to "
+"<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>"
+#. 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 ""
+"If a transient or detached child becomes referenced by a persistent parent, "
+"it is passed to <literal>saveOrUpdate()</literal>"
-#: index.docbook:1012
-msgid "If a parent is deleted, all children are passed to <literal>delete()</literal>"
+#. Tag: para
+#: session_api.xml:1012
+#, no-c-format
+msgid ""
+"If a parent is deleted, all children are passed to <literal>delete()</"
+"literal>"
msgstr ""
+"If a parent is deleted, all children are passed to <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."
+#. 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 ""
+"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."
-#: 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>."
+#. 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 ""
+"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>."
-#: index.docbook:1038
+#. Tag: title
+#: session_api.xml:1038
+#, no-c-format
msgid "Using metadata"
-msgstr ""
+msgstr "Usando metadados"
-#: 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 ""
+"O Hibernate requer um modelo muito rico a nível de metadados de todas as "
+"entidades e tipos de valores. De tempos em tempos, este modelo é muito útil "
+"à própria aplicação. Por exemplo, a aplicação pode usar o metadados do "
+"Hibernate que executa um algoritmo \"inteligente\" que compreende quais "
+"objetos podem ser copiados (por exemplo, tipos de valores mutáveis) ou não "
+"(por exemplo, tipos de valores imutáveis e, possivelmente, entidades "
+"associadas)."
-#: 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 ""
+"O Hibernate expõe o metadados via interfaces <literal>ClassMetadata</"
+"literal> e <literal>CollectionMetadata</literal> e pela hierarquia "
+"<literal>Type</literal>. Instâncias das interfaces de metadados podem ser "
+"obtidas a partir do <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 "state management"
+
+#~ msgid "statements"
+#~ msgstr "statements"
+
+#~ msgid "Connection"
+#~ msgstr "Connection"
+
+#~ msgid "session.connection()"
+#~ msgstr "session.connection()"
Modified: core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/toolset_guide.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,662 +1,1179 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+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."
+#. 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 ""
+"Roundtrip engineering with Hibernate is possible using a set of Eclipse "
+"plugins, commandline tools, as well as Ant tasks."
-#: 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:"
+#. 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 ""
+"The <emphasis>Hibernate Tools</emphasis> currently include plugins for the "
+"Eclipse IDE as well as Ant tasks for reverse engineering of existing "
+"databases:"
-#: 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."
+#. 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>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."
-#: 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."
+#. 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> 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."
-#: 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."
+#. 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>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."
-#: index.docbook:38
+#. Tag: emphasis
+#: toolset_guide.xml:38
+#, no-c-format
msgid "Ant Tasks:"
-msgstr ""
+msgstr "Ant Tasks:"
-#: index.docbook:43
-msgid "Please refer to the <emphasis>Hibernate Tools</emphasis> package and it's documentation for more information."
+#. 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 ""
+"Please refer to the <emphasis>Hibernate Tools</emphasis> package and it's "
+"documentation for more information."
-#: 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>."
+#. 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 ""
+"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>."
-#: index.docbook:55
+#. Tag: title
+#: toolset_guide.xml:55
+#, no-c-format
msgid "Automatic schema generation"
-msgstr ""
+msgstr "Automatic schema generation"
-#: 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."
+#. 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 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."
-#: 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."
+#. 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 ""
+"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."
-#: 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 "First, customize your mapping files to improve the generated schema."
-#: index.docbook:75
+#. Tag: title
+#: toolset_guide.xml:75
+#, no-c-format
msgid "Customizing the schema"
-msgstr ""
+msgstr "Customizing the schema"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:84
+#. Tag: programlisting
+#: toolset_guide.xml:84
+#, no-c-format
msgid "<![CDATA[<property name=\"zip\" length=\"5\"/>]]>"
msgstr ""
-#: index.docbook:85
+#. Tag: programlisting
+#: toolset_guide.xml:85
+#, no-c-format
msgid "<![CDATA[<property name=\"balance\" precision=\"12\" scale=\"2\"/>]]>"
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)."
+#. 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 ""
+"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)."
-#: index.docbook:93
-msgid "<![CDATA[<many-to-one name=\"bar\" column=\"barId\" not-null=\"true\"/>]]>"
+#. 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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 ""
-#: 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."
+#. 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 ""
+"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."
-#: 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\"/>]]>"
+"<![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."
+#. 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 ""
+"A <literal>foreign-key</literal> attribute may be used to override the name "
+"of any generated foreign key constraint."
-#: 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 ""
-#: index.docbook:122
-msgid "Many mapping elements also accept a child <literal><column></literal> element. This is particularly useful for mapping multi-column types:"
+#. Tag: para
+#: toolset_guide.xml:122
+#, no-c-format
+msgid ""
+"Many mapping elements also accept a child <literal><column></literal> "
+"element. This is particularly useful for mapping multi-column types:"
msgstr ""
+"Many mapping elements also accept a child <literal><column></literal> "
+"element. This is particularly useful for mapping multi-column types:"
-#: 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 ""
-#: 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 ""
+"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)."
-#: 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>]]>"
+"<![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 ""
-#: 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."
+#. Tag: para
+#: toolset_guide.xml:139
+#, no-c-format
+msgid ""
+"The <literal>sql-type</literal> attribute allows the user to override the "
+"default mapping of a Hibernate type to SQL datatype."
msgstr ""
+"The <literal>sql-type</literal> attribute allows the user to override the "
+"default mapping of a Hibernate type to SQL datatype."
-#: index.docbook:144
+#. 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>]]>"
+"<![CDATA[<property name=\"balance\" type=\"float\">\n"
+" <column name=\"balance\" sql-type=\"decimal(13,3)\"/>\n"
+"</property>]]>"
msgstr ""
-#: index.docbook:146
-msgid "The <literal>check</literal> attribute allows you to specify a check constraint."
+#. Tag: para
+#: toolset_guide.xml:146
+#, no-c-format
+msgid ""
+"The <literal>check</literal> attribute allows you to specify a check "
+"constraint."
msgstr ""
+"The <literal>check</literal> attribute allows you to specify a check "
+"constraint."
-#: index.docbook:150
+#. Tag: programlisting
+#: toolset_guide.xml:150
+#, no-c-format
msgid ""
- "<![CDATA[<property name=\"foo\" type=\"integer\">\n"
- " <column name=\"foo\" check=\"foo > 10\"/>\n"
- "</property>]]>"
+"<![CDATA[<property name=\"foo\" type=\"integer\">\n"
+" <column name=\"foo\" check=\"foo > 10\"/>\n"
+"</property>]]>"
msgstr ""
-#: index.docbook:152
+#. 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>]]>"
+"<![CDATA[<class name=\"Foo\" table=\"foos\" check=\"bar < 100.0\">\n"
+" ...\n"
+" <property name=\"bar\" type=\"float\"/>\n"
+"</class>]]>"
msgstr ""
-#: index.docbook:156
+#. Tag: title
+#: toolset_guide.xml:156
+#, no-c-format
msgid "Summary"
-msgstr ""
+msgstr "Summary"
-#: index.docbook:163
+#. Tag: entry
+#: toolset_guide.xml:163
+#, no-c-format
msgid "Attribute"
-msgstr ""
+msgstr "Attribute"
-#: index.docbook:164
+#. Tag: entry
+#: toolset_guide.xml:164
+#, no-c-format
msgid "Values"
-msgstr ""
+msgstr "Values"
-#: index.docbook:165
+#. Tag: entry
+#: toolset_guide.xml:165
+#, no-c-format
msgid "Interpretation"
-msgstr ""
+msgstr "Interpretation"
-#: 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 ""
+msgstr "number"
-#: index.docbook:172
+#. Tag: entry
+#: toolset_guide.xml:172
+#, no-c-format
msgid "column length"
-msgstr ""
+msgstr "column length"
-#: index.docbook:175
+#. Tag: literal
+#: toolset_guide.xml:175
+#, no-c-format
msgid "precision"
-msgstr ""
+msgstr "precision"
-#: index.docbook:177
+#. Tag: entry
+#: toolset_guide.xml:177
+#, no-c-format
msgid "column decimal precision"
-msgstr ""
+msgstr "column decimal precision"
-#: index.docbook:180
+#. Tag: literal
+#: toolset_guide.xml:180
+#, no-c-format
msgid "scale"
-msgstr ""
+msgstr "scale"
-#: index.docbook:182
+#. Tag: entry
+#: toolset_guide.xml:182
+#, no-c-format
msgid "column decimal scale"
-msgstr ""
+msgstr "column decimal scale"
-#: index.docbook:185
+#. Tag: literal
+#: toolset_guide.xml:185
+#, no-c-format
msgid "not-null"
-msgstr ""
+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 ""
+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 ""
+msgstr "specfies that the column should be non-nullable"
-#: 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 "specifies that the column should have a unique constraint"
-#: 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 ""
+msgstr "index_name"
-#: index.docbook:197
+#. Tag: entry
+#: toolset_guide.xml:197
+#, no-c-format
msgid "specifies the name of a (multi-column) index"
-msgstr ""
+msgstr "specifies the name of a (multi-column) index"
-#: 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 ""
+msgstr "unique_key_name"
-#: index.docbook:202
+#. Tag: entry
+#: toolset_guide.xml:202
+#, no-c-format
msgid "specifies the name of a multi-column unique constraint"
-msgstr ""
+msgstr "specifies the name of a multi-column unique constraint"
-#: index.docbook:205
+#. Tag: literal
+#: toolset_guide.xml:205
+#, no-c-format
msgid "foreign-key"
-msgstr ""
+msgstr "foreign-key"
-#: index.docbook:206
+#. Tag: literal
+#: toolset_guide.xml:206
+#, no-c-format
msgid "foreign_key_name"
-msgstr ""
+msgstr "foreign_key_name"
-#: index.docbook:207
-msgid "specifies the name of the foreign key constraint generated for an association, for a <literal><one-to-one></literal>, <literal><many-to-one></literal>, <literal><key></literal>, or <literal><many-to-many></literal> mapping element. Note that <literal>inverse=\"true\"</literal> sides will not be considered by <literal>SchemaExport</literal>."
+#. 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><one-to-one></literal>, <literal><many-"
+"to-one></literal>, <literal><key></literal>, or <literal><many-"
+"to-many></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 ""
+msgstr "sql-type"
-#: index.docbook:218
+#. Tag: literal
+#: toolset_guide.xml:218
+#, no-c-format
msgid "SQL column type"
-msgstr ""
+msgstr "SQL column type"
-#: index.docbook:219
-msgid "overrides the default column type (attribute of <literal><column></literal> element only)"
+#. Tag: entry
+#: toolset_guide.xml:219
+#, fuzzy, no-c-format
+msgid ""
+"overrides the default column type (attribute of <literal><column></"
+"literal> element only)"
msgstr ""
+"overrides the default column type (attribute of <placeholder-1/> element "
+"only)"
-#: 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 ""
+msgstr "SQL expression"
-#: index.docbook:227
+#. Tag: entry
+#: toolset_guide.xml:227
+#, no-c-format
msgid "specify a default value for the column"
-msgstr ""
+msgstr "specify a default value for the column"
-#: index.docbook:232
+#. Tag: literal
+#: toolset_guide.xml:232
+#, no-c-format
msgid "check"
-msgstr ""
+msgstr "check"
-#: index.docbook:234
+#. Tag: entry
+#: toolset_guide.xml:234
+#, no-c-format
msgid "create an SQL check constraint on either column or table"
-msgstr ""
+msgstr "create an SQL check constraint on either column or table"
-#: index.docbook:242
-msgid "The <literal><comment></literal> element allows you to specify comments for the generated schema."
+#. Tag: para
+#: toolset_guide.xml:242
+#, no-c-format
+msgid ""
+"The <literal><comment></literal> element allows you to specify "
+"comments for the generated schema."
msgstr ""
+"The <literal><comment></literal> element allows you to specify "
+"comments for the generated schema."
-#: index.docbook:247
+#. 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>]]>"
+"<![CDATA[<class name=\"Customer\" table=\"CurCust\">\n"
+" <comment>Current customers only</comment>\n"
+" ...\n"
+"</class>]]>"
msgstr ""
-#: index.docbook:249
+#. Tag: programlisting
+#: toolset_guide.xml:249
+#, no-c-format
msgid ""
- "<![CDATA[<property name=\"balance\">\n"
- " <column name=\"bal\">\n"
- " <comment>Balance in USD</comment>\n"
- " </column>\n"
- "</property>]]>"
+"<![CDATA[<property name=\"balance\">\n"
+" <column name=\"bal\">\n"
+" <comment>Balance in USD</comment>\n"
+" </column>\n"
+"</property>]]>"
msgstr ""
-#: 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)."
+#. Tag: para
+#: toolset_guide.xml:251
+#, no-c-format
+msgid ""
+"This results in a <literal>comment on table</literal> or <literal>comment on "
+"column</literal> statement in the generated DDL (where supported)."
msgstr ""
+"This results in a <literal>comment on table</literal> or <literal>comment on "
+"column</literal> statement in the generated DDL (where supported)."
-#: index.docbook:260
+#. Tag: title
+#: toolset_guide.xml:260
+#, no-c-format
msgid "Running the tool"
-msgstr ""
+msgstr "Running the tool"
-#: index.docbook:262
-msgid "The <literal>SchemaExport</literal> tool writes a DDL script to standard out and/or executes the DDL statements."
+#. 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 ""
+"The <literal>SchemaExport</literal> tool writes a DDL script to standard out "
+"and/or executes the DDL statements."
-#: index.docbook:267
-msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaExport</literal> <emphasis>options mapping_files</emphasis>"
+#. 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 ""
+msgstr "<literal>SchemaExport</literal> Command Line Options"
-#: 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 ""
+msgstr "Option"
-#: 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 "Description"
-#: index.docbook:285, index.docbook:435
+#. Tag: literal
+#: toolset_guide.xml:285 toolset_guide.xml:435
+#, no-c-format
msgid "--quiet"
-msgstr ""
+msgstr "--quiet"
-#: index.docbook:286, index.docbook:436
+#. Tag: entry
+#: toolset_guide.xml:286 toolset_guide.xml:436
+#, no-c-format
msgid "don't output the script to stdout"
-msgstr ""
+msgstr "don't output the script to stdout"
-#: index.docbook:289
+#. Tag: literal
+#: toolset_guide.xml:289
+#, no-c-format
msgid "--drop"
-msgstr ""
+msgstr "--drop"
-#: index.docbook:290
+#. Tag: entry
+#: toolset_guide.xml:290
+#, no-c-format
msgid "only drop the tables"
-msgstr ""
+msgstr "only drop the tables"
-#: index.docbook:293
+#. Tag: literal
+#: toolset_guide.xml:293
+#, no-c-format
msgid "--create"
-msgstr ""
+msgstr "--create"
-#: index.docbook:294
+#. Tag: entry
+#: toolset_guide.xml:294
+#, no-c-format
msgid "only create the tables"
-msgstr ""
+msgstr "only create the tables"
-#: index.docbook:297, index.docbook:439
+#. Tag: literal
+#: toolset_guide.xml:297 toolset_guide.xml:439
+#, no-c-format
msgid "--text"
-msgstr ""
+msgstr "--text"
-#: index.docbook:298
+#. Tag: entry
+#: toolset_guide.xml:298
+#, no-c-format
msgid "don't export to the database"
-msgstr ""
+msgstr "don't export to the database"
-#: index.docbook:301
+#. Tag: literal
+#: toolset_guide.xml:301
+#, no-c-format
msgid "--output=my_schema.ddl"
-msgstr ""
+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 ""
+msgstr "output the ddl script to a file"
-#: 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 ""
+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 ""
+msgstr "in <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 ""
+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 "read Hibernate configuration from an XML file"
-#: 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 ""
+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
+#, no-c-format
msgid "read database properties from a file"
-msgstr ""
+msgstr "read database properties from a file"
-#: index.docbook:317
+#. Tag: literal
+#: toolset_guide.xml:317
+#, no-c-format
msgid "--format"
-msgstr ""
+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 "format the generated SQL nicely in the script"
-#: index.docbook:321
+#. Tag: literal
+#: toolset_guide.xml:321
+#, no-c-format
msgid "--delimiter=;"
-msgstr ""
+msgstr "--delimiter=;"
-#: index.docbook:322
+#. Tag: entry
+#: toolset_guide.xml:322
+#, no-c-format
msgid "set an end of line delimiter for the script"
-msgstr ""
+msgstr "set an end of line delimiter for the script"
-#: index.docbook:328
+#. Tag: para
+#: toolset_guide.xml:328
+#, no-c-format
msgid "You may even embed <literal>SchemaExport</literal> in your application:"
msgstr ""
+"You may even embed <literal>SchemaExport</literal> in your application:"
-#: index.docbook:332
+#. Tag: programlisting
+#: toolset_guide.xml:332
+#, no-c-format
msgid ""
- "<![CDATA[Configuration cfg = ....;\n"
- "new SchemaExport(cfg).create(false, true);]]>"
+"<![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 ""
+msgstr "Properties"
-#: index.docbook:339
+#. Tag: para
+#: toolset_guide.xml:339
+#, no-c-format
msgid "Database properties may be specified"
-msgstr ""
+msgstr "Database properties may be specified"
-#: index.docbook:345
-msgid "as system properties with <literal>-D</literal><emphasis><property></emphasis>"
+#. Tag: para
+#: toolset_guide.xml:345
+#, no-c-format
+msgid ""
+"as system properties with <literal>-D</literal><emphasis><property></"
+"emphasis>"
msgstr ""
+"as system properties with <literal>-D</literal><emphasis><property></"
+"emphasis>"
-#: index.docbook:348
+#. Tag: para
+#: toolset_guide.xml:348
+#, no-c-format
msgid "in <literal>hibernate.properties</literal>"
-msgstr ""
+msgstr "in <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 ""
+msgstr "in a named properties file with <literal>--properties</literal>"
-#: index.docbook:355
+#. Tag: para
+#: toolset_guide.xml:355
+#, no-c-format
msgid "The needed properties are:"
-msgstr ""
+msgstr "The needed properties are:"
-#: index.docbook:360
+#. Tag: title
+#: toolset_guide.xml:360
+#, no-c-format
msgid "SchemaExport Connection Properties"
-msgstr ""
+msgstr "SchemaExport Connection Properties"
-#: index.docbook:366
+#. Tag: entry
+#: toolset_guide.xml:366
+#, no-c-format
msgid "Property Name"
-msgstr ""
+msgstr "Property Name"
-#: index.docbook:372
+#. Tag: literal
+#: toolset_guide.xml:372
+#, no-c-format
msgid "hibernate.connection.driver_class"
-msgstr ""
+msgstr "hibernate.connection.driver_class"
-#: index.docbook:373
+#. Tag: entry
+#: toolset_guide.xml:373
+#, no-c-format
msgid "jdbc driver class"
-msgstr ""
+msgstr "jdbc driver class"
-#: index.docbook:376
+#. Tag: literal
+#: toolset_guide.xml:376
+#, no-c-format
msgid "hibernate.connection.url"
-msgstr ""
+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 ""
+msgstr "hibernate.connection.username"
-#: index.docbook:381
+#. Tag: entry
+#: toolset_guide.xml:381
+#, no-c-format
msgid "database user"
-msgstr ""
+msgstr "database user"
-#: index.docbook:384
+#. Tag: literal
+#: toolset_guide.xml:384
+#, no-c-format
msgid "hibernate.connection.password"
-msgstr ""
+msgstr "hibernate.connection.password"
-#: index.docbook:385
+#. Tag: entry
+#: toolset_guide.xml:385
+#, no-c-format
msgid "user password"
-msgstr ""
+msgstr "user password"
-#: index.docbook:388
+#. Tag: literal
+#: toolset_guide.xml:388
+#, no-c-format
msgid "hibernate.dialect"
-msgstr ""
+msgstr "hibernate.dialect"
-#: index.docbook:389
+#. Tag: entry
+#: toolset_guide.xml:389
+#, no-c-format
msgid "dialect"
-msgstr ""
+msgstr "dialect"
-#: index.docbook:398
+#. Tag: title
+#: toolset_guide.xml:398
+#, no-c-format
msgid "Using Ant"
-msgstr ""
+msgstr "Using Ant"
-#: index.docbook:400
-msgid "You can call <literal>SchemaExport</literal> from your Ant build script:"
+#. Tag: para
+#: toolset_guide.xml:400
+#, no-c-format
+msgid ""
+"You can call <literal>SchemaExport</literal> from your Ant build script:"
msgstr ""
+"You can call <literal>SchemaExport</literal> from your Ant build script:"
-#: 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>]]>"
+"<![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 ""
+msgstr "Incremental schema updates"
-#: 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."
+#. 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 ""
+"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."
-#: index.docbook:417
-msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaUpdate</literal> <emphasis>options mapping_files</emphasis>"
+#. 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 ""
+msgstr "<literal>SchemaUpdate</literal> Command Line Options"
-#: index.docbook:440
+#. Tag: entry
+#: toolset_guide.xml:440
+#, no-c-format
msgid "don't export the script to the database"
-msgstr ""
+msgstr "don't export the script to the database"
-#: 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 ""
+msgstr "specify a <placeholder-1/> file"
-#: index.docbook:458
+#. Tag: para
+#: toolset_guide.xml:458
+#, no-c-format
msgid "You may embed <literal>SchemaUpdate</literal> in your application:"
-msgstr ""
+msgstr "You may embed <literal>SchemaUpdate</literal> in your application:"
-#: index.docbook:462
+#. Tag: programlisting
+#: toolset_guide.xml:462
+#, no-c-format
msgid ""
- "<![CDATA[Configuration cfg = ....;\n"
- "new SchemaUpdate(cfg).execute(false);]]>"
+"<![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 ""
+msgstr "Using Ant for incremental schema updates"
-#: index.docbook:469
+#. Tag: para
+#: toolset_guide.xml:469
+#, no-c-format
msgid "You can call <literal>SchemaUpdate</literal> from the Ant script:"
-msgstr ""
+msgstr "You can call <literal>SchemaUpdate</literal> from the Ant script:"
-#: 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>]]>"
+"<![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 ""
+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."
+#. 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 ""
+"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."
-#: index.docbook:486
-msgid "<literal>java -cp </literal><emphasis>hibernate_classpaths</emphasis> <literal>org.hibernate.tool.hbm2ddl.SchemaValidator</literal> <emphasis>options mapping_files</emphasis>"
+#. 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 ""
+msgstr "<literal>SchemaValidator</literal> Command Line Options"
-#: index.docbook:519
+#. Tag: para
+#: toolset_guide.xml:519
+#, no-c-format
msgid "You may embed <literal>SchemaValidator</literal> in your application:"
-msgstr ""
+msgstr "You may embed <literal>SchemaValidator</literal> in your application:"
-#: index.docbook:523
+#. Tag: programlisting
+#: toolset_guide.xml:523
+#, no-c-format
msgid ""
- "<![CDATA[Configuration cfg = ....;\n"
- "new SchemaValidator(cfg).validate();]]>"
+"<![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 ""
+msgstr "Using Ant for schema validation"
-#: 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 "You can call <literal>SchemaValidator</literal> from the Ant script:"
-#: 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 "<one-to-one>"
+#~ msgstr "<one-to-one>"
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
+#~ msgid "<many-to-one>"
+#~ msgstr "<many-to-one>"
+#~ msgid "<key>"
+#~ msgstr "<key>"
+
+#~ msgid "<many-to-many>"
+#~ msgstr "<many-to-many>"
+
+#~ msgid "inverse=\"true\""
+#~ msgstr "inverse=\"true\""
+
+#~ msgid "SchemaExport"
+#~ msgstr "SchemaExport"
+
+#~ msgid "<column>"
+#~ msgstr "<column>"
+
+#~ 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"
+
+#~ msgid "select a <placeholder-1/>"
+#~ msgstr "select a <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/pt-BR/content/transactions.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/transactions.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/transactions.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,673 +1,2126 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Transações e Concorrência"
-#: 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."
+#. 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 ""
+"O ponto o mais importante sobre o Hibernate e o controle de concorrência é "
+"que é muito fácil de ser compreendido. O Hibernate usa diretamente conexões "
+"de JDBC e recursos de JTA sem adicionar nenhum comportamento de bloqueio a "
+"mais. Nós altamente recomendamos que você gaste algum tempo com o JDBC, o "
+"ANSI e a especificação de isolamento de transação de seu sistema de gerência "
+"da base de dados."
-#: 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)."
+#. 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 ""
+"O Hibernate não bloqueia objetos na memória. Sua aplicação pode esperar o "
+"comportamento tal qual definido pelo nível de isolamento de suas transações "
+"de banco de dados. Note que graças ao <literal>Session</literal>, que também "
+"é um cache de escopo de transação, o Hibernate fornece leituras repetíveis "
+"para procurar por identificadores e consultas de entidade (não pesquisas de "
+"relatórios que retornam valores escalares)."
-#: 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."
+#. 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 ""
+"Além do versionamento para o controle automático de concorrência otimista, o "
+"Hibernate oferece também uma API (menor) para bloqueio pessimista de linhas "
+"usando a sintaxe <literal>SELECT FOR UPDATE</literal>. O controle de "
+"concorrência otimista e esta API são discutidos mais tarde neste capítulo."
-#: 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."
+#. 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 ""
+"Nós começamos a discussão do controle de concorrência no Hibernate com a "
+"granularidade do <literal>Configuration</literal>, <literal>SessionFactory</"
+"literal>, e <literal>Session</literal>, além de transações de base de dados "
+"e conversações longas."
-#: index.docbook:36
+#. Tag: title
+#: transactions.xml:36
+#, no-c-format
msgid "Session and transaction scopes"
-msgstr ""
+msgstr "Session e escopos de transações"
-#: 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."
+#. 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 ""
+"Um <literal>SessionFactory</literal> é objeto threadsafe compartilhado por "
+"todas as threads da aplicação que consome muitos recursos na sua criação. É "
+"criado uma unica vez no inicio da execução da aplicação a partir da "
+"instância de uma <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."
+#. 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 ""
+"Uma <literal>Session</literal> é um objeto de baixo custo de criação, não é "
+"threadsafe, deve ser usado uma vez, para uma única requisição, uma "
+"conversação, uma única unidade do trabalho e então deve ser descartado. Um "
+"<literal>Session</literal> não obterá um JDBC <literal>Connection</literal> "
+"(ou um <literal>Datasource</literal>) a menos que necessite, "
+"conseqüentemente não consome nenhum recurso até ser usado."
-#: 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."
+#. 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 ""
+"Para completar, você também tem que pensar sobre as transações de base de "
+"dados. Uma transação tem que ser tão curta quanto possível, para reduzir a "
+"disputa pelo bloqueio na base de dados. Transações longas impedirão que sua "
+"aplicação escale a carga altamente concorrente. Por isso, em um projeto "
+"raramente é para manter uma transação de base de dados aberta durante o "
+"tempo que o usuário pensa, até que a unidade do trabalho esteja completa."
-#: 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?"
+#. 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 ""
+"Qual é o escopo de uma unidade de trabalho? Pode uma únicoa "
+"<literal>Session</literal> do Hibernate gerenciar diversas transações ou é "
+"esta um o relacionamento um-para-um dos escopos? Quando deve você abrir e "
+"fechar uma <literal>Session</literal> e como você demarca os limites da "
+"transação?"
-#: index.docbook:69
+#. Tag: title
+#: transactions.xml:69
+#, no-c-format
msgid "Unit of work"
-msgstr ""
+msgstr "Unidade de trabalho"
-#: 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."
+#. 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 ""
+"Primeiro, não use o antipattern <emphasis>sessão-por-operação</emphasis>, "
+"isto é, não abra e não feche uma <literal>Session</literal> para cada "
+"simples chamada ao banco de de dados em uma única thread! Naturalmente, o "
+"mesmo é verdadeiro para transações. As chamadas a banco de dados em uma "
+"aplicação são feitas usando uma seqüência planejada, elas são agrupadas em "
+"unidades de trabalho atômicas. (Veja que isso também significa que um auto-"
+"commit depois de cada sentença SQL é inútil em uma aplicação, esta "
+"modalidade é ideal para o trabalho ad hoc do console do SQL. O Hibernate "
+"impede, ou espera que o servidor de aplicação impessa isso, o uso da "
+"modalidade de auto-commit.) As transações nunca são opcionais, toda a "
+"comunicação com um banco de dados tem que ocorrer dentro de uma transação, "
+"não importa se você vai ler ou escrever dados. Como explicado, o "
+"comportamento auto-commit para leitura de dados deve ser evitado, como "
+"muitas transações pequenas são improváveis de executar melhor do que uma "
+"unidade claramente definida do trabalho. A última opção também muito mais "
+"manutenível e extensível."
-#: 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."
+#. 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 ""
+"O pattern mais comum em uma aplicação multi-usuário cliente/servidor é "
+"<emphasis>sessão-por-requisição</emphasis>. Neste modelo, uma requisição do "
+"cliente é enviada ao servidor (onde a camada de persistência do Hibernate "
+"roda), uma <literal>Session</literal> nova do Hibernate é aberta, e todas as "
+"operações da base de dados são executadas nesta unidade do trabalho. Logo "
+"que o trabalho for completado (e a resposta para o cliente for preparada), a "
+"sessão é descarregad e fechada. Você usaria também uma única transação de "
+"base de dados para servir às requisições dos clientes, começando e "
+"commitando-o quando você abre e fecha a <literal>Session</literal>. O "
+"relacionamento entre os dois é um-para-um e este modelo é um ajuste perfeito "
+"para muitas aplicações."
-#: 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."
+#. 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 ""
+"O desafio encontra-se na implementação. O Hibernate fornece gerência "
+"integrada da \"sessão atual\" para simplificar este pattern. Tudo que você "
+"tem que fazer é iniciar uma transação quando uma requisição tem que ser "
+"processada e termina a transação antes que a resposta seja enviada ao "
+"cliente. Você pode fazer onde quiser, soluções comuns são "
+"<literal>ServletFilter</literal>, interceptador AOP com um pointcut (ponto "
+"de corte) nos métodos de serviço ou em um container de proxy/interceptação. "
+"Um container de EJB é uma maneira padronizada para implementar aspectos "
+"cross-cutting tais como a demarcação da transação em EJB session beans, "
+"declarativamente com CMT. Se você se decidir usar demarcação programática de "
+"transação, de preferencia a API <literal>Transaction</literal> do Hibernate "
+"mostrada mais adiante neste capítulo, para fácilidade no uso e portabilidade "
+"de código."
-#: 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\"/>."
+#. 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 ""
+"Seu código de aplicação pode acessar a \"sessão atual\" para processar a "
+"requisição fazendo uma chamada simples a <literal>sessionFactory."
+"getCurrentSession()</literal> em qualquer lugar e com a frequencia "
+"necessária. Você sempre conseguirá uma <literal>Session</literal> limitada a "
+"transação atual. Isto tem que ser configurado para recurso local ou os "
+"ambientes JTA. Veja <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."
+#. 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 ""
+"Às vezes é conveniente estender o escopo de uma <literal>Session</literal> e "
+"de uma transação do banco de dados até que a \"visão esteja renderizada\". É "
+"especialmente útil em aplicações servlet que utilizam uma fase de "
+"rendenderização separada depois que a requisição ter sido processada. "
+"Estendendo a transação até que renderização da visão esteja completa é fácil "
+"de fazer se você implementar seu próprio interceptador. Entretanto, não se "
+"pode fazer facilmente se você confiar em EJBs com transações gerenciadas por "
+"contêiner, porque uma transação será terminada quando um método de EJB "
+"retornar, antes da renderização de toda visão puder começar. Veja o website "
+"e o fórum do Hibernate para dicas e exemplos em torno deste pattern "
+"<emphasis>Open Session in View</emphasis>."
-#: index.docbook:135
+#. Tag: title
+#: transactions.xml:135
+#, no-c-format
msgid "Long conversations"
-msgstr ""
+msgstr "Longas conversações"
-#: 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:"
+#. 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 ""
+"O pattern sessão-por-requisição não é o único conceito útil que você pode "
+"usar ao projetar unidades de trabalho. Muitos processos de negócio requerem "
+"uma totalidade de séries de interações com o usuário intercaladas com "
+"acessos a uma base de dados. Em aplicações web e corporativas não é "
+"aceitável para uma transação atrapalhe uma interação do usuário. Considere o "
+"seguinte exemplo:"
-#: 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."
+#. 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 ""
+"A primeira tela de um diálogo abre os dados carregado pelo usuário em "
+"através de <literal>Session</literal> e transação particulares. O usuário "
+"está livre modificar os objetos."
-#: 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."
+#. 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 ""
+"O usuário clica em \"Salvar\" após 5 minutos e espera suas modificações "
+"serem persistidas; espera também que ele era a única pessoa que edita esta "
+"informação e que nenhuma modificação conflitante possa ocorrer."
-#: 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."
+#. 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 ""
+"Nós chamamos esta unidade de trabalho, do ponto da visão do usuário, "
+"executando uma longa <emphasis>conversação</emphasis> (ou "
+"<emphasis>transação da aplicação</emphasis>). Há muitas maneiras de você "
+"pode implementar em sua aplicação."
-#: 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."
+#. 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 ""
+"Uma primeira implementação simples pode manter a<literal>Session</literal> e "
+"a transação aberta durante o tempo de interação do usuário, com bloqueios na "
+"base de dados para impedir a modificação concorrente e para garantir o "
+"isolamento e a atomicidade. Esse é naturalmente um anti-pattern, desde que a "
+"disputa do bloqueio não permitiria o escalonameneto da aplicação com o "
+"número de usuários concorrentes."
-#: 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:"
+#. 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 ""
+"Claramente, nós temos que usar diversas transações para implementar a "
+"conversação. Neste caso, Manter o isolamento dos processos de negócio torna-"
+"se responsabilidade parcial da camada da aplicação. Uma única conversação "
+"geralmente usa diversas transações. Ela será atômica se somente uma destas "
+"transações (a última) armazenar os dados atualizados, todas as outras "
+"simplesmente leram os dados (por exemplo em um diálogo do estilo wizard que "
+"mede diversos ciclos de requisição/resposta). Isto é mais fácil de "
+"implementar do que pode parecer, especialmente se você usar as "
+"características do Hibernate:"
-#: 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."
+#. 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>Versionamento automático</emphasis> - O Hibernate pode fazer o "
+"controle automático de concorrência otimista para você, ele pode "
+"automaticamente detectar se uma modificação concorrente ocorreu durante o "
+"tempo de interação do usuário. Geralmente nós verificamos somente no fim da "
+"conversação."
-#: 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."
+#. 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 Objects</emphasis>- se você se decidir usar o já "
+"discutido pattern <emphasis>session-per-request</emphasis>, todas as "
+"instâncias carregadas estarão no estado destacado durante o tempo em que o "
+"usuário estiver pensando. O Hibernate permite que você reatache os objetos e "
+"persita as modificações, esse pattern é chamado <emphasis>session-per-"
+"request-with-detached-objects</emphasis>. É usado versionamento automatico "
+"para isolar as modificações concorrentes."
-#: 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."
+#. 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>Extended (or Long) Session</emphasis> A <literal>Session</literal> "
+"do Hibernate pode ser desligada da conexão básica do JDBC depois que a "
+"transação foi commitada e ser reconectado quando uma nova requisição do "
+"cliente ocorrer. Este pattern é conhecido como <emphasis>session-per-"
+"conversation</emphasis> e faz o reatamento uniforme desnecessário. "
+"Versionamento automático é usado para isolar modificações concorrentes e a "
+"<emphasis>session-per-conversation</emphasis> usualmente não é permitido "
+"para ser nivelado automaticamente, e sim explicitamente."
-#: 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."
+#. 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 ""
+"Ambos <emphasis>session-per-request-with-detached-objects</emphasis> e "
+"<emphasis>session-per-conversation</emphasis> possuem vantagens e "
+"desvantagens, nos discutiremos mais tarde neste capítulo no contexto do "
+"controle de concorrência otimista."
-#: index.docbook:229
+#. Tag: title
+#: transactions.xml:229
+#, no-c-format
msgid "Considering object identity"
-msgstr ""
+msgstr "Considerando a identidade do objeto"
-#: 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:"
+#. 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 ""
+"Uma aplicação pode acessar concorrentemente o mesmo estado persistente em "
+"duas <literal>Session</literal>s diferentes. Entretanto, uma instância de "
+"uma classe persistente nunca é compartilhada entre duas instâncias "
+"<literal>Session</literal>. Por tanto, há duas noções diferentes da "
+"identidade:"
-#: index.docbook:240
+#. Tag: term
+#: transactions.xml:240
+#, no-c-format
msgid "Database Identity"
-msgstr ""
+msgstr "Identidade da base de dados"
-#: 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 ""
+msgstr "Identidade da JVM"
-#: index.docbook:251
+#. Tag: literal
+#: transactions.xml:251
+#, no-c-format
msgid "foo==bar"
-msgstr ""
+msgstr "foo==bar"
-#: 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."
+#. 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 ""
+"Então para os objetos acoplados a um <literal>Session</literal> em "
+"<literal>particular </literal> (isto é no escopo de um <literal>Session</"
+"literal>), as duas noções são equivalentes e a identidade da JVM para a "
+"identidade da base de dados é garantida pelo Hibernate. Entretanto, quando a "
+"aplicação pode acessar concorrentemente o \"mesmo\" objeto do negócio "
+"(identidade persistente) em duas sessões diferentes, as duas instâncias "
+"serão realmente \"diferentes\" (identidade de JVM). Os conflitos são "
+"resolvidos usando (versionamento automático) no flush/commit, usando "
+"abordagem otimista."
-#: 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."
+#. 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 ""
+"Este caminho deixa o Hibernate e o banco dedados se preocuparem com a "
+"concorrência; também fornece uma escalabilidade melhor, garantindo que a "
+"identidade em unidades de trabalho único-encadeadas não necessite de "
+"bloqueio dispendioso ou de outros meios de sincronização. A aplicação nunca "
+"necessita sincronizar qualquer objeto de negócio tão longo que transpasse "
+"uma única thread por <literal>Session</literal>. Dentro de uma "
+"<literal>Session</literal> a aplicação pode usar com segurança o "
+"<literal>==</literal> para comparar objetos."
-#: 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."
+#. 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 ""
+"Com tudo, uma aplicação que usa <literal>==</literal> fora de uma "
+"<literal>Session</literal>, pode ver resultados inesperados. Isto pode "
+"ocorrer mesmo em alguns lugares inesperados, por exemplo, se você colocar "
+"duas instâncias desacopladas em um mesmo <literal>Set</literal>. Ambos podem "
+"ter a mesma identidade na base de dados (isto é eles representam a mesma "
+"linha em uma tabela), mas a identidade da JVM pela definição não garantida "
+"para instâncias em estado desacoplado. O desenvolvedor tem que sobrescrever "
+"os métodos <literal>equals()</literal> e <literal>hashCode()</literal> em "
+"classes persistentes e implementar sua própria noção da igualdade do objeto. "
+"Advertência: nunca use o identificador da base de dados para implementar a "
+"igualdade, use atributos de negócio, uma combinação única, geralmente "
+"imutável. O identificador da base de dados mudará se um objeto transiente "
+"passar para o estado persistente. Se a instância transiente (geralmente "
+"junto com instâncias desacopladas) for inserida em um <literal>Set</"
+"literal>, mudar o hashcode quebra o contrato do <literal>Set</literal>. "
+"Atributos para chaves de negócio não têm que ser tão estável quanto às "
+"chaves primárias da base de dados, você somente tem que garantir a "
+"estabilidade durante o tempo que os objetos estiverem no mesmo Set. Veja o "
+"website do Hibernate para uma discussão mais completa sobre o assunto. Note "
+"também que esta não é uma caracteristica do Hibernate, mas simplesmente como "
+"a identidade e a igualdade do objeto de Java têm que ser implementadas."
-#: index.docbook:296
+#. Tag: title
+#: transactions.xml:296
+#, no-c-format
msgid "Common issues"
-msgstr ""
+msgstr "Edições comuns"
-#: 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:"
+#. 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 ""
+"Nunca use o anti-patterns <emphasis>session-per-user-session</emphasis> ou "
+"<emphasis>session-per-application</emphasis> (naturalmente, há umas exceções "
+"raras a essa regra). Note que algumas das seguintes edições podem também "
+"aparecer com patterns recomendados, certifique-se que tenha compreendido as "
+"implicações antes de fazer uma decisão de projeto:"
-#: 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."
+#. 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 ""
+"Uma <literal>Session</literal> não é threadsafe. As coisas que são supostas "
+"para trabalhar concorrentemente, como requisições HTTP, session beans, ou "
+"Swing, causarão condições de disputa se uma instância <literal>Session</"
+"literal> for compartilhada. Se você mantiver sua <literal>Session</literal> "
+"do Hibernate em seu <literal>HttpSession</literal> (discutido mais tarde), "
+"você deve considerar sincronizar o acesso a sua sessão do HTTP. Caso "
+"contrário, um usuário que clica em reload várias muito rapidamente pode usar "
+"o mesmo <literal>Session</literal> em duas threads executando "
+"concorrentemente."
-#: 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."
+#. 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 ""
+"Uma exceção lançada pelo Hibernate significa que você tem que dar rollback "
+"na sua transação no banco de dados e fechar a <literal>Session</literal> "
+"imediatamente (discutido mais tarde em maiores detalhes). Se sua "
+"<literal>Session</literal> é limitado pela aplicação, você tem que parar a "
+"aplicação. Dando rollback na transação no banco de dados não põe seus "
+"objetos do negócio em um estado anterior que estavam no início da transação. "
+"Isto significa que o estado da base de dados e os objetos de negócio perdem "
+"a sincronização. Geralmente não é um problema porque as exceções não são "
+"recuperáveis e você tem que iniciar após o rollback de qualquer maneira."
-#: 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."
+#. 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 ""
+"O <literal>Session</literal> guarda em cache cada objeto que está no estado "
+"persistente (guardado e checado para estado \"sujo\" pelo Hibernate). Isto "
+"significa que ele cresce infinitamente até que você obtenha uma "
+"OutOfMemoryException, se você o mantiver aberto por muito tempo ou "
+"simplesmente carregar dados demais. Uma solução é chamar <literal>clear()</"
+"literal> e <literal>evict()</literal> para controlar o cache da "
+"<literal>Session</literal>, mas você deve considerar uma Store Procedure se "
+"precisar de operações que envolvam grande volume de dados. Algumas soluções "
+"são mostradas no <xref linkend=\"batch\"/>. Manter uma <literal>Session</"
+"literal> aberta durante uma sessão do usuário significa também uma "
+"probabilidade elevada de se acabar com dados velhos."
-#: index.docbook:348
+#. Tag: title
+#: transactions.xml:348
+#, no-c-format
msgid "Database transaction demarcation"
-msgstr ""
+msgstr "Demarcação de transações de bancos de dados"
-#: 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."
+#. 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 ""
+"Os limites de uma transação de banco de dados (ou sistema) são sempre "
+"necessários. Nenhuma comunicação com o banco de dados pode ocorrer fora de "
+"uma transação de banco de dados (isto parece confundir muitos "
+"desenvolvedores que estão usados modo auto-commit). Sempre use os limites "
+"desobstruídos da transação, até mesmo para operações somente leitura. "
+"Dependendo de seu nível de isolamento e capacidade da base de dados isto "
+"pode não ser requerido, mas não há nenhum aspecto negativo se você demarca "
+"sempre transações explicitamente. Certamente, uma única transação será "
+"melhor executada do que muitas transações pequenas, até mesmo para dados de "
+"leitura."
-#: 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."
+#. 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 ""
+"Uma aplicação do Hibernate pode funcionar em ambientes não gerenciados (isto "
+"é aplicações standalone, Web simples ou Swing) e ambientes gerenciados J2EE. "
+"Em um ambiente não gerenciado, o Hibernate é geralmente responsável pelo seu "
+"próprio pool de conexões. O desenvolvedor tem que manualmente ajustar "
+"limites das transaçãos, ou seja, começar, commitar, ou dar rollback nas "
+"transações ele mesmo. Um ambiente gerenciado fornece transações gerenciadas "
+"por contêiner (CMT - container-managed transactions), com um conjunto da "
+"transações definido declarativamente em descritores de deployment de EJB "
+"session beans, por exemplo. A demarcação programática é então já não é "
+"necessário."
-#: 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."
+#. 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 ""
+"Entretanto, é freqüentemente desejável manter sua camada de persistência "
+"portável entre ambientes de recurso locais não gerenciados e sistemas que "
+"podem confiar em JTA, mas usar BMT em vez de CMT. Em ambos os casos você "
+"usaria demarcação de transação programática. O Hibernate oferece uma API "
+"chamada Transaction que traduz dentro do sistema de transação nativa de seu "
+"ambiente de deployment. Esta API é realmente opcional, mas nós encorajamos "
+"fortemente seu uso a menos que você estiver em um CMT session bean."
-#: index.docbook:379
-msgid "Usually, ending a <literal>Session</literal> involves four distinct phases:"
+#. Tag: para
+#: transactions.xml:379
+#, no-c-format
+msgid ""
+"Usually, ending a <literal>Session</literal> involves four distinct phases:"
msgstr ""
+"Geralmente, finalizar um <literal>Session</literal>envolve quatro fases "
+"distintas:"
-#: index.docbook:385
+#. Tag: para
+#: transactions.xml:385
+#, no-c-format
msgid "flush the session"
-msgstr ""
+msgstr "flush da sessão"
-#: index.docbook:390
+#. Tag: para
+#: transactions.xml:390
+#, no-c-format
msgid "commit the transaction"
-msgstr ""
+msgstr "commitar a transação"
-#: index.docbook:395
+#. Tag: para
+#: transactions.xml:395
+#, no-c-format
msgid "close the session"
-msgstr ""
+msgstr "fechar a sessão"
-#: index.docbook:400
+#. Tag: para
+#: transactions.xml:400
+#, no-c-format
msgid "handle exceptions"
-msgstr ""
+msgstr "tratar as exceções"
-#: 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."
+#. 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 ""
+"A limpeza da sessão já foi bem discutida, agora nós daremos uma olhada na "
+"demarcação da transação e na manipulação de exceção em ambientes controlados "
+"e não controlados."
-#: index.docbook:413
+#. Tag: title
+#: transactions.xml:413
+#, no-c-format
msgid "Non-managed environment"
-msgstr ""
+msgstr "Ambiente não gerenciado"
-#: 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:"
+#. Tag: para
+#: transactions.xml:415
+#, no-c-format
+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 ""
+"Se uma camada de persistência do Hibernate roda em um ambiente não "
+"gerenciado, as conexões do banco de dados são geralmente tratadas pelos "
+"pools de conexões simples (isto é, não baseados em DataSource) dos quais o "
+"Hibernate obtém as conexões assim que necessita. A maneira de se manipular "
+"uma sessão/transação é mais ou menos assim:"
-#: index.docbook:422
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: 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 ""
+"Você não pode chamar <literal>flush()</literal> do <literal>Session()</"
+"literal> explicitamente - a chamada ao <literal>commit()</literal> dispara "
+"automaticamente a sincronização para a sessão (dependendo do <xref linkend="
+"\"objectstate-flushing\"> FlushMode</xref>). Uma chamada ao <literal>close()"
+"</literal> marca o fim de uma sessão. A principal implicação do "
+"<literal>close()</literal> é que a conexão JDBC será abandonada pela sessão. "
+"Este código Java é portável e funciona em ambientes não gerenciado e de JTA."
-#: index.docbook:433
-msgid "A much more flexible solution is Hibernate's built-in \"current session\" context management, as described earlier:"
+#. Tag: para
+#: transactions.xml:433
+#, no-c-format
+msgid ""
+"A much more flexible solution is Hibernate's built-in \"current session\" "
+"context management, as described earlier:"
msgstr ""
+"Uma solução muito mais flexível é gerência integrada de contexto da \"sessão "
+"atual\" do Hibernate, como descrito anteriormente:"
-#: index.docbook:438
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: 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 ""
+"Você muito provavelmente nunca verá estes fragmentos de código em uma "
+"aplicação regular; as exceções fatais (do sistema) devem sempre ser pegas no "
+"\"alto\". Ou seja, o código que executa chamadas do Hibernate (na camada de "
+"persistência) e o código que trata <literal>RuntimeException</literal> (e "
+"geralmente pode somente limpar acima e na saída) estão em camadas "
+"diferentes. O gerenciamento do contexto atual feito pelo Hibernate pode "
+"significativamente simplificar este projeto, como tudo que você necessita é "
+"do acesso a um <literal>SessionFactory</literal>. A manipulação de exceção é "
+"discutida mais tarde neste capítulo."
-#: 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>."
+#. 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 ""
+"Note que você deve selecionar <literal>org.hibernate.transaction."
+"JDBCTransactionFactory</literal> (que é o padrão) e para o segundo exemplo "
+"<literal>\"thread\"</literal> como seu <literal>hibernate."
+"current_session_context_class</literal>."
-#: index.docbook:459
+#. Tag: title
+#: transactions.xml:459
+#, no-c-format
msgid "Using JTA"
-msgstr ""
+msgstr "Usando JTA"
-#: 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."
+#. 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 ""
+"Se sua camada de persistência funcionar em um servidor de aplicação (por "
+"exemplo, dentro dos EJB session beans), cada conexão do datasource obtida "
+"pelo Hibernate automaticamente fará parte da transação global de JTA. Você "
+"pode também instalar uma implementação standalone de JTA e usá-la sem EJB. O "
+"Hibernate oferece duas estratégias para a integração de 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."
+#. Tag: para
+#: transactions.xml:468
+#, no-c-format
+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 ""
+"Se você usar bean-managed transactions (BMT - transações gerenciadas por "
+"bean) o Hibernate dirá ao servidor de aplicação para começar e para terminar "
+"uma transação de BMT se você usar a API Transaction. Assim, o código de "
+"gerência de transação é idêntico ao ambiente não gerenciado."
-#: index.docbook:474
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: para
+#: transactions.xml:476
+#, no-c-format
+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:"
msgstr ""
+"Se você quiser usar um <literal>Session</literal> limitada por transação, "
+"isto é, a funcionalidade do <literal>getCurrentSession()</literal> para a "
+"propagação fácil do contexto, você terá que usar diretamente a API JTA "
+"<literal>UserTransaction</literal>:"
-#: index.docbook:482
+#. 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"
- "}]]>"
+"<![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 ""
-#: index.docbook:484
-msgid "With CMT, transaction demarcation is done in session bean deployment descriptors, not programatically, hence, the code is reduced to:"
+#. Tag: para
+#: transactions.xml:484
+#, no-c-format
+msgid ""
+"With CMT, transaction demarcation is done in session bean deployment "
+"descriptors, not programatically, hence, the code is reduced to:"
msgstr ""
+"Com CMT, a demarcação da transação é feita em descritores de deployment do "
+"session beans, não programaticamente, conseqüentemente, o código é reduzido "
+"a:"
-#: index.docbook:489
+#. Tag: programlisting
+#: transactions.xml:489
+#, no-c-format
msgid ""
- "<![CDATA[// CMT idiom\n"
- " Session sess = factory.getCurrentSession();\n"
- "\n"
- " // do some work\n"
- " ...\n"
- "]]>"
+"<![CDATA[// CMT idiom\n"
+" Session sess = factory.getCurrentSession();\n"
+"\n"
+" // do some work\n"
+" ...\n"
+"]]>"
msgstr ""
-#: 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: 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 ""
+"Em um CMT/EJB mesmo um rollback acontece automaticamente, desde que uma "
+"exeção <literal>RuntimeException</literal> não tratável seja lançada por um "
+"método de um session bean que informa ao contêiner ajustar a transação "
+"global ao rollback. <emphasis>Isto significa que você não necessita usar a "
+"API <literal>Transaction</literal> do Hibernate em tudo com BMT ou CMT e "
+"você obtém a propagação automática do Session \"atual\" limitada à transação."
+"</emphasis>"
-#: 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>."
+#. 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 ""
+"Veja que você deverá escolher <literal>org.hibernate.transaction."
+"JTATransactionFactory</literal> se você usar o JTA diretamente (BMT) e "
+"<literal>org.hibernate.transaction.CMTTransactionFactory</literal> em um CMT "
+"session bean, quando você configura a fábrica de transação do Hibernate. "
+"Lembre-se também de configurar o <literal>hibernate.transaction."
+"manager_lookup_class</literal>. Além disso, certifique-se que seu "
+"<literal>hibernate.current_session_context_class</literal> ou não é "
+"configurado (compatibilidade com o legado) ou é definido para <literal>\"jta"
+"\"</literal>."
-#: 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.)"
+#. 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 ""
+"A operação <literal>getCurrentSession()</literal> tem um aspecto negativo em "
+"um ambiente JTA. Há uma advertência para o uso do método liberado de conexão "
+"<literal>after_statement</literal>, o qual é usado então por padrão. Devido "
+"a uma limitação simples da especificação JTA, não é possível para o "
+"Hibernate automaticamente limpar quaisquer instâncias "
+"<literal>ScrollableResults</literal> ou <literal>Iterator</literal> abertas "
+"retornadas pelo <literal>scroll()</literal> ou <literal>iterate()</literal>. "
+"Você <emphasis>deve</emphasis> liberar o cursor subjacente da base de dados "
+"chamando <literal>ScrollableResults.close()</literal> ou <literal>Hibernate."
+"close(Iterator)</literal> explicitamente de um bloco <literal>finally</"
+"literal>. (Claro que a maioria de aplicações podem facilmente evitar o uso "
+"do <literal>scroll()</literal> ou do <literal>iterate()</literal> em todo "
+"código provindo do JTA ou do CMT.)"
-#: index.docbook:524
+#. Tag: title
+#: transactions.xml:524
+#, no-c-format
msgid "Exception handling"
-msgstr ""
+msgstr "Tratamento de Exceção"
-#: 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."
+#. 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 ""
+"Se a <literal>Session</literal> levantar uma exceção (incluindo qualquer "
+"<literal>SQLException</literal>), você deve imediatamente dar um rollback na "
+"transação do banco, chamando <literal>Session.close()</literal> e "
+"descartando a instância da <literal>Session</literal>. Certos métodos da "
+"<literal>Session</literal><literal>não</literal> deixarão a sessão em um "
+"estado inconsistente. Nenhuma exceção lançada pelo Hibernate pode ser "
+"recuperada. Certifique-se que a <literal>Session</literal> será fechada "
+"chamando <literal>close()</literal> no bloco <literal>finally</literal>."
-#: 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."
+#. 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 ""
+"A exceção <literal>HibernateException</literal>, a qual envolve a maioria "
+"dos erros que podem ocorrer em uma camada de persistência do Hibernate, é "
+"uma exceção unchecked ( não estava em umas versões mais antigas de "
+"Hibernate). Em nossa opinião, nós não devemos forçar o desenvolvedor a "
+"tratar uma exceção irrecuperável em uma camada mais baixa. Na maioria dos "
+"sistemas, as exceções unchecked e fatais são tratadas em um dos primeiros "
+"frames da pilha da chamada do método (isto é, em umas camadas mais elevadas) "
+"e uma mensagem de erro é apresentada ao usuário da aplicação (ou a alguma "
+"outra ação apropriada é feita). Note que Hibernate pode também lançar outras "
+"exceções unchecked que não são um <literal>HibernateException</literal>. "
+"Estas, também são, irrecuperáveis e uma ação apropriada deve ser tomada."
-#: 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:"
+#. 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 ""
+"O Hibernate envolve <literal>SQLException</literal>s lançadas ao interagir "
+"com a base de dados em um <literal>JDBCException</literal>. Na realidade, o "
+"Hibernate tentará converter a exceção em em uma sub classe mais "
+"significativa da <literal>JDBCException</literal>. A <literal>SQLException</"
+"literal> subjacente está sempre disponível através de <literal>JDBCException."
+"getCause()</literal>. O Hibernate converte a <literal>SQLException</literal> "
+"em uma sub classe <literal>JDBCException</literal> apropriada usando "
+"<literal>SQLExceptionConverter</literal> associado ao SessionFactory. Por "
+"padrão, o <literal>SQLExceptionConverter</literal> é definido pelo dialeto "
+"configurado; entretanto, é também possível conectar em uma implementação "
+"customizada (veja o javadoc para mais detalhes da classe "
+"<literal>SQLExceptionConverterFactory</literal>). Os subtipos padrão de "
+"<literal>JDBCException</literal> são:"
-#: index.docbook:565
-msgid "<literal>JDBCConnectionException</literal> - indicates an error with the underlying JDBC communication."
+#. Tag: para
+#: transactions.xml:565
+#, no-c-format
+msgid ""
+"<literal>JDBCConnectionException</literal> - indicates an error with the "
+"underlying JDBC communication."
msgstr ""
+"<literal>JDBCConnectionException</literal> - indica um erro com a "
+"comunicação subjacente de JDBC."
-#: index.docbook:571
-msgid "<literal>SQLGrammarException</literal> - indicates a grammar or syntax problem with the issued 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> - indica um problema da gramática ou "
+"da sintaxe com o SQL emitido."
-#: index.docbook:577
-msgid "<literal>ConstraintViolationException</literal> - indicates some form of integrity constraint violation."
+#. Tag: para
+#: transactions.xml:577
+#, no-c-format
+msgid ""
+"<literal>ConstraintViolationException</literal> - indicates some form of "
+"integrity constraint violation."
msgstr ""
+"<literal>ConstraintViolationException</literal> - indica algum forma de "
+"violação de confinamento de integridade."
-#: index.docbook:583
-msgid "<literal>LockAcquisitionException</literal> - indicates an error acquiring a lock level necessary to perform the requested operation."
+#. 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> - indica um erro ao adquirir um "
+"nível de bloqueio necessário para realizar a operação de requisição."
-#: index.docbook:589
-msgid "<literal>GenericJDBCException</literal> - a generic exception which did not fall into any of the other categories."
+#. 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> - uma exceção genérica que não cai "
+"em algumas das outras categorias."
-#: index.docbook:599
+#. Tag: title
+#: transactions.xml:599
+#, no-c-format
msgid "Transaction timeout"
-msgstr ""
+msgstr "Timeout de Transação"
-#: 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."
+#. Tag: para
+#: transactions.xml:601
+#, no-c-format
+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 ""
+"Uma característica extremamente importante fornecida por um ambiente "
+"gerenciado como EJB e que nunca é fornecido pelo código não gerenciado é o "
+"timeout de transação. Timeouts de transação asseguram que nenhuma transação "
+"possa reter indefinidamente recursos enquanto não retorna nenhuma resposta "
+"ao usuário. Fora de um ambiente controlado (JTA), o Hibernate não pode "
+"fornecer inteiramente esta funcionalidade. Entretanto, o Hibernate pode "
+"afinal controlar as operações do acesso a dados, assegurando que o nível de "
+"deadlocks e queries do banco de dados com imensos resultados definidos sejam "
+"limitados pelo timeout. Em um ambiente gerenciado, o Hibernate pode delegar "
+"o timeout da transação ao JTA. Esta funcionalidade é abstraída pelo objeto "
+"<literal>Transaction</literal> do Hibernate."
-#: index.docbook:614
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: 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 ""
+"Veja que <literal>setTimeout()</literal> não pode ser chamado em um CMT "
+"bean, onde os timeouts das transações devem ser definidos declarativamente."
-#: index.docbook:626
+#. Tag: title
+#: transactions.xml:626
+#, no-c-format
msgid "Optimistic concurrency control"
-msgstr ""
+msgstr "Controle de concorrência otimista"
-#: 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."
+#. 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 ""
+"O único caminho que é consistente com a elevada concorrência e "
+"escalabilidade é controle de concorrência otimista com versionamento. "
+"Checagem de versão usa número de versão, ou timestamps, para detectar "
+"conflitos de atualizações (e para impedir atualizações perdidas). O "
+"Hibernate fornece três caminhos possíveis para escrever aplicações que usam "
+"concorrência otimista. Os casos de uso que nós mostramos estão no contexto "
+"de conversações longas, mas a checagem de versão também tem o benefício de "
+"impedir atualizações perdidas em únicas transações."
-#: index.docbook:639
+#. Tag: title
+#: transactions.xml:639
+#, no-c-format
msgid "Application version checking"
-msgstr ""
+msgstr "Checagem de versão da aplicação"
-#: 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."
+#. Tag: para
+#: transactions.xml:641
+#, no-c-format
+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 ""
+"Em uma implementação sem muita ajuda do Hibernate, cada interação com o "
+"banco de dados ocorre em uma nova <literal>Session</literal> e o "
+"desenvolvedor é responsável para recarregar todas as instâncias persistentes "
+"da base de dados antes de manipulá-las. Este caminho força a aplicação a "
+"realizar sua própria checagem de versão para assegurar a conversação do "
+"isolamento da transação. Este caminho é menos eficiente em termos de acesso "
+"ao banco de dados. É a caminho mais similar a EJBs entity."
-#: index.docbook:650
+#. 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();]]>"
+"<![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 ""
-#: index.docbook:652
-msgid "The <literal>version</literal> property is mapped using <literal><version></literal>, and Hibernate will automatically increment it during flush if the entity is dirty."
+#. Tag: para
+#: transactions.xml:652
+#, no-c-format
+msgid ""
+"The <literal>version</literal> property is mapped using <literal><"
+"version></literal>, and Hibernate will automatically increment it during "
+"flush if the entity is dirty."
msgstr ""
+"A propriedade <literal>version</literal> é mapeada usando <literal><"
+"version></literal>, e o Hibernate vai incrementá-lo-á automaticamente "
+"durante o flush se a entidade estiver alterada."
-#: 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."
+#. 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 ""
+"Claro, se você se estiver operando em um ambiente de baixa concorrência de "
+"dados e não requerer a checagem de versão, você pode usar este caminho e "
+"apenas saltar a checagem de versão. Nesse caso, o <emphasis>ultimo commit "
+"realizdo </emphasis> é a estratégia padrão para suas conversações longas. "
+"Mantenha em mente que isto pode confundir os usuários da aplicação, assim "
+"como eles podem experimentar atualizações perdidas sem mensagens de erro ou "
+"uma possibilidade ajustar mudanças de conflito."
-#: 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."
+#. 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 ""
+"Claro que, checagem manual da versão é somente praticável em circunstâncias "
+"triviais e não para a maioria de aplicações. Freqüentemente, os grafos "
+"completos de objetos modificados têm que ser verificados, não somente únicas "
+"instâncias. O Hibernate oferece checagem de versão automática com uma "
+"<literal>Session</literal> estendida ou instâncias desatachadas como o "
+"paradigma do projeto."
-#: index.docbook:678
+#. Tag: title
+#: transactions.xml:678
+#, no-c-format
msgid "Extended session and automatic versioning"
-msgstr ""
+msgstr "Sessão estendida e versionamento automático"
-#: 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)."
+#. 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 ""
+"Uma única instância de <literal>Session</literal> e suas instâncias "
+"persistentes são usadas para a conversação inteira, isto é conhecido como "
+"<emphasis>session-per-conversation</emphasis>. O Hibernate verifica versões "
+"da instância no momento dio flush, lançando uma exceção se a modificação "
+"concorrente for detectada. Até o desenvolvedor pegar e tratar essa exceção "
+"(as opções comuns são a oportunidade para que o usuário intercale as "
+"mudanças ou reinicie a conversação do negócio com dados não antigos)."
-#: 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."
+#. Tag: para
+#: transactions.xml:689
+#, no-c-format
+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 ""
+"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. A "
+"<literal>Session</literal> é desconectada de toda a conexão JDBC subjacente "
+"enquanto espera a interação do usuário. Este caminho é a mais eficiente em "
+"termos de acesso a bancos de dados. A aplicação não necessita concernir-se "
+"com a checagem de versão ou com as instâncias destacadas reatadas, nem tem "
+"que recarregar instâncias em cada transação."
-#: index.docbook:697
+#. 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]]>"
+"<![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 ""
-#: 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: 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 ""
+"O objeto <literal>foo</literal> sabe que <literal>Session</literal> já foi "
+"carregada. Começando uma nova transação em uma sessão velha obtém uma "
+"conexão nova e recomeça a sessão. Commitando uma transação desconecta uma "
+"sessão da conexão JDBC e retorna a conexão ao pool. Após a reconexão, forçar "
+"uma checagem de versão em dados que você não está atualizando, você pode "
+"chamar <literal>Session.lock()</literal> com o <literal>LockMode.READ</"
+"literal> em todos os objetos que possam ter sido atualizados por uma outra "
+"transação. Você não necessita bloquear nenhum dado para atualizar. "
+"Geralmente você configuraria <literal>FlushMode.MANUAL</literal> em uma "
+"<literal>Session</literal> estendida, de modo que somente o último ciclo da "
+"transação tenha permissão de persistir todas as modificações feitas nesta "
+"conversação. Disso, somente esta última transação incluiria a operação "
+"<literal>flush()</literal> e então chamar também <literal>close()</literal> "
+"da sessão para terminar a conversação."
-#: 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."
+#. 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 ""
+"Este pattern é problemático se a <literal>Session</literal> for "
+"demasiadamente grande para ser armazenado durante o tempo que usuário "
+"pensar, por exemplo um <literal>HttpSession</literal> estiver mantido tão "
+"pequeno quanto possível. Como o <literal>Session</literal> é também cache de "
+"primeiro nível (imperativo) e contém todos os objetos carregados, nós "
+"podemos provavelmente usar esta estratégia somente para alguns ciclos de "
+"requisição/resposta. Você deve usar a <literal>Session</literal> somente "
+"para uma única conversação, porque ela logo também estará com dados velhos."
-#: 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.)"
+#. 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 ""
+"(Note que versões mais atuais de Hibernate requerem a desconexão e o "
+"reconexão explícitas de uma <literal>Session</literal>. Estes métodos são "
+"desatualizados, como o início e término de uma transação tem o mesmo efeito.)"
-#: 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>."
+#. 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 ""
+"Note também que você deve manter a <literal>Session</literal> desconectada "
+"fechada para a camada de persistência. Ou seja, use um EJB stateful session "
+"bean para prender a <literal>Session</literal> em um ambiente do três "
+"camadas e não o transferir à camada web (ou até serializá-lo para uma camada "
+"separada) para armazená-lo no <literal>HttpSession</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."
+#. 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 ""
+"O pattern sessão estendida, ou <emphasis>session-per-conversation</"
+"emphasis>, é mais difícil de implementar com gerenciamento automático de "
+"sessão atual. Você precisa fornecer sua própria implementação do "
+"<literal>CurrentSessionContext</literal> para isto (veja o Hibernate Wiki "
+"para exemplos)."
-#: index.docbook:747
+#. Tag: title
+#: transactions.xml:747
+#, no-c-format
msgid "Detached objects and automatic versioning"
-msgstr ""
+msgstr "Objetos destacados e versionamento automático"
-#: 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>."
+#. Tag: para
+#: transactions.xml:749
+#, no-c-format
+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 ""
+"Cada interação com o armazenamento persistente ocorre em uma "
+"<literal>Session</literal> nova. Entretanto, as mesmas instâncias "
+"persistentes são reusadas para cada interação com o banco de dados. A "
+"aplicação manipula o estado das instâncias desatachadas originalmente "
+"carregadas em um outro <literal>Session</literal> e reata-os então usando "
+"<literal>Session.update()</literal>, <literal>Session.saveOrUpdate()</"
+"literal> ou <literal>Session.merge()</literal>."
-#: index.docbook:757
+#. 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();]]>"
+"<![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 ""
-#: index.docbook:759
-msgid "Again, Hibernate will check instance versions during flush, throwing an exception if conflicting updates occured."
+#. 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 ""
+"Outra vez, o Hibernate verificará versões da instância durante o flush, "
+"lançando uma exceção se ocorrer conflitos de atualizações."
-#: 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."
+#. 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 ""
+"Você pode também chamar o <literal>lock()</literal> em vez de <literal>update"
+"()</literal> e usar <literal>LockMode.READ</literal> (executando uma "
+"checagem de versão, ignorando todos os caches) se você estiver certo de que "
+"o objeto não foi modificado."
-#: index.docbook:773
+#. Tag: title
+#: transactions.xml:773
+#, no-c-format
msgid "Customizing automatic versioning"
-msgstr ""
+msgstr "Versionamento automático customizado"
-#: 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."
+#. 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 ""
+"Você pode desabilitar o incremento da versão automática de Hibernate para "
+"propriedades e coleções particulares configurando o mapeamento do atributo "
+"<literal>optimistic-lock</literal> para false. O Hibernate então não irá "
+"incrementa versões se a propriedade estiver modificada."
-#: 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><class></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."
+#. 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><class></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 ""
+"Os esquemas da base de dados legada são freqüentemente estáticos e não podem "
+"ser modificados. Ou outras aplicações puderam também acessar a mesma base de "
+"dados e não sabem tratar a versão dos números ou timestamps. Em ambos os "
+"casos, o versionamento não pode confiar em uma coluna particular em uma "
+"tabela. Para forçar uma checagem de versão sem uma versão ou mapeamento da "
+"propriedade do timestamp com uma comparação do estado de todos os campos em "
+"uma linha, configure <literal>optimistic-lock=\"all\"</literal> no "
+"mapeamento <literal><class></literal>. Note que isto conceitualmente é "
+"somente feito em trabalhos se Hibernate puder comparar o estado velho e "
+"novo, isto é, se você usa um único <literal>Session</literal> longo e não "
+"session-per-request-with-detached-objects."
-#: 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><class></literal>, Hibernate will only compare dirty fields during flush."
+#. 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><class></literal>, "
+"Hibernate will only compare dirty fields during flush."
msgstr ""
+"Às vezes a modificação concorrente pode ser permitida tão longa quanto às "
+"mudanças que tiveram sido feitas que não sobrepuseram. Se você configurar "
+"<literal>optimistic-lock=\"dirty\"</literal> ao mapear o <literal><"
+"class></literal>, o Hibernate comparará somente campos modificados "
+"durante o flush."
-#: 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><class></literal> mapping, forcing Hibernate to <literal>SELECT</literal> the instance to ensure that changes did actually occur, before updating the row."
+#. 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><class></literal> mapping, forcing Hibernate "
+"to <literal>SELECT</literal> the instance to ensure that changes did "
+"actually occur, before updating the row."
msgstr ""
+"Em ambos os casos, com as colunas dedicadas da versão/timestamp ou com "
+"comparação do campo cheio/modificados, o Hibernate usa uma única declaração "
+"UPDATE (com uma cláusula WHERE apropriada ) por entidade para executar a "
+"checagem da versão e atualizar a informação. Se você usa a persistência "
+"transitiva para cascatear o reatamento das entidades associadas, o Hibernate "
+"pode executar atualizações desnecessárias. Isso não é geralmente um "
+"problema, mas triggers <emphasis>on update</emphasis> em um banco de dados "
+"podem ser executados mesmo quando nenhuma mudança foi feita nas instâncias "
+"destacadas. Você pode customizar este comportamento configurando "
+"<literal>select-before-update=\"true\"</literal> no mapeamento <literal><"
+"class></literal>, forçando o Hibernate a dá um SELECT nas instâncias para "
+"assegurar-se esse as mudanças ocorreram realmente, antes de atualizar a "
+"linha."
-#: index.docbook:817
+#. Tag: title
+#: transactions.xml:817
+#, no-c-format
msgid "Pessimistic Locking"
-msgstr ""
+msgstr "Locking pessimista"
-#: 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."
+#. 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 ""
+"Não se pretende que os usuários gastam muitas horas se preocupando com suas "
+"estratégias de locking. Geralmente é o bastante para especificar um nível de "
+"isolamento para as conexões JDBC e então deixar simplesmente o banco de "
+"dados fazer todo o trabalho. Entretanto, os usuários avançados podem às "
+"vezes desejar obter locks pessimistas exclusivos, ou re-obter locks no "
+"início de uma nova transação."
-#: index.docbook:826
-msgid "Hibernate will always use the locking mechanism of the database, never lock objects in memory!"
+#. 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 ""
+"O Hibernate usará sempre o mecanismo de lock da base de dados, nunca trava "
+"objetos na memória!"
-#: 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:"
+#. 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 ""
+"A classe <literal>LockMode</literal> define os diferentes níveis de lock que "
+"o Hibernate pode adquirir. Um lock é obtido pelos seguintes mecanismos:"
-#: index.docbook:838
-msgid "<literal>LockMode.WRITE</literal> is acquired automatically when Hibernate updates or inserts a row."
+#. 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> é adquirido automaticamente quando o "
+"Hibernate atualiza ou insere uma linha."
-#: 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."
+#. 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> pode ser adquirido explicitamente pelo "
+"usuário usando <literal>SELECT ... FOR UPDATE</literal> em um banco de dados "
+"que suporte esse sintaxe."
-#: 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."
+#. 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> pode ser adquirido explicitamente "
+"pelo usuário usando <literal>SELECT ... FOR UPDATE NOWAIT</literal> no "
+"Oracle."
-#: 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."
+#. 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> é adquirido automaticamente quando o "
+"Hibernate lê dados em um nível Repeatable Read ou Serializable isolation. "
+"Pode ser readquirido explicitamente pelo usuário."
-#: 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."
+#. 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> representa a ausência do lock. Todos os "
+"objetos mudam para esse estado de lock no final da <literal>Transaction</"
+"literal>. Objetos associados com a sessão através do método <literal>update()"
+"</literal> ou <literal>saveOrUpdate()</literal> também são inicializados com "
+"esse lock mode."
-#: index.docbook:872
-msgid "The \"explicit user request\" is expressed in one of the following ways:"
+#. Tag: para
+#: transactions.xml:872
+#, no-c-format
+msgid ""
+"The \"explicit user request\" is expressed in one of the following ways:"
msgstr ""
+"O lock obtido \"explicitamente pelo usuário\" se dá em uma das seguintes "
+"maneiras:"
-#: index.docbook:878
-msgid "A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</literal>."
+#. Tag: para
+#: transactions.xml:878
+#, no-c-format
+msgid ""
+"A call to <literal>Session.load()</literal>, specifying a <literal>LockMode</"
+"literal>."
msgstr ""
+"Uma chamada a <literal>Session.load()</literal>, especificando o "
+"<literal>LockMode</literal>."
-#: index.docbook:883
+#. Tag: para
+#: transactions.xml:883
+#, no-c-format
msgid "A call to <literal>Session.lock()</literal>."
-msgstr ""
+msgstr "Uma chamada a <literal>Session.lock()</literal>."
-#: index.docbook:888
+#. Tag: para
+#: transactions.xml:888
+#, no-c-format
msgid "A call to <literal>Query.setLockMode()</literal>."
-msgstr ""
+msgstr "Uma chamada a <literal>Query.setLockMode()</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."
+#. 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 ""
+"Se uma <literal>Session.load()</literal> é invocada com <literal>UPGRADE</"
+"literal> ou <literal>UPGRADE_NOWAIT</literal>, e o objeto requisitado ainda "
+"não foi carregado pela sessão, o objeto é carregado usando "
+"<literal>SELECT ... FOR UPDATE</literal>. Se <literal>load()</literal> for "
+"chamado para um objeto que já foi carregado com um lock menos restritivo que "
+"o novo lock solicitado, o Hibernate invoca o método <literal>lock()</"
+"literal> para aquele objeto."
-#: 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.)"
+#. 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 ""
+"O método <literal>Session.lock()</literal> executa uma verificação no número "
+"da versão se o modo de lock especificado for <literal>READ</literal>, "
+"<literal>UPGRADE</literal> ou <literal>UPGRADE_NOWAIT</literal>.. (No caso "
+"do <literal>UPGRADE</literal> ou <literal>UPGRADE_NOWAIT</literal>, é usado "
+"<literal>SELECT ... FOR UPDATE</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."
+#. 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 ""
+"Se o banco de dados não suportar o lock mode solicitado, o Hibernate vai "
+"usar um modo alternativo apropriado (ao invés de lançar uma exceção). Isso "
+"garante que a aplicação vai ser portável."
-#: index.docbook:919
+#. Tag: title
+#: transactions.xml:919
+#, no-c-format
msgid "Connection Release Modes"
-msgstr ""
+msgstr "Modos de liberar a Connection"
-#: 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>:"
+#. 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 ""
+"O comportamento legado do Hibernate (2.x) em consideração ao gerenciamento "
+"da conexão via JDBC fez com que a <literal>Session</literal> precisasse "
+"obter uma conexão quando ela precisasse pela primeira vez e depois manter a "
+"conexão enquanto a sessão não fosse fechada. O Hibernate 3.x introduz a "
+"idéia de modos de liberar a sessão, para informar a sessão a forma como deve "
+"manusear a sua conexão JDBC. Veja que essa discussão só é pertinente para "
+"conexões fornecidas com um <literal>ConnectionProvider</literal> "
+"configurado; conexões fornecidas pelo usuário estão fora do escopo dessa "
+"discussão. Os diferentes modos de liberação estão definidos pelos valores da "
+"enumeração <literal>org.hibernate.ConnectionReleaseMode</literal>:"
-#: 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."
+#. 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> - essencialmente é o modo legado descrito acima. "
+"A sessão do Hibernate obtêm a conexão quando precisar executar alguma "
+"operação JDBC pela primeira vez e mantem enquanto a conexão não for fechada."
-#: index.docbook:942
-msgid "<literal>AFTER_TRANSACTION</literal> - says to release connections after a <literal>org.hibernate.Transaction</literal> has completed."
+#. 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> – informa que a conexão deve ser "
+"liberada após a conclusão de uma <literal>org.hibernate.Transaction</"
+"literal>."
-#: 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>."
+#. 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> (também conhecida com liberação "
+"agressiva) – informa que a conexão deve ser liberada após a execução de cada "
+"statement. A liberação agressiva não ocorre se o statement deixa pra trás "
+"algum recurso aberto associado com a sessão obtida; atualmente, a única "
+"situação em que isso é possível é com o uso de <literal>org.hibernate."
+"ScrollableResults</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:"
+#. 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 ""
+"O parâmetro de configuração <literal>hibernate.connection.release_mode</"
+"literal> é usado para especificar qual modo de liberação deve ser usado. "
+"Opções disponíveis:"
-#: 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."
+#. 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> (padrão) – essa opção delega ao modo de liberação "
+"retornado pelo método <literal>org.hibernate.transaction.TransactionFactory."
+"getDefaultReleaseMode()</literal>. Para JTATransactionFactory, ele retorna "
+"ConnectionReleaseMode.AFTER_STATEMENT; para JDBCTransactionFactory, ele "
+"retorna ConnectionReleaseMode.AFTER_TRANSACTION. Raramente é uma boa idéia "
+"alterar padrão, como frequencia ao se fazer isso temos falhas que parecem "
+"bugs e/ou suposições inválidas no código do usuário."
-#: 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."
+#. 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> - indica o uso da ConnectionReleaseMode."
+"ON_CLOSE. Essa opção foi deixada para manter a compatibilidade, mas seu uso "
+"é fortemente desencorajado."
-#: 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."
+#. 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> – indica o uso da ConnectionReleaseMode."
+"AFTER_TRANSACTION. Essa opção nada deve ser usada com ambientes JTA. Também "
+"note que no caso da ConnectionReleaseMode.AFTER_TRANSACTION, se a sessão foi "
+"colocada no modo auto-commit a conexão vai ser liberada de forma similar ao "
+"modo AFTER_STATEMENT."
-#: 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."
+#. 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"<literal>after_statement</literal> – indica o uso ConnectionReleaseMode."
+"AFTER_STATEMENT. Adicionalmente, o <literal>ConnectionProvider</literal> "
+"configurado é consultado para verificar se suporta essa configuração "
+"((<literal>supportsAggressiveRelease()</literal>). Se não suportar, o modo "
+"de liberação é redefinido como ConnectionRelease-Mode.AFTER_TRANSACTION. "
+"Essa configuração só é segura em ambientes onde podemos readquirir a mesma "
+"conexão JDBC toda vez que o método <literal>ConnectionProvider.getConnection"
+"()</literal> for chamado ou em um ambiente auto-commit onde não importa se "
+"nós recuperamos a mesma conexão."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/tutorial.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,1315 +1,2829 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:7
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Introdução ao Hibernate"
-#: index.docbook:10
+#. Tag: title
+#: tutorial.xml:10
+#, no-c-format
msgid "Preface"
-msgstr ""
+msgstr "Prefácio"
-#: 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."
+#. 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 ""
+"Este capítulo é um tutorial introdutório para novos usuários do Hibernate. "
+"Nós iniciaremos com uma simples linha de comando em uma aplicação usando uma "
+"base de dados em memória tornando isto um passo de fácil de compreender."
-#: 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."
+#. 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 ""
+"Este tutorial é voltado para novos usuários do Hibernate, mas requer um "
+"conhecimento de Java e SQL. Este tutorial é baseado no tutorial de Michael "
+"Gloegl, as bibliotecas Third Party foram nomeadas para JDK 1.4 e 5.0. Você "
+"pode precisar de outras bibliotecas para 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."
+#. 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 ""
+"O código fonte para o tutorial está incluído no diretório da distribuição "
+"<literal>doc/reference/tutorial/</literal>."
-#: index.docbook:32
+#. Tag: title
+#: tutorial.xml:32
+#, no-c-format
msgid "Part 1 - The first Hibernate Application"
-msgstr ""
+msgstr "Parte 1 – A primeira aplicação 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."
+#. 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 ""
+"Primeiro, iremos criar uma simples aplicação Hibernate baseada em console. "
+"Usaremos uma base de dados Java (HSQL DB), então não teremos que instalar "
+"nenhum servidor de base de dados."
-#: 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."
+#. 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 ""
+"Vamos supor que precisemos de uma aplicação com um banco de dados pequeno "
+"que possa armazenar e atender os eventos que queremos, e as informaççes "
+"sobre os hosts destes eventos."
-#: 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:"
+#. 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 ""
+"A primeira coisa que devemos fazer é configurar nosso diretório de "
+"desenvolvimento, e colocar todas as bibliotecas Java que precisamos dentro "
+"dele. Faça o download da distribuição do Hibernate no site do Hibernate. "
+"Descompacte o pacote e coloque todas as bibliotecas necessárias encontradas "
+"no diretório <literal>/lib</literal>, dentro do diretório <literal>/lib</"
+"literal> do seu novo projeto. Você deverá ter algo parecido com isso:"
-#: 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 ""
-#: 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.)"
+#. 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 ""
+"Esta é a configuração mínima requerida das bibliotecas (observe que também "
+"foi copiado o hibernate3.jar da pasta principal do Hibernate) para o "
+"Hibernate <emphasis>na hora do desenvolvimento</emphasis>. O Hibernate "
+"permite que você utilize mais ou menos bibliotecas. Veja o arquivo "
+"<literal>README.txt</literal> no diretório <literal>lib/</literal> da "
+"distribuição do Hibernate para maiores informaççes sobre bibliotecas "
+"requeridas e opcionais. (Atualmente, a biblioteca Log4j não é requerida, mas "
+"é preferida por muitos desenvolvedores.)"
-#: 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 ""
+"Agora, iremos criar uma classe que representa o evento que queremos "
+"armazenar na base de dados.."
-#: index.docbook:68
+#. Tag: title
+#: tutorial.xml:68
+#, no-c-format
msgid "The first class"
-msgstr ""
+msgstr "A primeira Classe"
-#: 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 ""
+"Nossa primeira classe de persistência é uma simples classe JavaBean com "
+"algumas propriedades:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Você pode ver que esta classe usa o padrão JavaBean para o nomeamento "
+"convencional da propriedade getter e dos métodos setter, como também a "
+"visibilidade private dos campos. Este é um padrão de projeto recomendado, "
+"mas não requerido. O Hibernate pode também acessar campos diretamente, o "
+"benefício para os métodos de acesso é a robustez para o Refactoring. O "
+"construtor sem argumento é requerido para instanciar um objeto desta classe "
+"com a reflexão."
-#: 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."
+#. 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 ""
+"A propriedade <literal>id</literal> mantém um único valor de identificação "
+"para um evento particular. Todas as classes persistentes da entidade (bem "
+"como aquelas classes dependentes de menos importância) precisam de uma "
+"propriedade de identificação, caso nós queiramos usar o conjunto completo de "
+"características do Hibernate. De fato, a maioria das aplicações (esp. "
+"aplicações web) precisam destinguir os objetos pelo identificador, então "
+"você deverá considerar esta, uma característica em lugar de uma limitação. "
+"Porém, nós normalmente não manipulamos a identidade de um objeto, "
+"consequentemente o método setter deverá ser privado. O Hibernate somente "
+"nomeará os identificadores quando um objeto for salvo. Você pode ver como o "
+"Hibernate pode acessar métodos públicos, privados, e protegidos, como também "
+"campos (públicos, privados, protegidos) diretamente. A escolha está até "
+"você, e você pode combinar isso para adaptar seu projeto de aplicação"
-#: 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."
+#. 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 ""
+"O construtor sem argumentos é um requerimento para todas as classes "
+"persistentes; O Hibernate tem que criar para você os objetos usando Java "
+"Reflection. O construtor pode ser privado, porém, a visibilidade do pacote é "
+"requerida para a procuração da geração em tempo de execução e recuperação "
+"eficiente dos dados sem a instrumentação de bytecode"
-#: 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:"
+#. 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 ""
+"Coloque este fonte Java no diretório chamado <literal>src</literal> na pasta "
+"de desenvolvimento, e em seu pacote correto. O diretório deverá ser parecido "
+"como este:"
-#: 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 ""
-#: index.docbook:110
+#. Tag: para
+#: tutorial.xml:110
+#, no-c-format
msgid "In the next step, we tell Hibernate about this persistent class."
msgstr ""
+"No próximo passo, iremos falar sobre as classes de persistência do "
+"Hibernate.."
-#: index.docbook:117
+#. Tag: title
+#: tutorial.xml:117
+#, no-c-format
msgid "The mapping file"
-msgstr ""
+msgstr "O mapeamento do arquivo"
-#: 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."
+#. 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 ""
+"O Hibernate precisa saber como carregar e armazenar objetos da classe de "
+"persistência. Isto será onde o mapeamento do arquivo do Hibernate entrará em "
+"jogo. O arquivo mapeado informa ao Hibernate, qual tabela no banco de dados "
+"ele deverá acessar, e quais as colunas na tabela ele deverá usar."
-#: index.docbook:126
+#. Tag: para
+#: tutorial.xml:126
+#, no-c-format
msgid "The basic structure of a mapping file looks like this:"
-msgstr ""
+msgstr "A estrutura básica de um arquivo de mapeamento é parecida com:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Note que o Hibernate DTD é muito sofisticado. Você pode usar isso para auto-"
+"conclusão no mapeamento XML dos elementos e atributos no seu editor ou IDE. "
+"Você também pode abrir o arquivo DTD no seu editor – é a maneira mais fácil "
+"de ter uma visão geral de todos os elementos e atributos e dos padrões, como "
+"também alguns comentários. Note que o Hibernate não irá carregar o arquivo "
+"DTD da web, e sim do diretório da aplicação (classpath). O arquivo DTD está "
+"incluído no <literal>hibernate3.jar</literal> como também no diretório "
+"<literal>src/</literal> da distribuição do Hibernate."
-#: index.docbook:143
-msgid "We will omit the DTD declaration in future examples to shorten the code. It is of course not optional."
+#. 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 ""
+"Nós omitiremos a declaração do DTD nos exemplos futuros para encurtar o "
+"código. Isto, é claro, não é opcional."
-#: 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:"
+#. 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 ""
+"Entre os dois tags <literal>hibernate-mapping</literal>, inclua um elemento "
+"<literal>class</literal>. Todas as classes persistentes da entidade "
+"(novamente, poderá haver mais tarde, dependências sobre as classes que não "
+"são classes-primárias de entidades) necessitam do tal mapeamento, para uma "
+"tabela na base de dados 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 ""
-#: 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:"
+#. 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 ""
+"Mais adiante iremos dizer ao Hibernate como fazer para persistir e carregar "
+"objetos da classe <literal>Event</literal> da tabela <literal>EVENTS</"
+"literal>, cada instancia representada por uma coluna na tabela. Agora, "
+"continuaremos com o mapeamento de uma única propriedade identificadora para "
+"as chaves primárias da tabela. Além disso, nós não iremos se importar com "
+"esta propriedade identificadora, nós iremos configurar uma estratégia de "
+"geração de id’s para uma chave primária de uma surrogate key:"
-#: 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 ""
-#: 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)."
+#. 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 ""
+"O elemento <literal>id</literal> é a declaração da propriedade "
+"identificadora, o <literal>name=\"id\"</literal> declara o nome da "
+"propriedade Java – o Hibernate irá usar os métodos getter e setter para "
+"acessar a propriedade. O atributo da coluna informa ao Hibernate qual coluna "
+"da tabela <literal>EVENTS</literal> nós iremos usar como chave primária. O "
+"elemento <literal>generator</literal> especifica a estratégia de geração do "
+"identificador, neste caso usaremos <literal>native</literal>, que escolhe a "
+"melhor estratégia dependendo da base de dados (dialeto) configurada. O "
+"Hibernate suporta a base de dados gerada, globalmente única, bem como a "
+"atribuição aos identificadores da aplicação (ou toda estratégia escrita para "
+"uma extensão)."
-#: 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:"
+#. 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 ""
+"Finalmente incluiremos as declarações para as propriedades persistentes da "
+"classe no arquivo mapeado. Por default, nenhuma das propriedades da classe é "
+"considerada persistente:"
-#: 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 ""
-#: 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>."
+#. 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 ""
+"Da mesma maneira que com o elemento <literal>id</literal>, o atributo "
+"<literal>name</literal> do elemento <literal>property</literal> informa ao "
+"Hibernate qual método getter e setter deverá usar. Assim, neste caso, o "
+"Hibernate irá procurar pelo <literal>getDate()/setDate()</literal>, como "
+"também pelo <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."
+#. 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 ""
+"Porque fazer o mapeamento da propriedade <literal>date</literal> incluído no "
+"atributo <literal>column</literal>, e no title não fazer? Sem o atributo "
+"<literal>column</literal> o Hibernate por padrão usa o nome da propriedade "
+"como o nome da coluna. Isto trabalha muito bem para o <literal>title</"
+"literal>. Entretanto o <literal>date</literal> é uma palavra-chave reservada "
+"na maioria dos bancos de dados, assim nós melhoramos o mapeamentos disto com "
+"um nome diferente."
-#: 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."
+#. 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 ""
+"A próxima coisa interessante é que mapemanto do <literal>title</literal> "
+"também falta o atributo <literal>type</literal>. O tipo que declaramos e o "
+"uso nos arquivos mapeados, não são como você pôde esperar, atributos de "
+"dados Java. Eles não são como os tipos de base de dados SQL. Esses tipos "
+"podem ser chamados de <emphasis>Tipos de mapeamento Hibernate</emphasis>, "
+"que são conversores que podem traduzir tipos de dados do Java para os tipos "
+"de dados SQL e vice-versa. Novamente, o Hibernate irá tentar determinar a "
+"conversão correta e mapeará o <literal>type</literal> próprio, caso o tipo "
+"do atributo não estiver presente no mapeamento. Em alguns casos, esta "
+"detecção automática (que usa Reflection sobre as classes Java) poderá não "
+"ter padrão que você espera ou necessita. Este é o caso com a propriedade "
+"<literal>date</literal>. O Hibernate não pode saber se a propriedade (que é "
+"do <literal>java.util.Date</literal>) pode mapear para uma coluna do tipo "
+"<literal>date</literal> do SQL, <literal>timestamp</literal>, ou "
+"<literal>time</literal> . Nós preservamos a informação cheia de datas e "
+"horas pelo mapeamento da propriedade com um conversor <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:"
+#. 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 ""
+"Este arquivo de mapeamento deve ser salvo como <literal>Event.hbm.xml</"
+"literal>, corretamente no diretório próximo ao arquivo fonte da Classe Java "
+"<literal>Event</literal>. O nomeamento dos arquivos de mapeamento podem ser "
+"arbitrários, porém o sufixo <literal>hbm.xml</literal> é uma convenção da "
+"comunidade dos desenvolvedores do Hibernate. Esta estrutura do diretório "
+"deve agora se parecer com isso:"
-#: 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 ""
-#: index.docbook:230
+#. Tag: para
+#: tutorial.xml:230
+#, no-c-format
msgid "We continue with the main configuration of Hibernate."
-msgstr ""
+msgstr "Nós iremos continuar com a configuração principal do Hibernate."
-#: index.docbook:237
+#. Tag: title
+#: tutorial.xml:237
+#, no-c-format
msgid "Hibernate configuration"
-msgstr ""
+msgstr "Configuração do 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."
+#. 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 ""
+"Agora nós temos uma classe persistente e este arquivo de mapeamento no "
+"lugar. Está na hora de configurar o Hibernate. Antes de fazermos isso, "
+"iremos precisar de uma base de dados. O HSQL DB, um SQL DBMS feito em java, "
+"pode ser baixado através do site do HSQL DB(http://hsqldb.org/). Atualmente, "
+"você só precisa baixar o <literal>hsqldb.jar</literal>. Coloque este arquivo "
+"no diretório da pasta de desenvolvimento <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."
+#. 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 ""
+"Crie um diretório chamado <literal>data</literal> no diretório root de "
+"desenvolvimento – Isto será onde o HSQL DB irá armazenar arquivos de dados. "
+"Agora iremos iniciar o banco de dados executando <literal>java -classpath ../"
+"lib/hsqldb.jar org.hsqldb.Server</literal> neste diretório de dados. Você "
+"pode ver ele iniciando e conectando ao socket TCP/IP, isto será onde nossa "
+"aplicação irá se conectar depois. Se você deseja iniciar uma nova base de "
+"dados durante este tutorial, finalize o HSQL DB(pressionando o <literal>CTRL "
+"+ C</literal> na janela), delete todos os arquivos no diretório "
+"<literal>data/</literal>, e inicie o HSQL BD novamente."
-#: 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."
+#. 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 ""
+"O Hibernate é uma camada na sua aplicação na qual se conecta com a base de "
+"dados, para isso necessita de informação da conexão. As conexões são feitas "
+"através de um pool de conexão JDBC, na qual teremos que configurar. A "
+"distribuição do Hibernate contém diversas ferramentas de pooling da conexão "
+"JDBC de fonte aberta, mas iremos usar o pool de conexão interna para este "
+"tutorial. Note que você tem que copiar a biblioteca necessária em seu "
+"classpath e use configurações diferentes para pooling de conexão caso você "
+"deseje utilizar um software de pooling JDBC terceirizado para qualidade de "
+"produção."
-#: 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:"
+#. 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 ""
+"Para as configurações do Hibernate, nós podemos usar um arquivo simples "
+"<literal>hibernate.properties</literal>, um arquivo mais ligeiramente "
+"sofisticado <literal>hibernate.cfg.xml</literal> ou até mesmo uma instalação "
+"programática completa. A maioria dos usuários preferem utilizar o arquivo de "
+"configuração 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 ""
-#: 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><session-factory></literal> configurations, usually in several configuration files (for easier startup)."
+#. 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><session-factory></literal> configurations, usually in "
+"several configuration files (for easier startup)."
msgstr ""
+"Note que esta configuração XML usa um diferente DTD. Nós configuraremos as "
+"<literal>SessionFactory</literal> do Hibernate – uma factory global "
+"responsável por uma base de dedados particular. Se você tiver diversas bases "
+"de dados, use diversas configurações <literal><session-factory></"
+"literal>, geralmente em diversos arquivos de configuração (para uma partida "
+"mais fácil)."
-#: 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."
+#. 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 ""
+"As primeiras quatro <literal>propriedades</literal> do elemento contém a "
+"configuração necessária para a conexão ao JDBC. A propriedade "
+"<literal>propriedade</literal> dialect do elemento especifica a variante "
+"particular do SQL que o Hibernate gera. O gerenciamento automático de sessão "
+"do Hibernate para contextos de persistência estará disponível em breve. A "
+"opção <literal>hbm2ddl.auto</literal> habilita a geração automática de "
+"schemas da base de dados – diretamente na base de dados. Isto também pode "
+"ser naturalmente desligado (removendo a opção de configuração) ou "
+"redirecionando para um arquivo com ajuda do <literal>SchemaExport</literal> "
+"nas tarefas do Ant. Finalmente, iremos adicionar os arquivos das classes de "
+"persistência mapeadas na configuração."
-#: 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."
+#. 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 ""
+"Copie este arquivo no diretório fonte, assim isto irá terminar na raiz "
+"(root) do classpath. O Hibernate automaticamente procura por um arquivo "
+"chamado <literal>hibernate.cfg.xml</literal> na raiz do classpath, no "
+"startup."
-#: index.docbook:305
+#. Tag: title
+#: tutorial.xml:305
+#, no-c-format
msgid "Building with Ant"
-msgstr ""
+msgstr "Construindo com o 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."
+#. 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 ""
+"Nos iremos, agora, construir o tutorial com Ant. Você ira precisar o Ant "
+"instalado – se encontra disponível <ulink url=\"http://ant.apache.org/"
+"bindownload.cgi\">na página de download do Ant</ulink>. Como instalar o Ant, "
+"não será abordado aqui. Caso tenha alguma dúvida, por favor, vá ao <ulink "
+"url=\"http://ant.apache.org/manual/index.html\">Ant manual</ulink>. Depois "
+"que tiver instalado o Ant, podemos começar a criar o arquivo de construção "
+"<literal>build.xml</literal>. Este arquivo será chamado de <literal>build."
+"xml</literal> e posto diretamente no diretório de desenvolvimento."
-#: index.docbook:316
+#. Tag: para
+#: tutorial.xml:316
+#, no-c-format
msgid "A basic build file looks like this:"
-msgstr ""
+msgstr "Um arquivo básico de build, se parece com isto:"
-#: 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 ""
-#: 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:"
+#. 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 ""
+"Isto irá avisar ao Ant para adicionar todos os arquivos no diretório lib "
+"terminando com <literal>.jar</literal>, para o classpath usado para "
+"compilação. Irá também copiar todos os arquivos não-java para o diretório "
+"alvo (arquivos de configuração, mapeamento). Se você rodar o ant agora, "
+"deverá ter esta saída."
-#: 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 ""
-#: index.docbook:334
+#. Tag: title
+#: tutorial.xml:334
+#, no-c-format
msgid "Startup and helpers"
-msgstr ""
+msgstr "Startup and helpers"
-#: 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."
+#. 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 ""
+"É hora de carregar e arquivar alguns objetos <literal>Event</literal>, mas "
+"primeiro nós temos de completar o setup com algum código de infraestrutura. "
+"Este startup inclui a construção de um objeto <literal>SessionFactory</"
+"literal> global e armazenar isto em algum lugar de fácil acesso para o "
+"código da aplicação. Uma <literal>SessionFactory</literal> pode abrir novas "
+"<literal>Session</literal>'s. Uma <literal>Session</literal> representa uma "
+"unidade single-theaded do trabalho, a <literal>SessionFactory</literal> é um "
+"objeto global thread-safe, instanciado uma vez."
-#: 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:"
+#. 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 ""
+"Nos iremos criar uma classe de ajuda <literal>HibernateUtil</literal>, que "
+"toma conta do startup e faz acesso a uma <literal>SessionFactory</literal> "
+"conveniente. Vamos dar uma olhada na implementação:"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Esta classe não só produz a global <literal>SessionFactory</literal> no seu "
+"static initializer (chamado uma vez pela JVM quando a classe é carregada), "
+"mas também esconde o fato de que isto usa um static singleton. Ela pode "
+"muito bem, enxergar a <literal>SessionFactory</literal> do JNDI em um "
+"application server."
-#: 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."
+#. 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 ""
+"Se você der à <literal>SessionFactory</literal> um nome, no seu arquivo de "
+"configuração. O Hibernate irá, de fato, tentar uni-lo ao JNDI depois que "
+"estiver construído. Para evitar este completamente este código, você também "
+"poderia usar JMX deployment e deixar o contêiner JMX capaz, instanciar e "
+"unir um <literal>HibernateService</literal> no JNDI. Essas opções avançadas "
+"são discutidas no documento de referência do Hibernate."
-#: index.docbook:370
-msgid "Place <literal>HibernateUtil.java</literal> in the development source directory, in a package next to <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 ""
+"Coloque o <literal>HibernateUtil.java</literal> no diretório de arquivos de "
+"desenvolvimento(source), em um pacote após o <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 ""
-#: 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."
+#. 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 ""
+"Novamente, isto deve compilar sem problemas. Finalmente, nós precisamos "
+"configurar um sistema de logging – o Hibernate usa commons logging e deixa "
+"você escolher entre o Log4j e o logging do JDK 1.4 . A maioria dos "
+"desenvolvedores preferem o Log4j: copie <literal>log4j.properties</literal> "
+"da distribuição do Hibernate (está no diretório <literal>etc/</literal>), "
+"para seu diretório <literal>src</literal>, depois vá em hibernate.cfg.xml. "
+"Dê uma olhada no exemplo de configuração e mude as configurações se você "
+"quizer ter uma saída mais detalhada. Por default, apenas as mensagems de "
+"startup e shwwn do Hibernate é mostrada no stdout."
-#: index.docbook:387
-msgid "The tutorial infrastructure is complete - and we are ready to do some real work with 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 ""
+"O tutorial de infra-estrutura está completo - e nós já estamos preparados "
+"para algum trabalho de verdade com o Hibernate."
-#: index.docbook:395
+#. Tag: title
+#: tutorial.xml:395
+#, no-c-format
msgid "Loading and storing objects"
-msgstr ""
+msgstr "Carregando e salvando objetos"
-#: 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:"
+#. 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 ""
+"Finalmente, nós podemos usar o Hibernate para carregar e armazenar objetos. "
+"Nós escrevemos uma classe <literal>EventManager</literal> com um método main"
+"():"
-#: 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 ""
-#: 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."
+#. 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 ""
+"Nós criamos um novo objeto <literal>Event</literal>, e passamos para o "
+"Hibernate. O Hibernate sabe como tomar conta do SQL e executa "
+"<literal>INSERT</literal>s no banco de dados. Vamos dar uma olhada na "
+"<literal>Session</literal> e no código <literal>Transaction</literal>-"
+"handling antes de executarmos."
-#: 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>."
+#. 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 ""
+"Um <literal>Session</literal> é uma unidade simples de trabalho. Por agora "
+"nós iremos pegar coisas simples e assumir uma granularidade de um-pra-um "
+"entre uma <literal>Session</literal> do Hibernate e uma transação de banco "
+"de dados. Para proteger nosso código de um atual sistema subjacente de "
+"transação (nesse caso puro JDBC, mas também poderia rodar com JTA), nos "
+"usamos a API <literal>Transaction</literal>, que está disponível na "
+"<literal>Session</literal> do Hibernate."
-#: 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."
+#. 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 ""
+"O que a <literal>sessionFactory.getCurrentSession()</literal> faz? Primeiro, "
+"você pode chamar quantas vezes e de onde quiser, uma vez você recebe sua "
+"<literal>SessionFactory</literal> (fácil graças ao <literal>HibernateUtil</"
+"literal>). O método <literal>getCurrentSession()</literal> sempre retorna a "
+"unidade de trabalho \"corrente\". Lembra de que nós mudamos a opção de "
+"configuração desse mecanismo para thread no <literal>hibernate.cfg.xml</"
+"literal>? Daqui em diante, o escopo da unidade de trabalho corrente é a "
+"thread Java corrente que executa nossa aplicação. Entretanto, esta não é "
+"toda a verdade. Uma"
-#: 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)."
+#. 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> começa quando é primeiramente necessária, quando "
+"é feita a primeira chamada à <literal>getCurrentSession()</literal>. É então "
+"limitado pelo Hibernate para thread corrente. Quando a transação termina, "
+"tanto com commit quanto rollback, o Hibernate também desune a "
+"<literal>Session</literal> da thread e fecha isso pra você. Se você chamar "
+"<literal>getCurrentSession()</literal> novamente, você receberá uma nova "
+"<literal>Session</literal> e pode começar uma nova unidade de trabalho. Esse "
+"modelo de programação de limite de thread <emphasis>thread-bound</emphasis>, "
+"é o modo mais popular de se usar o 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."
+#. 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 ""
+"Dê uma olhada no <xref linkend=\"transactions\"/> para mais informações a "
+"respeito de manipulação de transação e demarcação. Nós também pulamos "
+"qualquer manipulação de erro e rollback no exemplo anterior."
-#: index.docbook:458
-msgid "To run this first routine we have to add a callable target to the Ant build file:"
+#. 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 ""
+"Para executar esta primeira rotina, nos teremos que adicionar um ponto de "
+"chamada para o arquivo de build do 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>]]>"
+"<![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:"
+#. 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 ""
+"O valor do argumento <literal>action</literal>, é setado na linha de comando "
+"quando chamando esse ponto:"
-#: index.docbook:469
+#. Tag: programlisting
+#: tutorial.xml:469
+#, no-c-format
msgid "<![CDATA[C:\\hibernateTutorial\\>ant run -Daction=store]]>"
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:"
+#. 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 ""
+"Você deverá ver, após a compilação, o startup do Hibernate e, dependendo da "
+"sua configuração, muito log de saída. No final você verá a seguinte linha:"
-#: index.docbook:476
-msgid "<![CDATA[[java] Hibernate: insert into EVENTS (EVENT_DATE, title, EVENT_ID) values (?, ?, ?)]]>"
+#. 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 ""
+"Este é o <literal>INSERT</literal> executado pelo Hibernate, os pontos de "
+"interrogação representam parêmetros de união do JDBC. Para ver os valores "
+"substituídos, ou para diminuir a verbalidade do log, check seu "
+"l<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:"
+#. 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 ""
+"Agora nós gostaríamos de listar os eventos arquivados, então nós adicionamos "
+"uma opção para o método main:"
-#: 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 ""
-#: index.docbook:490
+#. Tag: para
+#: tutorial.xml:490
+#, no-c-format
msgid "We also add a new <literal>listEvents() method</literal>:"
-msgstr ""
+msgstr "Nos também adicionamos um novo <literal>método 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"
- "}]]>"
+"<![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."
+#. 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 ""
+"O que nós fazemos aqui, é usar uma query HQL (Hibernate Query Language), "
+"para carregar todos os objetos <literal>Event</literal> exitentes no banco "
+"de dados. O Hibernate irá gerar o SQL apropriado, enviar para o banco de "
+"dados e popular objetos <literal>Event</literal> com os dados. Você pode "
+"criar queries mais complexas com HQL, claro."
-#: index.docbook:503
+#. Tag: para
+#: tutorial.xml:503
+#, no-c-format
msgid "Now, to execute and test all of this, follow these steps:"
-msgstr ""
+msgstr "Agora, para executar e testar tudo isso, siga os passos a seguir:"
-#: 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."
+#. 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 ""
+"Execute <literal>ant run -Daction=store</literal> para armazenar algo no "
+"banco de dados e, claro, gerar o esquema do banco de dados antes pelo "
+"hbm2ddl."
-#: 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\"."
+#. 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 ""
+"Agora desabilite hbm2ddl comentando a propriedade no seu arquivo "
+"<literal>hibernate.cfg.xml</literal>. Normalmente só se deixa habilitado em "
+"teste unitários contínuos, mas outra carga de hbm2ddl pode "
+"<emphasis>remover</emphasis> tudo que você já tenha arquivado. Sa "
+"configuração <literal>create</literal>, atualmente são traduzidas para "
+"\"apague todas as tabelas do esquema, então recrie todas quando a "
+"SessionFactory estiver pronta\"."
-#: 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."
+#. 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 ""
+"Se você agora chamar o Ant com <literal>-Daction=list</literal>, você deverá "
+"ver os eventos que você acabou de criar. Você pode também chamar a ação "
+"<literal>store</literal> mais algumas vezes."
-#: 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."
+#. 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 ""
+"Nota: A maioria dos novos usuários do Hibernate falha nesse ponto e nós "
+"regularmente, vemos questões sobre mensagens de erro de <emphasis>tabela não "
+"encontrada </emphasis> . Entretanto, se você seguir os passos marcados "
+"acima, você não terá esse problema, com o hbm2ddl criando o esquema do banco "
+"de dados na primeira execução, e restarts subsequentes da aplicação irão "
+"usar este esquema. Se você mudar o mapeamento e/ou o esquema do banco de "
+"dados, terá de re-habilitar o hbm2ddl mais uma vez."
-#: index.docbook:544
+#. Tag: title
+#: tutorial.xml:544
+#, no-c-format
msgid "Part 2 - Mapping associations"
-msgstr ""
+msgstr "Part 2 - Mapeando associações"
-#: 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."
+#. 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 ""
+"Nós mapeamos uma classe de entidade de persistência para uma tabela. Agora "
+"vamos continuar e adicionar algumas associações de classe. Primeiro nos "
+"iremos adicionar pessoas a nossa aplicação, e armazenar os eventos de que "
+"elas participam."
-#: index.docbook:552
+#. Tag: title
+#: tutorial.xml:552
+#, no-c-format
msgid "Mapping the Person class"
-msgstr ""
+msgstr "Mapeando a classe 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 ""
+msgstr "O primeiro código da classe <literal>Person</literal> é simples:"
-#: 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 ""
-#: index.docbook:560
-msgid "Create a new mapping file called <literal>Person.hbm.xml</literal> (don't forget the DTD reference at the top):"
+#. 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 ""
+"Crie um novo arquivo de mapeamento, chamado <literal>Person.hbm.xml</"
+"literal> (não esqueça a referencia ao DTD no topo)"
-#: 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 ""
-#: index.docbook:567
+#. Tag: para
+#: tutorial.xml:567
+#, no-c-format
msgid "Finally, add the new mapping to Hibernate's configuration:"
-msgstr ""
+msgstr "Finalmente, adicione o novo mapeamento a configuração do 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\"/>]]>"
+"<![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."
+#. 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 ""
+"Nos iremos agora criar uma associação entre estas duas entidades. "
+"Obviamente, pessoas (Person) podem participar de eventos, e eventos possuem "
+"participantes. As questões de design com que teremos de lidar são: "
+"direcionalidade, multiplicidade e comportamento de coleção."
-#: index.docbook:583
+#. Tag: title
+#: tutorial.xml:583
+#, no-c-format
msgid "A unidirectional Set-based association"
-msgstr ""
+msgstr "Uma associação Set-based unidirectional"
-#: 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 ""
+"Nos iremos adicionar uma coleção de eventos na classe <literal>Person</"
+"literal>. Desse jeito poderemos navegar pelos eventos de uma pessoa em "
+"particular, sem executar uma query explicitamente – apenas chamando "
+"<literal>aPerson.getEvents()</literal>. Nos usaremos uma coleção Java, um "
+"<literal>Set</literal>, porquê a coleção não conterá elementos duplicados e "
+"a ordem não é relevante para nós."
-#: 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 ""
+#. 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 "Vamos escrever o código para isto nas classes Java e então mapear:"
-#: 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 ""
-#: 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:"
+#. 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 ""
+"Antes de mapearmos esta associação, pense no outro lado. Claramente, "
+"poderíamos apenas fazer isto de forma unidirecional. Ou poderíamos criar "
+"outra coleção no <literal>Event</literal>, se quisermos ser capaz de navegar "
+"bidirecionalmente, i.e. um - <literal>anEvent.getParticipants()</literal>. "
+"Isto não é necessário, de perspectiva funcional. Você poderia sempre "
+"executar uma query explicita que retornasse os participantes de um evento em "
+"particular. Esta é uma escolha de design que cabe a você, mas o que é claro "
+"nessa discussão é a multiplicidade da associação: \"muitos\" valores em "
+"ambos os lados, nós chamamos isto uma associação <emphasis>muitos-para-"
+"muitos</emphasis>. Daqui pra frente, nos usaremos o mapeamento muitos-para-"
+"muitos do Hibernate:"
-#: 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>]]>"
+"<![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><set></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><key></literal> element, the column name for the event's side with the <literal>column</literal> attribute of the <literal><many-to-many></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><set></"
+"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><key>"
+"</literal> element, the column name for the event's side with the "
+"<literal>column</literal> attribute of the <literal><many-to-many></"
+"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 ""
+"O Hibernate suporta todo tipo de mapeamento de coleção , sendo um "
+"<literal><set></literal> mais comum. Para uma associação muitos-para-"
+"muitos (ou relacionamento de entidade <emphasis>n:m</emphasis> ), uma tabela "
+"de associação é necessária. Cada linha nessa tabela representa um link entre "
+"uma pessoa e um evento. O nome da tabela é configurado com o atributo "
+"<literal>table</literal> do elemento <literal>set</literal>. O nome da "
+"coluna identificadora na associção, peloo lado da pessoa, é definido com o "
+"elemento <literal><key></literal> , o nome da coluna pelo lado dos "
+"eventos, e definido com o atributo <literal>column</literal> do <literal><"
+"many-to-many></literal>. Você também precisa dizer para o Hibernate a "
+"classe dos objetos na sua coleção (a classe do outro lado das coleções de "
+"referência)."
-#: index.docbook:624
+#. Tag: para
+#: tutorial.xml:624
+#, no-c-format
msgid "The database schema for this mapping is therefore:"
-msgstr ""
+msgstr "O esquema de mapeamento para o banco de dados está a seguir:"
-#: 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"
- " ]]>"
+"<![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 ""
+msgstr "Trabalhando a associação"
-#: index.docbook:635
-msgid "Let's bring some people and events together in a new method in <literal>EventManager</literal>:"
+#. 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 ""
+"Vamos trazer juntos algumas pessoas e eventos em um novo método na classe "
+"<literal>EventManager</literal>::"
-#: index.docbook:639
+#. 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"
- "}]]>"
+"<![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: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:641
+#, no-c-format
+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 database transaction - as defined by the "
+"<literal>thread</literal> configuration option for the "
+"<literal>CurrentSessionContext</literal> class."
msgstr ""
+"Após carregar um <literal>Person</literal> e um <literal>Event</literal>, "
+"simplesmente modifique a coleção usando os métodos normais de uma coleção. "
+"Como você pode ver, não há chamada explícita para <literal>update()</"
+"literal> ou <literal>save()</literal>, o Hibernate detecta automaticamente "
+"que a coleção foi modificada e necessita ser atualizada. Isso é chamado de "
+"<emphasis>checagem suja automática</emphasis>, e você também pode usá-la "
+"modificando o nome ou a data de qualquer um dos seus objetos. Assim que eles "
+"estiverem no estado <emphasis>persistent</emphasis>, ou seja, limitado por "
+"uma <literal>Session</literal> do Hibernate em particular (i.e. eles foram "
+"carregados ou salvos dentro de uma unidade de trabalho), o Hibernate "
+"monitora qualquer alteração e executa o SQL em modo de escrita em segundo "
+"plano. O processo de sincronização do estado da memória com o banco de "
+"dados, geralmente apenas no final de uma unidade de trabalho, é chamado de "
+"<emphasis>flushing</emphasis>. No nosso código, a unidade de trabalho "
+"termina com o commit da transação do banco de dados – como definido pela "
+"opção de configuração da <literal>thread</literal> da classe "
+"<literal>CurrentSessionContext</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:"
+#. 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 ""
+"Você pode também querer carregar pessoas e eventos em diferentes unidades de "
+"trabalho. Ou você modifica um objeto fora de uma <literal>Session</literal>, "
+"quando não se encontra no estado persistent (se já esteve neste estado "
+"anteriormente, chamamos esse estado de <emphasis>detached</emphasis>). Você "
+"pode até mesmo modificar uma coleção quando esta se encontrar no estado "
+"detached."
-#: index.docbook:663
+#. 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"
- "}]]>"
+"<![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: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:665
+#, no-c-format
+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."
msgstr ""
+"A chamada <literal>update</literal> cria um objeto persistent novamente, "
+"você poderia dizer que ele liga o objeto a uma nova unidade de trabalho, "
+"assim qualquer modificação que você faça neste objeto enquanto estiver no "
+"estado detached pode ser salvo no banco de dados. Isso inclui qualquer "
+"modificação (adição/exclusão) que você faça em uma coleção da entidade deste "
+"objeto."
-#: 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):"
+#. 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 ""
+"Bom, isso não foi muito usado na nossa situação, porém, é um importante "
+"conceito que você pode aplicar em seus aplicativos. Agora, complete este "
+"exercício adicionando uma nova ação ao método main( ) da classe "
+"<literal>EventManager</literal> e chame-o pela linha de comando. Se você "
+"precisar dos identificadores de uma pessoa ou evento – o método <literal>save"
+"()</literal> retorna estes identificadores (você poderá modificar alguns dos "
+"métodos anteriores para retornar aquele identificador):"
-#: index.docbook:680
+#. 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"
- "}]]>"
+"<![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: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:682
+#, no-c-format
+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."
msgstr ""
+"Este foi um exemplo de uma associação entre duas classes igualmente "
+"importantes, duas entidades. Como mencionado anteriormente, há outras "
+"classes e tipos dentro de um modelo típico, geralmente \"menos importante\". "
+"Alguns você já viu, como um <literal>int</literal> ou uma <literal>String</"
+"literal>. Nós chamamos essas classes de <emphasis>value types</emphasis>, e "
+"suas instâncias <emphasis>depend</emphasis> de uma entidade particular. As "
+"instâncias desses tipos não possuem sua própria identidade, nem são "
+"compartilhados entre entidades (duas pessoas não referenciam o mesmo objeto "
+"<literal>firstname</literal> mesmo se elas tiverem o mesmo objeto "
+"firstname). Naturalmente, os value types não são apenas encontrados dentro "
+"da JDK (de fato, em um aplicativo Hibernate todas as classes JDK são "
+"consideradas como value types), mas você pode também criar suas classes "
+"como, por exemplo, <literal>Address</literal> ou <literal>MonetaryAmount</"
+"literal>."
-#: 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."
+#. 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 ""
+"Você também pode criar uma coleção de value types. Isso é conceitualmente "
+"muito diferente de uma coleção de referências para outras entidades, mas em "
+"Java parece ser quase a mesma coisa."
-#: index.docbook:703
+#. Tag: title
+#: tutorial.xml:703
+#, no-c-format
msgid "Collection of values"
-msgstr ""
+msgstr "Coleção de valores"
-#: 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: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 ""
+"Nós adicionamos uma coleção de objetos de tipo de valores à entidade "
+"<literal>Person</literal>. Nós querermos armazenar endereços de e-mail, para "
+"isso utilizamos o tipo <literal>String</literal>, e a coleção novamente será "
+"um <literal>Set</literal>:"
-#: index.docbook:710
+#. 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"
- "}]]>"
+"<![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 ""
-#: index.docbook:712
+#. Tag: para
+#: tutorial.xml:712
+#, no-c-format
msgid "The mapping of this <literal>Set</literal>:"
-msgstr ""
+msgstr "O mapeamento deste <literal>Set</literal>:"
-#: index.docbook:716
+#. Tag: programlisting
+#: tutorial.xml:716
+#, 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>]]>"
+"<![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."
+#. Tag: para
+#: tutorial.xml:718
+#, no-c-format
+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."
msgstr ""
+"A diferença comparada com o mapeamento anterior se encontra na parte "
+"<literal>element</literal>, que indica ao Hibernate que a coleção não contém "
+"referências à outra entidade, mas uma coleção de elementos do tipo "
+"<literal>String</literal> (a tag name em miniscula indica que se trata de um "
+"mapeamento do Hibernate para conversão de tipos). Mais uma vez, o atributo "
+"<literal>table</literal> do elemento <literal>set</literal> determina o nome "
+"da tabela para a coleção. O elemento <literal>key</literal> define o nome da "
+"coluna de chave estrangeira na tabela de coleção. O atributo "
+"<literal>column</literal> dentro do elemento <literal>element</literal> "
+"define o nome da coluna onde os valores da <literal>String</literal> serão "
+"armazenados."
-#: index.docbook:728
+#. Tag: para
+#: tutorial.xml:728
+#, no-c-format
msgid "Have a look at the updated schema:"
-msgstr ""
+msgstr "Dê uma olhada no esquema atualizado:"
-#: 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"
- " ]]>"
+"<![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 ""
+"Você pode observar que a chave primária da tabela da coleção é de na verdade "
+"uma chave composta, usando ambas colunas. Isso também implica que cada "
+"pessoa não pode ter endereços de e-mail duplicados, o que é exatamente a "
+"semântica que precisamos para um set em Java."
-#: 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:"
+#. 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 ""
+"Você pode agora tentar adicionar elementos a essa coleção, do mesmo modo que "
+"fizemos anteriormente ligando pessoas e eventos. È o mesmo código em 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"
- "}]]>"
+"<![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."
+#. 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 ""
+"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."
-#: index.docbook:757
+#. Tag: title
+#: tutorial.xml:757
+#, no-c-format
msgid "Bi-directional associations"
-msgstr ""
+msgstr "Associações bidirecionais"
-#: 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 ""
+"Agora iremos mapear uma associação bidirecional – fazendo a associação entre "
+"pessoas e eventos, de ambos os lados, em Java. Logicamente, o esquema do "
+"banco de dados não muda, nós continuamos tendo multiplicidades muitos-para-"
+"muitos. Um banco de dados é mais flexível do que uma linguagem de "
+"programação para redes, ele não precisa de nenhuma direção de navegação – os "
+"dados podem ser acessados em qualquer caminho possível."
-#: index.docbook:767
-msgid "First, add a collection of participants to the <literal>Event</literal> Event class:"
+#. Tag: para
+#: tutorial.xml:767
+#, no-c-format
+msgid ""
+"First, add a collection of participants to the <literal>Event</literal> "
+"Event class:"
msgstr ""
+"Primeiramente, adicione uma coleção de participantes à classe "
+"<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 ""
-#: index.docbook:773
-msgid "Now map this side of the association too, in <literal>Event.hbm.xml</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 ""
+"Agora mapeie este lado da associação em <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>]]>"
+"<![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."
+#. 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 ""
+"Como você pode ver, esses é uma mapeamento normal usando <literal>set</"
+"literal> em ambos documenentos de mapeamento. Observe que o nome das colunas "
+"em <literal>key</literal> e <literal>many-to-many</literal> estão trocados "
+"em ambos os documentos de mapeamento. A adição mais importante feita está no "
+"atributo <literal>inverse=\"true\"</literal> no elemento set do mapeamento "
+"da coleção da classe <literal>Event</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 ."
+#. 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 ""
+"Isso significa que o Hibernate deve pegar o outro lado – a classe "
+"<literal>Person</literal> – quando necessitar encontrar informação sobre a "
+"relação entre as duas entidades. Isso será muito mais facilmente "
+"compreendido quando você analisar como a relação bidirecional entre as "
+"entidades é criada."
-#: index.docbook:796
+#. Tag: title
+#: tutorial.xml:796
+#, no-c-format
msgid "Working bi-directional links"
-msgstr ""
+msgstr "Trabalhando com links bidirecionais"
-#: 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 ""
+"Primeiro tenha em mente que o Hibernate não afeta a semântica normal do "
+"Java. Como nós criamos um link entre uma <literal>Person</literal> e um "
+"<literal>Event</literal> no exemplo unidirecional? Nós adicionamos uma "
+"instância de <literal>Event</literal>, da coleção de referências de eventos, "
+"a uma instância de <literal>Person</literal>. Então, obviamente, se nós "
+"queremos que este link funcione bidirecionalmente, nós devemos fazer a mesma "
+"coisa para o outro lado – adicionando uma referência de <literal>Person</"
+"literal> na coleção de um <literal>Event</literal>. Esse acerto de link de "
+"ambos os lados é absolutamente necessário e você nunca deve esquecer de faze-"
+"lo."
-#: index.docbook:808
-msgid "Many developers program defensive and create link management methods to correctly set both sides, e.g. in <literal>Person</literal>:"
+#. 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 ""
+"Muitos desenvolvedores programam de maneira defensiva e criam métodos "
+"gerenciador de associações que ajusta corretamente ambos os lados:"
-#: 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"
- "}]]>"
+"<![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."
+#. 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 ""
+"Observe que os métodos set e get da a coleção estão protegidos – isso "
+"permite que classes e subclasses do mesmo pacote continuem acessando os "
+"métodos, mas previne que qualquer outra classe, que não esteja no mesmo "
+"pacote, acesse a coleção diretamente. Você provavelmente deve fazer a mesma "
+"coisa para a coleção do outro lado."
-#: 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."
+#. 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 ""
+"E sobre o mapeamento do atributo <literal>inverse</literal>? Pra você, e "
+"para o Java, um link bidirecional é simplesmente o fato de ajustar "
+"corretamente as referências de ambos os lados. O Hibernate, entretanto não "
+"possui informação necessária para corretamente adaptar os estados "
+"<literal>INSERT</literal> e <literal>UPDATE</literal> do SQL, e precisa de "
+"ajuda para manipular as propriedades das associações bidirecionais. Fazer um "
+"lado da associação com o atributo <literal>inverse</literal> instrui o "
+"Hibernate para basicamente ignora-lo, considerando-o uma <emphasis>cópia</"
+"emphasis> do outro lado. Isso é todo o necessário para o Hibernate trabalhar "
+"com todas as possibilidades quando transformando um modelo de navegação "
+"bidirecional em esquema de banco de dados do SQL. As regras que você possui "
+"para lembrar são diretas: Todas associações bidirecionais necessitam que um "
+"lado possua o atributo inverse. Em uma associação de um-para-muitos, o lado "
+"de \"muitos\" deve conter o atributo <literal>inverse</literal>, já em uma "
+"associação de muitos-para-muitos você pode pegar qualquer lado, não há "
+"diferença."
-#: index.docbook:837
+#. Tag: para
+#: tutorial.xml:837
+#, no-c-format
msgid "Let's turn this into a small web application."
msgstr ""
+"Agora, vamos portar este exemplo para um pequeno aplicativo para internet."
-#: index.docbook:844
+#. Tag: title
+#: tutorial.xml:844
+#, no-c-format
msgid "Part 3 - The EventManager web application"
-msgstr ""
+msgstr "EventManager um aplicativo para internet"
-#: 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."
+#. 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 ""
+"Um aplicativo para internet do Hibernate usa uma <literal>Session</literal> "
+"e uma <literal>Transaction</literal> quase do mesmo modo que um aplicativo "
+"standalone. Entretanto, alguns patterns comuns são úteis. Nós agora "
+"criaremos um <literal>EventManagerServlet</literal>. Esse servlet lista "
+"todos os eventos salvos no banco de dados, e cria um formulário HTML para "
+"entrada de novos eventos."
-#: index.docbook:854
+#. Tag: title
+#: tutorial.xml:854
+#, no-c-format
msgid "Writing the basic servlet"
-msgstr ""
+msgstr "Criando um servlet básico"
-#: index.docbook:856
-msgid "Create a new class in your source directory, in the <literal>events</literal> package:"
+#. Tag: para
+#: tutorial.xml:856
+#, no-c-format
+msgid ""
+"Create a new class in your source directory, in the <literal>events</"
+"literal> package:"
msgstr ""
+"Crie uma nova classe no seu diretório fonte, no pacote <literal>events</"
+"literal>:"
-#: index.docbook:861
+#. 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"
- "}]]>"
+"<![CDATA[package events;\n"
+"\n"
+"// Imports\n"
+"\n"
+"public class EventManagerServlet extends HttpServlet {\n"
+"\n"
+" // Servlet code\n"
+"}]]>"
msgstr ""
-#: index.docbook:863
-msgid "The servlet handles HTTP <literal>GET</literal> requests only, hence, the method we implement is <literal>doGet()</literal>:"
+#. Tag: para
+#: tutorial.xml:863
+#, no-c-format
+msgid ""
+"The servlet handles HTTP <literal>GET</literal> requests only, hence, the "
+"method we implement is <literal>doGet()</literal>:"
msgstr ""
+"O servlet manuseia somente requisições <literal>GET</literal> do HTTP, "
+"portanto o método que iremos implementar é <literal>doGet()</literal>:"
-#: index.docbook:868
+#. 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"
- "}]]>"
+"<![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: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—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)."
+#. Tag: para
+#: tutorial.xml:870
+#, fuzzy, no-c-format
+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—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 ""
+"O pattern que estamos aplicando neste código é chamado <emphasis>session-per-"
+"request</emphasis>. Quando uma requisição chega ao servlet, uma nova "
+"<literal>Session</literal> do Hibernate é aberta através da primeira chamada "
+"para <literal>getCurrentSession()</literal> em <literal>SessionFactory</"
+"literal>. Então uma transação do banco de dados é inicializada - todo acesso "
+"a dados deve ocorrer dentro de uma transação, não importando se o dado é de "
+"leitura ou escrita. (nós não devemos usar o modo auto-commit em aplicações)."
-#: 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: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: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: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 ""
+"Agora, as possibilidades de ações de uma requisição serão processadas e uma "
+"resposta HTML será renderizada. Nós já iremos chegar nesta parte."
-#: 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>—you'll need it as soon as you consider rendering your view in JSP, not in a servlet."
+#. 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>—you'll need it as "
+"soon as you consider rendering your view in JSP, not in a servlet."
msgstr ""
+"Finalmente, a unidade de trabalho termina quando o processamento e a "
+"restituição são completados. Se ocorrer algum erro durante o processamento "
+"ou a restituição, uma exceção será lançada e a transação do banco de dados "
+"encerrada. Isso completa o pattern <literal>session-per-request</literal>. "
+"Em vez de usar código de demarcação de transação em todo servlet você pode "
+"também criar um filtro servlet. Dê uma olhada no site do Hibernate e do Wiki "
+"para maiores informações sobre esse pattern, chamado <emphasis>Open Session "
+"in View</emphasis>."
-#: index.docbook:905
+#. Tag: title
+#: tutorial.xml:905
+#, no-c-format
msgid "Processing and rendering"
-msgstr ""
+msgstr "Processando e renderizando"
-#: index.docbook:907
-msgid "Let's implement the processing of the request and rendering of the page."
+#. Tag: para
+#: tutorial.xml:907
+#, no-c-format
+msgid ""
+"Let's implement the processing of the request and rendering of the page."
msgstr ""
+"Vamos implementar o processamento da requisição e a restituição da página "
+"HTML."
-#: index.docbook:911
+#. 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();]]>"
+"<![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 ""
-#: index.docbook:913
-msgid "Granted, this coding style with a mix of Java and HTML would not scale in a more complex application—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: 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—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 ""
+"O estilo de código acima, misturando linguagem HTML e Java não será "
+"funcional em um aplicativo mais complexo—tenha em mente que neste "
+"manual nós estamos apenas ilustrando conceitos básicos do Hibernate. O "
+"código imprime um cabeçalho HTML e um rodapé. Dentro desta página, é "
+"mostrado um formulário em HTML, para entrada de novos eventos, e uma lista "
+"de todos os eventos contidos no banco de dados. O primeiro método é trivial "
+"e apenas imprime uma página HTML:"
-#: index.docbook:922
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: para
+#: tutorial.xml:924
+#, no-c-format
+msgid ""
+"The <literal>listEvents()</literal> method uses the Hibernate "
+"<literal>Session</literal> bound to the current thread to execute a query:"
msgstr ""
+"O método <literal>listEvents()</literal> usa a <literal>Session</literal> do "
+"Hibernate associada a thread atual para executar um query:"
-#: index.docbook:930
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: para
+#: tutorial.xml:932
+#, no-c-format
+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:"
msgstr ""
+"Finalmente, a action <literal>store</literal> é passada pra o método "
+"<literal>createAndStoreEvent()</literal>, que também usa a <literal>Session</"
+"literal> da thread atual:"
-#: index.docbook:938
+#. 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"
- "}]]>"
+"<![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 ""
-#: 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: para
+#: tutorial.xml:940
+#, no-c-format
+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."
msgstr ""
+"Pronto, o servlet está completo. Uma requisição para o servlet será "
+"processada em uma <literal>Session</literal> e uma <literal>Transaction</"
+"literal> simples. Como anteriormente, no aplicativo standalone, o Hibernate "
+"pode automaticamente associar esses objetos a thread atual em execução. Isso "
+"possibilita a liberdade de você modelar seu código e acessar o método "
+"<literal>SessionFactory</literal> do jeito que achar melhor. Geralmente você "
+"irá usar um design mais sofisticado e mover o código de acesso a dados para "
+"dentro de objetos de acesso a dados (o patter DAO). Leia o Hibernate Wiki "
+"para maiores exemplos."
-#: index.docbook:954
+#. Tag: title
+#: tutorial.xml:954
+#, no-c-format
msgid "Deploying and testing"
-msgstr ""
+msgstr "Instalando e testando"
-#: 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: para
+#: tutorial.xml:956
+#, no-c-format
+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>:"
msgstr ""
+"Para fazer o deploy desta aplicação você tem que criar um arquivo para web, "
+"um WAR. Adicione o alvo Ant abaixo em seu <literal>build.xml</literal>:"
-#: index.docbook:961
+#. 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>]]>"
+"<![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 ""
-#: 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:"
+#. 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 ""
+"Esta target cria um arquivo chamado <literal>hibernate-tutorial.war</"
+"literal> no diretório do seu projeto. Ele empacota todas as bibliotecas e o "
+"arquivo de descrição <literal>web.xml</literal>, o qual é esperado no "
+"diretório base do seu projeto:"
-#: index.docbook:969
+#. 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>]]>"
+"<![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 ""
-#: 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."
+#. Tag: para
+#: tutorial.xml:971
+#, no-c-format
+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 ""
+"Antes de você compilar e fazer o deploy desta aplicação web, note que uma "
+"biblioteca adicional é requerida: <literal>jsdk.jar</literal>. Esse é o Java "
+"servlet development kit, se você não possui esta biblioteca, faça seu "
+"download na página da Sun e copie-a para seu diretório de bibliotecas. "
+"Entretanto, será usado somente para a compilação e excluído do pacote WAR."
-#: 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."
+#. 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 ""
+"Para compilar e instalar execute <literal>ant war</literal> no seu diretório "
+"do projeto e copie o arquivo <literal>hibernate-tutorial.war</literal> para "
+"o diretório <literal>webapp</literal> do Tomcat. Se você não possui o Tomcat "
+"instalado faça o download e siga as instruções de instalação. Você não "
+"precisa modificar nenhuma configuração do Tomcat para rodar este aplicativo."
-#: 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."
+#. Tag: para
+#: tutorial.xml:987
+#, no-c-format
+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 ""
+"Uma vez feito o deploy e com Tomcat rodando, acesse o aplicativo em "
+"<literal>http://localhost:8080/hibernate-tutorial/eventmanager</literal>. "
+"Veja o log do Tomcat para observar a inicialização do Hibernate quando a "
+"primeira requisição chega ao servlet (o inicializador estático dentro de "
+"<literal>HibernateUtil</literal> é chamado) e para ter uma depuração "
+"detalhada se ocorrer alguma exceção."
-#: index.docbook:1000
+#. Tag: title
+#: tutorial.xml:1000
+#, no-c-format
msgid "Summary"
-msgstr ""
+msgstr "Sumário"
-#: 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 ""
+"Este manual cobriu os princípios básicos para criação de uma aplicação "
+"simples do Hibernate e uma pequena aplicação 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 ""
+"Se você já se sente seguro com o Hibernate, continue navegando na "
+"documentação de referência por tópicos que você acha interessante – os "
+"tópicos mais questionados são: processo de transação (<xref linkend="
+"\"transactions\"/>), uso da API (<xref linkend=\"objectstate\"/>) e "
+"características de consulta (<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-->"
-
+"Não esqueça de visitar o site do Hibernate para obter mais tutoriais "
+"especializados."
Modified: core/trunk/documentation/manual/translations/pt-BR/content/xml.po
===================================================================
--- core/trunk/documentation/manual/translations/pt-BR/content/xml.po 2007-10-25 22:34:46 UTC (rev 14134)
+++ core/trunk/documentation/manual/translations/pt-BR/content/xml.po 2007-10-26 00:46:38 UTC (rev 14135)
@@ -1,284 +1,456 @@
-#, 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 at ADDRESS>\n"
-"Content-Type: text/plain; charset=utf-8\n"
-#: index.docbook:5
+"Language-Team: LANGUAGE <LL at li.org>\n"
+"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 ""
+msgstr "Mapeamento XML"
-#: index.docbook:7
-msgid "Note that this is an experimental feature in Hibernate 3.0 and is under extremely active development."
+#. 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 ""
+"Note that this is an experimental feature in Hibernate 3.0 and is under "
+"extremely active development. Veja que essa é uma feature experimental no "
+"Hibernate 3.0 e o desenvolvimento esta bastante ativo."
-#: index.docbook:13
+#. Tag: title
+#: xml.xml:13
+#, no-c-format
msgid "Working with XML data"
-msgstr ""
+msgstr "Trabalhando com dados em 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."
+#. 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 ""
+"O Hibernate permite que se trabalhe com dados persistentes em XML quase da "
+"mesma maneira como você trabalhar com POJOs persistentes. Uma árvore XML "
+"parseada, pode ser imaginada como apenas uma maneira de representar os dados "
+"relacionais como objetos, ao invés dos POJOs."
-#: 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)."
+#. 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 ""
+"O Hibernate suporta a API dom4j para manipular árvores XML. Você pode "
+"escrever queries que retornem árvores dom4j do banco de dados e "
+"automaticamente sincronizar com o banco de dados qualquer modificação feita "
+"nessas árvores. Você pode até mesmo pegar um documento XML, parsear usando o "
+"dom4j, e escrever as alterações no banco de dados usando quaisquer operações "
+"básicas do Hibernate: <literal>persist(), saveOrUpdate(),merge(), delete(), "
+"replicate()</literal> (merging ainda não é suportado)"
-#: 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."
+#. 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 ""
+"Essa funcionalidade tem várias aplicações incluindo importação/exportação de "
+"dados, externalização de dados de entidade via JMS or SOAP e relatórios "
+"usando 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."
+#. 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 ""
+"Um mapeamento simples pode ser usado para simultaneamente mapear "
+"propriedades da classe e nós de um documento XML para um banco de dados ou, "
+"se não houver classe para mapear, pode ser usado simplesmente para mapear o "
+"XML."
-#: index.docbook:44
+#. Tag: title
+#: xml.xml:44
+#, no-c-format
msgid "Specifying XML and class mapping together"
msgstr ""
+"Especificando o mapeamento de uma classe e de um arquivo XML simultaneamente"
-#: index.docbook:46
+#. Tag: para
+#: xml.xml:46
+#, no-c-format
msgid "Here is an example of mapping a POJO and XML simultaneously:"
-msgstr ""
+msgstr "Segue um exemplo de como mapear um POJO e um XML ao mesmo tempo:"
-#: 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 ""
-#: index.docbook:54
+#. Tag: title
+#: xml.xml:54
+#, no-c-format
msgid "Specifying only an XML mapping"
-msgstr ""
+msgstr "Especificando somente um mapeamento XML"
-#: index.docbook:56
+#. Tag: para
+#: xml.xml:56
+#, no-c-format
msgid "Here is an example where there is no POJO class:"
-msgstr ""
+msgstr "Segue um exemplo que não contém uma classe 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 ""
-#: 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."
+#. 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 ""
+"Esse mapeamento permite que você acesse os dados como uma árvore dom4j ou um "
+"grafo de de pares nome de propriedade/valor (<literal>Map</literal>s do "
+"Java). Os nomes de propriedades são somente construções lógicas que podem "
+"ser referenciadas em consultas HQL."
-#: index.docbook:73
+#. Tag: title
+#: xml.xml:73
+#, no-c-format
msgid "XML mapping metadata"
-msgstr ""
+msgstr "Mapeando metadados com 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:"
+#. 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 ""
+"Muitos elementos do mapeamento do Hibernate aceitam o atributo "
+"<literal>node</literal>. Por meio dele, você pode especificar o nome de um "
+"atributo ou elemento XML que contém a propriedade ou os dados da entidade. O "
+"formato do atributo <literal>node</literal> deve ser o seguinte:"
-#: 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> - mapeia para o elemento XML com "
+"determinado nome"
-#: 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> - mapeia para o atributo XML com "
+"determinado nome"
-#: index.docbook:90
+#. Tag: para
+#: xml.xml:90
+#, no-c-format
msgid "<literal>\".\"</literal> - map to the parent element"
-msgstr ""
+msgstr "<literal>\".\"</literal> - mapeia para o elemento pai"
-#: index.docbook:93
-msgid "<literal>\"element-name/@attribute-name\"</literal> - map to the named attribute of the named element"
+#. 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> - mapeia para para o "
+"atributo com determinado nome do elemento com determinado nome"
-#: 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."
+#. 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 ""
+"Para coleções e associações simples, existe o atributo adicional "
+"<literal>embed-xml</literal>. Se o atributo <literal>embed-xml=\"true\"</"
+"literal>, que é o valor padrão, a árvore XML para a entidade associada (ou "
+"coleção de determinado tipo de valor) será embutida diretamente na árvore "
+"XML que contém a associação. Por outro lado, se <literal>embed-xml=\"false"
+"\"</literal>, então apenas o valor do identificador referenciado irá "
+"aparecer no XML para associações simples e coleções simplesmentenão irão "
+"aparecer."
-#: 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!"
+#. 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 ""
+"Você precisa tomar cuidado em não deixar o<literal>embed-xml=\"true\"</"
+"literal> para muitas associações, pois o XML não suporta bem referências "
+"circulares."
-#: 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 ""
-#: 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:"
+#. 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 ""
+"Nesse caso, decidimos embutir a colenção de account ids, e não os dados de "
+"accounts. A query HQL a seguir:"
-#: index.docbook:122
-msgid "<![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 ""
+msgstr "Retornaria um conjunto de dados como esse:"
-#: 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 ""
-#: index.docbook:130
-msgid "If you set <literal>embed-xml=\"true\"</literal> on the <literal><one-to-many></literal> mapping, the data might look more like this:"
+#. Tag: para
+#: xml.xml:130
+#, no-c-format
+msgid ""
+"If you set <literal>embed-xml=\"true\"</literal> on the <literal><one-to-"
+"many></literal> mapping, the data might look more like this:"
msgstr ""
+"Se você setar <literal>embed-xml=\"true\"</literal> em um mapeamento "
+"<literal><one-to-many></literal>, os dados se pareceriam com o "
+"seguinte:"
-#: 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 ""
-#: index.docbook:141
+#. Tag: title
+#: xml.xml:141
+#, no-c-format
msgid "Manipulating XML data"
-msgstr ""
+msgstr "Manipulando dados em XML"
-#: index.docbook:143
-msgid "Let's rearead and update XML documents in the application. We do this by obtaining a dom4j session:"
+#. 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 ""
+"Vamos reler e atualizar documentos em XML em nossa aplicação. Nós fazemos "
+"isso obtendo uma session do 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 ""
-#: 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 ""
-#: 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."
+#. 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 ""
-
-msgid "ROLES_OF_TRANSLATORS"
-msgstr "<!--TRANS:ROLES_OF_TRANSLATORS-->"
-
-msgid "CREDIT_FOR_TRANSLATORS"
-msgstr "<!--TRANS:CREDIT_FOR_TRANSLATORS-->"
-
+"É extremamente útil combinar essa funcionalidade com a operação "
+"<literal>replicate()</literal> do Hibernate para implementar importação/"
+"exportação baseadas em XML."
More information about the hibernate-commits
mailing list