3 <!-- Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-06-02 -->
27 <!-- NEW PAGE - - - - - uri: integration.html -->
39 <!-- NEW PAGE - - - - - uri: dependencies.html -->
51 <!-- NEW PAGE - - - - - uri: dependency-info.html -->
63 <!-- NEW PAGE - - - - - uri: distribution-management.html -->
75 <!-- NEW PAGE - - - - - uri: index.html -->
87 <!-- NEW PAGE - - - - - uri: license.html -->
99 <!-- NEW PAGE - - - - - uri: plugin-management.html -->
111 <!-- NEW PAGE - - - - - uri: plugins.html -->
123 <!-- NEW PAGE - - - - - uri: team-list.html -->
135 <!-- NEW PAGE - - - - - uri: source-repository.html -->
147 <!-- NEW PAGE - - - - - uri: project-summary.html -->
154 <!-- NEW PAGE - - - - - uri: project-info.html -->
171 <!-- NEW PAGE - - - - - uri: testapidocs/index.html -->
183 <!-- NEW PAGE - - - - - uri: apidocs/index.html -->
195 <!-- NEW PAGE - - - - - uri: xref/index.html -->
207 <!-- NEW PAGE - - - - - uri: xref-test/index.html -->
219 <!-- NEW PAGE - - - - - uri: cpd.html -->
231 <!-- NEW PAGE - - - - - uri: pmd.html -->
243 <!-- NEW PAGE - - - - - uri: plugin-info.html -->
250 <!-- NEW PAGE - - - - - uri: project-reports.html -->
255 <!-- DONE WITH MENUE - - $page.name-->
270 <!-- OVERWRITING PAGE - uri: index.html -->
282 <!-- NEW PAGE - - - - - uri: configuration.html -->
294 <!-- NEW PAGE - - - - - uri: create-mojo.html -->
306 <!-- NEW PAGE - - - - - uri: drop-mojo.html -->
318 <!-- NEW PAGE - - - - - uri: debugging.html -->
330 <!-- NEW PAGE - - - - - uri: skip.html -->
342 <!-- NEW PAGE - - - - - uri: force.html -->
354 <!-- NEW PAGE - - - - - uri: pitfalls.html -->
366 <!-- OVERWRITING PAGE - uri: project-info.html -->
378 <!-- OVERWRITING PAGE - uri: project-reports.html -->
383 <!-- DONE WITH MENUE - - (no name)-->
387 <!-- name: Known Pitfalls (FAQ) -->
388 <!-- title: Hibernate Maven Plugin – -->
389 <!-- short title: -->
390 <!-- current page: pitfalls.html -->
391 <!-- path: /hibernate-maven-plugin/ -->
392 <!-- crumbs: {"uri":"/projects.html","name":"Projects"} -->
393 <!-- pages: {integration.html={name=CI Management, uri=integration.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=integration.html, name=CI Management}]}, dependencies.html={name=Dependencies, uri=dependencies.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=dependencies.html, name=Dependencies}]}, dependency-info.html={name=Dependency Information, uri=dependency-info.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=dependency-info.html, name=Dependency Information}]}, distribution-management.html={name=Distribution Management, uri=distribution-management.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=distribution-management.html, name=Distribution Management}]}, index.html={name=Overview, uri=index.html, childs={index.html=Overview, configuration.html=Configuration Examples, create-mojo.html=Goal: CREATE, drop-mojo.html=Goal: DROP, debugging.html=Enable Debugging-Output, skip.html=Skipping Execution, force.html=Force Exceution, pitfalls.html=Known Pitfalls (FAQ), project-info.html=Project Information, project-reports.html=Project Reports}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=index.html, name=Overview}]}, license.html={name=Licenses, uri=license.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=license.html, name=Licenses}]}, plugin-management.html={name=Plugin Management, uri=plugin-management.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=plugin-management.html, name=Plugin Management}]}, plugins.html={name=Plugins, uri=plugins.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=plugins.html, name=Plugins}]}, team-list.html={name=Team, uri=team-list.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=team-list.html, name=Team}]}, source-repository.html={name=Source Code Management, uri=source-repository.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=source-repository.html, name=Source Code Management}]}, project-summary.html={name=Summary, uri=project-summary.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}, {uri=project-summary.html, name=Summary}]}, project-info.html={name=Project Information, uri=project-info.html, childs={integration.html=CI Management, dependencies.html=Dependencies, dependency-info.html=Dependency Information, distribution-management.html=Distribution Management, index.html=About, license.html=Licenses, plugin-management.html=Plugin Management, plugins.html=Plugins, team-list.html=Team, source-repository.html=Source Code Management, project-summary.html=Summary}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-info.html, name=Project Information}]}, testapidocs/index.html={name=Test JavaDocs, uri=testapidocs/index.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}, {uri=testapidocs/index.html, name=Test JavaDocs}]}, apidocs/index.html={name=JavaDocs, uri=apidocs/index.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}, {uri=apidocs/index.html, name=JavaDocs}]}, xref/index.html={name=Source Xref, uri=xref/index.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}, {uri=xref/index.html, name=Source Xref}]}, xref-test/index.html={name=Test Source Xref, uri=xref-test/index.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}, {uri=xref-test/index.html, name=Test Source Xref}]}, cpd.html={name=CPD, uri=cpd.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}, {uri=cpd.html, name=CPD}]}, pmd.html={name=PMD, uri=pmd.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}, {uri=pmd.html, name=PMD}]}, plugin-info.html={name=Plugin Documentation, uri=plugin-info.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}, {uri=plugin-info.html, name=Plugin Documentation}]}, project-reports.html={name=Project Reports, uri=project-reports.html, childs={testapidocs/index.html=Test JavaDocs, apidocs/index.html=JavaDocs, xref/index.html=Source Xref, xref-test/index.html=Test Source Xref, cpd.html=CPD, pmd.html=PMD, plugin-info.html=Plugin Documentation}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=project-reports.html, name=Project Reports}]}, configuration.html={name=Configuration Examples, uri=configuration.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=configuration.html, name=Configuration Examples}]}, create-mojo.html={name=Goal: CREATE, uri=create-mojo.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=create-mojo.html, name=Goal: CREATE}]}, drop-mojo.html={name=Goal: DROP, uri=drop-mojo.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=drop-mojo.html, name=Goal: DROP}]}, debugging.html={name=Enable Debugging-Output, uri=debugging.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=debugging.html, name=Enable Debugging-Output}]}, skip.html={name=Skipping Execution, uri=skip.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=skip.html, name=Skipping Execution}]}, force.html={name=Force Exceution, uri=force.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=force.html, name=Force Exceution}]}, pitfalls.html={name=Known Pitfalls (FAQ), uri=pitfalls.html, childs={}, crumbs=[{uri=index.html, name=Hibernate Maven Plugin}, {uri=pitfalls.html, name=Known Pitfalls (FAQ)}]}} -->
398 xmlns="http://www.w3.org/1999/xhtml"
399 xmlns:layout="http://www.thymeleaf.org"
400 layout:decorator="templates/layout"
402 uri='/hibernate-maven-plugin/pitfalls.html',
403 json='MERGE:{"pages":{"/hibernate-maven-plugin/integration.html":{"name":"CI Management","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/integration.html","name":"CI Management"}]},"/hibernate-maven-plugin/dependencies.html":{"name":"Dependencies","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/dependencies.html","name":"Dependencies"}]},"/hibernate-maven-plugin/dependency-info.html":{"name":"Dependency Information","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/dependency-info.html","name":"Dependency Information"}]},"/hibernate-maven-plugin/distribution-management.html":{"name":"Distribution Management","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/distribution-management.html","name":"Distribution Management"}]},"/hibernate-maven-plugin/index.html":{"name":"Overview","childs":{"/hibernate-maven-plugin/index.html":"Overview","/hibernate-maven-plugin/configuration.html":"Configuration Examples","/hibernate-maven-plugin/create-mojo.html":"Goal: CREATE","/hibernate-maven-plugin/drop-mojo.html":"Goal: DROP","/hibernate-maven-plugin/debugging.html":"Enable Debugging-Output","/hibernate-maven-plugin/skip.html":"Skipping Execution","/hibernate-maven-plugin/force.html":"Force Exceution","/hibernate-maven-plugin/pitfalls.html":"Known Pitfalls (FAQ)","/hibernate-maven-plugin/project-info.html":"Project Information","/hibernate-maven-plugin/project-reports.html":"Project Reports"},"crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/index.html","name":"Overview"}]},"/hibernate-maven-plugin/license.html":{"name":"Licenses","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/license.html","name":"Licenses"}]},"/hibernate-maven-plugin/plugin-management.html":{"name":"Plugin Management","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/plugin-management.html","name":"Plugin Management"}]},"/hibernate-maven-plugin/plugins.html":{"name":"Plugins","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/plugins.html","name":"Plugins"}]},"/hibernate-maven-plugin/team-list.html":{"name":"Team","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/team-list.html","name":"Team"}]},"/hibernate-maven-plugin/source-repository.html":{"name":"Source Code Management","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/source-repository.html","name":"Source Code Management"}]},"/hibernate-maven-plugin/project-summary.html":{"name":"Summary","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"},{"uri":"/hibernate-maven-plugin/project-summary.html","name":"Summary"}]},"/hibernate-maven-plugin/project-info.html":{"name":"Project Information","childs":{"/hibernate-maven-plugin/integration.html":"CI Management","/hibernate-maven-plugin/dependencies.html":"Dependencies","/hibernate-maven-plugin/dependency-info.html":"Dependency Information","/hibernate-maven-plugin/distribution-management.html":"Distribution Management","/hibernate-maven-plugin/index.html":"About","/hibernate-maven-plugin/license.html":"Licenses","/hibernate-maven-plugin/plugin-management.html":"Plugin Management","/hibernate-maven-plugin/plugins.html":"Plugins","/hibernate-maven-plugin/team-list.html":"Team","/hibernate-maven-plugin/source-repository.html":"Source Code Management","/hibernate-maven-plugin/project-summary.html":"Summary"},"crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-info.html","name":"Project Information"}]},"/hibernate-maven-plugin/testapidocs/index.html":{"name":"Test JavaDocs","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"},{"uri":"/hibernate-maven-plugin/testapidocs/index.html","name":"Test JavaDocs"}]},"/hibernate-maven-plugin/apidocs/index.html":{"name":"JavaDocs","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"},{"uri":"/hibernate-maven-plugin/apidocs/index.html","name":"JavaDocs"}]},"/hibernate-maven-plugin/xref/index.html":{"name":"Source Xref","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"},{"uri":"/hibernate-maven-plugin/xref/index.html","name":"Source Xref"}]},"/hibernate-maven-plugin/xref-test/index.html":{"name":"Test Source Xref","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"},{"uri":"/hibernate-maven-plugin/xref-test/index.html","name":"Test Source Xref"}]},"/hibernate-maven-plugin/cpd.html":{"name":"CPD","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"},{"uri":"/hibernate-maven-plugin/cpd.html","name":"CPD"}]},"/hibernate-maven-plugin/pmd.html":{"name":"PMD","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"},{"uri":"/hibernate-maven-plugin/pmd.html","name":"PMD"}]},"/hibernate-maven-plugin/plugin-info.html":{"name":"Plugin Documentation","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"},{"uri":"/hibernate-maven-plugin/plugin-info.html","name":"Plugin Documentation"}]},"/hibernate-maven-plugin/project-reports.html":{"name":"Project Reports","childs":{"/hibernate-maven-plugin/testapidocs/index.html":"Test JavaDocs","/hibernate-maven-plugin/apidocs/index.html":"JavaDocs","/hibernate-maven-plugin/xref/index.html":"Source Xref","/hibernate-maven-plugin/xref-test/index.html":"Test Source Xref","/hibernate-maven-plugin/cpd.html":"CPD","/hibernate-maven-plugin/pmd.html":"PMD","/hibernate-maven-plugin/plugin-info.html":"Plugin Documentation"},"crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/project-reports.html","name":"Project Reports"}]},"/hibernate-maven-plugin/configuration.html":{"name":"Configuration Examples","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/configuration.html","name":"Configuration Examples"}]},"/hibernate-maven-plugin/create-mojo.html":{"name":"Goal: CREATE","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/create-mojo.html","name":"Goal: CREATE"}]},"/hibernate-maven-plugin/drop-mojo.html":{"name":"Goal: DROP","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/drop-mojo.html","name":"Goal: DROP"}]},"/hibernate-maven-plugin/debugging.html":{"name":"Enable Debugging-Output","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/debugging.html","name":"Enable Debugging-Output"}]},"/hibernate-maven-plugin/skip.html":{"name":"Skipping Execution","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/skip.html","name":"Skipping Execution"}]},"/hibernate-maven-plugin/force.html":{"name":"Force Exceution","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/force.html","name":"Force Exceution"}]},"/hibernate-maven-plugin/pitfalls.html":{"name":"Known Pitfalls (FAQ)","crumbs":[{"uri":"/projects.html","name":"Projects"},{"uri":"/hibernate-maven-plugin/index.html","name":"Hibernate Maven Plugin"},{"uri":"/hibernate-maven-plugin/pitfalls.html","name":"Known Pitfalls (FAQ)"}]}}}'
407 <title>Hibernate Maven Plugin — Known Pitfalls (FAQ)</title>
408 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
409 <link rel="canonical" href="/hibernate-maven-plugin/pitfalls.html"/>
415 <li><a href="index.html">Hibernate Maven Plugin</a></li><li><a href="pitfalls.html">Known Pitfalls (FAQ)</a></li> </ol>
418 <article class="main" layout:fragment="maincontent">
423 <h1>Known Pitfalls (FAQ)</h1>
425 <div class="section">
426 <h2><a name="Annotated_classes_in_dependencies_are_not_found."></a>Annotated classes in dependencies are not found.</h2>
429 hibernate-maven-plugin by default scans dependencies in the scope
430 <tt>compile</tt>. You can configure it to scan dependencies in other
431 scopes as well. But it scans only direct dependencies. Transitive
432 dependencies are not scanned for annotated classes. If some of your
433 annotated classes are hidden in a transitive dependency, you can simply
434 add that dependency explicitly.
437 <div class="section">
438 <h2><a name="hibernate-maven-plugin_always_needs_a_database-connection"></a>hibernate-maven-plugin always needs a database-connection</h2>
441 The default-configuration executes the created SQL.
442 Therefore, it needs a valid database-connection and fails, if none is
444 If you do not need the generated SQL to be executed automatically,
445 you can set the property <tt>hibernate.schema.execute</tt> to
447 This can be achieved with the command-line parameter
448 <tt>-Dhibernate.schema.execute=false</tt> or with the following
453 <pre class="prettyprint linenums lang-html">
454 <configuration>
455 <execute>false</execute>
456 </configuration></pre></div>
459 But even when no database is to be created, hibernate always needs to know
460 the dialect. Hence, the plugin will still fail, if this parameter is also
464 <div class="section">
465 <h2><a name="Dependency_for_driver-class_XYZ_is_missing"></a>Dependency for driver-class XYZ is missing</h2>
468 One regular problem is the scope of the jdbc-driver-dependency.
469 It is very unlikely, that this dependency is needed at compile-time.
470 So a tidy maven-developer would usually scope it for <tt>runtime</tt>.
474 But this will break the execution of the <tt>hibernate-maven-plugin</tt>.
475 Since it will not be able to see the needed dependency, it will fail with
476 an error-message like:
480 <pre class="prettyprint">
481 [INFO] Gathered hibernate-configuration (turn on debugging for details):
482 [INFO] hibernate.connection.username = sa
483 [INFO] hibernate.connection.password =
484 [INFO] hibernate.dialect = org.hibernate.dialect.H2Dialect
485 [INFO] hibernate.connection.url = jdbc:h2:file:./db
486 [INFO] hibernate.hbm2dll.create_namespaces = false
487 [INFO] hibernate.connection.driver_class = org.h2.Driver
488 [INFO] hibernate.format_sql = true
489 [INFO] HHH000412: Hibernate Core {5.0.2.Final}
490 [INFO] HHH000206: hibernate.properties not found
491 [INFO] HHH000021: Bytecode provider name : javassist
492 [INFO] Adding /home/kai/project/target/classes to the list of roots to scan...
493 [INFO] Adding dependencies from scope compile to the list of roots to scan
494 [INFO] Adding dependencies from scope org.hibernate:hibernate-core:jar:4.3.0.Final to the list of roots to scan
495 [INFO] Adding annotated resource: de.juplo.tests.SimplestMavenHib4Test
496 [INFO] ------------------------------------------------------------------------
498 [INFO] ------------------------------------------------------------------------
499 [INFO] Total time: 1.760s
500 [INFO] Finished at: Mon Mar 07 19:06:54 CET 2016
501 [INFO] Final Memory: 11M/215M
502 [INFO] ------------------------------------------------------------------------
503 [ERROR] Failed to execute goal de.juplo:hibernate-maven-plugin:2.1.0:drop (default) on project hibernate4-properties-test: Could not open the JDBC-connection: Unable to load class [org.h2.Driver]: Could not load requested class : org.h2.Driver -> [Help 1]
505 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
506 [ERROR] Re-run Maven using the -X switch to enable full debug logging.
508 [ERROR] For more information about the errors and possible solutions, please read the following articles:
509 [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException</pre></div>
512 A quick workaround for this error would be, to delete the runtime-constraint
513 for the jdbc-driver-dependency.
517 A much cleaner way is, to (additionally) ad the dependency, to the
522 <pre class="prettyprint linenums lang-html">
524 <groupId>de.juplo</groupId>
525 <artifactId>hibernate-maven-plugin</artifactId>
526 <version>2.1.0</version>
530 <goal>drop</goal>
531 <goal>create</goal>
537 <groupId>org.hsqldb</groupId>
538 <artifactId>hsqldb</artifactId>
539 <version>2.2.8</version>
541 </dependencies>
542 </plugin></pre></div>
545 This is also the best way, if you use a different jdbc-driver for
546 testing, than in production.
547 Because otherwise, this dependency will unnecessarily bloat the
548 runtime-dependencies of your project.
551 <div class="section" id="fails">
552 <h2 id="fails">DBUnit fails after execution of hibernate was skipped because nothing has changed</h2>
555 If hibernate-maven-plugin skips its excecution, this may lead to errors in
557 For example, when importing sample-data in the automatically created database
558 with the help of the <a class="externalLink" href="http://mojo.codehaus.org/dbunit-maven-plugin/">dbunit-plugin</a>,
559 the <tt>CLEAN_INSERT</tt>-operation may fail because of foreign-key-constraints,
560 if the database was not recreated, because the hibernate-maven-plugin has
561 skipped its excecution.
565 A quick fix to this problem is, to <a href="./force.html">force</a>
566 hibernate-maven-plugin to generate and execute the SQL every time it is running.
567 But to recreate the database on every testrun may noticeable slow down your
568 development cycle, if you have to wait for slow IO.
572 To circumvent this problem, hibernate-maven-plugin signals a skipped
573 excecution by setting the maven property <tt>${hibernate.schema.skipped}</tt> to
575 You can configure other plugins to react on this signal.
576 For example, the dbunit-plugin can be configured to skip its excecution, if
577 hibernate-maven-plugin was skipped like this:
581 <pre class="prettyprint linenums lang-html">
583 <groupId>org.codehaus.mojo</groupId>
584 <artifactId>dbunit-maven-plugin</artifactId>
585 <configuration>
586 <skip>${hibernate.schema.skipped}</skip>
587 </configuration>
588 </plugin></pre></div>
590 <div class="section">
591 <h2><a name="The_database_will_not_be_recreated_after_a_manual_dropclean"></a>The database will not be recreated after a manual drop/clean</h2>
594 If one manually drops the database or removes the hsqldb-files, it will not
595 be recreated by the hibernate-maven-plugin, because it cannot detect, that
596 the database needs to be recreated.
597 This happens, because the plugin will not recreate the database if neither
598 the configuration nor the annotated classes have changed, because an
599 unnecessary drop-create-cycle might take a long time. The plugin will
600 report that like this:
604 <pre class="prettyprint">
605 [INFO] No modified annotated classes found and dialect unchanged.
606 [INFO] Skipping schema generation!</pre></div>
609 If one always uses <tt>mvn clean</tt> for cleanup, this will not happen.
610 Otherwise the recreation must be <a href="./force.html">forced</a>:
614 <pre class="prettyprint">
615 mvn hibernate:create -Dhibernate.schema.force=true</pre></div>
617 <div class="section">
618 <h2><a name="The_hibernate:create_goal_is_not_executed_when_tests_are_skipped"></a>The hibernate:create goal is not executed, when tests are skipped</h2>
621 The hibernate-maven-plugin automatically skips its execution, when
622 <tt>maven.test.skip</tt> is set to <tt>true</tt>. If you need it to be always
623 executed, you can configure that explicitly like this:
627 <pre class="prettyprint linenums lang-html">
629 <groupId>de.juplo</groupId>
630 <artifactId>hibernate-maven-plugin</artifactId>
632 <configuration>
633 <skip>false</skip>
634 </configuration>
635 </plugin></pre></div>
638 Background-information for this design-decission can be found on the extra
639 page <a href="./skip.html">To skip or not to skip: that is the question</a>...
642 <div class="section">
643 <h2><a name="I_do_not_want_my_dependencies_to_be_scanned_for_hibernate_annotations"></a>I do not want my dependencies to be scanned for hibernate annotations</h2>
646 If you do not want your dependencies to be scanned for hibernate annotations,
647 you can pass <tt>-Dhibernate.schema.scan.dependencies=none</tt> to maven
648 or set <tt>scanDependencies</tt> to <tt>none</tt> in the configuration
649 of the plugin like this:
653 <pre class="prettyprint linenums lang-html">
655 <groupId>de.juplo</groupId>
656 <artifactId>hibernate-maven-plugin</artifactId>
658 <configuration>
659 <scanDependencies>none</scanDependencies>
660 </configuration>
661 </plugin></pre></div>
663 <div class="section">
664 <h2><a name="No_annotated_classes_found"></a>No annotated classes found</h2>
667 If you are working under Windows and get the error-message
668 <tt>No annotated classes found in directory C:\projects\X Y Z\path-to-project\target\classes</tt>,
669 but you are really sure, that there are annotated classes in that
670 directory, you are expiriencing a bug, in the scannotation-library, that
671 was closed in version 1.1.0 of the hibernate-maven-plugin.
676 You should consider to upgrade to the latest version of the plugin.
680 <div class="section">
681 <h2><a name="If_two_goals_are_specified_the_second_one_is_always_skipped"></a>If two goals are specified, the second one is always skipped</h2>
684 If you specify two goals, for example <tt>drop</tt> and
685 <tt>create</tt>, each goal has to be specified in its own
686 <tt>execution</tt>, so that you can specify two different
687 output-files for the two goals.
688 Otherwise, both goals will use the same output-file and the goal, that
689 is run second, will always skip, becaus it will find, that the output
690 file already exists and conclude, that its work was already done in a
695 Example configuration for two goals:
699 <pre class="prettyprint linenums lang-html">
702 <id>Create Drop-Schema</id>
703 <phase>test-compile</phase>
705 <goal>drop</goal>
707 <configuration>
708 <outputFile>db-schema/drop-schema.ddl</outputFile>
709 </configuration>
712 <id>Create Create-Schema</id>
713 <phase>test-compile</phase>
715 <goal>create</goal>
717 <configuration>
718 <outputFile>db-schema/create-schema.ddl</outputFile>
719 </configuration>
721 </executions></pre></div>
729 <li><a href="integration.html">CI Management</a></li><li><a href="dependencies.html">Dependencies</a></li><li><a href="dependency-info.html">Dependency Information</a></li><li><a href="distribution-management.html">Distribution Management</a></li><li><a href="index.html">Overview</a></li><li><a href="license.html">Licenses</a></li><li><a href="plugin-management.html">Plugin Management</a></li><li><a href="plugins.html">Plugins</a></li><li><a href="team-list.html">Team</a></li><li><a href="source-repository.html">Source Code Management</a></li><li><a href="project-summary.html">Summary</a></li><li><a href="project-info.html">Project Information</a></li><li><a href="testapidocs/index.html">Test JavaDocs</a></li><li><a href="apidocs/index.html">JavaDocs</a></li><li><a href="xref/index.html">Source Xref</a></li><li><a href="xref-test/index.html">Test Source Xref</a></li><li><a href="cpd.html">CPD</a></li><li><a href="pmd.html">PMD</a></li><li><a href="plugin-info.html">Plugin Documentation</a></li><li><a href="project-reports.html">Project Reports</a></li><li><a href="configuration.html">Configuration Examples</a></li><li><a href="create-mojo.html">Goal: CREATE</a></li><li><a href="drop-mojo.html">Goal: DROP</a></li><li><a href="debugging.html">Enable Debugging-Output</a></li><li><a href="skip.html">Skipping Execution</a></li><li><a href="force.html">Force Exceution</a></li><li><a href="pitfalls.html">Known Pitfalls (FAQ)</a></li> </ul>