====== Instalación ======

Para instalar Hibernate 4, lo primero que es necesario hacer es descargarlo y descomprimirlo.

**Paso 1:** Navegar a [[http://www.hibernate.org/downloads|Downloads - Hibernate - JBoss Community]]

**Paso 2:** Pinchar en el enlace [[http://sourceforge.net/projects/hibernate/files/hibernate4/|release bundles]]

{{:install:hibernate_install_01.png|}}

**Paso 3:** Descargar el fichero [[http://sourceforge.net/projects/hibernate/files/hibernate4/4.1.0.Final/|4.1.0.Final]].

{{:install:hibernate_install_02.png|}}

**Paso 4:** Una vez descargado el fichero ''hibernate-release-4.1.0.Final.zip'' deberemos descomprimirlo.

{{:install:hibernate_install_03.png|}}


En el fichero se encuentran 3 carpetas:

  * **lib:** Contiene las librerías ({{http://docs.oracle.com/javase/6/docs/technotes/guides/jar/index.html|jars}}) java con el código de Hibernate.
    * ''lib\required'':Contiene los jars que siempre deben usarse en Hibernate. Es decir siempre debemos incluir estos jars en todos nuestros proyectos de Hibernate.
    * ''lib\jpa'': Las librerías necesarias para usar JPA con Hibernate.
    * ''lib\optional'': Contiene las librerías que añaden nuevas funcionalidades a hibernate ,como poder usar el {{http://sourceforge.net/projects/c3p0/|Pool de conexiones C3PO}} o el  sistema de cache {{http://ehcache.org/|EhCache}}, etc.
    * ''lib\envers'': Contiene librerías que permiten realizar auditorías sobre los datos que se persisten.
  * **documentation:** Documentación sobre Hibernate.
    * ''documentation/devguide/en-US/html_single/index.html'': Guía del desarrollador. "Hibernate Developer Guide"
    * ''documentation/quickstart/en-US/html_single/index.html'':Guía de inicio. "Hibernate Getting Started Guide"
    * ''documentation/manual/en-US/html_single/index.html'':Documentación de referencia sobre Hibernate. "Hibernate Reference Documentation"
    * ''documentation/javadocs/index.html'': JavaDoc de las clases Java. "Hibernate JavaDoc (4.1.0.Final)"

<note tip>En la página [[http://www.hibernate.org/docs|Documentation - Hibernate - JBoss Community]] podemos encontrar la misma documentación pero incluye además otro documento: [[http://docs.jboss.org/hibernate/core/4.0/hem/en-US/html_single/|Hibernate Entity Manager User Guide]]</note>

  * **project:** Contiene principalmente el código fuente y ficheros de configuración de las distintas bases de datos.

**Paso 5:** Ahora se deben copiar todos los ficheros jar que se encuentran en la carpeta ''lib\required'' en la carpeta ''lib'' de nuestro proyecto java. 

{{:install:hibernate_install_04.png|}}

<note tip>Si no existe la carpeta ''lib'' en el raíz de nuestro proyecto deberemos crearla.</note>

**Paso 6:** Copiar el fichero ''hibernate-entitymanager-4.1.0.Final.jar'' de la carpeta ''lib\jpa'' en la carpeta ''lib'' de nuestro proyecto java. 

{{:install:hibernate_install_08.png|}}

**Paso 7:** Indicar a NetBeans que queremos usar todas esas librerías , para ello con el botón derecho pulsar sobre el árbol en el nodo "Libraries" y seleccionar la opción de menú "Add Jar/Folder...".

{{:install:hibernate_install_09.png|}}

**Paso 8:** Seleccionar todos los ficheros jar y pulsar el botón "Abrir".

{{:install:hibernate_install_10.png|}}

<note important>
Fijaté que debe estar seleccionada la opción **''Relative Path''**
</note>

Ahora ya tenemos todas las librerías de Hibernate en nuestro proyecto Java listas para usarse.

{{:install:hibernate_install_11.png|}}