OJB Table of contents 1 OJB...............................................................................................................................................8 1.1 Apache ObJectRelationalBridge - OJB................................................................................... 8 1.1.1 Summary............................................................................................................................. 8 1.1.1.1 flexibility........................................................................................................................ 8 1.1.1.2 scalability........................................................................................................................8 1.1.1.3 functionality....................................................................................................................8 1.2 News........................................................................................................................................ 8 1.2.1 .............................................................................................................................................9 1.3 OJB - Features......................................................................................................................... 9 1.4 OJB - API Status................................................................................................................... 10 1.5 OJB - References and Testimonials...................................................................................... 11 1.5.1 References and Testimonials............................................................................................ 11 1.5.1.1 projects using OJB........................................................................................................11 1.5.1.2 user testimonials .......................................................................................................... 12 1.6 OJB - Mailing Lists............................................................................................................... 13 1.6.1 Mailing Lists..................................................................................................................... 13 1.7 OJB - Mailing Lists Archives................................................................................................13 1.7.1 Mailing Lists Archives......................................................................................................13 1.8 OJB - Links and further readings.......................................................................................... 13 1.8.1 Summary........................................................................................................................... 13 1.8.2 OJB - Tutorials and Howto............................................................................................... 14 1.8.2.1 OJB and Spring.............................................................................................................14 1.8.3 Design............................................................................................................................... 14 1.8.4 Further readings on O/R mapping.....................................................................................15 1.8.5 Patterns..............................................................................................................................15 1.8.6 Books covering OJB......................................................................................................... 15 2 Download...................................................................................................................................15 3 Development.............................................................................................................................. 16 3.1 Coding Standards...................................................................................................................16 4 Index...........................................................................................................................................17 4.1 Site Linkmap......................................................................................................................... 17 4.1.1 Table of Contents..............................................................................................................17 5 Documentation...........................................................................................................................20 Copyright © 2002-2006 The Apache Software Foundation. All rights reserved. OJB 5.1 Documentation - Introduction............................................................................................... 20 5.2 Frequently Asked Questions..................................................................................................20 5.2.1 Questions...........................................................................................................................20 5.2.1.1 1. General..................................................................................................................... 20 5.2.1.2 2. Getting Started..........................................................................................................22 5.2.1.3 3. OJB APIs.................................................................................................................. 24 5.2.1.4 4. Howto....................................................................................................................... 25 5.3 Getting Started.......................................................................................................................34 5.3.1 Acquiring ojb-blank.......................................................................................................... 34 5.3.2 Contents of ojb-blank........................................................................................................35 5.3.2.1 Sample project.............................................................................................................. 36 5.3.3 The build files................................................................................................................... 36 5.3.3.1 Configuration via build.properties................................................................................36 5.3.3.2 Building via build.xml..................................................................................................37 5.3.3.3 Sample project.............................................................................................................. 38 5.3.4 The runtime configuration files.........................................................................................41 5.3.4.1 Configuring the OJB runtime....................................................................................... 41 5.3.4.2 Configuring the database connection........................................................................... 41 5.3.4.3 Configuring the repository........................................................................................... 41 5.3.4.4 Sample project.............................................................................................................. 41 5.3.5 Learning More...................................................................................................................43 5.4 Tutorials.................................................................................................................................43 5.4.1 Tutorial Summary............................................................................................................. 43 5.4.2 Mapping Tutorial.............................................................................................................. 44 5.4.2.1 What is the Object-Relational Mapping Metadata?..................................................... 44 5.4.2.2 Advanced Topics.......................................................................................................... 47 5.4.3 Persistence Broker Tutorial...............................................................................................47 5.4.3.1 The PersistenceBroker API.......................................................................................... 47 5.4.3.2 Exception Handling...................................................................................................... 52 5.4.4 The ODMG API................................................................................................................53 5.4.4.1 Introduction.................................................................................................................. 53 5.4.4.2 Initializing ODMG....................................................................................................... 54 5.4.4.3 Persisting New Objects.................................................................................................54 5.4.4.4 Querying Persistent Objects......................................................................................... 55 5.4.4.5 Updating Persistent Objects......................................................................................... 55 5.4.4.6 Deleting Persistent Objects...........................................................................................55 5.4.5 JDO Tutorial..................................................................................................................... 56 5.4.5.1 Using the ObJectRelationalBridge