Getting Started

Introduction

POJO-MVCC provides a Subversion like cache that can be used with simple Java objects.

Basic Operation Example

1. Creating a cache:

` CacheElementFactory factory = new ExampleCacheElementFactory();

RootObjectCache<ExampleKey, ExampleCacheElement> rootCache = new RootObjectCacheImpl<ExampleKey, ExampleCacheElement>(factory); `

2. Checking out from a cache: RevisionObjectCache<ExampleKey, ExampleCacheElement> revision = rootCache.checkout();

3. Adding / Modifying / Deleting from a cache:

` Example key = new ExampleKey(); revision.addElement(key, new ExampleCacheElement());

revision.get(key).setExample("abcd");

revision.removeElement(key); `

4. Checking back in:

rootCache.commit(revision);

5. Reverting changes:

revision.revert();

Important Classes

code.google.pojomvcc.CacheElementFactory A CacheElementFactory must be registered with the RootObjectCache and is responsible for cloning and merging elements that are stored in the cache when required by the RootObjectCache.

code.google.pojomvcc.RootObjectCache The RootObjectCache is the base class for POJO-MVCC and is the "root" of the cache graph. A RootObjectCache may not be modified directly, all changes must be made to the RevisionObjectCache that can be obtained by calling checkout().

Once the RevisionObjectCache has been updated (adding, modifying or removing) elements the RootObjectCache is updated using the checkin() method.

code.google.pojomvcc.RevisionObjectCache A RevisionObjectCache represents the RootObjectCache at a specific revision. Modifications may be made to the RevisionObjectCache and later committed to the RootObjectCache.

That's it! Thats all you need to know to use POJO-MVCC

More Detail

An overview of POJO-MVCC can be found by looking at the Architecture page.

For more advanced features, refer to the AdvancedConcepts page.