Configuration Examples
+ +Configuration Through A Configuration-File
+ ++ The most simple way to configure the plugin is, to put all the + hibernate-configuration in a hibernate.properties- or + a hibernate.cfg.xml-file on your classpath or in the + persistence.xml-file of your JPA-configuration, just + like you would do, if you are not using the + hibernate-maven-plugin. +
+ ++ Doing so, the only additionally configuration needed, to activat the plugin + is the following entry in the plugins-section of your pom.xml: +
+ ++<plugin> + <groupId>de.juplo</groupId> + <artifactId>hibernate-maven-plugin</artifactId> + <version>2.1.0</version> + <executions> + <execution> + <goals> + <goal>create</goal> + </goals> + </execution> + </executions> +</plugin>
+ This would create the configured database. + If you want it to be droped beforehand, you have to add the goal + drop: +
+ ++<plugin> + <groupId>de.juplo</groupId> + <artifactId>hibernate-maven-plugin</artifactId> + <version>2.1.0</version> + <executions> + <execution> + <goals> + <goal>drop</goal> + <goal>create</goal> + </goals> + </execution> + </executions> +</plugin>
+ A correspondin goal for the command update is missing in this + version, but we are planning to implement it in near feature. +
+ ++ In order to let this configuration work, your configuration file must + contain a complete valid configuration for the database, that you want + to use. + A simple example hibernate.properties-file may look like this: +
+ ++hibernate.dialect=org.hibernate.dialect.H2Dialect +hibernate.connection.url=jdbc:h2:file:./target/db +hibernate.connection.driver_class=org.h2.Driver +hibernate.connection.username=sa +hibernate.connection.password=
+ But be aware, that using this configuration-approach the database-url, + that is build in the application is the same that is used while testing, + where the database is droped and recreated by the plugin. + Because of that, + + you should never fire up this configuration on your production + system, or your database might be erased! + +
+ ++ A better approach is, to specify a different url for testing like in the + following snippet: +
+ ++<plugin> + <groupId>de.juplo</groupId> + <artifactId>hibernate-maven-plugin</artifactId> + <version>2.1.0</version> + <executions> + <execution> + <goals> + <goal>drop</goal> + <goal>create</goal> + </goals> + </execution> + </executions> + <configuration> + <url><![CDATA[jdbc:mysql://localhost/test-db]]></url> + </configuration> +</plugin>
+ Configuration properties, that are set in the configuration-section + of the plugin-configuration cannnot be overwritten elsewere (for details + see Configuration-Method-Precedence). + You never can overwrite them by accident when specifying a property on + the commandline or in your settings.xml. +
+Configuration through maven-properties
+ ++ Alternatively, it is possible, to configure the plugin via maven-properties. + Each relevant configuration-option has a corresponding maven-property + (for a full list see the Documentation of the goal create). + These are named after the + Hibernate JDBC Properties: +
+ +-
+
+
- hibernate.connection.driver_class + +
- hibernate.dialect + +
- hibernate.connection.url + +
- hibernate.connection.username + +
- hibernate.connection.password +
+ So, instead of writing the hibernate-configuration in the properties-file, + like above, you could put it in the properties-section of your + pom.xml. +
+ ++ Thogether with the plugin-definition from above, the following would + be a complete configuration (again, the database-url was overwritten in + the plugin-configuration, to be sure to have a separate database for + testing): +
+ ++<properties> + <hibernate.connection.driver_class>org.hsqldb.jdbcDriver</hibernate.connection.driver_class> + <hibernate.dialect>org.hibernate.dialect.HSQLDialect</hibernate.dialect> + <hibernate.connection.url><![CDATA[jdbc:hsqldb:res:org.my.path.production_db]]></hibernate.connection.url> + <hibernate.connection.username>sa</hibernate.connection.username> + <hibernate.connection.password></hibernate.connection.password> +</properties> + +... + +<plugins> + + ... + + <plugin> + <groupId>de.juplo</groupId> + <artifactId>hibernate-maven-plugin</artifactId> + <version>2.1.0</version> + <executions> + <execution> + <goals> + <goal>drop</goal> + <goal>create</goal> + </goals> + </execution> + </executions> + <configuration> + <url><![CDATA[jdbc:hsqldb:target/db/testdb;shutdown=true]]></url> + </configuration> + </plugin> + +<plugins>
+ This way, you can reuse the same properties to provide a + default-configurationthe, that is build into your application, and + overwrite the database-url, that is used during testing to prevent + accidential drops of your production database. +
+Configuration through the plugin-configuration
+ ++ A third way for configuring the plugin is the plugin-configuration. + The relevant configuration-parameters are: +
+ +-
+
+
- driver + +
- dialect + +
- url + +
- username + +
- password +
+ The equivalent of the configuration from the last section would look + like this: +
+ ++<plugin> + <groupId>de.juplo</groupId> + <artifactId>hibernate-maven-plugin</artifactId> + <version>2.1.0</version> + <executions> + <execution> + <goals> + <goal>drop</goal> + <goal>create</goal> + </goals> + </execution> + </executions> + <configuration> + <driver>org.hsqldb.jdbcDriver</driver> + <dialect>org.hibernate.dialect.HSQLDialect</dialect> + <url><![CDATA[jdbc:hsqldb:target/db/fotos;shutdown=true]]></url> + <username>sa</username> + <password></password> + </configuration> +</plugin>
+ The parameter hibernateProperties (name of the hibernate-properties-file + to use, defaults to hibernate.properties) can only be configured through + this approach. +
+ ++ For more explanations, see the + Documentation of the goal create. +
+Configuration-Method-Precedence
+ ++ The configuration is gathered in a fix order: +
+ +-
+
+
- hibernate.properties + +
- hibernate.cfg.xml + +
- persistence.xml + +
- maven-properties + +
- plugin-configuration +
+ If you are in doubt about where a configuration-value comes from, run + maven with the debug-output enabled: mvn -X hibernate:create + and be aware, that maven-properties can be overwitten on the command-line, + in your ~/.m2/settings.xml and in a profile. +
+ ++ The plugin-configuration comes last and overwrites everything else. + That way, you can be sure, that a configuration-value, that is + specified in the plugin-configuration will never be overwritten by any + other configuration-method. +
+ ++ If you need to overwrite plugin-configuration-values with + maven-properties, you can use maven-properties in the plugin-configuration: +
+ ++<plugin> + <groupId>de.juplo</groupId> + <artifactId>hibernate-maven-plugin</artifactId> + <version>2.1.0</version> + <executions> + <execution> + <goals> + <goal>drop</goal> + <goal>create</goal> + </goals> + </execution> + </executions> + <configuration> + <password>${my-password-property}</password> + </configuration> +</plugin>