Building TJDO From Source

Requirements

Build Tools

Additional Libraries

* = optional.

File Place In Needed To
Enhance Apps Run Apps Build TJDO Test TJDO
jdo.jar lib/ X X X X
log4j-version.jar lib/ X X X X
jdori.jar
jdori-enhancer.jar
lib/ X     X
xercesImpl.jar
xml-apis.jar
lib/ X* X* X* X*
jta.jar lib/   X* X* X*
jdbc2_0-stdext.jar lib/   X* X* X*
ojdbc14.jar or
classes_12.jar, etc.
lib/   X* X* X*
junit.jar $ANT_HOME/lib       X
xalan.jar $ANT_HOME/lib       X
commons-collections.jar
commons-dbcp.jar
commons-pool.jar
lib/test       X*
DBMS-specific jars lib/test/dbname       X

Building

  1. Download the latest source of TJDO.
  2. Install any necessary software listed above.
  3. Run ant from the project root directory. See the Ant project file "build.xml" or type:
    ant -projecthelp
    to see the available targets.

Testing

The unit test suite includes tests that perform a fairly thorough exercise of TJDO using a real database.

To run the tests against a particular database:

  1. Make sure the necessary JDBC driver jar(s) are in the lib/test/dbname directory.
  2. Type "ant -Ddb=dbname unit-tests" to run tests on a specific database, or "ant unit-tests-all" to run them on all databases having directories set up in lib/test.

To run the tests against all databases defined lib/test:

  1. Type "ant unit-tests-all".

A test_results/ directory will be created to hold the results of individual test runs. Ant's <junitreport> task is used to generate pretty JUnit test result pages.

JDBC connection parameters for testing are taken from the "lib/test/dbname/db.properties" file.


SourceForge.net