Berkeley DB
version 4.8.30

com.sleepycat.persist.evolve
Class Mutations

java.lang.Object
  extended by com.sleepycat.persist.evolve.Mutations
All Implemented Interfaces:
Serializable

public class Mutations
extends Object
implements Serializable

A collection of mutations for configuring class evolution.

Mutations are configured when a store is opened via StoreConfig.setMutations. For example:

  Mutations mutations = new Mutations();
  // Add mutations...
  StoreConfig config = new StoreConfig();
  config.setMutations(mutations);
  EntityStore store = new EntityStore(env, "myStore", config);

Mutations cause data conversion to occur lazily as instances are read from the store. The EntityStore.evolve method may also be used to perform eager conversion.

Not all incompatible class changes can be handled via mutations. For example, complex refactoring may require a transformation that manipulates multiple entity instances at once. Such changes are not possible with mutations but can made by performing a store conversion.

See Also:
Class Evolution, Serialized Form

Constructor Summary
Mutations()
          Creates an empty set of mutations.
 
Method Summary
 void addConverter(Converter converter)
          Adds a converter mutation.
 void addDeleter(Deleter deleter)
          Adds a deleter mutation.
 void addRenamer(Renamer renamer)
          Adds a renamer mutation.
 boolean equals(Object other)
          Returns true if this collection has the same set of mutations as the given collection and all mutations are equal.
 Converter getConverter(String className, int classVersion, String fieldName)
          Returns the converter mutation for the given class, version and field, or null if none exists.
 Collection<Converter> getConverters()
          Returns an unmodifiable collection of all converter mutations.
 Deleter getDeleter(String className, int classVersion, String fieldName)
          Returns the deleter mutation for the given class, version and field, or null if none exists.
 Collection<Deleter> getDeleters()
          Returns an unmodifiable collection of all deleter mutations.
 Renamer getRenamer(String className, int classVersion, String fieldName)
          Returns the renamer mutation for the given class, version and field, or null if none exists.
 Collection<Renamer> getRenamers()
          Returns an unmodifiable collection of all renamer mutations.
 int hashCode()
           
 boolean isEmpty()
          Returns true if no mutations are present.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Mutations

public Mutations()
Creates an empty set of mutations.

Method Detail

isEmpty

public boolean isEmpty()
Returns true if no mutations are present.


addRenamer

public void addRenamer(Renamer renamer)
Adds a renamer mutation.


getRenamer

public Renamer getRenamer(String className,
                          int classVersion,
                          String fieldName)
Returns the renamer mutation for the given class, version and field, or null if none exists. A null field name should be specified to get a class renamer.


getRenamers

public Collection<Renamer> getRenamers()
Returns an unmodifiable collection of all renamer mutations.


addDeleter

public void addDeleter(Deleter deleter)
Adds a deleter mutation.


getDeleter

public Deleter getDeleter(String className,
                          int classVersion,
                          String fieldName)
Returns the deleter mutation for the given class, version and field, or null if none exists. A null field name should be specified to get a class deleter.


getDeleters

public Collection<Deleter> getDeleters()
Returns an unmodifiable collection of all deleter mutations.


addConverter

public void addConverter(Converter converter)
Adds a converter mutation.


getConverter

public Converter getConverter(String className,
                              int classVersion,
                              String fieldName)
Returns the converter mutation for the given class, version and field, or null if none exists. A null field name should be specified to get a class converter.


getConverters

public Collection<Converter> getConverters()
Returns an unmodifiable collection of all converter mutations.


equals

public boolean equals(Object other)
Returns true if this collection has the same set of mutations as the given collection and all mutations are equal.

Overrides:
equals in class Object

hashCode

public int hashCode()
Overrides:
hashCode in class Object

toString

public String toString()
Overrides:
toString in class Object

Berkeley DB
version 4.8.30

Copyright (c) 1996-2009 Oracle. All rights reserved.