Persistence module

Noticeable files

• osgi.bnd: spring-data and openjpa imports, persistence.xml location declaration
• pom.xml: openjpa plugin declaration, by default, all classes suffixed by ‘Entity’ will be enhanced (see management here)
• persistence.xml persistent classes mapping and database referencing.
• blueprint context: jpa context creation and injection with transactional behaviour and OSGI service exporting will be automatically generated if it’s contained in subpackages of maven module artifactId (e.g. com.foo.bar.baz).
• sample entity with Xml marshalling, and validation enabled
• Jaxb marshaling index listing xml marshallable classe on the package
• Repository definition to save, query or update the database
• Repository implementation
• Model feature declaration

This module uses blueprint and generates xml file from cdi annotations, for more informations look at the liquid-reality (Christian Schneider) blog

Using database versionning

In order to use database versioning, follow this steps: * Ensure the production database is started and have the same port as the one specified in the parent pom * Execute mvn clean install -Pdb-diff to have the according tables structure changelog * Then add the generated changelogs on the database module/src/main/resources/db/db.changelog.xml <databaseChangeLog> <include file="db/db-20121120_120949.changelog.xml" /> </databaseChangeLog>
* Execute mvn clean install -Pdb-data to retrieve ALL the production data on a changelog (it will be located on the db folder of the database module sources)

This file needs to be updated, as liquibase: Dumps all data. You will have to keep only the added data to your db from the previous db version. No diff here performed by Liquibase. Data is not properly ordered regarding referential integrity

Once this file has been cleaned-up, we can include it as well in our main db.changelog.xml file: <include file="db/db-data-20121128_170043.changelog.xml" />