org.apache.commons.lang.text
Class CompositeFormat

java.lang.Object
  java.text.Format
      org.apache.commons.lang.text.CompositeFormat

All Implemented Interfaces:

java.lang.Cloneable, java.io.Serializable

public class CompositeFormat

extends java.text.Format

Formats using one formatter and parses using a different formatter. An example of use for this would be a webapp where data is taken in one way and stored in a database another way.

Version:

$Id: CompositeFormat.java 598710 2007-11-27 17:34:34Z mbenson $

Author:

Archimedes Trajano

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class java.text.Format

java.text.Format.Field

Constructor Summary

CompositeFormat(java.text.Format parser, java.text.Format formatter)
Create a format that points its parseObject method to one implementation and its format method to another.

Method Summary

java.lang.StringBuffer	format(java.lang.Object obj, java.lang.StringBuffer toAppendTo, java.text.FieldPosition pos) Uses the formatter Format instance.
java.text.Format	getFormatter() Provides access to the parser Format implementation.
java.text.Format	getParser() Provides access to the parser Format implementation.
java.lang.Object	parseObject(java.lang.String source, java.text.ParsePosition pos) Uses the parser Format instance.
java.lang.String	reformat(java.lang.String input) Utility method to parse and then reformat a String.

Methods inherited from class java.text.Format

clone, format, formatToCharacterIterator, parseObject

Methods inherited from class java.lang.Object

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

Constructor Detail

CompositeFormat

public CompositeFormat(java.text.Format parser,
                       java.text.Format formatter)

Create a format that points its parseObject method to one implementation and its format method to another.

Parameters:

parser - implementation

formatter - implementation

Method Detail

format

public java.lang.StringBuffer format(java.lang.Object obj,
                                     java.lang.StringBuffer toAppendTo,
                                     java.text.FieldPosition pos)

Uses the formatter Format instance.

Parameters:

obj - the object to format

toAppendTo - the StringBuffer to append to

pos - the FieldPosition to use (or ignore).

Returns:

toAppendTo

See Also:

Format.format(Object, StringBuffer, FieldPosition)

parseObject

public java.lang.Object parseObject(java.lang.String source,
                                    java.text.ParsePosition pos)

Uses the parser Format instance.

Parameters:

source - the String source

pos - the ParsePosition containing the position to parse from, will be updated according to parsing success (index) or failure (error index)

Returns:

the parsed Object

See Also:

Format.parseObject(String, ParsePosition)

getParser

public java.text.Format getParser()

Provides access to the parser Format implementation.

Returns:

parser Format implementation

getFormatter

public java.text.Format getFormatter()

Provides access to the parser Format implementation.

Returns:

formatter Format implementation

reformat

public java.lang.String reformat(java.lang.String input)
                          throws java.text.ParseException

Utility method to parse and then reformat a String.

Parameters:

input - String to reformat

Returns:

A reformatted String

Throws:

java.text.ParseException - thrown by parseObject(String) call