Experiment of a simple embedded database application
This application is an experiment and a learning exercise.
More details on building and running may be found in the project wiki, but here's a quick overview.
Maven must run under Java 8. Running under Java 9 or later doesn't work. (I have read that a later version of JOOQ, 3.11, will fix this problem. I have not yet confirmed this.)
The project is written to be built in JDK 1.8. It has not been tested with any later versions.
Before building the project, you must run the code generator. The jOOQ database classes are generated from the empty database at src/main/resources/sql/generateFromSkeleton.db
After ensuring the maven runner is using Java 8, you may generate the code and build the Mac OSX executable with this command:
mvn jooq-codegen:generate clean install
Generated code goes into the com.neptunedreams.skeleton.gen package.
Once the code has been generated, it need not be generated again unless the schema changes. (The maven clean command does not delete the generated code.) So at this point, you can build by just typing
mvn clean install
To run on any other platform, you need to build an executable jar file. For that, you should run
mvn clean assembly:assembly
To build, type mvn clean install
This uses the checkerframework, which can be finicky. If maven will not build be sure of three things:
-
Maven should be 3.6 or later
-
The maven runner should use java 1.8, but not later versions.
-
JAVA_HOME should be defined, and point to JDK 1.8.
If you want to use JDK 1.11 or later, you will need to make changes to the pom.xml file. See the checker framework for instructions. It's not clear if JDK 1.9 or 1.10 are supported, and I haven't tried them.
The pom.xml file will build an application bundle for the Mac. As it is currently configured, it does not bundle the JDK with the app. This is done for size reasons. To include the JDK, uncomment the line that specifies a value for <jrePath>.
For more information on the purpose of this project, see the project wiki.