Package org.apache.sis.io

Class DefaultFormat

java.lang.Object

java.text.Format

org.apache.sis.io.DefaultFormat

All Implemented Interfaces:

Serializable, Cloneable

final class DefaultFormat
extends Format

Created by CompoundFormat for parsing and formatting unlocalized numbers. This implementation use toString() and valueOf(…) methods instead than the java.text package because the former provide the best guarantees to format all significant digits.

Thread safety

The same instance can be safely used by many threads without synchronization on the part of the caller. Note that this is specific to DefaultFormat and generally not true for arbitrary Format classes.

Since:

0.3

Version:

1.0

Nested Class Summary

Nested classes/interfaces inherited from class java.text.Format

Format.Field

Field Summary

Fields

Modifier and Type	Field	Description
private static final Format[]	INSTANCES	The array for storing singleton instances for types byte to double.
private static final long	serialVersionUID	For cross-version compatibility.
private final Class<?>	type	The type of the objects to parse.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	DefaultFormat(Class<?> type)	Creates a new instance for parsing and formatting objects of the given type.

Method Summary

Modifier and Type	Method	Description
Object	clone()	Unconditionally returns this since this format does not contain any modifiable field.
StringBuffer	format(Object obj, StringBuffer toAppendTo, FieldPosition pos)	Formats the given number using its Object.toString() method.
(package private) static Format	getInstance(Class<?> type)	Gets an instance of the given type, or null if the given type is not supported.
Object	parseObject(String source)	Parses the given string as a number of the type given at construction time.
Object	parseObject(String source, ParsePosition pos)	Parses the given string as a number of the type given at construction time.
private Object	readResolve()	Resolves to the singleton instance on deserialization.
private Object	valueOf(String source)	Parses the given string.

Methods inherited from class java.text.Format

format, formatToCharacterIterator

Methods inherited from class java.lang.Object

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

Field Details

serialVersionUID

private static final long serialVersionUID

For cross-version compatibility.

See Also:

• Constant Field Values

INSTANCES

private static final Format[] INSTANCES

The array for storing singleton instances for types byte to double. The value at index 0 is reserved for the generic Number type.

type

private final Class<?> type

The type of the objects to parse.

Constructor Details

DefaultFormat

private DefaultFormat(Class<?> type)

Creates a new instance for parsing and formatting objects of the given type.

Method Details

getInstance

static Format getInstance(Class<?> type)

Gets an instance of the given type, or null if the given type is not supported.

format

public StringBuffer format(Object obj,
 StringBuffer toAppendTo,
 FieldPosition pos)

Formats the given number using its Object.toString() method.

Specified by:

format in class Format

valueOf

private Object valueOf(String source)
                throws NumberFormatException

Parses the given string. Callers shall catch the NumberFormatException and handle the error according the caller's method contract.

Throws:

NumberFormatException - if the parsing failed.

parseObject

public Object parseObject(String source)
                   throws ParseException

Parses the given string as a number of the type given at construction time.

Overrides:

parseObject in class Format

Throws:

ParseException

parseObject

public Object parseObject(String source,
 ParsePosition pos)

Parses the given string as a number of the type given at construction time.

Specified by:

parseObject in class Format

clone

public Object clone()

Unconditionally returns this since this format does not contain any modifiable field. The same DefaultFormat instances can be shared.

Overrides:

clone in class Format

readResolve

private Object readResolve()
                    throws ObjectStreamException

Resolves to the singleton instance on deserialization.

Throws:

ObjectStreamException