Chapter 2. Getting Started with Kodo Development Workbench

2.1. Beginning The Kodo Development Workbench Tutorial
2.2. Getting Familiar with Kodo Development Workbench
2.3. The MetaData Explorer
2.3.1. MetaData Explorer Basics
2.3.2. Creating JDO MetaData
2.3.3. Using The MetaData Explorer
2.3.4. Editing MetaData
2.3.5. Additional MetaData Explorer Actions
2.4. The Schema Explorer
2.5. Kodo Development Workbench Logging
2.6. The Details Pane
2.7. The Editor
2.7.1. Editor Overview
2.7.2. Using The Visualization Editor
2.7.3. Editing Visualization Mappings
2.7.4. Mapping Fields
2.7.5. Completing Visualization Changes
2.7.6. JDOQLEditor
2.8. Running The Tutorial

This chapter will familiarize you with Kodo Workbench's gui environment by leading you through a brief tutorial.

2.1. Beginning The Kodo Development Workbench Tutorial

This tutorial begins with compiling the source files included in the Kodo distribution. The source classes are based on modeling a simple class for a airplane ticketing application, Passenger. Traverse to the samples/ide directory and inspect the source code. Then compile the source code:

.../samples/ide> javac *.java

Now edit idetutorial.properties to include your license key for the workbench to use. In addition, you may want to specify an absolute file URL for the sample database to use:

javax.jdo.option.ConnectionURL:jdbc:hsqldb:your_kodo_directory/samples/ide/ide-db

Now that we have generated our classes and configured our properties, we are ready to start Kodo Workbench. If Kodo Workbench is already running, stop it so that we can configure the storage and base dirs for this tutorial as well as pick up the new classes we have just compiled. We'll restart Kodo Workbench with some temporary folders to isolate the tutorial:

.../samples/ide> kodoworkbench -storage tutorialstorage -properties idetutorial.properties

Now you that you have started Kodo Workbench, we can begin using some of Kodo Workbench's features.