java.text

Формат класса

java.lang. Объект

java.text. Формат

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

Прямые Известные Подклассы:

DateFormat, MessageFormat, NumberFormat

public abstract class Format
extends Object
implements Serializable, Cloneable

Format абстрактный базовый класс для того, чтобы отформатировать уязвимую информацию локали, такую как даты, сообщения, и числа.

Format определяет интерфейс программирования для того, чтобы отформатировать чувствительные к локали объекты в Strings ( format метод) и для того, чтобы проанализировать Strings назад в объекты ( parseObject метод).

Обычно, формат parseObject метод должен быть в состоянии проанализировать любую строку, отформатированную format метод. Однако, могут быть исключительные случаи, где это не возможно. Например, a 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 метод, который не берет a ParsePosition параметр должен бросить ParseException когда никакой текст в необходимом формате не в начале входного текста.

Большинство подклассов также реализует следующие методы фабрики:

1. getInstance для того, чтобы получить полезный формат возражают соответствующий для текущей локали
2. getInstance(Locale) для того, чтобы получить полезный формат возражают соответствующий для указанной локали

Кроме того, некоторые подклассы могут также реализовать другой getXxxxInstance методы для более специализированного управления. Например, NumberFormat класс обеспечивает getPercentInstance и getCurrencyInstance методы для того, чтобы получить специализированные средства форматирования числа.

Подклассы Format это позволяет программистам создавать объекты для локалей (с getInstance(Locale) например), должен также реализовать следующий метод класса:

 public static Locale[] getAvailableLocales()
 

И наконец подклассы могут определить ряд констант, чтобы идентифицировать различные поля в отформатированном выводе. Эти константы используются, чтобы создать объект FieldPosition, который идентифицирует, какая информация содержится в поле и его позиции в отформатированном результате. Эти константы нужно назвать item_FIELD где item идентифицирует поле. Для примеров этих констант см. ERA_FIELD и его друзья в DateFormat.

Синхронизация

Форматы обычно не синхронизируются. Рекомендуется создать отдельные экземпляры формата для каждого потока. Если многократные потоки получают доступ к формату одновременно, он должен синхронизироваться внешне.

См. Также:

ParsePosition, FieldPosition, NumberFormat, DateFormat, MessageFormat, Сериализированная Форма

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
static class	Формат. Поле Определяет константы, которые используются, поскольку атрибут вводит AttributedCharacterIterator возвращенный из Format.formatToCharacterIterator и как полевые идентификаторы в FieldPosition.

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	Format() Единственный конструктор.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Создает и возвращает копию этого объекта.
Строка	format(Object obj) Форматирует объект произвести строку.
abstract StringBuffer	format(Object obj, StringBuffer toAppendTo, FieldPosition pos) Форматирует объект и добавляет получающийся текст к данному строковому буферу.
AttributedCharacterIterator	formatToCharacterIterator(Object obj) Форматирует Объект, производящий AttributedCharacterIterator.
Объект	parseObject(String source) Текст синтаксических анализов с начала данной строки произвести объект.
abstract Object	parseObject(String source, ParsePosition pos) Текст синтаксических анализов от строки, чтобы произвести объект.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

Формат

protected Format()

Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)

Деталь метода

формат

public final String format(Object obj)

Форматирует объект произвести строку. Это эквивалентно

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

Параметры:

obj - Объект отформатировать

Возвраты:

Отформатированная строка.

Броски:

IllegalArgumentException - если Формат не может отформатировать данный объект

формат

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

Форматирует объект и добавляет получающийся текст к данному строковому буферу. Если pos параметр идентифицирует поле, используемое форматом, тогда его индексы устанавливаются в начало и конец первого такое поле, с которым встречаются.

Параметры:

obj - Объект отформатировать

toAppendTo - где текст должен быть добавлен

pos - A 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 - когда Формат не может отформатировать данный объект.

С тех пор:

1.4

parseObject

public abstract Object parseObject(String source,
                 ParsePosition pos)

Текст синтаксических анализов от строки, чтобы произвести объект.

Метод пытается проанализировать текст, запускающийся по индексу, данному pos. Если парсинг успешно выполняется, то индекс pos обновляется к индексу после используемого последнего знака (парсинг не обязательно израсходовал все символы до конца строки), и проанализированный объект возвращается. Обновленный pos может использоваться, чтобы указать на начальную точку для следующего звонка в этот метод. Если ошибка происходит, то индекс pos не изменяется, ошибочный индекс pos устанавливается в индекс символа, где ошибка произошла, и нуль возвращается.

Параметры:

source - A String, часть которого должна быть проанализирована.

pos - A ParsePosition объект с индексом и ошибкой индексирует информацию как описано выше.

Возвраты:

Object проанализированный от строки. В случае ошибки, нуля возвратов.

Броски:

NullPointerException - если pos нуль.

parseObject

public Object parseObject(String source)
                   throws ParseException

Текст синтаксических анализов с начала данной строки произвести объект. Метод, возможно, не использует весь текст данной строки.

Параметры:

source - A String чье начало должно быть проанализировано.

Возвраты:

Object проанализированный от строки.

Броски:

ParseException - если начало указанной строки не может быть проанализировано.

клон

public Object clone()

Создает и возвращает копию этого объекта.

Переопределения:

clone в классе Object

Возвраты:

клон этого экземпляра.

См. Также:

Cloneable