You create them in PROJECT_HOME/db/mysql/testdb db/mysql/testdb/build-mysql-testdb.xml db/mysql/testdb/createTables.sql db/mysql/testdb/dropTables.sql db/mysql/testdb/populateTables.sql db/mysql/testdb/testData.sql

The build script itself is fairly self-explanatory.  It replicates the targets from the master build script.  It reads the mysql.properties and schema.properties files and adds the correct jar file to the classpath.

For each target you first check if the property mysql.db.enable has been set so the target will only run if you’ve configured schema.properties to include the mysql database.   For each target you connect to the database and execute the sql in the appropriate sql script.

mysql/testdb/build-mysql-testdb.xml: <?xml version="1.0"?> <project basedir="." name="-build"> <property file="../../config/mysql.properties" /> <property file="../../config/schema.properties" /> <property name="lib.dir" value="../../lib" /> <!-- Class path settings --> <fileset id="lib" dir="${lib.dir}/mysql"> <include name="*.jar" /> </fileset> <path id="classpath"> <fileset refid="lib" /> </path> <target name="createUser" if="mysql.db.enable" description="Creates user and schema specified in properties file"> <echo>Executing mysql-airline:createUser </echo> <sql driver="${mysql.driver}" url="${mysql.url}" userid="${mysql.rootuser}" password="${mysql.rootpass}" print="${print}"> <classpath refid="classpath"/> create schema ${mysql.schema}; GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,ALTER,INDEX,DROP ON ${mysql.schema}.* TO '${mysql.username}'@'${mysql.user.location}' IDENTIFIED BY '${mysql.password}'; </sql> </target> <target name="dropUser" if="mysql.db.enable" description="Drops user and schema specified in properties file"> <echo>Executing mysql-airline:dropUser </echo> <sql driver="${mysql.driver}" url="${mysql.url}" userid="${mysql.rootuser}" password="${mysql.rootpass}" print="${print}" onerror="continue"> <classpath refid="classpath"/> drop schema ${mysql.schema}; drop user '${mysql.username}'@'${mysql.user.location}'; </sql> </target> <target name="recreateTables" if="mysql.db.enable" depends="dropUser,createUser,createTables,populateTables,testData" description="refreshes the database tables"/> <target name="createTables" if="mysql.db.enable" description="Creates Database Tables"> <echo>Executing mysql-airline:createTables </echo> <sql driver="${mysql.driver}" src="${mysql.create.tables.script}" url="${mysql.url}/${mysql.schema}" userid="${mysql.username}" password="${mysql.password}" print="${print}"> <classpath refid="classpath"/> </sql> </target> <target name="populateTables" if="mysql.db.enable" description="Populates Database Tables"> <echo>Executing mysql-airline:populateTables </echo> <sql driver="${mysql.driver}" src="${mysql.populate.tables.script}" url="${mysql.url}/${mysql.schema}" userid="${mysql.username}" password="${mysql.password}" print="${print}"> <classpath refid="classpath"/> </sql> </target> <target name="dropTables" if="mysql.db.enable" description="Drops Database Tables"> <echo>Executing mysql-airline:dropTables </echo> <sql driver="${mysql.driver}" url="${mysql.url}/${mysql.schema}" userid="${mysql.username}" password="${mysql.password}" src="${mysql.drop.tables.script}" print="${print}" onerror="continue"> <classpath refid="classpath"/> </sql> </target> <target name="testData" if="mysql.db.enable" description="Refreshes test data"> <echo>Executing mysql-airline:testData </echo> <sql driver="${mysql.driver}" src="${mysql.testdata.script}" url="${mysql.url}/${mysql.schema}" userid="${mysql.username}" password="${mysql.password}" print="${print}"> <classpath refid="classpath"/> </sql> </target> </project>

You then edit the sql scripts to add the tables and data needed for your schema.  Note that for targets that drop tables or users we set onerror=”continue” so that the build won’t fail if you add in new tables and attempt to drop them before they’ve been created.

You create them in PROJECT_HOME/db/oraclexe/testdb db/oraclexe/testdb/build-oraclexe-testdb.xml db/oraclexe/testdb/createTables.sql db/oraclexe/testdb/dropTables.sql db/oraclexe/testdb/populateTables.sql db/oraclexe/testdb/testData.sql

The build script itself is fairly self-explanatory.  It replicates the targets from the master build script.  It reads the xe.properties and schema.properties files and adds the correct jar file to the classpath.

For each target you first check if the property oraclexe.db.enable has been set so the target will only run if you’ve configured schema.properties to include the oraclexe database.   Then in each target you connect to the database and execute the statements in the appropriate sql script.

oraclexe/testdb/build-xe-testdb.xml: <?xml version="1.0"?> <project basedir="." name="xe-mdm-build"> <property file="../../config/schema.properties" /> <property file="../../config/xe.properties" /> <property name="template.dir" value="../templates" /> <property name="lib.dir" value="../../lib" /> <property name="build.dir" value="../../build" /> <!-- Class path settings --> <fileset id="lib" dir="${lib.dir}/oracle"> <include name="*.jar" /> </fileset> <path id="classpath"> <fileset refid="lib" /> </path> <target name="init" if="xe.db.enable"> <mkdir dir="${build.dir}"/> </target> <target name="clean" if="xe.db.enable"> <delete dir="${build.dir}"/> </target> <target name="gen-sql" if="xe.db.enable" depends="clean,init" description="Generates the sql files"> <copy file="${template.dir}/createUser.template" tofile="${build.dir}/createTestUser.sql" overwrite="true"> <!-- replace template tokens marked with ~~ before and after --> <filterset begintoken="~~" endtoken="~~"> <filter token="template.username" value="${xe.username}" /> <filter token="template.password" value="${xe.password}" /> </filterset> </copy> <copy file="${template.dir}/dropUser.template" tofile="${build.dir}/dropTestUser.sql" overwrite="true"> <!-- replace template tokens marked with ~~ before and after --> <filterset begintoken="~~" endtoken="~~"> <filter token="template.username" value="${xe.username}" /> </filterset> </copy> </target> <target name="createUser" if="xe.db.enable" depends="gen-sql" description="Creates user specified in properties file"> <echo>Executing xe-mdm:createUser </echo> <exec dir="${template.dir}" executable="cmd"> <arg line="/c run.bat ${xe.rootuser} ${xe.rootpass} ${xe.sid} ${build.dir}/createTestUser.sql"/> </exec> </target> <target name="dropUser" if="xe.db.enable" depends="gen-sql" description="Creates user specified in properties file"> <echo>Executing xe-mdm:dropUser </echo> <exec dir="${template.dir}" executable="cmd"> <arg line="/c run.bat ${xe.rootuser} ${xe.rootpass} ${xe.sid} ${build.dir}/dropTestUser.sql"/> </exec> </target> <target name="recreateTables" depends="dropTables,createTables,populateTables,testData" description="Refreshes the database tables"/> <target name="createTables" if="xe.db.enable" description="Creates Database Tables"> <echo>Executing xe-mdm:createtables </echo> <sql driver="${xe.driver}" src="${xe.create.tables.script}" url="${xe.url}" userid="${xe.username}" password="${xe.password}" print="${print}"> <classpath refid="classpath"/> </sql> </target> <target name="populateTables" if="xe.db.enable" description="Populates Database Tables"> <echo>Executing xe-mdm:populateTables </echo> <sql driver="${xe.driver}" src="${xe.populate.tables.script}" url="${xe.url}" userid="${xe.username}" password="${xe.password}" print="${print}"> <classpath refid="classpath"/> </sql> </target> <target name="dropTables" if="xe.db.enable" description="Drops the Database Tables"> <echo>Executing xe-mdm:dropTables </echo> <sql driver="${xe.driver}" src="${xe.drop.tables.script}" url="${xe.url}" userid="${xe.username}" password="${xe.password}" print="${print}" onerror="continue"> <classpath refid="classpath"/> </sql> </target> <target name="testData" if="xe.db.enable" description="Refreshes test data"> <echo>Executing xe-mdm:testData </echo> <sql driver="${xe.driver}" src="${xe.testdata.script}" url="${xe.url}" userid="${xe.username}" password="${xe.password}" print="${print}"> <classpath refid="classpath"/> </sql> </target> </project>

For oraclexe you need to generate scripts for creating and dropping the user and run them from a batch file.  The values in xe.properties are used to fill in the details.  Create the following templates:

oraclexe/templates/createUser.template: create user ~~template.username~~ identified by ~~template.password~~ DEFAULT TABLESPACE users TEMPORARY TABLESPACE temp QUOTA 50M ON users; GRANT CONNECT, RESOURCE TO ~~template.username~~;

oraclexe/templates/dropUser.template:

In createUser.template we want to sustitute a value for the token template.username. We choose ~~ to indicate the start and end of the token. In the gen-sql target you state the start and end of the tokens are ~~ and indicate which value should replace the token in the template. In this case ~~template.username~~ will be replaced with the xe.username value. The generated sql scripts will be stored in db/build.

oraclexe/templates/run.bat:@echo off SET sysdba_userid=%1 SET sysdba_psswd=%2 SET sid=%3 SET sql_file=%4 SQLPlus %sysdba_userid%/%sysdba_psswd%@%sid% as sysdba @%sql_file% echo Finished processing, exiting ...

The createUser and dropUser targets are run after gen-sql. They execute a command line prompt and pass the database connection details and sql script to run.bat before launching it.

Now the only thing left to do is add the sql statements to the .sql scripts to create the database you want.  Note that for targets that drop tables or users we set onerror="continue" so that the build won't fail if you add in new tables and attempt to drop them before they've been created.

As part of your automated build system you should run the database scripts whenever there’s a change to keep your code and database in synch.  You can add the code into your existing build in a db folder or check it into source control separately.

You follow almost the same process whether adding scripts for mysql or oraclexe and can modify the scripts to cater for multiple schemas across different databases.   In this example we’ll cover the configuration for setting up the testdb schema in both oraclexe and mysql before writing the scripts for each. This example assumes you already have both databases running locally on your machine.

To start with you create a PROJECT_HOME/db folder which contains: db/config db/datasources db/lib db/oraclexe/testdb db/mysql/testdb

In the lib folder add the connector jars for the databases eg. db/lib/oracle/ojdbc5.jar db/lib/mysql/mysql-connector-java-5.1.6-bin.jar

In the config folder we need some property files to configure the build. db/config/mysql.properties db/config/xe.properties db/config/schema.properties

Schema.properties is used to configure the build depending on whether you want to just use oracle xe or mysql or use both.  In this example oraclexe is enabled and mysql is disabled.

schema.properties: ## ## Use this property file to enable or disable the databases and ## schemas you want to run the build scripts against. ## Comment them out with a # if you don't want to enable a ## setting. #Databases xe.db.enable xe.username=testdb xe.password=testdb #mysql.db.enable #mysql.username=testdb #mysql.password=testdb

The next two give the access details for your oracle xe and mysql databases.

mysql.properties: # MySql Database Details mysql.rootuser=root mysql.rootpass=password mysql.url=jdbc:mysql://localhost:3306 mysql.schema=testdb mysql.driver=com.mysql.jdbc.Driver mysql.user.location=localhost mysql.create.tables.script=createTables.sql mysql.drop.tables.script=dropTables.sql mysql.populate.tables.script=populateTables.sql mysql.testdata.script=testData.sql print=false

xe.properties: # Oracle XE Database Details xe.rootuser=sys xe.host=localhost xe.sid=XE xe.rootpass=password xe.port=1521 xe.driver=oracle.jdbc.OracleDriver xe.url=jdbc:oracle:thin:@${xe.host}:${xe.port}:${xe.sid} xe.create.user.script=createUser.sql xe.delete.user.script=dropUser.sql xe.create.tables.script=createTables.sql xe.drop.tables.script=dropTables.sql xe.populate.tables.script=populateTables.sql xe.testdata.script=testdata.sql print=false

We start off with a master build.xml script in PROJECT_HOME which calls oraclexe/testdb/build-xe-testdb.xml and mysql/testdb/build-mysql-testdb.xml script.  The ‘ant dir’ value specifies the directory the script to be called in, ‘antfile’ gives the name of the script, and lastly you specify the target to be run in that script.

db/build.xml: <?xml version="1.0"?> <project basedir="." name="db-master-build" default="recreateTables"> <property name="build.dir" value="${basedir}/build" /> <target name="clean"> <delete dir="${build.dir}" failonerror="false" /> </target> <target name="install" depends="createUsers,createTables,populateTables,testData" description="Creates all users and schemas for a fresh install" /> <target name="recreateTables" description="Refreshes the database tables for all schemas"> <ant dir="oraclexe/testdb" antfile="build-xe-testdb.xml" target="recreateTables" /> <ant dir="mysql/testdb" antfile="build-mysql-testdb.xml" target="recreateTables" /> </target> <target name="createUsers" description="Creates users for all schemas"> <ant dir="oraclexe/testdb" antfile="build-xe-testdb.xml" target="createUser" /> <ant dir="mysql/testdb" antfile="build-mysql-testdb.xml" target="createUser" /> </target> <target name="dropUsers" description="Drops users for all schemas"> <ant dir="oraclexe/testdb" antfile="build-xe-testdb.xml" target="dropUser" /> <ant dir="mysql/testdb" antfile="build-mysql-testdb.xml" target="dropUser" /> </target> <target name="createTables" description="Creates Database Tables for all schemas"> <ant dir="oraclexe/testdb" antfile="build-xe-testdb.xml" target="createTables" /> <ant dir="mysql/testdb" antfile="build-mysql-testdb.xml" target="createTables" /> </target> <target name="populateTables" description="Populates Database Tables for all schemas"> <ant dir="oraclexe/testdb" antfile="build-xe-testdb.xml" target="populateTables" /> <ant dir="mysql/testdb" antfile="build-mysql-testdb.xml" target="populateTables" /> </target> <target name="dropTables" description="Drops Database Tables for all schemas"> <ant dir="oraclexe/testdb" antfile="build-xe-testdb.xml" target="dropTables" /> <ant dir="mysql/testdb" antfile="build-mysql-testdb.xml" target="dropTables" /> </target> <target name="testData" description="Refreshes test data for all schemas"> <ant dir="oraclexe/testdb" antfile="build-xe-testdb.xml" target="testData" /> <ant dir="mysql/testdb" antfile="build-mysql-testdb.xml" target="testData" /> </target> </project>

The install target is used to create the database schemas from scratch – including the users.

The recreateTables target is the default and is used when the schemas and users already exist and you just want to drop and create the tables to pick up changes.

The rest of the targets can be called separately for creating tables, populating them with default data (eg. lists of countries that would always be needed for an application) adding some test data and deleting the tables again.

The next step is to add the oraclexe-specific scripts and the mysql-specific scripts.