The OPJ Tutorial

The OPJ Tutorial

Converting from previous releases of OPJ

Getting Started

Setting up your environment

Step-by-step instructions for PATH and CLASSPATH setup.

Introduction

Introduction to the basic concepts

A Simple Example

To illustrate the basic concepts

Evolution

How to evolve a deployed OPJ application

Storage Management

How storage management and garbage collection works with OPJ

The transient modifier

Problems with the transient modifier and a workaround

Using AWT and Swing with OPJ

How to make your user-interfaces persistent

Using Java RMI with OPJ

How to use Java RMI with OPJ to make server objects and client references persistent.

Manual Pages for Tools

opj

An upward compatible, extended Java interpreter that implements orthogonal persistence for Java.

opjcs

A tool to create and delete persistent stores

opjsubst

An off-line class substitution (evolution) tool for persistent stores.

opjc

A version of javac that supports opjsubst.

opjgc

An off-line garbage collector for persistent stores.

There are two flavors of backup/restore tools, logical and physical. The logical backup tools, opjlarchive and opjlrestore, utilize an architecture-neutral, store-independent, abstract representation of the suspended computation, which can be used, in principle, to migrate between different implementations of OPJ. In contrast, the physical archive/restore tools, opjparchive and opjprestore, simply work with physical copies of a store, and can only be used with the same OPJ implementation.

opjlarchive

An off-line, logical archive utility for persistent stores.

opjlrestore

A off-line, logical restore utility for persistent stores.

opjparchive

An off-line, physical archive utility for persistent stores.

opjprestore

An off-line, physical restore utility for persistent stores.