Instalación

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

Paso 1: Navegar a Downloads - Hibernate - JBoss Community

Paso 2: Pinchar en el enlace release bundles

Paso 3: Descargar el fichero 4.1.0.Final.

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

En el fichero se encuentran 3 carpetas:

lib: Contiene las librerías (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 Pool de conexiones C3PO o el sistema de cache 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)”

En la página Documentation - Hibernate - JBoss Community podemos encontrar la misma documentación pero incluye además otro documento: Hibernate Entity Manager User Guide

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.

Si no existe la carpeta lib en el raíz de nuestro proyecto deberemos crearla.

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.

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…”.

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

Fijaté que debe estar seleccionada la opción Relative Path

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