Path

  1. Hibernate 4 Maven Plugin
  2. Parameter Documentation


hibernate4:export

Full name:

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

Description:

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

Attributes:

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: true.
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.
hibernateConfig String 1.1.0 Path to Hibernate configuration file (.cfg.xml). Settings in this file will overwrite settings in the properties file. If this parameter is not set the plugin will try to load the configuration from a file hibernate.cfg.xml on the classpath. The test-classpath takes precedence.
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 properties file. If this parameter is not set the plugin will try to load the configuration from a file hibernate.properties on the classpath. The test-classpath takes precedence.
outputDirectory String 1.0 Classes-Directory to scan.

This parameter defaults to the maven build-output-directory for classes. Additionally, 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.
persistenceUnit String 1.1.0 Name of the persistence-unit. If there is only one persistence-unit available, that unit will be used automatically. Settings in this file will overwrite settings in the properties or the configuration file.
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.

If you do not want any dependencies to be scanned for annotated classes, set this parameter to none.

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 Whether 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 execution is signaled via the maven-property ${hibernate.export.skipped}.

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


Default value is: ${maven.test.skip}.
User property is: hibernate.skip.
target String 1.0 Target of execution:
  • NONE only export schema to SQL-script (forces execution, signals skip)
  • EXPORT create database (DEFAULT!). forces execution, signals skip)
  • SCRIPT export schema to SQL-script and print it to STDOUT
  • BOTH
A database connection is only needed for EXPORT and BOTH, but a Hibernate-Dialect must always be chosen.
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: true

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

hibernateConfig:

Path to Hibernate configuration file (.cfg.xml). Settings in this file will overwrite settings in the properties file. If this parameter is not set the plugin will try to load the configuration from a file hibernate.cfg.xml on the classpath. The test-classpath takes precedence.
  • Type: java.lang.String
  • Since: 1.1.0
  • Required: No

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 properties file. If this parameter is not set the plugin will try to load the configuration from a file hibernate.properties on the classpath. The test-classpath takes precedence.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No

outputDirectory:

Classes-Directory to scan.

This parameter defaults to the maven build-output-directory for classes. Additionally, 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

persistenceUnit:

Name of the persistence-unit. If there is only one persistence-unit available, that unit will be used automatically. Settings in this file will overwrite settings in the properties or the configuration file.
  • Type: java.lang.String
  • Since: 1.1.0
  • Required: No

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.

If you do not want any dependencies to be scanned for annotated classes, set this parameter to none.

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:

Whether 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 execution is signaled via the maven-property ${hibernate.export.skipped}.

The execution 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: hibernate.skip
  • Default: ${maven.test.skip}

target:

Target of execution:
  • NONE only export schema to SQL-script (forces execution, signals skip)
  • EXPORT create database (DEFAULT!). forces execution, signals skip)
  • SCRIPT export schema to SQL-script and print it to STDOUT
  • BOTH
A database connection is only needed for EXPORT and BOTH, but a Hibernate-Dialect must always be chosen.
  • 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

Pages