prep for gettext conversion
git-svn-id: https://svn.jboss.org/repos/hibernate/core/trunk@14118 1b8cb986-b30d-0410-93ca-fae66ebed9b2
This commit is contained in:
parent
216c85b66c
commit
c98631e861
|
@ -1,4 +1,4 @@
|
|||
<?xml version='1.0' encoding="iso-8859-1"?>
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!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">
|
||||
|
@ -9,7 +9,7 @@
|
|||
|
||||
<bookinfo>
|
||||
<title>HIBERNATE - Relational Persistence for Idiomatic Java</title>
|
||||
<subtitle>Documentação da Referência do Hibernate</subtitle>
|
||||
<subtitle>Documentação da Referência do Hibernate</subtitle>
|
||||
<releaseinfo>&versionNumber;</releaseinfo>
|
||||
<productnumber>&versionNumber;</productnumber>
|
||||
<issuenum>1</issuenum>
|
||||
|
@ -25,22 +25,20 @@
|
|||
<year>©rightYear;</year>
|
||||
<holder>©rightHolder;</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/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/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/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/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" />
|
||||
|
|
|
@ -1,18 +1,6 @@
|
|||
<!--
|
||||
~ 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
|
||||
-->
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="architecture">
|
||||
|
||||
<title>Arquitetura</title>
|
||||
|
|
|
@ -1,3 +1,6 @@
|
|||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="associations">
|
||||
|
||||
<title>Mapeamento de Associações</title>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="mapping">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="mapping">
|
||||
<title>Mapeamento O/R Bassico</title>
|
||||
|
||||
<sect1 id="mapping-declaration" revision="1">
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="batch">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="batch">
|
||||
<title>Processamento de lotes</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="best-practices" revision="3">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="best-practices" revision="3">
|
||||
<title>Boas práticas</title>
|
||||
|
||||
<variablelist spacing="compact">
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="collections">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="collections">
|
||||
<title>Mapeamento de Coleções</title>
|
||||
|
||||
<sect1 id="collections-persistent" revision="3">
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="components">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="components">
|
||||
<title>Mapeamento de Componentes</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="session-configuration" revision="1">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="session-configuration" revision="1">
|
||||
|
||||
<title>Configuração</title>
|
||||
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="events">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="events">
|
||||
<title>Interceptadores e Eventos</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,19 +1,7 @@
|
|||
<!--
|
||||
~ 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">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="example-mappings">
|
||||
<title>Exemplo: Vários Mapeamentos</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="example-parentchild">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="example-parentchild">
|
||||
<title>Example: Parent/Child</title>
|
||||
|
||||
<para>
|
||||
|
@ -358,4 +361,4 @@ public boolean onSave(Object entity,
|
|||
|
||||
</sect1>
|
||||
|
||||
</chapter>
|
||||
</chapter>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="example-weblog">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="example-weblog">
|
||||
<title>Example: Weblog Application</title>
|
||||
|
||||
<sect1 id="example-weblog-classes">
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="filters">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="filters">
|
||||
<title>Filtrando dados</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="inheritance">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="inheritance">
|
||||
<title>Mapeamento de Herança</title>
|
||||
|
||||
<sect1 id="inheritance-strategies" revision="3">
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="performance">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="performance">
|
||||
<title>Aumentando a performance</title>
|
||||
|
||||
<sect1 id="performance-fetching" revision="2">
|
||||
|
@ -1381,4 +1384,4 @@ log.info(Cat.class.getName() + " changed " + changes + "times" );]]></programli
|
|||
|
||||
</sect1>
|
||||
|
||||
</chapter>
|
||||
</chapter>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="persistent-classes" revision="2">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="persistent-classes" revision="2">
|
||||
<title>Persistent Classes</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,61 +1,46 @@
|
|||
<?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
|
||||
-->
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!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>
|
||||
<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
|
||||
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
|
||||
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.
|
||||
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.
|
||||
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,
|
||||
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
|
||||
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>
|
||||
|
@ -66,9 +51,9 @@
|
|||
</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
|
||||
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
|
||||
|
@ -77,43 +62,43 @@
|
|||
</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.
|
||||
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
|
||||
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.
|
||||
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.).
|
||||
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 bug’s (JIRA) para relatórios de erros
|
||||
e requisições de features. Se você está interessado no desenvolvimento do Hibernate,
|
||||
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
|
||||
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>
|
||||
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="querycriteria">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="querycriteria">
|
||||
<title>Consultas por critérios</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,6 +1,7 @@
|
|||
858
|
||||
|
||||
<chapter id="queryhql">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="queryhql">
|
||||
<title>HQL: A linguagem de Queries do Hibernate</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,5 +1,7 @@
|
|||
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||
<chapter id="querysql" revision="2">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="querysql" revision="2">
|
||||
<title>Native SQL</title>
|
||||
|
||||
<para>You may also express queries in the native SQL dialect of your
|
||||
|
@ -601,10 +603,10 @@ BEGIN
|
|||
<itemizedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>
|
||||
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.
|
||||
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.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
@ -615,16 +617,16 @@ BEGIN
|
|||
<listitem>
|
||||
<para>
|
||||
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.
|
||||
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.
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>
|
||||
Se você habilitar <literal>SET NOCOUNT ON</literal> na sua procedure, ela
|
||||
provavelmente será mais eficiente. Mas, isto não é obrigatório</para>
|
||||
Se você habilitar <literal>SET NOCOUNT ON</literal> na sua procedure, ela
|
||||
provavelmente será mais eficiente. Mas, isto não é obrigatório</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect3>
|
||||
|
@ -642,9 +644,9 @@ BEGIN
|
|||
<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.).
|
||||
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
|
||||
|
@ -663,13 +665,13 @@ BEGIN
|
|||
</class>]]></programlisting>
|
||||
|
||||
<para>
|
||||
O SQL é executado diretamente no seu banco de dados, então você pode usar qualquer
|
||||
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.
|
||||
você utilizar um SQL para um banco de dados especifico.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Stored Procedures são suportadas se o atributo the
|
||||
Stored Procedures são suportadas se o atributo the
|
||||
<literal>callable</literal> estiver ativado:
|
||||
</para>
|
||||
|
||||
|
@ -684,22 +686,22 @@ BEGIN
|
|||
</class>]]></programlisting>
|
||||
|
||||
<para>
|
||||
A ordem de posições dos parâmetros são vitais, pois eles devem estar na mesma seqüência
|
||||
A ordem de posições dos parâmetros são vitais, pois eles devem estar na mesma seqüência
|
||||
esperada pelo Hibernate.
|
||||
</para>
|
||||
|
||||
<para>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).
|
||||
<para>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).
|
||||
</para>
|
||||
|
||||
<para>As stored procedures são na maioria dos casos (leia: melhor não fazer) requeridas para
|
||||
<para>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.
|
||||
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.
|
||||
</para>
|
||||
|
||||
<programlisting><![CDATA[CREATE OR REPLACE FUNCTION updatePerson (uid IN NUMBER, uname IN VARCHAR2)
|
||||
|
@ -723,7 +725,7 @@ END updatePerson;]]>
|
|||
<title>SQL customizado para carga</title>
|
||||
|
||||
<para>
|
||||
Você pode declarar sua própria query SQL (ou HQL) para iniciar entidades:
|
||||
Você pode declarar sua própria query SQL (ou HQL) para iniciar entidades:
|
||||
</para>
|
||||
|
||||
<programlisting><![CDATA[<sql-query name="person">
|
||||
|
@ -735,8 +737,8 @@ END updatePerson;]]>
|
|||
</sql-query>]]></programlisting>
|
||||
|
||||
<para>
|
||||
Este é apenas uma declaração de query com nome, como discutido anteriormente.
|
||||
Você pode referenciar esta query com nome em um mapeamento de classe:
|
||||
Este é apenas uma declaração de query com nome, como discutido anteriormente.
|
||||
Você pode referenciar esta query com nome em um mapeamento de classe:
|
||||
</para>
|
||||
|
||||
<programlisting><![CDATA[<class name="Person">
|
||||
|
@ -747,10 +749,10 @@ END updatePerson;]]>
|
|||
<loader query-ref="person"/>
|
||||
</class>]]></programlisting>
|
||||
|
||||
<para>Isto também funciona com stored procedures.
|
||||
<para>Isto também funciona com stored procedures.
|
||||
</para>
|
||||
|
||||
<para>Você pode tembém definir uma query para iniciar collection:
|
||||
<para>Você pode tembém definir uma query para iniciar collection:
|
||||
</para>
|
||||
|
||||
<programlisting><![CDATA[<set name="employments" inverse="true">
|
||||
|
@ -780,4 +782,4 @@ END updatePerson;]]>
|
|||
WHERE ID=?
|
||||
</sql-query>]]></programlisting>
|
||||
</sect1>
|
||||
</chapter>
|
||||
</chapter>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="objectstate">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="objectstate">
|
||||
<title>Trabalhando com objetos</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="toolsetguide" revision="2">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="toolsetguide" revision="2">
|
||||
<title>Toolset Guide</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="transactions" revision="2">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="transactions" revision="2">
|
||||
<title>Transações e Concorrência</title>
|
||||
|
||||
<para>
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="tutorial">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="tutorial">
|
||||
<title>Introdução ao Hibernate</title>
|
||||
|
||||
<sect1 id="tutorial-intro" revision="1">
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="tutorial">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="tutorial">
|
||||
<title>Introdução ao Hibernate</title>
|
||||
|
||||
<sect1 id="tutorial-intro" revision="1">
|
||||
|
|
|
@ -1,4 +1,7 @@
|
|||
<chapter id="xml">
|
||||
<?xml version='1.0' encoding="UTF-8"?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
||||
|
||||
<chapter id="xml">
|
||||
<title>Mapeamento XML</title>
|
||||
|
||||
<para><emphasis>
|
||||
|
|
|
@ -1,15 +0,0 @@
|
|||
<?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>
|
|
@ -1,93 +0,0 @@
|
|||
<?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>
|
Loading…
Reference in New Issue