ObjectStore Java Tutorial

Preface

Topics discussed here:

Purpose

The ObjectStore Java Tutorial provides an overview of the basic concepts of ObjectStore. It uses an example application to show you how to define persistent classes and manipulate persistent objects. It also shows you how to develop and run applications that use ObjectStore.

Audience

This book is for experienced Java programmers who are new to writing applications that use the Java interface to ObjectStore.. If you are new to ObjectStore, you should read the tutorial and then look at the demonstration programs

Scope

This book supports Release 3.0 of the Java interface to ObjectStore.

How the Tutorial Is Organized

The tutorial provides an introduction to Object Design's ObjectStore products.

Chapter 1, Benefits of ObjectStore for Java introduces the concept of persistence and compares object serialization with the features provided by ObjectStore.
Chapter 2, Description of the Personalization Application, presents a small sample application to show how to use ObjectStore.
Chapter 3, Writing Your Application to Use ObjectStore, introduces the core concepts of ObjectStore through explanation of code samples.
Chapter 4, Compiling and Running an ObjectStore Program, describes the compile and build phases of ObjectStore development.
Chapter 5, Using ObjectStore to Query a Database, discusses queries and indexing, which are available in PSE Pro but not in PSE.
Chapter 6, Choosing PSE, PSE Pro, or ObjectStore, describes limitations of PSE and provides information to help you decide whether PSE, PSE Pro, or ObjectStore is the best fit for your requirements.
Appendix A, Source Code, provides a complete code example for the Personalization application.
Appendix B, Sample Output, provides sample output from running the Personalization application.

Documentation Conventions

This document uses the following conventions:


Convention	Meaning
Bold	Bold typeface in text indicates user input, code fragments, file names, and object, field, and method names.
Courier	Courier typeface identifies lines of code and method signatures.
Magenta	Magenta typeface indicates a variable for which you must supply a value. This most often appears in a syntax line or table.
Italic	In text, italic typeface indicates the first use of an important term.
[ ]	Brackets enclose optional arguments.
{ a \| b \| c }	Braces enclose two or more items. You can specify only one of the enclosed items. Vertical bars represent OR separators. For example, you can specify a or b or c.
...	Three consecutive periods indicate that you can repeat the immediately previous item. In examples, they also indicate omissions.

Examples in the documentation

Examples in the documentation assume that COM.odi.* is imported. This allows specification of, for example,

db.open(ObjectStore.READONLY)

db.open(COM.odi.ObjectStore.READONLY)

Internet Sources of More Information

Internet gateway

You can obtain such information as frequently asked questions (FAQs) from Object Design's Internet gateway machine as well as from the web. This machine is called ftp.objectdesign.com and its Internet address is 198.3.16.26. You can use ftp to retrieve the FAQs from there. Use the login name objectdesignftp and the password obtained from patch-info. This password also changes monthly, but you can automatically receive the updated password by subscribing to patch-info. See the ObjectStore Release 5.1 README file for guidelines for using this connection. The FAQs are in the /support/FAQ subdirectory. This directory contains a group of subdirectories organized by topic. The FAQ/FAQ.tar.Z file is a compressed tar version of this hierarchy that you can download.

Automatic email notification

In addition to the previous methods of obtaining Object Design's latest patch updates (available on the ftp server as well as the Object Design Support home page), you can now automatically be notified of updates. To subscribe, send email to majordomo@objectdesign.com with the keyword SUBSCRIBE patch-info < your siteid> in the body of your email. This will subscribe you to Object Design's patch information server daemon that automatically provides site access information and notification of other changes to the on-line support services. Your site ID is listed on any shipment from Object Design, or you can contact your Object Design Sales Administrator for the site ID information.

Email discussion list

There is a majordomo discussion list called osji-discussion. The purpose of this list is to facilitate discussion about the Java interface to ObjectStore.

Support

Object Design's support organization provides a number of information resources and services. Their home page is at http://support.objectdesign.com/WWW/Welcome.html. From the support home page, you can learn about support policies, product discussion groups, and the different ways Object Design can keep you informed about the latest release information - including the Web, ftp, and email services.

Training

Object Design's educational services organization provides a number of courses. You can find their home page at: http://www.objectdesign.com/services/services.html.

You can obtain information about training courses from the Object Design web site (http://www.objectdesign.com). From the home page, select Services and then Education.

If you are in North America, you can call 781.674.5000 for information about Object Design's educational offerings, Monday through Friday from 8:30 AM to 5:30 PM Eastern Time. If you are outside North America, call your Object Design sales representative.

Your Comments

Object Design welcomes your comments about ObjectStore documentation. Send feedback to support@objectdesign.com. To expedite your message, begin the subject with Doc:. For example:

Subject: Doc: Incorrect message on page 76 of reference manual

You can also fax your comments to 781.674.5440.

Copyright Notice

ObjectStore Java Tutorial

ObjectStore Java interface 3.0, October 1998

ObjectStore, Object Design, the Object Design logo, LEADERSHIP BY DESIGN, and Object Exchange are registered trademarks of Object Design, Inc. ObjectForms and Object Manager are trademarks of Object Design, Inc.

All other trademarks are the property of their respective owners.

Copyright © 1989 to 1998 Object Design, Inc. All rights reserved. Printed in the United States of America. Except as permitted under the Copyright Act of 1976, no part of this publication may be reproduced or distributed in any form or by any means, or stored in a database or retrieval system, without the prior written permission of the publisher.

COMMERCIAL ITEM - The Programs are Commercial Computer Software, as defined in the Federal Acquisition Regulations and Department of Defense FAR Supplement, and are delivered to the United States Government with only those rights set forth in Object Design's software license agreement.

Data contained herein are proprietary to Object Design, Inc., or its licensors, and may not be used, disclosed, reproduced, modified, performed or displayed without the prior written approval of Object Design, Inc.

This document contains proprietary Object Design information and is licensed for use pursuant to a Software License Services Agreement between Object Design, Inc., and Customer.

The information in this document is subject to change without notice. Object Design, Inc., assumes no responsibility for any errors that may appear in this document.

Object Design, Inc.
Twenty Five Mall Road
Burlington, MA 01803-4194

[previous] [next]
Copyright © 1998 Object Design, Inc. All rights reserved.

Updated: 10/07/98 07:05:21