This chapter will familiarize you with Kodo Workbench's gui environment by leading you through a brief 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.