Hibernate 4 Maven Plugin - Parameter Documentation

hibernate4:export

Full name:

de.juplo:hibernate4-maven-plugin:1.0.3:export

Description:

Goal which extracts the hibernate-mapping-configuration and exports an according SQL-database-schema.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: runtime.
  • The goal is thread-safe and supports parallel builds.
  • Binds by default to the lifecycle phase: process-classes.

Optional Parameters

Name Type Since Description
delimiter String 1.0 Delimiter in output-file.
Default value is: ;.
User property is: hibernate.export.schema.delimiter.
driverClassName String 1.0 SQL-Driver name.
User property is: hibernate.connection.driver_class.
envers boolean 1.0.3 Generate envers schema for auditing tables.
Default value is: false.
User property is: hibernate.export.envers.
force boolean 1.0 Force execution

Force execution, even if no modified or newly added annotated classes where found and the dialect was not changed.

skip takes precedence over force.


Default value is: false.
User property is: hibernate.export.force.
format boolean 1.0 Format output-file.
Default value is: true.
User property is: hibernate.export.schema.format.
hibernateDialect String 1.0 Hibernate dialect.
User property is: hibernate.dialect.
hibernateMapping String 1.0.2 List of Hibernate-Mapping-Files (XML). Multiple files can be separated with white-spaces and/or commas.
User property is: hibernate.mapping.
hibernateNamingStrategy String 1.0.2 Hibernate Naming Strategy
User property is: hibernate.ejb.naming_strategy.
hibernateProperties String 1.0 Path to Hibernate configuration file.
Default value is: ${project.build.outputDirectory}/hibernate.properties.
outputDirectory String 1.0 Classes-Directory to scan.

This parameter defaults to the maven build-output-directory for classes. Additonally, all dependencies are scanned for annotated classes.


User property is: project.build.outputDirectory.
outputFile String 1.0 Output file.
Default value is: ${project.build.directory}/schema.sql.
User property is: hibernate.export.schema.filename.
password String 1.0 Database password
User property is: hibernate.connection.password.
scanDependencies String 1.0.3 Dependency-Scopes, that should be scanned for annotated classes.

By default, only dependencies in the scope compile are scanned for annotated classes. Multiple scopes can be seperated by white space or commas.

The plugin does not scan for annotated classes in transitive dependencies. If some of your annotated classes are hidden in a transitive dependency, you can simply add that dependency explicitly.


Default value is: compile.
User property is: hibernate.export.scan_dependencies.
scanTestClasses boolean 1.0.1 Wether to scan test-classes too, or not.

If this parameter is set to true the test-classes of the artifact will be scanned for hibernate-annotated classes additionally.


Default value is: false.
User property is: hibernate.export.scan_testclasses.
skip boolean 1.0 Skip execution

If set to true, the execution is skipped.

A skipped excecution is signaled via the maven-property ${hibernate.export.skipped}.

The excecution is skipped automatically, if no modified or newly added annotated classes are found and the dialect was not changed.


Default value is: false.
User property is: maven.test.skip.
target String 1.0 Target of execution:
  • NONE only export schema to SQL-script (forces excecution, signals skip)
  • EXPORT create database (DEFAULT!). forces excecution, signals skip)
  • SCRIPT export schema to SQL-script and print it to STDOUT
  • BOTH
A databaseconnection is only needed for EXPORT and BOTH, but a Hibernate-Dialect must always be choosen.
Default value is: EXPORT.
User property is: hibernate.export.target.
testOutputDirectory String 1.0.2 Test-Classes-Directory to scan.

This parameter defaults to the maven build-output-directory for test-classes.

This parameter is only used, when scanTestClasses is set to true!


User property is: project.build.testOutputDirectory.
type String 1.0 Type of execution.
  • NONE do nothing - just validate the configuration
  • CREATE create database-schema
  • DROP drop database-schema
  • BOTH (DEFAULT!)
If NONE is choosen, no databaseconnection is needed.
Default value is: BOTH.
User property is: hibernate.export.type.
url String 1.0 Database URL.
User property is: hibernate.connection.url.
username String 1.0 Database username
User property is: hibernate.connection.username.

Parameter Details

delimiter:

Delimiter in output-file.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.export.schema.delimiter
  • Default: ;

driverClassName:

SQL-Driver name.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.connection.driver_class

envers:

Generate envers schema for auditing tables.
  • Type: boolean
  • Since: 1.0.3
  • Required: No
  • User Property: hibernate.export.envers
  • Default: false

force:

Force execution

Force execution, even if no modified or newly added annotated classes where found and the dialect was not changed.

skip takes precedence over force.

  • Type: boolean
  • Since: 1.0
  • Required: No
  • User Property: hibernate.export.force
  • Default: false

format:

Format output-file.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • User Property: hibernate.export.schema.format
  • Default: true

hibernateDialect:

Hibernate dialect.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.dialect

hibernateMapping:

List of Hibernate-Mapping-Files (XML). Multiple files can be separated with white-spaces and/or commas.
  • Type: java.lang.String
  • Since: 1.0.2
  • Required: No
  • User Property: hibernate.mapping

hibernateNamingStrategy:

Hibernate Naming Strategy
  • Type: java.lang.String
  • Since: 1.0.2
  • Required: No
  • User Property: hibernate.ejb.naming_strategy

hibernateProperties:

Path to Hibernate configuration file.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Default: ${project.build.outputDirectory}/hibernate.properties

outputDirectory:

Classes-Directory to scan.

This parameter defaults to the maven build-output-directory for classes. Additonally, all dependencies are scanned for annotated classes.

  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: project.build.outputDirectory

outputFile:

Output file.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.export.schema.filename
  • Default: ${project.build.directory}/schema.sql

password:

Database password
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.connection.password

scanDependencies:

Dependency-Scopes, that should be scanned for annotated classes.

By default, only dependencies in the scope compile are scanned for annotated classes. Multiple scopes can be seperated by white space or commas.

The plugin does not scan for annotated classes in transitive dependencies. If some of your annotated classes are hidden in a transitive dependency, you can simply add that dependency explicitly.

  • Type: java.lang.String
  • Since: 1.0.3
  • Required: No
  • User Property: hibernate.export.scan_dependencies
  • Default: compile

scanTestClasses:

Wether to scan test-classes too, or not.

If this parameter is set to true the test-classes of the artifact will be scanned for hibernate-annotated classes additionally.

  • Type: boolean
  • Since: 1.0.1
  • Required: No
  • User Property: hibernate.export.scan_testclasses
  • Default: false

skip:

Skip execution

If set to true, the execution is skipped.

A skipped excecution is signaled via the maven-property ${hibernate.export.skipped}.

The excecution is skipped automatically, if no modified or newly added annotated classes are found and the dialect was not changed.

  • Type: boolean
  • Since: 1.0
  • Required: No
  • User Property: maven.test.skip
  • Default: false

target:

Target of execution:
  • NONE only export schema to SQL-script (forces excecution, signals skip)
  • EXPORT create database (DEFAULT!). forces excecution, signals skip)
  • SCRIPT export schema to SQL-script and print it to STDOUT
  • BOTH
A databaseconnection is only needed for EXPORT and BOTH, but a Hibernate-Dialect must always be choosen.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.export.target
  • Default: EXPORT

testOutputDirectory:

Test-Classes-Directory to scan.

This parameter defaults to the maven build-output-directory for test-classes.

This parameter is only used, when scanTestClasses is set to true!

  • Type: java.lang.String
  • Since: 1.0.2
  • Required: No
  • User Property: project.build.testOutputDirectory

type:

Type of execution.
  • NONE do nothing - just validate the configuration
  • CREATE create database-schema
  • DROP drop database-schema
  • BOTH (DEFAULT!)
If NONE is choosen, no databaseconnection is needed.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.export.type
  • Default: BOTH

url:

Database URL.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.connection.url

username:

Database username
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • User Property: hibernate.connection.username