Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Berkeley DB Java Edition version 3.1.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.sleepycat.persist.evolve
Class Converter

    java.lang.Object
      com.sleepycat.persist.evolve.Mutation
          com.sleepycat.persist.evolve.Converter

All Implemented Interfaces:
  Serializable

Direct Known Subclasses:
  EntityConverter

    public class Converter

extends Mutation

A mutation for converting an old version of an object value to conform to the current class or field definition. For example:

      package my.package;

      // The old class.  Version 0 is implied.
      //
      @Entity
      class Person {
          // ...
      }

      // The new class.  A new version number must be assigned.
      //
      @Entity(version=1)
      class Person {
          // Incompatible changes were made here...
      }

      // Add a converter mutation.
      //
      Mutations mutations = new Mutations();

      mutations.addConverter(new Converter(Person.class.getName(), 0,
                                           new MyConversion()));

      // Configure the mutations as described here.

See `Conversion` for more information.

Author:
  Mark Hayes
See Also:
  `Class Evolution`, Serialized Form

Constructor Summary
`Converter(String className, int classVersion, Conversion conversion)` Creates a mutation for converting all instances of the given class version to the current version of the class.
`Converter(String declaringClassName, int declaringClassVersion, String fieldName, Conversion conversion)` Creates a mutation for converting all values of the given field in the given class version to a type compatible with the current declared type of the field.

Method Summary
`boolean` | `equals(Object other)` Returns true if the conversion objects are equal in this object and given object, and if the `Mutation.equals(java.lang.Object)` superclass method returns true.
`Conversion` | `getConversion()` Returns the converter instance specified to the constructor.
`String` | `toString()`

Methods inherited from class com.sleepycat.persist.evolve.Mutation
`getClassName, getClassVersion, getFieldName, hashCode`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### Converter

    public Converter(String className,
                     int classVersion,
                     Conversion conversion)

  Creates a mutation for converting all instances of the given class version to the current version of the class.

### Converter

    public Converter(String declaringClassName,
                     int declaringClassVersion,
                     String fieldName,
                     Conversion conversion)

  Creates a mutation for converting all values of the given field in the given class version to a type compatible with the current declared type of the field.

Method Detail

### getConversion

    public Conversion getConversion()

  Returns the converter instance specified to the constructor.

### equals

    public boolean equals(Object other)

  Returns true if the conversion objects are equal in this object and given object, and if the `Mutation.equals(java.lang.Object)` superclass method returns true.

  Overrides:
    `equals` in class `Mutation`

### toString

    public String toString()

  Overrides:
    `toString` in class `Mutation`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Berkeley DB Java Edition version 3.1.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright(c) 1996-2006 Oracle Corporation - All rights reserved.