new docbook layout (prep for translations migration to PO)

git-svn-id: https://svn.jboss.org/repos/hibernate/core/trunk@14080 1b8cb986-b30d-0410-93ca-fae66ebed9b2
This commit is contained in:
Steve Ebersole 2007-10-09 19:32:35 +00:00
parent 2f75f56085
commit a4cce4c205
51 changed files with 414 additions and 397 deletions

View File

@ -0,0 +1,73 @@
<?xml version='1.0' encoding="iso-8859-1"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY versionNumber "3.3.0.alpha1">
<!ENTITY copyrightYear "2004">
<!ENTITY copyrightHolder "Red Hat Middleware, LLC.">
]>
<book>
<bookinfo>
<title>HIBERNATE - Relational Persistence for Idiomatic Java</title>
<subtitle>Documentação da Referência do Hibernate</subtitle>
<releaseinfo>&versionNumber;</releaseinfo>
<productnumber>&versionNumber;</productnumber>
<issuenum>1</issuenum>
<mediaobject>
<imageobject role="fo">
<imagedata fileref="images/hibernate_logo_a.png" align="center" />
</imageobject>
<imageobject role="html">
<imagedata fileref="images/hibernate_logo_a.png" depth="3cm" />
</imageobject>
</mediaobject>
<copyright>
<year>&copyrightYear;</year>
<holder>&copyrightHolder;</holder>
</copyright>
<xi:include href="translators.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="legal_notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="legal_notice2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</bookinfo>
<toc/>
<xi:include href="content/preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/tutorial.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/architecture.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/persistent_classes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/basic_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/collection_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/association_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/component_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/inheritance_mapping.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/session_api.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/transactions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/events.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/batch.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/query_hql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/query_criteria.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/query_sql.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/filters.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/xml.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/performance.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/toolset_guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/example_parentchild.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/example_weblog.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/example_mappings.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="content/best_practices.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
</book>

View File

@ -1,4 +1,19 @@
<chapter id="architecture">
<!--
~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
~
~ This copyrighted material is made available to anyone wishing to use, modify,
~ copy, or redistribute it subject to the terms and conditions of the GNU
~ Lesser General Public License, v. 2.1. This program is distributed in the
~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
~ Lesser General Public License for more details. You should have received a
~ copy of the GNU Lesser General Public License, v.2.1 along with this
~ distribution; if not, write to the Free Software Foundation, Inc.,
~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
~
~ Red Hat Author(s): Steve Ebersole
-->
<chapter id="architecture">
<title>Arquitetura</title>
@ -11,10 +26,10 @@
<mediaobject>
<imageobject role="fo">
<imagedata fileref="images/overview.svg" format="SVG" align="center"/>
<imagedata fileref="../images/overview.svg" format="SVG" align="center"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="../shared/images/overview.gif" format="GIF" align="center"/>
<imagedata fileref="../images/overview.png" format="PNG" align="center"/>
</imageobject>
</mediaobject>
@ -34,10 +49,10 @@
<mediaobject>
<imageobject role="fo">
<imagedata fileref="images/lite.svg" format="SVG" align="center"/>
<imagedata fileref="../images/lite.svg" format="SVG" align="center"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="../shared/images/lite.gif" format="GIF" align="center"/>
<imagedata fileref="../images/lite.png" format="PNG" align="center"/>
</imageobject>
</mediaobject>
@ -48,10 +63,10 @@
<mediaobject>
<imageobject role="fo">
<imagedata fileref="images/full_cream.svg" format="SVG" align="center"/>
<imagedata fileref="../images/full_cream.svg" format="SVG" align="center"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="../shared/images/full_cream.gif" format="GIF" align="center"/>
<imagedata fileref="../images/full_cream.png" format="PNG" align="center"/>
</imageobject>
</mediaobject>

View File

@ -1384,7 +1384,7 @@ hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect]]></programlisting>
</para>
<para>
The XML configuration file is by default expected to be in the root of
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:

View File

@ -1,4 +1,19 @@
<chapter id="example-mappings">
<!--
~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
~
~ This copyrighted material is made available to anyone wishing to use, modify,
~ copy, or redistribute it subject to the terms and conditions of the GNU
~ Lesser General Public License, v. 2.1. This program is distributed in the
~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
~ Lesser General Public License for more details. You should have received a
~ copy of the GNU Lesser General Public License, v.2.1 along with this
~ distribution; if not, write to the Free Software Foundation, Inc.,
~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
~
~ Red Hat Author(s): Steve Ebersole
-->
<chapter id="example-mappings">
<title>Exemplo: Vários Mapeamentos</title>
<para>
@ -18,10 +33,10 @@
<mediaobject>
<imageobject role="fo">
<imagedata fileref="images/EmployerEmployee.gif" format="GIF" align="center"/>
<imagedata fileref="../images/EmployerEmployee.png" format="PNG" align="center"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="../shared/images/EmployerEmployee.gif" format="GIF" align="center"/>
<imagedata fileref="../images/EmployerEmployee.png" format="PNG" align="center"/>
</imageobject>
</mediaobject>
@ -132,10 +147,10 @@ create sequence employer_id_seq]]></programlisting>
<mediaobject>
<imageobject role="fo">
<imagedata fileref="images/AuthorWork.gif" format="GIF" align="center"/>
<imagedata fileref="../images/AuthorWork.png" format="PNG" align="center"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="../shared/images/AuthorWork.gif" format="GIF" align="center"/>
<imagedata fileref="../images/AuthorWork.png" format="PNG" align="center"/>
</imageobject>
</mediaobject>
@ -261,10 +276,10 @@ alter table author_work
<mediaobject>
<imageobject role="fo">
<imagedata fileref="images/CustomerOrderProduct.gif" format="GIF" align="center"/>
<imagedata fileref="../images/CustomerOrderProduct.png" format="PNG" align="center"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="../shared/images/CustomerOrderProduct.gif" format="GIF" align="center"/>
<imagedata fileref="../images/CustomerOrderProduct.png" format="PNG" align="center"/>
</imageobject>
</mediaobject>

View File

@ -1,4 +1,4 @@
<chapter id="performance">
<chapter id="performance">
<title>Aumentando a performance</title>
<sect1 id="performance-fetching" revision="2">
@ -677,7 +677,7 @@ Cat fritz = (Cat) iter.next();]]></programlisting>
<entry>OSCache</entry>
<entry><literal>org.hibernate.cache.OSCacheProvider</literal></entry>
<entry>memory, disk</entry>
<entry>yes (clustered invalidation)</entry>
<entry></entry>
<entry>yes</entry>
</row>
<row>
@ -940,32 +940,26 @@ sessionFactory.evictCollection("Cat.kittens"); //evict all kitten collections]]>
<itemizedlist>
<listitem>
<para>
<literal>CacheMode.NORMAL</literal> - read items from and write items to the second-level cache.
</para>
</listitem>
<listitem>
<para>
<literal>CacheMode.IGNORE</literal> - never write nor read items from the second-level cache,
except when updating data.
<literal>CacheMode.NORMAL</literal> - read items from and write items to the second-level cache
</para>
</listitem>
<listitem>
<para>
<literal>CacheMode.GET</literal> - read items from the second-level cache, but don't write to
the second-level cache except when updating data.
the second-level cache except when updating data
</para>
</listitem>
<listitem>
<para>
<literal>CacheMode.PUT</literal> - write items to the second-level cache, but don't read from
the second-level cache.
the second-level cache
</para>
</listitem>
<listitem>
<para>
<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.
a refresh of the second-level cache for all items read from the database
</para>
</listitem>
</itemizedlist>

View File

@ -0,0 +1,120 @@
<?xml version='1.0' encoding="iso-8859-1"?>
<!--
~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
~
~ This copyrighted material is made available to anyone wishing to use, modify,
~ copy, or redistribute it subject to the terms and conditions of the GNU
~ Lesser General Public License, v. 2.1. This program is distributed in the
~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
~ Lesser General Public License for more details. You should have received a
~ copy of the GNU Lesser General Public License, v.2.1 along with this
~ distribution; if not, write to the Free Software Foundation, Inc.,
~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
~
~ Red Hat Author(s): Steve Ebersole
-->
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<preface id="preface" revision="2">
<title>Prefácio</title>
<para>
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
</para>
<para>
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.
</para>
<para>
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.
</para>
<para>
Se você for novo no Hibernate e no mapeamento Objeto/Relacional, ou até mesmo em Java,
por favor, siga os seguintes passos.
</para>
<orderedlist>
<listitem>
<para>
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>.
</para>
</listitem>
<listitem>
<para>
Leia o <xref linkend="architecture"/> para entender o ambiente onde o Hibernate pode ser utilizado.
</para>
</listitem>
<listitem>
<para>
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>.
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
FAQs (perguntas feitas com mais freqüência) estão respondidas no site do Hibernate
</para>
</listitem>
<listitem>
<para>
Demonstrações, exemplos e tutorials estão disponíveis no site do Hibernate.
</para>
</listitem>
<listitem>
<para>
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.).
</para>
</listitem>
</orderedlist>
<para>
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 bugs (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.
</para>
<para>
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).
</para>
</preface>

View File

@ -100,7 +100,7 @@
</para>
<programlisting><![CDATA[<many-to-one name="org" column="orgId" unique-key="OrgEmployeeId"/>
<property name="employeeId" unique-key="OrgEmployeeId"/>]]></programlisting>
<property name="employeeId" unique-key="OrgEmployee"/>]]></programlisting>
<para>
An <literal>index</literal> attribute specifies the name of an index that

View File

@ -1,4 +1,4 @@
<chapter id="tutorial">
<chapter id="tutorial">
<title>Introdu&#x00E7;&#x00E3;o ao Hibernate</title>
<sect1 id="tutorial-intro" revision="1">
@ -1447,7 +1447,7 @@ out.close();]]></programlisting>
<programlisting><![CDATA[<target name="war" depends="compile">
<war destfile="hibernate-tutorial.war" webxml="web.xml">
<lib dir="${librarydir}">
<exclude name="servlet.jar"/>
<exclude name="jsdk*.jar"/>
</lib>
<classes dir="${targetdir}"/>
@ -1479,9 +1479,8 @@ out.close();]]></programlisting>
<para>
Antes de você compilar e fazer o deploy desta aplicação web, note que uma biblioteca
adicional é requerida: <literal>servlet.jar</literal>. Esse é o Java Servlet Development Kit,
se você não possui esta biblioteca, faça seu download na
<ulink url="http://java.sun.com/products/servlet/archive.html">página da Sun</ulink> e copie-a
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.
</para>

View File

@ -1,4 +1,4 @@
<chapter id="tutorial">
<chapter id="tutorial">
<title>Introdu&#x00E7;&#x00E3;o ao Hibernate</title>
<sect1 id="tutorial-intro" revision="1">
@ -1461,7 +1461,7 @@ out.close();]]></programlisting>
<programlisting><![CDATA[<target name="war" depends="compile">
<war destfile="hibernate-tutorial.war" webxml="web.xml">
<lib dir="${librarydir}">
<exclude name="servlet.jar"/>
<exclude name="jsdk*.jar"/>
</lib>
<classes dir="${targetdir}"/>
@ -1493,9 +1493,8 @@ out.close();]]></programlisting>
<para>
Before you compile and deploy the web application, note that an additional library
is required: <literal>servlet.jar</literal>. This is the Java Servlet Development Kit,
if you don't have this library already, get it from the
<ulink url="http://java.sun.com/products/servlet/archive.html">Sun website</ulink> and copy it to
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.
</para>

View File

@ -255,7 +255,7 @@ List results = dom4jSession
for ( int i=0; i<results.size(); i++ ) {
//add the customer data to the XML document
Element customer = (Element) results.get(i);
doc.getRootElement().add(customer);
doc.add(customer);
}
tx.commit();

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.7 KiB

View File

Before

Width:  |  Height:  |  Size: 8.5 KiB

After

Width:  |  Height:  |  Size: 8.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.2 KiB

View File

Before

Width:  |  Height:  |  Size: 6.5 KiB

After

Width:  |  Height:  |  Size: 6.5 KiB

View File

@ -0,0 +1,52 @@
<?xml version='1.0'?>
<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!--
~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
~
~ This copyrighted material is made available to anyone wishing to use, modify,
~ copy, or redistribute it subject to the terms and conditions of the GNU
~ Lesser General Public License, v. 2.1. This program is distributed in the
~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
~ Lesser General Public License for more details. You should have received a
~ copy of the GNU Lesser General Public License, v.2.1 along with this
~ distribution; if not, write to the Free Software Foundation, Inc.,
~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
~
~ Red Hat Author(s): Steve Ebersole
-->
<legalnotice id="Legal_Notice">
<title>Legal Notice</title>
<para>
<address>
<street>1801 Varsity Drive</street>
<city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country>
<phone>Phone: +1 919 754 3700</phone>
<phone>Phone: 888 733 4281</phone>
<fax>Fax: +1 919 754 3701</fax>
<pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country>
</address>
</para>
<para>
Copyright <trademark class="copyright"></trademark> 2007 by Red Hat, Inc. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, V1.0 or later (the latest version is presently available at <ulink url="http://www.opencontent.org/openpub/">http://www.opencontent.org/openpub/</ulink>).
</para>
<para>
Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder.
</para>
<para>
Distribution of the work or derivative of the work in any standard (paper) book form for commercial purposes is prohibited unless prior permission is obtained from the copyright holder.
</para>
<para>
Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat, Inc. in the United States and other countries.
</para>
<para>
All other trademarks referenced herein are the property of their respective owners.
</para>
<para>
The GPG fingerprint of the security@redhat.com key is:
</para>
<para>
CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E
</para>
</legalnotice>

View File

@ -0,0 +1,15 @@
<?xml version='1.0'?>
<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<legalnotice id="Legal_Notice">
<title>Translation-specific Legal Notice</title>
<para>
<emphasis>Advertencia! Esta é uma versão traduzida do inglês da
documentação de referencia do Hibernate. A versão traduziada pode estar
desatualizada. Sem dúvida, as diferenças devem ser pequenas e serão corrigidas o
mais breve possivel. Consulte a documentação de referencia em inglês, se estiver
faltando alguma informação ou você encotrar erros de tradução. Se quiser
colaborar com ama tradução em particular, entre em contato com um dos tradutores
abaixo:</emphasis>. Gamarra
</para>
</legalnotice>

View File

@ -1,261 +0,0 @@
<?xml version='1.0' encoding="iso-8859-1"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
"../support/docbook-dtd/docbookx.dtd"
[
<!ENTITY tutorial SYSTEM "modules/tutorial.xml">
<!ENTITY architecture SYSTEM "modules/architecture.xml">
<!ENTITY configuration SYSTEM "modules/configuration.xml">
<!ENTITY persistent-classes SYSTEM "modules/persistent_classes.xml">
<!ENTITY basic-mapping SYSTEM "modules/basic_mapping.xml">
<!ENTITY collection-mapping SYSTEM "modules/collection_mapping.xml">
<!ENTITY association-mapping SYSTEM "modules/association_mapping.xml">
<!ENTITY component-mapping SYSTEM "modules/component_mapping.xml">
<!ENTITY inheritance-mapping SYSTEM "modules/inheritance_mapping.xml">
<!ENTITY session-api SYSTEM "modules/session_api.xml">
<!ENTITY transactions SYSTEM "modules/transactions.xml">
<!ENTITY events SYSTEM "modules/events.xml">
<!ENTITY batch SYSTEM "modules/batch.xml">
<!ENTITY query-hql SYSTEM "modules/query_hql.xml">
<!ENTITY query-criteria SYSTEM "modules/query_criteria.xml">
<!ENTITY query-sql SYSTEM "modules/query_sql.xml">
<!ENTITY filters SYSTEM "modules/filters.xml">
<!ENTITY xml SYSTEM "modules/xml.xml">
<!ENTITY performance SYSTEM "modules/performance.xml">
<!ENTITY toolset-guide SYSTEM "modules/toolset_guide.xml">
<!ENTITY example-parentchild SYSTEM "modules/example_parentchild.xml">
<!ENTITY example-weblog SYSTEM "modules/example_weblog.xml">
<!ENTITY example-mappings SYSTEM "modules/example_mappings.xml">
<!ENTITY best-practices SYSTEM "modules/best_practices.xml">
]>
<book lang="en">
<bookinfo>
<title>HIBERNATE - Relational Persistence for Idiomatic Java</title>
<subtitle>Documentação da Referência do Hibernate</subtitle>
<releaseinfo>3.2 cr2</releaseinfo>
</bookinfo>
<toc/>
<preface id="preface" revision="2">
<title>Prefácio</title>
<para>
<emphasis>Advertencia! Esta é uma versão traduzida do inglês da
documentação de referencia do Hibernate. A versão traduziada pode estar
desatualizada. Sem dúvida, as diferenças devem ser pequenas e serão corrigidas o
mais breve possivel. Consulte a documentação de referencia em inglês, se estiver
faltando alguma informação ou você encotrar erros de tradução. Se quiser
colaborar com ama tradução em particular, entre em contato com um dos tradutores
abaixo:</emphasis>. Gamarra
</para>
<para>
Tradutor(es) em ordem alfabética:
</para>
<itemizedlist>
<listitem>
<para>
<emphasis>Alvaro Netto</emphasis> alvaronetto@cetip.com.br
</para>
</listitem>
<listitem>
<para>
<emphasis>Anderson Braulio</emphasis> andersonbraulio@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Daniel Vieira Costa</emphasis> danielvc@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Francisco gamarra</emphasis> francisco.gamarra@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Gamarra</emphasis> mauricio.gamarra@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Luiz Carlos Rodrigues</emphasis> luizcarlos_rodrigues@yahoo.com.br
</para>
</listitem>
<listitem>
<para>
<emphasis>Marcel Castelo</emphasis> marcel.castelo@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Paulo César</emphasis> paulocol@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Pablo L. de Miranda</emphasis> pablolmiranda@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Renato Deggau</emphasis> rdeggau@gmail.com
</para>
</listitem>
<listitem>
<para>
<emphasis>Rogério Araújo</emphasis> rgildoaraujo@yahoo.com.br
</para>
</listitem>
<listitem>
<para>
<emphasis>Wanderson Siqueira</emphasis> wandersonxs@gmail.com
</para>
</listitem>
</itemizedlist>
<para>
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
</para>
<para>
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.
</para>
<para>
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.
</para>
<para>
Se você for novo no Hibernate e no mapeamento Objeto/Relacional, ou até mesmo em Java,
por favor, siga os seguintes passos.
</para>
<orderedlist>
<listitem>
<para>
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>.
</para>
</listitem>
<listitem>
<para>
Leia o <xref linkend="architecture"/> para entender o ambiente onde o Hibernate pode ser utilizado.
</para>
</listitem>
<listitem>
<para>
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>.
</para>
</listitem>
<listitem>
<para>
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.
</para>
</listitem>
<listitem>
<para>
FAQs (perguntas feitas com mais freqüência) estão respondidas no site do Hibernate
</para>
</listitem>
<listitem>
<para>
Demonstrações, exemplos e tutorials estão disponíveis no site do Hibernate.
</para>
</listitem>
<listitem>
<para>
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.).
</para>
</listitem>
</orderedlist>
<para>
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 bugs (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.
</para>
<para>
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).
</para>
</preface>
&tutorial;
&architecture;
&configuration;
&persistent-classes;
&basic-mapping;
&collection-mapping;
&association-mapping;
&component-mapping;
&inheritance-mapping;
&session-api;
&transactions;
&events;
&batch;
&query-hql;
&query-criteria;
&query-sql;
&filters;
&xml;
&performance;
&toolset-guide;
&example-parentchild;
&example-weblog;
&example-mappings;
&best-practices;
</book>

View File

@ -0,0 +1,93 @@
<?xml version='1.0'?>
<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!--
~ Copyright (c) 2007, Red Hat Middleware, LLC. All rights reserved.
~
~ This copyrighted material is made available to anyone wishing to use, modify,
~ copy, or redistribute it subject to the terms and conditions of the GNU
~ Lesser General Public License, v. 2.1. This program is distributed in the
~ hope that it will be useful, but WITHOUT A WARRANTY; without even the implied
~ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
~ Lesser General Public License for more details. You should have received a
~ copy of the GNU Lesser General Public License, v.2.1 along with this
~ distribution; if not, write to the Free Software Foundation, Inc.,
~ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
~
~ Red Hat Author(s): Steve Ebersole
-->
<authorgroup id="AuthorGroup">
<othercredit class="translator">
<firstname>Alvaro</firstname>
<surname>Netto</surname>
<email>alvaronetto@cetip.com.br</email>
</othercredit>
<othercredit class="translator">
<firstname>Anderson</firstname>
<surname>Braulio</surname>
<email>andersonbraulio@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Daniel Vieira</firstname>
<surname>Costa</surname>
<email>danielvc@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Francisco</firstname>
<surname>gamarra</surname>
<email>francisco.gamarra@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Gamarra</firstname>
<email>mauricio.gamarra@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Luiz Carlos</firstname>
<surname>Rodrigues</surname>
<email>luizcarlos_rodrigues@yahoo.com.br</email>
</othercredit>
<othercredit class="translator">
<firstname>Marcel</firstname>
<surname>Castelo</surname>
<email>marcel.castelo@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Paulo</firstname>
<surname>César</surname>
<email>paulocol@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Pablo L.</firstname>
<surname>de Miranda</surname>
<email>pablolmiranda@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Renato</firstname>
<surname>Deggau</surname>
<email>rdeggau@gmail.com</email>
</othercredit>
<othercredit class="translator">
<firstname>Rogério</firstname>
<surname>Araújo</surname>
<email>rgildoaraujo@yahoo.com.br</email>
</othercredit>
<othercredit class="translator">
<firstname>Wanderson</firstname>
<surname>Siqueira</surname>
<email>wandersonxs@gmail.com</email>
</othercredit>
</authorgroup>

View File

@ -1,97 +0,0 @@
A {
color: #003399;
}
A:active {
color: #003399;
}
A:visited {
color: #888888;
}
P, OL, UL, LI, DL, DT, DD, BLOCKQUOTE {
color: #000000;
}
TD, TH, SPAN {
color: #000000;
}
BLOCKQUOTE {
margin-right: 0px;
}
H1, H2, H3, H4, H5, H6 {
color: #000000;
font-weight:500;
margin-top:10px;
padding-top:15px;
}
TABLE {
border-collapse: collapse;
border-spacing:0;
border: 1px thin black;
empty-cells: hide;
}
TD {
padding: 4pt;
}
H1 { font-size: 150%; }
H2 { font-size: 140%; }
H3 { font-size: 110%; font-weight: bold; }
H4 { font-size: 110%; font-weight: bold;}
H5 { font-size: 100%; font-style: italic; }
H6 { font-size: 100%; font-style: italic; }
TT {
font-size: 90%;
font-family: "Courier New", Courier, monospace;
color: #000000;
}
PRE {
font-size: 100%;
padding: 5px;
border-style: solid;
border-width: 1px;
border-color: #CCCCCC;
background-color: #F4F4F4;
}
UL, OL, LI {
list-style: disc;
}
HR {
width: 100%;
height: 1px;
background-color: #CCCCCC;
border-width: 0px;
padding: 0px;
color: #CCCCCC;
}
.variablelist {
padding-top: 10;
padding-bottom:10;
margin:0;
}
.itemizedlist, UL {
padding-top: 0;
padding-bottom:0;
margin:0;
}
.term {
font-weight:bold;
}

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.1 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.4 KiB