+++ /dev/null
-<!DOCTYPE html>
-<!-- Generated by Apache Maven Doxia Site Renderer at Nov 10, 2015 -->
- <!-- Current: configuration.html -->
-<!-- Active: index.html -->
-<!-- Path: $path -->
-<!-- Skiplist: [index.html, getting-started.html] -->
-<html>
- <head>
- <title>juplo - </title>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <link rel="canonical" href="http://www.juplo.de/facebook-utils/configuration.html"/>
- <meta name="viewport" content="width=device-width, initial-scale=1" />
- <link rel="stylesheet" type="text/css" href="/css/base.css" />
- <style type="text/css">
- @import '/css/screen.css' screen;
- </style>
- <script src="/js/prettify.js"></script>
- <!--[if lt IE 9]>
- <script src="/js/html5shiv.js"></script>
- <![endif]-->
- <!--[if IE 8]>
- <link rel="stylesheet" type="text/css" href="/css/ie8.css" />
- <![endif]-->
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- </head>
- <body class="menu" onload="prettyPrint()">
- <div id="page" class="cf">
- <header id="header">
- <h1 id="logo"><a href="/" title="Home" class="l">juplo</a></h1>
- <span id="slogan"><strong>Java</strong> bits from nerds for nerds</span>
- <hr class="h" />
- </header>
- <div id="breadcrumb">
- <strong class="b title">You are here:</strong>
- <ol class="b">
- <li class="b"><a class="b" href="/">Home</a></li>
- <li class="b"><a class="b" href="/projects.html">Projects</a></li>
- <li class="b"><a class="b" href="./index.html">Juplo - Facebook Utils</a></li>
- <li class="b"><strong class="b">$shortTitle</strong></li>
- </ol>
- <a class="hide" href="#navigation">Jump to navigation</a>
- <hr class="b" />
- </div>
- <main class="content cf">
- <article id="content" class="main">
- <header><h1>$shortTitle</h1></header>
-
-
-
- <div class="section"><h2>Configuration through a hibernate.properties-File<a name="Configuration_through_a_hibernate.properties-File"></a></h2>
- <p>
- The most simple way to configure the plugin is, to put all the
- hibernate-configuration in a <b>hibernate.properties</b>-file on your
- classpath. Put the file in the <tt>resources</tt>-folder. Maven will put
- it in the <tt>class</tt>-folder of your webapp, where it will be picked up
- by this plugin as well as by Hibernate 4.
- </p>
- <p>
- Doing so, the only additionally configuration needed, to activat the plugin
- is the following entry in the <tt>plugins</tt>-section of your <tt>pom.xml</tt>:
- </p>
- <div class="prettyprint linenums lang-html"><pre>
-<plugin>
- <groupId>de.juplo</groupId>
- <artifactId>hibernate-maven-plugin</artifactId>
- <version>${project.version}</version>
- <executions>
- <execution>
- <goals>
- <goal>export</goal>
- </goals>
- </execution>
- </executions>
-</plugin></pre></div>
- <p>
- But be aware, that in this case 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,
- <b>
- you should never fire up this configuration on your production
- system, or your database might be erased!
- </b>
- </p>
- <p>
- A better approach is, to specify a different url for testing like in the
- following snippet:
- </p>
- <div class="prettyprint linenums lang-html"><pre>
-<plugin>
- <groupId>de.juplo</groupId>
- <artifactId>hibernate-maven-plugin</artifactId>
- <version>${project.version}</version>
- <executions>
- <execution>
- <goals>
- <goal>export</goal>
- </goals>
- </execution>
- </executions>
- <configuration>
- <url><![CDATA[jdbc:mysql://localhost/test-db]]></url>
- </configuration>
-</plugin></pre></div>
- <p>
- Configuration properties, that are set in the <tt>configuration</tt>-section
- of the plugin-configuration cannnot be overwritten elsewere (for details
- see <a href="#precedence">Configuration-Method-Precedence</a>).
- You never can overwrite them by accident when specifying a property on
- the commandline or in your <tt>settings.xml</tt>.
- </p>
- </div><div class="section"><h2>Configuration through maven-properties<a name="Configuration_through_maven-properties"></a></h2>
- <p>
- 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 <a href="./export-mojo.html">Documentation of the export-Mojo</a>).
- These are named after the
- <a class="externalLink" href="http://docs.jboss.org/hibernate/orm/4.1/manual/en-US/html_single/#configuration-hibernatejdbc">Hibernate JDBC Properties</a>:
- </p>
- <ul>
- <li><tt>hibernate.connection.driver_class</tt></li>
- <li><tt>hibernate.dialect</tt></li>
- <li><tt>hibernate.connection.url</tt></li>
- <li><tt>hibernate.connection.username</tt></li>
- <li><tt>hibernate.connection.password</tt></li>
- </ul>
- <p>
- So, instead of writing the hibernate-configuration in the properties-file,
- like above, you could put it in the <tt>properties</tt>-section of your
- <tt>pom.xml</tt>.
- </p>
- <p>
- 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):
- </p>
- <div class="prettyprint linenums lang-html"><pre>
-<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>${project.version}</version>
- <executions>
- <execution>
- <goals>
- <goal>export</goal>
- </goals>
- </execution>
- </executions>
- <configuration>
- <url><![CDATA[jdbc:hsqldb:target/db/testdb;shutdown=true]]></url>
- </configuration>
- </plugin>
-
-<plugins></pre></div>
- </div><div class="section"><h2>Configuration through the plugin-configuration<a name="Configuration_through_the_plugin-configuration"></a></h2>
- <p>
- A third way for configuring the plugin is the plugin-configuration.
- The relevant configuration-parameters are:
- </p>
- <ul>
- <li><tt>driver</tt></li>
- <li><tt>dialect</tt></li>
- <li><tt>url</tt></li>
- <li><tt>username</tt></li>
- <li><tt>password</tt></li>
- </ul>
- <p>
- The equivalent of the configuration from the last section would look
- like this:
- </p>
- <div class="prettyprint linenums lang-html"><pre>
-<plugin>
- <groupId>de.juplo</groupId>
- <artifactId>hibernate-maven-plugin</artifactId>
- <version>${project.version}</version>
- <executions>
- <execution>
- <goals>
- <goal>export</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></pre></div>
- <p>
- The parameter <b>hibernateProperties</b> (name of the hibernate-properties-file
- to use, defaults to <b>hibernate.properties</b>) can only be configured through
- this approach.
- </p>
- <p>
- For more explanations, see the
- <a href="./export-mojo.html">Documentation of the export-Mojo</a>.
- </p>
- </div><div class="section"><h2 id="precedence">Configuration-Method-Precedence</h2>
- <p>
- The configuration is gathered in a fix order:
- </p>
- <ol style="list-style-type: decimal">
- <li><tt>hibernate.properties</tt></li>
- <li><tt>hibernate.cfg.xml</tt></li>
- <li><tt>persistence.xml</tt></li>
- <li>maven-properties</li>
- <li>plugin-configuration</li>
- </ol>
- <p>
- If you are in doubt about where a configuration-value comes from, run
- maven with the <a href="./debugging.html">debug-output</a> enabled: <tt>mvn -X hibernate:export</tt>
- and be aware, that maven-properties can be overwitten on the command-line,
- in your <tt>~/.m2/settings.xml</tt> and in a profile.
- </p>
- <p>
- 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.
- </p>
- <p>
- If you need to overwrite plugin-configuration-values with
- maven-properties, you can use maven-properties in the plugin-configuration:
- </p>
- <div class="prettyprint linenums lang-html"><pre>
-<plugin>
- <groupId>de.juplo</groupId>
- <artifactId>hibernate-maven-plugin</artifactId>
- <version>${project.version}</version>
- <executions>
- <execution>
- <goals>
- <goal>export</goal>
- </goals>
- </execution>
- </executions>
- <configuration>
- <password>${my-password-property}</password>
- </configuration>
-</plugin></pre></div>
- </div>
-
- </article>
- <div class="marginal">
- <nav id="nav">
- <hr class="n" />
- <a id="navigation"></a>
- <a class="hide" href="#top" title="Show Content">Jump back to the top of the page</a>
- <h2 class="nav menu">Section-Menu</h2>
- <ul id="menu">
- <li class="m blog"><a href="/blog/" class="m">Blog</a></li>
- <li class="m projects"><a href="/projects.html" class="m selected">Projects</a></li>
- <li class="m about"><a href="/about.html" class="m">About</a></li>
- </ul>
- <h2 class="nav submenu">
- <span class="s">Submenu for section</span>
- <a class="s selected" href="/projects.html">Projects</a>
- </h2>
- <ul id="submenu" class="s">
- <li class="s sub off"><a class="s" href="/hibernate4-maven-plugin/">Hibernate 4 Maven Plugin</a></li>
- </ul>
- <hr class="n" />
- </nav>
- <aside class="m">
- <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
- <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
- </a>
- </aside>
- </div>
- </main>
- <footer id="footer">
- <hr class="f" />
- <ul id="footerlinks">
- <li class="f" id="copyright">© <strong>mo</strong> 2015
- </li>
- <li class="f"><a class="f" href="/impressum.html">Impressum</a></li>
- <li class="f about"><a class="f" href="/about.html">About</a></li>
- </ul>
- </footer>
- </div>
- <script type="text/javascript"><!--//--><![CDATA[//><!--
- var _gaq = _gaq || [];
- _gaq.push(['_setAccount', 'UA-571104-3']);
- _gaq.push(['_trackPageview']);
- (function() {
- var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
- ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
- var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
- })();
- //--><!]]>
- </script>
- </body>
-</html>