Torque Directory Structure

Here is what the Torque directory structure looks like in CVS:

    db-torque/
      examples/        <--- example schema and config files
      profile/         <--- testing profiles
      src/             <--- sources
        conf/          <--- runtime configuration
        generator/     <--- home of torque-gen
          src/         <--- sources
            conf/      <--- generator configuration and ant buildfile
            dtd/       <--- DTD for schema.xml files
            java/      <--- java sources for generator
            schema/    <--- needed schema files (IDBroker)
            templates/ <--- templates for sql- and om- generation
            test/      <--- junit tests
          xdocs/       <--- docs for generator in anakia xml format
        java/          <--- java sources for runtime
        maven-plugin   <--- home of maven-plugin
          xdocs/       <--- docs for maven-plugin in anakia xml format
        rttest/        <--- sources for the runtime tests
        test/          <--- junit tests
      xdocs/           <--- docs for runtime in anakia xml format
      

Building

The Torque build process uses Maven. Before you begin, you'll need to check out the db-torque CVS repository (if you are not familiar with the Apache CVS repositories, please refer to the documentation). Specific information for Torque is available on the Source Repository page.

To build the Torque generator jar execute maven jar:jar in the src/generator directory (maven jar:install to install a copy of the jar in your local Maven repository).

To build and install the Torque maven-plugin execute maven plugin:install in the src/maven-plugin directory.

To build the Torque runtime jar execute maven jar:jar in the root directory of the project (maven jar:install to install a copy of the jar in your local Maven repository).

Testing

You must define a profile in your ${user.home}/build.properties file

    torque.testProfile=profile/oracle.profile
      

Edit the profile to match your database settings. To start the runtime tests simply type:

    maven runtime:test
      

Please report any problems to the torque-dev mailing list.