BRIDGING JAVA OBJECTS AND RELATIONAL DATABASES

Quick Start

1. Be sure to have a JDK 1.2 or higher installed !

2. unpack the latest tar.gz snapshot to a directory <path> of your choice

3. If you want to use OJB under JDK1.2 you must edit the file build.xml and change the property JDK to -JDK13 as in the following code:
   <!-- Preprocess Java Source Code to switch on JDK specifics -->
   <target name="preprocess" depends="prepare">
   <property name="JDK" value="-JDK13"/>
   
   The default value for this property is +JDK13 and needs not to be changed for JDK1.3 or higher.
   
   in a terminal window (or dos box under Win32) change to directory <path>/ojb
   Then execute build[.sh] preprocess to run a preprocessor that activates the JDK1.2 compatible code.

4. in a terminal window (or dos box under Win32) change to directory <path>/ojb

5. run build[.sh] run_broker_example to see the sample programs test.ojb.broker.BrokerExamples and test.ojb.broker.ProxyExamples running. These samples show basic programming techniques using the OJB PersistenceBroker.

6. run build[.sh] run_odmg_example to see the sample programs test.ojb.odmg.OdmgExamples running. This samples shows programming techniques using the OJB ODMG implementation.

7. execute build[.sh] to build sample applications, generate javadoc api documentation and setup the demo database. To see which other build targets are available run build[.sh] targets.

8. For example you might type build[.sh] junit to run a suite of JUnit regression tests against the framework.

9. have a look at the code of the sample apps and play with the debug switches to see tracings of all internal components of the system

10. have a look at the metadata repository repository.xml to see how entity classes are mapped onto an underlying RDBMS

11. have a look at the tutorials: tutorial1, tutorial2, tutorial3.

$FOOTER$