org.apache.tapestry.form.translator
Class NumberTranslator

java.lang.Object
  org.apache.tapestry.form.AbstractFormComponentContributor
      org.apache.tapestry.form.translator.AbstractTranslator
          org.apache.tapestry.form.translator.FormatTranslator
              org.apache.tapestry.form.translator.NumberTranslator

All Implemented Interfaces:

FormComponentContributor, Translator

public class NumberTranslator
extends FormatTranslator

A DecimalFormat-based Translator implementation.

Since:

4.0

Author:

Paul Ferraro

Constructor Summary

NumberTranslator()

NumberTranslator(String initializer)

Method Summary

protected String	defaultPattern()
protected String	formatObject(IFormComponent field, Locale locale, Object object)
protected ValidationConstraint	getConstraint()
DecimalFormat	getDecimalFormat(Locale locale)
protected Format	getFormat(Locale locale)
protected String	getMessageKey()
protected Object[]	getMessageParameters(Locale locale, String label)
protected Object	getValueForEmptyInput() The value to be used when the value supplied in the request is blank (null or empty).
boolean	isOmitZero()
void	renderContribution(IMarkupWriter writer, IRequestCycle cycle, FormComponentContributorContext context, IFormComponent field) Invoked by a form component after it finishes rendering its tag (but before the tag is closed) to allow this object to contribute to the component's rendering process.
void	setOmitZero(boolean omitZero) If true (which is the default for the property), then values that are 0 are rendered to an empty string, not "0" or "0.00".

Methods inherited from class org.apache.tapestry.form.translator.FormatTranslator

getPattern, getPattern, parseText, setPattern

Methods inherited from class org.apache.tapestry.form.translator.AbstractTranslator

buildMessage, format, getMessage, isTrim, parse, setMessage, setTrim

Methods inherited from class org.apache.tapestry.form.AbstractFormComponentContributor

accumulateProfileProperty, accumulateProperty, defaultScript, getScript, setScript

Methods inherited from class java.lang.Object

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

Constructor Detail

NumberTranslator

public NumberTranslator()

NumberTranslator

public NumberTranslator(String initializer)

Method Detail

formatObject

protected String formatObject(IFormComponent field,
                              Locale locale,
                              Object object)

Overrides:

formatObject in class FormatTranslator

See Also:

AbstractTranslator.formatObject(org.apache.tapestry.form.IFormComponent, Locale, java.lang.Object)

getValueForEmptyInput

protected Object getValueForEmptyInput()

Description copied from class: AbstractTranslator

The value to be used when the value supplied in the request is blank (null or empty). The default value is null, but some subclasses may override.

Overrides:

getValueForEmptyInput in class AbstractTranslator

Returns:

null, subclasses may override

See Also:

AbstractTranslator.parse(IFormComponent, ValidationMessages, String)

defaultPattern

protected String defaultPattern()

Specified by:

defaultPattern in class FormatTranslator

See Also:

FormatTranslator.defaultPattern()

getFormat

protected Format getFormat(Locale locale)

Specified by:

getFormat in class FormatTranslator

See Also:

FormatTranslator.getFormat(java.util.Locale)

getDecimalFormat

public DecimalFormat getDecimalFormat(Locale locale)

getMessageKey

protected String getMessageKey()

Specified by:

getMessageKey in class FormatTranslator

See Also:

FormatTranslator.getMessageKey()

getMessageParameters

protected Object[] getMessageParameters(Locale locale,
                                        String label)

Overrides:

getMessageParameters in class AbstractTranslator

See Also:

AbstractTranslator.getMessageParameters(java.util.Locale, java.lang.String)

renderContribution

public void renderContribution(IMarkupWriter writer,
                               IRequestCycle cycle,
                               FormComponentContributorContext context,
                               IFormComponent field)

Description copied from interface: FormComponentContributor

Invoked by a form component after it finishes rendering its tag (but before the tag is closed) to allow this object to contribute to the component's rendering process. Typically used by Validators and Translators to add javascript methods to the form's submit event handler.

Specified by:

renderContribution in interface FormComponentContributor

Overrides:

renderContribution in class AbstractTranslator

Parameters:

writer - allows contributor to write additional attributes into the component's tag

cycle - for accessing request information

context - utilities for genering messages and client-side validation

field - the field for which contributions are being rendered

See Also:

FormComponentContributor.renderContribution(org.apache.tapestry.IMarkupWriter, org.apache.tapestry.IRequestCycle, FormComponentContributorContext, org.apache.tapestry.form.IFormComponent)

getConstraint

protected ValidationConstraint getConstraint()

Specified by:

getConstraint in class FormatTranslator

See Also:

FormatTranslator.getConstraint()

setOmitZero

public void setOmitZero(boolean omitZero)

If true (which is the default for the property), then values that are 0 are rendered to an empty string, not "0" or "0.00". This is useful in most cases where the field is optional; it allows the field to render blank when no value is present.

Parameters:

omitZero - Whether or not to omit zero.

isOmitZero

public boolean isOmitZero()