com.sappenin.objectify.translate

Class BigDecimalEmbeddedEntityTranslatorFactory

java.lang.Object

com.sappenin.objectify.translate.BigDecimalEmbeddedEntityTranslatorFactory

All Implemented Interfaces:

com.googlecode.objectify.impl.translate.TranslatorFactory<BigDecimal,com.google.appengine.api.datastore.EmbeddedEntity>

public class BigDecimalEmbeddedEntityTranslatorFactory
extends Object
implements com.googlecode.objectify.impl.translate.TranslatorFactory<BigDecimal,com.google.appengine.api.datastore.EmbeddedEntity>

This a more advanced strategy for storing java.math.BigDecimal in the datastore than the standard Objectify translators. This implementation encodes the BigDecimal value and stores the result as a String. This is appropriate for monetary and other values of ~475 digits (the end encoded value length is number dependent). This strategy offers the following advantages over encoding a java.math.BigDecimal as a Long:

• Offers support for arbitrary precision numbers
• Supports very large numbers (~475 digits long)
• Encodes numbers in lexigraphical order, which allows for native sorting in Datastore queries.

For more details, read this blog entry: "http://softwareblog.sappenin.com/2014/05/best-practices-for-storing-bigdecimal.html"

This translator is not installed by default, but can be installed as follows:

 ObjectifyService.factory().getTranslators().add(new BigDecimalStringTranslatorFactory());
 

Author:

David Fuelling

Constructor Summary

Constructors

Constructor and Description
BigDecimalEmbeddedEntityTranslatorFactory()

Method Summary

Methods

Modifier and Type	Method and Description
com.googlecode.objectify.impl.translate.Translator<BigDecimal,com.google.appengine.api.datastore.EmbeddedEntity>	create(com.googlecode.objectify.impl.translate.TypeKey<BigDecimal> tk, com.googlecode.objectify.impl.translate.CreateContext ctx, com.googlecode.objectify.impl.Path path)

Methods inherited from class java.lang.Object

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

Constructor Detail

BigDecimalEmbeddedEntityTranslatorFactory

public BigDecimalEmbeddedEntityTranslatorFactory()

Method Detail

create

public com.googlecode.objectify.impl.translate.Translator<BigDecimal,com.google.appengine.api.datastore.EmbeddedEntity> create(com.googlecode.objectify.impl.translate.TypeKey<BigDecimal> tk,
                                                                                                                      com.googlecode.objectify.impl.translate.CreateContext ctx,
                                                                                                                      com.googlecode.objectify.impl.Path path)

Specified by:

create in interface com.googlecode.objectify.impl.translate.TranslatorFactory<BigDecimal,com.google.appengine.api.datastore.EmbeddedEntity>