com.googlecode.objectify.impl.translate

Class TranslatorRegistry

java.lang.Object

com.googlecode.objectify.impl.translate.TranslatorRegistry

public class TranslatorRegistry
extends Object

Manages all the translators used to map between POJO fields and the types that the Datastore can actually persist. Essentially acts as an aggregator for all the TranslatorFactory objects.

When Objectify arranges a translator for a type at registration time, it runs through the available TranslatorFactory instances one at time looking for one that will provide a Translator. The first one found is kept and used during runtime assembly and disassembly of entities.

Author:

Jeff Schnitzer

Constructor Summary

Constructors

Constructor and Description
TranslatorRegistry(ObjectifyFactory fact) Initialize the default set of converters in the proper order.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(TranslatorFactory<?> trans) Add a new translator to the list.
void	addEarly(TranslatorFactory<?> trans) Add a new translator to the beginning of the list, before all other translators except other translators that have been added early.
<T> Translator<T>	create(Path path, Property property, Type type, CreateContext ctx) Goes through our list of known translators and returns the first one that succeeds

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TranslatorRegistry

public TranslatorRegistry(ObjectifyFactory fact)

Initialize the default set of converters in the proper order.

Method Detail

add

public void add(TranslatorFactory<?> trans)

Add a new translator to the list. Translators are added in order after most of the "plumbing" translators (collections, arrays, maps, serialize, embeds, references) but before any of the standard value conversions like String, Number, Key, Enum, SqlDate, TimeZone, etc.

Translators are added in-order so earlier translaters pre-empt later translators.

addEarly

public void addEarly(TranslatorFactory<?> trans)

Add a new translator to the beginning of the list, before all other translators except other translators that have been added early.

create

public <T> Translator<T> create(Path path,
                       Property property,
                       Type type,
                       CreateContext ctx)

Goes through our list of known translators and returns the first one that succeeds

Parameters:

path - is the path to this type, used for logging and debugging

ctx - is the context we pass down from the root

Throws:

IllegalStateException - if no matching loader can be found