TriActive JDO - Building From Source

Building TJDO From Source

Requirements

Build Tools

JDK 1.3 or newer.
Ant 1.5 or newer.
- ANT_HOME must be set as an environment variable.
- TJDO will not build or run unit tests correctly with Ant 1.4.x because it includes crimson.jar and jaxp.jar in the classpath. TJDO currently requires Xerces for XML parsing, which is included in Ant 1.5.

Additional Libraries

* = optional.

File	Place In	Needed To
File	Place In	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

Download the latest source of TJDO.
Install any necessary software listed above.
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:

Make sure the necessary JDBC driver jar(s) are in the lib/test/dbname directory.
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:

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.