net.sf.mmm.util.lang.api

Interface LocalizableFormatter<V>

Type Parameters:

V - is the generic type of the actual value to format.

All Superinterfaces:

Formatter<V>

All Known Implementing Classes:

AbstractLocalizableFormatter, ComposedLocalizableFormatter

public interface LocalizableFormatter<V>
extends Formatter<V>

This is the interface for a Formatter that is localizable. Methods inherited from Formatter will use Locale.getDefault().

Since:

3.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Method Summary

Modifier and Type	Method and Description
void	format(V value, Appendable buffer, Locale locale) This method formats the given value for the given locale and directly appends to the given buffer.
String	format(V value, Locale locale) This method formats the given value for the given locale.

Methods inherited from interface net.sf.mmm.util.lang.api.Formatter

format, format

Method Detail

format

String format(V value,
              Locale locale)

This method formats the given value for the given locale.
This is a shorthand of the following code:

 StringBuilder buffer = new StringBuilder();
 format(value, buffer, locale);
 return buffer.toString();
 

Parameters:

value - is the value to format. May be null.

locale - is the Locale.

Returns:

the formatted value. If the given value is null, a legal implementation will return "null" or "".

format

void format(V value,
            Appendable buffer,
            Locale locale)
     throws RuntimeIoException

This method formats the given value for the given locale and directly appends to the given buffer.

Parameters:

value - is the value to format. May be null.

buffer - is the Appendable to append the formatted value to.

locale - is the Locale to use.

Throws:

RuntimeIoException - if append caused a IOException.