JBoss Application Server 4.3 Seam Reference Guide - 27.2.2. Creating a Hibernate Console configuration

27.2.2. Creating a Hibernate Console configuration

A Console Configuration describes to the Hibernate plugin which configuration files should be used to configure hibernate, including which classpath is needed to load the POJO's, JDBC drivers etc. It is required to make usage of query prototyping, reverse engineering and code generation. You can have multiple named console configurations. Normally you would just need one per project, but more (or less) is definitly possible.

You create a console configuration by running the Console Configuration wizard, shown in the following screenshot. The same wizard will also be used if you are coming from the hibernate.cfg.xml wizard and had enabled "Create Console Configuration".

Creating a Hibernate Console configuration

The following table describes the relevant settings. The wizard can automatically detect default values for most of these if you started the Wizard with the relevant java project selected

Parameter	Description	Auto detected value
Name	The unique name of the configuration	Name of the selected project
Property file	Path to a hibernate.properties file	First hibernate.properties file found in the selected project
Configuration file	Path to a hibernate.cfg.xml file	First hibernate.cfg.xml file found in the selected project
Enable Hibernate ejb3/annotations	Selecting this option enables usage of annotated classes. hbm.xml files are of course still possible to use too. This feature requires running the Eclipse IDE with a JDK 5 runtime, otherwise you will get classloading and/or version errors.	Not enabled
Mapping files	List of additional mapping files that should be loaded. Note: A hibernate.cfg.xml can also contain mappings. Thus if these a duplicated here, you will get "Duplicate mapping" errors when using the console configuration.	If no hibernate.cfg.xml file is found, all hbm.xml files found in the selected project
Classpath	The classpath for loading POJO and JDBC drivers. Do not add Hibernate core libraries or dependencies, they are already included. If you get ClassNotFound errors then check this list for possible missing or redundant directories/jars.	The default build output directory and any JARs with a class implementing java.sql.Driver in the selected project

Table 27.1. Hibernate Console Configuration Parameters

Clicking "Finish" creates the configuration and shows it in the "Hibernate Configurations" view

Console overview