Apache OpenJPA
Go to file
Maxim Solodovnik 20f682eb7e [OPENJPA-2808] indicies are dropped in schema tool 2020-04-05 16:58:42 +07:00
openjpa [maven-release-plugin] prepare for next development iteration 2020-02-14 12:12:11 +01:00
openjpa-all [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
openjpa-examples OPENJPA-2809 adding openjpa-junit5 module 2020-03-17 17:17:19 +01:00
openjpa-features OPENJPA-2809 adding openjpa-junit5 module 2020-03-17 17:17:19 +01:00
openjpa-integration OPENJPA-2809 adding openjpa-junit5 module 2020-03-17 17:17:19 +01:00
openjpa-jdbc [OPENJPA-2808] indicies are dropped in schema tool 2020-04-05 16:58:42 +07:00
openjpa-jest [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
openjpa-junit5 extracting directory enhancement logic in a runnable for junit5 module to be able to reuse it easily 2020-03-31 09:28:32 +02:00
openjpa-kernel OPENJPA-2809 adding openjpa-junit5 module 2020-03-17 17:17:19 +01:00
openjpa-kubernetes [maven-release-plugin] prepare for next development iteration 2020-02-14 12:12:11 +01:00
openjpa-lib [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
openjpa-persistence [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
openjpa-persistence-jdbc [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
openjpa-persistence-locking [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
openjpa-project OPENJPA-2809 adding openjpa-junit5 module 2020-03-17 17:17:19 +01:00
openjpa-slice [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
openjpa-tools OPENJPA-2809 adding openjpa-junit5 module 2020-03-17 17:17:19 +01:00
openjpa-xmlstore [OPENJPA-2798] Automatic-Module-Name is added 2020-03-15 15:59:45 +07:00
scripts OPENJPA-2747 upgrade to jpa-2.2 api 2019-03-27 12:29:57 +01:00
src OPENJPA-2753 add a profile for Oracle as Docker image 2019-01-06 23:43:41 +01:00
.gitignore [OPENJPA-2781] persistence_2_1.xsd is bundled for offline processing 2019-03-24 20:32:47 +07:00
LICENSE [OPENJPA-2781] persistence_2_1.xsd is bundled for offline processing 2019-03-24 20:32:47 +07:00
NOTICE upgrade license year to - 2015 2015-04-03 19:38:01 +00:00
README.adoc fix missing space in readme 2019-01-03 21:28:04 +01:00
patchoj.py [OPENJPA-2751] trailing white-spaces were removed 2018-10-02 12:32:32 +00:00
pom.xml Fixing Maven build 2020-03-23 09:13:46 +01:00

README.adoc

= Apache OpenJPA - README

== Preface
Thank you for downloading this release of Apache OpenJPA.

Apache OpenJPA is an implementation of the Java Persistence API specification.


== License
The content of this repository is licensed under Apache License 2.0
http://www.apache.org/licenses/LICENSE-2.0

== Further Information

The following files can be found in the openjpa-project subdirectory:

* openjpa-project/BUILDING.txt
* openjpa-project/CHANGES.txt
* openjpa-project/RELEASE-NOTES.html

For documentation and project information, please visit our project site:
    http://openjpa.apache.org/


== Compiling

The best way to compile Apache OpenJPA yourself is to run the build against the default derby database.

 $> mvn clean install -Dsurefire.excludes.locking=**/*

== Testing against different Databases

The Apache OpenJPA project also contains a setup for testing against multiple databases.
The easiest way is to use Docker.
We assume that Docker is installed to be used from your current user.
The respective database image has to be started manually bofore starting the build.
The reason for not starting it as part of the build itself is to be able to look at the database content after the build did run.

To start e.g. a PostgreSQL Docker image you can simply invoke the following command.
Note the -N Maven option which stands for 'non-recursive'.
This is used because the docker container is configured only at the root project but not at his children.

 mvn -N -Ptest-mysql-docker docker:start

After that you can execute your tests with the respective Maven profile

 mvn clean install -Ptest-mysql-docker

Once the Docker image for the database is not needed any longer one can stop and remove it:

 mvn -N -Ptest-mysql-docker docker:stop
 mvn -N -Ptest-mysql-docker docker:remove


The following Maven profiles do exist so far:

* test-mysql-docker
* test-mariadb-docker
* test-postgresql-docker