|Name||Modified||Size||Downloads / Week||Status|
|Totals: 5 Items||97.4 MB||6|
Version: 4.1.0.Beta1 - 19 February 2014
Hibernate OGM is an attempt to store data in a NoSQL data grid using the Hibernate ORM engine rather than rewriting a JPA engine from scratch.
The benefits are fairly obvious: - reimplementing the complex JPA specification is a lot of work - a new implementation would mature at a rather slow rate and risk of bugs would be high - Hibernate is familiar to many people
Checkout http://ogm.hibernate.org for more information.
The code is available on GitHub at https://github.com/hibernate/hibernate-ogm.
To run the full project build including tests for all backends, documentation etc. execute:
mvn clean install -s settings-example.xml
Note that for running the test suite against separately installed MongoDB and CouchDB servers their host name must be specified via an environment variable. See the sections below for the details.
To speed things up, there are several options for skipping parts of the build. To run the minimum project build without integration tests, documentation and distribution execute:
mvn clean install -DskipITs -DskipDocs -DskipDistro -s settings-example.xml
The following sections describe these options in more detail.
You can skip integration tests by specifying the
mvn clean install -DskipITs -s settings-example.xml
The documentation is built by default as part of the project build. You can skip it by specifying the
mvn clean install -DskipDocs -s settings-example.xml
If you just want to build the documentation, run it from the documentation/manual subdirectory.
For rapid documentation testing, you can limit the generated format to html to speed up the process
mvn clean install -f documentation/manual/pom.xml -s settings-example.xml -Djdocbook.format=html_single
The distribution bundle is built by default as part of the project build. You can skip it by specifying the
mvn clean install -DskipDistro -s settings-example.xml
For executing the tests in the mongodb and integrationtest/mongodb modules, the embedmongo-maven-plugin is used which downloads the MongoDB distribution, extracts it, starts a mongod process and shuts it down after test execution.
If required, you can configure the port to which the MongoDB instance binds to (by default 27018) and the target directory for the extracted binary (defaults to /home/gunnar/Development/projects/hibernate-ogm/target/checkout/distribution/target/embeddedMongoDb/extracted) like this:
mvn clean install -s settings-example.xml -DembeddedMongoDbTempDir=<my-temp-dir> -DembeddedMongoDbPort=<my-port>
To work with a separately installed MongoDB instance instead, specify the
mvn clean install -s settings-example.xml -DuseExternalMongoDb
This assumes MongoDB to be installed on
localhost, using the default port. If you have MongoDB
installed on another host or use a different port, you can set the environment variables
MONGODB_PORT and then run the test suite:
export MONGODB_HOSTNAME=mongodb-machine export MONGODB_PORT=1234 mvn clean install -s settings-example.xml
For running the tests in the couchdb module an installed CouchDB server is required. Specify its host name by
setting the environment variable
COUCHDB_HOSTNAME prior to running the test suite:
If this variable is not set, the couchdb module still will be compiled and packaged but the tests will be skipped.
Free Technical Support:
If you want to contribute, come to the <email@example.com> mailing list or join us on #hibernate-dev on freenode (login required)
This software and its documentation are distributed under the terms of the FSF Lesser Gnu Public License (see license.txt).