# Apache Db Torque Project ## General - Apache Torque is an object-relational mapper using java. - It generates the necessary classes (including the Data Objects) from an XML schema describing the database layout. - it uses velocity / groovy templates during the code generation process. ## Requirements - Version 5 requires Java 8. - Build and Tests run with Java 8 and 14. Building with Java 11 may require some fixes. ### Modules - This project consists of six modules - torque-runtime - torque-generator - torque-templates - torque-maven-plugin - torque-ant-tasks - torque-site - torque-test (internal only) ### Core modules *Torque-generator* is the core module providing the mechanism to generate the mappings, which are provided by *Torque-templates* module. You need the ant tool installed. *Torque-runtime* is the only module needed, if building / generation step was done. #### Test module Two kinds of tests exist. Module "internal" tests without database dependency or explicitely inlined dependency as in torque-templates (ddl templates) and database testing in the module "Torque-test". *Torque-test* allows to test against databases and provides a [README](torque-test/README.md) of its own. You need the ant tool installed. You may start Torque-Test module in the root by this command (with default database derbyEmbedded) ```sh mvn clean install -PderbyEmbedded,test,beans,managers ``` #### Site module *Torque-site* is used to generate the site (add post-site to merge the documentation of dependend modules. You need the ant tool installed. ```sh mvn site post-site ``` #### Build modules - *Torque-maven-plugin* provides a Maven plugin (generator). - *Torque-ant-tasks* is to provide some ant tasks to generate the Torque artefacts (xml, java, sql). To build all with checksums run in root ```sh mvn clean install -Papache-release,beans,managers,owasp ``` - one "database" profile (setting torque.driver) is required to be active - managers and beans profile currently are required to be activated #### Provided database profiles - derby - derbyEmbedded - hsqldb - mssql - mysql - oracle - postgresql - derbyEmbedded-jenkins: derby profile with default settings. Can only be run from parent project with `mvn -Ptest,derbyEmbedded-jenkins install` - hsqldb-jenkins: see above - apache-release: sets as database derbyEmbedded #### Deploy Artifacts and Release modules Find more information here: [Developer Guide][https://db.apache.org/torque/torque-4.0/developer-info/developer-guide.html] - Requirements Public Key is added to KEYS. - Deploy artifacts You will be asked for your gpg passphrase durign the build process, if not provided otherwise. mvn package deploy - Release modules First test the release locally until the build is successfull, then clean again and run and perform release: mvn release:prepare -DdryRun=true -DautoVersionSubmodules=true -Ptest,managers,beans mvn release:clean -DautoVersionSubmodules=true ##### Important information: - from the developer-guide: Running release:prepare "will change the version in the poms to the release version and then run a clean verify cycle on the new poms. This will fail because the test project needs the *maven plugin* which is not installed in the new version yet. To fix this, you might have to run rm torque-test/derby.log, then run *mvn install* to install the torque artifacts in the release version. Then run again mvn -Ptest release:prepare .. to finish building the release". - requires activated profile test to also apply the release prepare step to module torque-test, which is by default not in modules list. mvn release:prepare -DautoVersionSubmodules=true -Ptest,managers,beans mvn release:perform -Pmanagers,beans Note: We need to add profiles managers, beans as release perform does a checkout of the tagged version (which is then uploaded to nexus) and is running the build process again. In module torque-test the beans and manager java is generated only, if the beforementioned profiles are active. Now close the staging repository after Login in Nexus Repo https://repository.apache.org/index.html#stagingRepositories Then prepare voting information and voting. If voting was successfull, proceed by publishing in Nexus Repo and distribute binaries and sources to d. Otherwise drop the staged repo in Nexus repo.