javolution.text

Class TextContext

java.lang.Object

javolution.context.AbstractContext

javolution.context.FormatContext

javolution.text.TextContext

public abstract class TextContext
extends FormatContext

A context for plain text parsing/formatting. This context provides the TextFormat to parse/format objects of any class. If not superseded, the text format for a class is specified by the DefaultTextFormat annotation.

A text context always returns the most specialized format. If a class has no default format annotation (inherited or not), then the default Object format (which calls Object.toString()) is returned. A predefined format exists for the following standard types:

• java.lang.Object (parsing not supported, formatting calls toString())
• java.lang.Boolean
• java.lang.Character
• java.lang.Byte
• java.lang.Short
• java.lang.Integer
• java.lang.Long
• java.lang.Float
• java.lang.Double
• java.lang.Class
• java.lang.String

Version:

6.0 December 12, 2012

Author:

Jean-Marie Dautelle

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TextContext() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static TextContext	enter() Enters and returns a new text context instance.
static Appendable	format(Object obj, Appendable dest) Formats the specified object using its current format (convenience method).
static <T> TextFormat<T>	getFormat(Class<? extends T> type) Returns the text format for the specified type.
protected abstract <T> TextFormat<T>	searchFormat(Class<? extends T> type) Searches the most specialized format for the specified type.
abstract <T> void	setFormat(Class<? extends T> type, TextFormat<T> newFormat) Sets the text format for the specified type (and its sub-types).

Methods inherited from class javolution.context.AbstractContext

current, current, enter, enterInner, exit, getOuter, inherit, inner

Methods inherited from class java.lang.Object

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

Constructor Detail

TextContext

protected TextContext()

Default constructor.

Method Detail

enter

public static TextContext enter()

Enters and returns a new text context instance.

getFormat

public static <T> TextFormat<T> getFormat(Class<? extends T> type)

Returns the text format for the specified type. It is the most specialized format able to parse/format instances of the specified class. If there is no default format for the specified class, the standard object format (toString based) is returned.

setFormat

public abstract <T> void setFormat(Class<? extends T> type,
                 TextFormat<T> newFormat)

Sets the text format for the specified type (and its sub-types).

format

public static Appendable format(Object obj,
                Appendable dest)
                         throws IOException

Formats the specified object using its current format (convenience method).

Throws:

IOException

searchFormat

protected abstract <T> TextFormat<T> searchFormat(Class<? extends T> type)

Searches the most specialized format for the specified type.