204 lines
8.9 KiB
XML
204 lines
8.9 KiB
XML
<?xml version='1.0' encoding="iso-8859-1"?>
|
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
|
|
"../support/docbook-dtd/docbookx.dtd"
|
|
[
|
|
<!ENTITY quickstart SYSTEM "modules/quickstart.xml">
|
|
<!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="es">
|
|
|
|
<bookinfo>
|
|
<title>HIBERNATE - Persistencia Relacional para Java Idiomático</title>
|
|
<subtitle>Documentación de Referencia de Hibernate</subtitle>
|
|
<releaseinfo>3.0.5</releaseinfo>
|
|
</bookinfo>
|
|
|
|
<toc/>
|
|
|
|
<preface id="preface" revision="2">
|
|
<title>Prefacio</title>
|
|
|
|
<para>
|
|
Advertencia! Esta es una versión traducida del inglés de
|
|
la documentacién de referencia de Hibernate. La versión
|
|
traducida puede no estar actualizada! Sin embargo, las diferencias
|
|
deberían ser sólo menores. Consulta la documentación
|
|
de referencia en inglés si estás perdiendo información
|
|
o encuentras algún error de traducción. Si quieres colaborar con
|
|
una traducción en particular, contáctanos en la lista de correo
|
|
de desarrolladores de Hibernate.
|
|
</para>
|
|
|
|
<para>
|
|
Traductor(es): Bernardo Antonio Buffa Colomé <kreimer@bbs.frc.utn.edu.ar>
|
|
<!--,
|
|
Antonio López Gota <antoniogota@gmail.com> -->
|
|
</para>
|
|
|
|
<para>
|
|
Trabajar con software orientado a objetos y una base de datos relacional puede ser
|
|
incómodo y consumir tiempo en los entornos de empresa de hoy. Hibernate es una
|
|
herramienta de mapeo objeto/relacional para entornos Java. El término mapeo
|
|
objeto/relacional (MOR) hace referencia a la técnica de mapear una
|
|
representación de datos desde un modelo de objetos a un modelo de datos relacional
|
|
con un esquema basado en SQL.
|
|
</para>
|
|
|
|
<para>
|
|
Hibernate no sólo se encarga de mapear de clases Java a tablas de base de datos
|
|
(y de tipos de datos de Java a tipos de datos SQL), sino que también provee
|
|
facilidades de consulta y recuperación de datos y puede reducir significativamente
|
|
el tiempo de desarrollo que de otra forma se gasta en el manejo de los datos en SQL y JDBC.
|
|
</para>
|
|
|
|
<para>
|
|
La meta de Hibernate es relevar al desarrollador del 95 por ciento de las tareas comunes
|
|
relacionadas a la programación de la persistencia de los datos.
|
|
Hibernate puede no ser la mejor solución para aplicaciones que usan solamente
|
|
procedimientos almacenados para implementar la lógica de negocio en la base de
|
|
datos, es mas útil con modelos de dominio orientados a objetos y lógica de
|
|
negocio en middle-tier basada en Java. Sin embargo, Hibernate ciertamente puede ayudarte
|
|
a quitar o encapsular código SQL específico de vendedor y ayudará
|
|
con la tarea común de traducción de resultados desde una representación
|
|
tabular a un grafo de objetos.
|
|
</para>
|
|
|
|
<para>
|
|
Si eres nuevo en Hibernate y lo del Mapeo Objeto/Relacional o incluso en Java,
|
|
sigue por favor estos pasos:
|
|
</para>
|
|
|
|
<orderedlist>
|
|
<listitem>
|
|
<para>
|
|
Lee <xref linkend="quickstart"/> para un tutorial de 30 minutos, usando Tomcat.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Lee <xref linkend="architecture"/> para entender los entornos en los que
|
|
puede ser usado Hibernate.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Dale una mirada al directorio <literal>eg/</literal> en la distribución
|
|
de Hibernate, contiene una aplicación independiente simple.
|
|
Copia tu driver JDBC al directorio <literal>lib/</literal> y edita
|
|
<literal>etc/hibernate.properties</literal>, especificando los valores
|
|
correctos para tu base de datos. Desde línea de comandos en el
|
|
directorio de la distribución, tipea <literal>ant eg</literal>
|
|
(usando Ant), o bajo Windows, tipea <literal>build eg</literal>.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Usa esta documentación de referencia como tu fuente de información
|
|
primaria. Ten en consideración leer <emphasis>Hibernate in Action</emphasis>
|
|
(http://www.manning.com/bauer) si necesitas mas ayuda con el diseño
|
|
de aplicaciones o si prefieres un tutorial paso a paso.
|
|
Visita también http://caveatemptor.hibernate.org y descarga la aplicación
|
|
de ejemplo para Hibernate in Action.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Los FAQs son respondidos en el sitio web de Hibernate.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
En el sitio web de Hibernate hay enlaces a demos de terceros, ejemplos
|
|
y tutoriales.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
El Area de Comunidad en el sitio web de Hibernate es una buena fuente
|
|
de patrones de diseño y varias soluciones de integración
|
|
(Tomcat, JBoss, Struts, EJB, etc.).
|
|
</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
|
|
<para>
|
|
Si tienes preguntas, usa el foro de usuarios enlazado en el sitio web de Hibernate.
|
|
También proveemos un sistema de seguimiento JIRA para reportes de defectos y
|
|
peticiones de nuevas características.
|
|
Si estas interesado en el desarrollo de Hibernate, únete a la lista de correo
|
|
de desarrolladores. Si estas interesado en traducir esta documentación a tu
|
|
lenguaje, contáctanos en la lista de correo de desarrolladores.
|
|
</para>
|
|
|
|
<para>
|
|
A través de JBoss Inc. (see http://www.hibernate.org/SupportTraining/) hay
|
|
disponibilidad de soporte comercial de desarrollo, soporte de producción y
|
|
entrenamiento en Hibernate.
|
|
Hibernate es un proyecto de la suite de productos de código abierto
|
|
JBoss Professional.
|
|
</para>
|
|
|
|
</preface>
|
|
|
|
&quickstart;
|
|
&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>
|
|
|