compact1, compact2, compact3

java.text

Class Format

java.lang.Object

java.text.Format

All Implemented Interfaces:

Serializable， Cloneable

已知直接子类：

DateFormat， MessageFormat， NumberFormat

public abstract class Format
extends Object
implements Serializable, Cloneable

Format是格式化的区域敏感信息，如日期、消息的一个抽象基类，和数字。

Format定义格式现场敏感对象为Strings编程接口（的format法）和解析Strings回对象（的parseObject法）。

一般来说，一个格式的parseObject方法必须能够分析任何字符串的格式format方法。然而，有可能是特殊情况下，这是不可能的。例如，一个format方法可以创建两个相邻的整数之间没有分隔符，在这种情况下，parseObject不能告诉这位属于哪个号码。

子类别化

java平台提供三个专业子Format -- DateFormat，MessageFormat，和NumberFormat --格式化日期，消息，和数字，分别。

具体的子类必须实现三种方法：

1. format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
2. formatToCharacterIterator(Object obj)
3. parseObject(String source, ParsePosition pos)

这些一般方法允许多态性解析和格式化对象和使用，例如，通过 MessageFormat。子类通常也提供特定的输入类型的附加 format方法以及具体的结果类型 parse方法。任何 parse方法，不需要 ParsePosition争论应该把 ParseException时要求的格式中没有文字是在输入文本的开始。

大多数子类也将实现以下工厂方法：

1. 得到一个有用的对象格式适合当前现场getInstance
2. 得到一个有用的对象格式适合于指定的区域getInstance(Locale)

此外，一些子类还可以实现更多的特殊的控制方法等 getXxxxInstance。例如，在 NumberFormat类提供专门的号码格式化 getPercentInstance和 getCurrencyInstance方法。

对Format允许程序员创建对象的子类（与地方getInstance(Locale)例如）也必须实施以下类的方法：

 public static Locale[] getAvailableLocales()
 

最后，子类可以定义一组常量，以确定格式化输出中的各个字段。这些常数是用来创建一个力场排斥的对象，确定什么样的信息是包含在场及其在格式化结果的位置。这些常量应该被命名为item_FIELD哪里item标识字段。对于这些常数的例子，看到DateFormat ERA_FIELD和它的朋友。

Synchronization

格式一般不同步。建议为每个线程创建单独的格式实例。如果多个线程同时访问一个格式，则必须在外部同步。

另请参见：

ParsePosition， FieldPosition， NumberFormat， DateFormat， MessageFormat， Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Format.Field 定义常数，作为在 AttributedCharacterIterator属性的钥匙从 Format.formatToCharacterIterator作为 FieldPosition字段标识符返回。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Format() 唯一的构造函数。

方法摘要

Modifier and Type	Method and Description
Object	clone() 创建并返回此对象的副本。
String	format(Object obj) 格式化一个对象以产生一个字符串。
abstract StringBuffer	format(Object obj, StringBuffer toAppendTo, FieldPosition pos) 格式对象和将产生的文本到一个给定的字符串缓冲区。
AttributedCharacterIterator	formatToCharacterIterator(Object obj) 格式对象产生一个 AttributedCharacterIterator。
Object	parseObject(String source) 解析文本从给定的字符串生成一个对象的开始。
abstract Object	parseObject(String source, ParsePosition pos) 解析文本字符串以产生一个对象。

Methods inherited from class java.lang.Object

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

Constructor Detail

Format

protected Format()

唯一的构造函数。（用于调用子类构造函数，通常是隐式的。）

方法详细信息

format

public final String format(Object obj)

格式化一个对象以产生一个字符串。这相当于

format (obj, new StringBuffer(), new FieldPosition(0)).toString();

参数

obj -格式化对象

结果

格式化字符串。

异常

IllegalArgumentException如果给定对象的格式不格式

format

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

格式对象和将产生的文本到一个给定的字符串缓冲区。如果 pos参数识别的格式使用领域，那么其指标设置开始和结束的第一场遭遇。

参数

obj -格式化对象

toAppendTo，文本是要追加

pos - FieldPosition识别格式化文本字段

结果

字符串缓冲区传递为 toAppendTo，带格式文本追加

异常

NullPointerException -如果 toAppendTo或 pos是空的

IllegalArgumentException如果给定对象的格式不格式

formatToCharacterIterator

public AttributedCharacterIterator formatToCharacterIterator(Object obj)

格式对象产生一个 AttributedCharacterIterator。你可以使用返回的 AttributedCharacterIterator建立得到的字符串，以及确定得到的字符串信息。

attributedcharacteriterator每个属性的关键将是Field型。这是每一Format实现定义在AttributedCharacterIterator每个属性的法律价值是什么，但通常情况下，属性也主要是作为属性值。

默认的实现创造了一个AttributedCharacterIterator没有属性。子类，支持领域应重写此创造有意义的属性AttributedCharacterIterator。

参数

obj -格式化对象

结果

attributedcharacteriterator描述格式化值。

异常

NullPointerException如果obj是空的。

IllegalArgumentException当格式不格式给定的对象。

从以下版本开始：

一点四

parseObject

public abstract Object parseObject(String source,
                                   ParsePosition pos)

解析文本字符串以产生一个对象。

解析文本开始了pos索引的方法尝试。如果分析成功，那么pos索引更新索引的最后一个字符后（解析不一定使用所有字符到字符串的末尾），和解析对象返回。更新pos可以用来指示下一个调用这个方法的出发点。如果出现错误，那么pos指标没有发生变化，对pos误差指标设置为错误发生位置的字符的索引，并返回null。

参数

source - String，其中一部分会被解析。

pos -一个指标和误差指标上述信息， ParsePosition对象。

结果

一个 Object解析字符串。在错误的情况下，返回空。

异常

NullPointerException -如果 pos是空的。

parseObject

public Object parseObject(String source)
                   throws ParseException

解析文本从给定的字符串生成一个对象的开始。该方法可能不使用给定字符串的整个文本。

参数

source - String始应解析。

结果

一个 Object解析字符串。

异常

ParseException -如果不能指定字符串的开始被解析。

clone

public Object clone()

创建并返回此对象的副本。

重写：

clone 方法重写，继承类 Object

结果

这个实例的克隆。

另请参见：

Cloneable