Spec-Zone .ru спецификации, руководства, описания, API

javax.faces.convert
Класс NumberConverter

java.lang.Object
  javax.faces.convert.NumberConverter

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

PartialStateHolder, StateHolder, Преобразователь

public class NumberConverter
расширяет java.lang. Объект
Преобразователь реализаций, PartialStateHolder

Converter реализация для java.lang.Number значения.

getAsObject() метод анализирует Строку в java.lang.Double или java.lang.Long, согласно следующему алгоритму:

• Если указанная Строка является нулем, возвратите a null. Иначе, обрежьте ведущий и запаздывающий пробел перед продолжением.
• Если у указанной Строки - после обрезки - есть нулевая длина, возвратиться null.
• Если locale свойство не является нулем, используйте это Locale для того, чтобы управлять парсингом. Иначе, используйте Locale от UIViewRoot.
• Если a pattern был определен, его синтаксис должен приспособить правилам, определенным java.text.DecimalFormat. Такой образец будет использоваться, чтобы проанализировать, и type свойство будет проигнорировано.
• Если a pattern не был определен, парсинг будет основан на type свойство, которое ожидает валюту, число, или процент. Образец синтаксического анализа для валют, чисел, и процентов определяется, вызывая getCurrencyInstance(), getNumberInstance(), или getPercentInstance() метод java.text.NumberFormat class, передающий в выбранном Locale.
• Если integerOnly свойство было установлено в истину, только целочисленная часть Строки будет проанализирована. См. JavaDocs для setParseIntegerOnly() метод java.text.NumberFormat class для получения дополнительной информации.

getAsString() метод ожидает значение типа java.lang.Number (или подкласс), и создает отформатированную Строку согласно следующему алгоритму:

• Если указанное значение является нулем, возвратите Строку нулевую длиной.
• Если указанным значением является Строка, возвратите неизмененное.
• Если locale свойство не является нулем, используйте это Locale для того, чтобы управлять форматированием. Иначе, используйте Locale от FacesContext.
• Если a pattern был определен, его синтаксис должен приспособить правилам, определенным java.text.DecimalFormat. Такой образец будет использоваться, чтобы отформатировать, и type свойство (наряду со связанными параметрами форматирования, описанными в следующем абзаце), будет проигнорировано.
• Если a pattern не был определен, форматирование будет основано на type свойство, которое форматирует значение как валюту, число, или процент. Образец формата для валют, чисел, и процентов определяется, вызывая проценты, определяется, вызывая getCurrencyInstance(), getNumberInstance(), или getPercentInstance() метод java.text.NumberFormat class, передающий в выбранном Locale. Кроме того, следующие свойства будут применены к образцу формата, если определено:
  • Если groupingUsed свойство true, setGroupingUsed(true) метод на соответствии NumberFormat экземпляр вызовут.
  • Минимальное и максимальное количество цифр в целочисленных и дробных частях результата будет сконфигурировано основанное на любом наборе значений для maxFractionDigits, maxIntegerDigits, minFractionDigits, и minIntegerDigits свойства.
  • Если тип устанавливается в currency, также возможно сконфигурировать обозначение денежной единицы, которое будет использоваться, используя любого currencyCode или currencySymbol свойства. Если оба устанавливаются, значение для currencyCode имеет приоритет на JDK 1.4 (или позже) JVM; иначе, значение для currencySymbol имеет приоритет.

Полевая Сводка

static java.lang.String	CONVERTER_ID Стандартный идентификатор преобразователя для этого преобразователя.
static java.lang.String	CURRENCY_ID Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои.
static java.lang.String	NUMBER_ID Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои.
static java.lang.String	PATTERN_ID Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои.
static java.lang.String	PERCENT_ID Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои.
static java.lang.String	STRING_ID Идентификатор сообщения FacesMessage создаваться если преобразование Number значение к String сбои.

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

NumberConverter()

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

void	clearInitialState() Сбросьте PartialStateHolder к состоянию отслеживания недельты.
java.lang.Object	getAsObject(FacesContext context, UIComponent component, java.lang.String value) Преобразуйте указанное строковое значение, которое связывается с указанным UIComponent, в объект данных модели, который является подходящим для того, чтобы был сохранен во время Применять фазы Значений Запроса жизненного цикла обработки запросов.
java.lang.String	getAsString(FacesContext context, UIComponent component, java.lang.Object value) Преобразуйте указанное значение объекта модели, которое связывается с указанным UIComponent, в Строку, которая является подходящей для того, чтобы быть включенной в ответ, сгенерированный во время Представлять фазы Ответа обработки запросов lifeycle.
java.lang.String	getCurrencyCode() Возвратите код валюты ISO 4217, используемый getAsString() с a type из currency.
java.lang.String	getCurrencySymbol() Возвратите обозначение денежной единицы, используемое getAsString() с a type из currency.
java.util.Locale	getLocale() Возвратитесь Locale использоваться, анализируя числа.
int	getMaxFractionDigits() Возвратите максимальное количество цифр getAsString() должен представить в дробной части результата.
int	getMaxIntegerDigits() Возвратите максимальное количество цифр getAsString() должен представить в целочисленной части результата.
int	getMinFractionDigits() Возвратите минимальное число цифр getAsString() должен представить в дробной части результата.
int	getMinIntegerDigits() Возвратите минимальное число цифр getAsString() должен представить в целочисленной части результата.
java.lang.String	getPattern() Возвратите образец формата, который будет использоваться, форматируя и анализируя числа.
java.lang.String	getType() Возвратите тип числа, который будет использоваться, форматируя и анализируя числа.
boolean	initialStateMarked() Возвратиться true если изменения состояния дельты прослеживаются, иначе false
boolean	isGroupingUsed() Возвратиться true если getAsString должен включать группирующиеся разделители в случае необходимости.
boolean	isIntegerOnly() Возвратиться true если только целочисленная часть данного значения должна быть возвращена из getAsObject().
boolean	isTransient() Если это правда, Объект, реализовывая этот интерфейс не должен участвовать в сохранении состояния или восстановлении.
void	markInitialState() Время выполнения должно гарантировать что PartialStateHolder.markInitialState() метод вызывают на каждом экземпляре этого интерфейса в представлении в подходящее время, чтобы указать, что компонент находится в своем начальном состоянии.
void	restoreState(FacesContext context, java.lang.Object state) Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния.
java.lang.Object	saveState(FacesContext context) Получает состояние экземпляра как a Serializable Объект.
void	setCurrencyCode(java.lang.String currencyCode) Установите код валюты ISO 4217, используемый getAsString() с a type из currency.
void	setCurrencySymbol(java.lang.String currencySymbol) Установите обозначение денежной единицы, используемое getAsString() с a type из currency.
void	setGroupingUsed(boolean groupingUsed) Установите флаг, указывающий ли getAsString() должен включать группирующиеся разделители в случае необходимости.
void	setIntegerOnly(boolean integerOnly) Набор к true если только целочисленная часть данного значения должна быть возвращена из getAsObject().
void	setLocale(java.util.Locale locale) Установите Locale использоваться, анализируя числа.
void	setMaxFractionDigits(int maxFractionDigits) Установите максимальное количество цифр getAsString() должен представить в дробной части результата.
void	setMaxIntegerDigits(int maxIntegerDigits) Установите максимальное количество цифр getAsString() должен представить в целочисленной части результата.
void	setMinFractionDigits(int minFractionDigits) Определите минимальный номер цифр getAsString() должен представить в дробной части результата.
void	setMinIntegerDigits(int minIntegerDigits) Определите минимальный номер цифр getAsString() должен представить в целочисленной части результата.
void	setPattern(java.lang.String pattern) Установите образец формата, который будет использоваться, форматируя и анализируя числа.
void	setTransient(boolean transientFlag) Обозначает, должен ли Объект, реализовывая этот интерфейс или не должен участвовать в сохранении состояния или восстановлении.
void	setType(java.lang.String type) Установите тип числа, который будет использоваться, форматируя и анализируя числа.

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

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

Полевая Деталь

CONVERTER_ID

public static final java.lang.String CONVERTER_ID

Стандартный идентификатор преобразователя для этого преобразователя.

См. Также:

Постоянные Значения полей

CURRENCY_ID

public static final java.lang.String CURRENCY_ID

Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои. Строка формата сообщения для этого сообщения может дополнительно включать следующих заполнителей:

• {0} замененный непреобразованным значением.
• {1} замененный значением в качестве примера.
• {2} замененный a String чье значение является меткой входного компонента, который произвел это сообщение.

См. Также:

Постоянные Значения полей

NUMBER_ID

public static final java.lang.String NUMBER_ID

Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои. Строка формата сообщения для этого сообщения может дополнительно включать следующих заполнителей:

• {0} замененный непреобразованным значением.
HA
• {1} замененный значением в качестве примера.
• {2} замененный a String чье значение является меткой входного компонента, который произвел это сообщение.

См. Также:

Постоянные Значения полей

PATTERN_ID

public static final java.lang.String PATTERN_ID

Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои. Строка формата сообщения для этого сообщения может дополнительно включать следующих заполнителей:

• {0} замененный непреобразованным значением.
• {1} замененный значением в качестве примера.
• {2} замененный a String чье значение является меткой входного компонента, который произвел это сообщение.

См. Также:

Постоянные Значения полей

PERCENT_ID

public static final java.lang.String PERCENT_ID

Идентификатор сообщения FacesMessage создаваться если преобразование в Number сбои. Строка формата сообщения для этого сообщения может дополнительно включать следующих заполнителей:

• {0} замененный непреобразованным значением.
• {1} замененный значением в качестве примера.
• {2} замененный a String чье значение является меткой входного компонента, который произвел это сообщение.

См. Также:

Постоянные Значения полей

STRING_ID

public static final java.lang.String STRING_ID

Идентификатор сообщения FacesMessage создаваться если преобразование Number значение к String сбои. Строка формата сообщения для этого сообщения может дополнительно включать следующих заполнителей:

• {0} повторно зашнурованный непреобразованным значением.
• {1} замененный a String чье значение является меткой входного компонента, который произвел это сообщение.

См. Также:

Постоянные Значения полей

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

NumberConverter

public NumberConverter()

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

getCurrencyCode

public java.lang.String getCurrencyCode()

Возвратите код валюты ISO 4217, используемый getAsString() с a type из currency. Если не набор, используемое значение будет основано на форматировании Locale.

setCurrencyCode

public void setCurrencyCode(java.lang.String currencyCode)

Установите код валюты ISO 4217, используемый getAsString() с a type из currency.

Параметры:

currencyCode - Новый код валюты

getCurrencySymbol

public java.lang.String getCurrencySymbol()

Возвратите обозначение денежной единицы, используемое getAsString() с a type из currency. Если не набор, используемое значение будет основано на форматировании Locale.

setCurrencySymbol

public void setCurrencySymbol(java.lang.String currencySymbol)

Установите обозначение денежной единицы, используемое getAsString() с a type из currency.

Параметры:

currencySymbol - Новое обозначение денежной единицы

isGroupingUsed

public boolean isGroupingUsed()

Возвратиться true если getAsString должен включать группирующиеся разделители в случае необходимости. Если не измененный, значение по умолчанию true.

setGroupingUsed

public void setGroupingUsed(boolean groupingUsed)

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

Параметры:

groupingUsed - Новая группировка используемый флаг

isIntegerOnly

public boolean isIntegerOnly()

Возвратиться true если только целочисленная часть данного значения должна быть возвращена из getAsObject(). Если не измененный, значение по умолчанию false.

setIntegerOnly

public void setIntegerOnly(boolean integerOnly)

Набор к true если только целочисленная часть данного значения должна быть возвращена из getAsObject().

Параметры:

integerOnly - Новый флаг только для целого числа

getMaxFractionDigits

public int getMaxFractionDigits()

Возвратите максимальное количество цифр getAsString() должен представить в дробной части результата.

setMaxFractionDigits

public void setMaxFractionDigits(int maxFractionDigits)

Установите максимальное количество цифр getAsString() должен представить в дробной части результата. Если не набор, число цифр зависит от преобразовываемого значения.

Параметры:

maxFractionDigits - Новый предел

getMaxIntegerDigits

public int getMaxIntegerDigits()

Возвратите максимальное количество цифр getAsString() должен представить в целочисленной части результата.

setMaxIntegerDigits

public void setMaxIntegerDigits(int maxIntegerDigits)

Установите максимальное количество цифр getAsString() должен представить в целочисленной части результата. Если не набор, число цифр зависит от преобразовываемого значения.

Параметры:

maxIntegerDigits - Новый предел

getMinFractionDigits

public int getMinFractionDigits()

Возвратите минимальное число цифр getAsString() должен представить в дробной части результата.

setMinFractionDigits

public void setMinFractionDigits(int minFractionDigits)

Определите минимальный номер цифр getAsString() должен представить в дробной части результата. Если не набор, число цифр зависит от преобразовываемого значения.

Параметры:

minFractionDigits - Новый предел

getMinIntegerDigits

public int getMinIntegerDigits()

Возвратите минимальное число цифр getAsString() должен представить в целочисленной части результата.

setMinIntegerDigits

public void setMinIntegerDigits(int minIntegerDigits)

Определите минимальный номер цифр getAsString() должен представить в целочисленной части результата. Если не набор, число цифр зависит от преобразовываемого значения.

Параметры:

minIntegerDigits - Новый предел

getLocale

public java.util.Locale getLocale()

Возвратитесь Locale использоваться, анализируя числа. Если это значение null, Locale сохраненный в UIViewRoot поскольку текущий запрос будет использоваться.

setLocale

public void setLocale(java.util.Locale locale)

Установите Locale использоваться, анализируя числа. Если установлено в null, Locale сохраненный в UIViewRoot поскольку текущий запрос будет использоваться.

Параметры:

locale - Новое Locale (или null)

getPattern

public java.lang.String getPattern()

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

setPattern

public void setPattern(java.lang.String pattern)

Установите образец формата, который будет использоваться, форматируя и анализируя числа. Допустимые значения - поддерживаемые java.text.DecimalFormat. Недопустимое значение вызовет a ConverterException когда getAsObject() или getAsString() вызывается.

Параметры:

pattern - Новый образец формата

getType

public java.lang.String getType()

Возвратите тип числа, который будет использоваться, форматируя и анализируя числа. Если не измененный, тип значения по умолчанию number.

setType

public void setType(java.lang.String type)

Установите тип числа, который будет использоваться, форматируя и анализируя числа. Допустимые значения currency, number, или percent. Недопустимое значение вызовет a ConverterException когда getAsObject() или getAsString() вызывается.

Параметры:

type - Новый стиль числа

getAsObject

public java.lang.Object getAsObject(FacesContext context,
                                    UIComponent component,
                                    java.lang.String value)

Описание скопировало с интерфейса: Converter

Преобразуйте указанное строковое значение, которое связывается с указанным UIComponent, в объект данных модели, который является подходящим для того, чтобы был сохранен во время Применять фазы Значений Запроса жизненного цикла обработки запросов.

Определенный:

getAsObject в интерфейсе Converter

Параметры:

context - FacesContext для обрабатываемого запроса

component - UIComponent с которым связывается это значение объекта модели

value - Строковое значение, которое будет преобразовано (может быть null)

Возвраты:

null если значение, чтобы преобразовать null, иначе результат преобразования

Броски:

ConverterException - если преобразование не может быть успешно выполнено

java.lang.NullPointerException - если context или component null

getAsString

public java.lang.String getAsString(FacesContext context,
                                    UIComponent component,
                                    java.lang.Object value)

Описание скопировало с интерфейса: Converter

Преобразуйте указанное значение объекта модели, которое связывается с указанным UIComponent, в Строку, которая является подходящей для того, чтобы быть включенной в ответ, сгенерированный во время Представлять фазы Ответа обработки запросов lifeycle.

Определенный:

getAsString в интерфейсе Converter

Параметры:

context - FacesContext для обрабатываемого запроса

component - UIComponent с которым связывается это значение объекта модели

value - Значение объекта модели, которое будет преобразовано (может быть null)

Возвраты:

Строка нулевая длиной, если значение null, иначе результат преобразования

Броски:

ConverterException - если преобразование не может быть успешно выполнено

java.lang.NullPointerException - если context или component null

saveState

public java.lang.Object saveState(FacesContext context)

Описание скопировало с интерфейса: StateHolder

Получает состояние экземпляра как a Serializable Объект.

Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые реализуют StateHolder (такой как a UIComponent с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать StateHolder.saveState(javax.faces.context.FacesContext) метод на всех тех экземплярах также. Этот метод не должен сохранить состояние дочерних элементов и фасетов. Это делается через StateManager

Этот метод не должен изменить состояние объекта реализации. Другими словами, после выполнения этого кода:

 Object state = component.saveState(facesContext);
 

component должно быть то же самое как прежде, чем выполнить это.

Возврат из этого метода должен быть Serializable

Определенный:

saveState в интерфейсе StateHolder

restoreState

public void restoreState(FacesContext context,
                         java.lang.Object state)

Описание скопировало с интерфейса: StateHolder

Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния.

Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые также реализуют StateHolder (такой как a UIComponent с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object) метод на всех тех экземплярах также.

Если state параметр null, не предпримите меры и возврат.

Определенный:

restoreState в интерфейсе StateHolder

isTransient

public boolean isTransient()

Описание скопировало с интерфейса: StateHolder

Если это правда, Объект, реализовывая этот интерфейс не должен участвовать в сохранении состояния или восстановлении.

Определенный:

isTransient в интерфейсе StateHolder

setTransient

public void setTransient(boolean transientFlag)

Описание скопировало с интерфейса: StateHolder

Обозначает, должен ли Объект, реализовывая этот интерфейс или не должен участвовать в сохранении состояния или восстановлении.

Определенный:

setTransient в интерфейсе StateHolder

Параметры:

transientFlag - булева передача true если этот Объект не будет участвовать в сохранении состояния или восстановлении, иначе передайте false.

markInitialState

public void markInitialState()

Описание скопировало с интерфейса: PartialStateHolder

Время выполнения должно гарантировать что PartialStateHolder.markInitialState() метод вызывают на каждом экземпляре этого интерфейса в представлении в подходящее время, чтобы указать, что компонент находится в своем начальном состоянии. Конструктор интерфейса должен гарантировать это PartialStateHolder.initialStateMarked() возвраты true со времени markInitialState() до не вызывают PartialStateHolder.clearInitialState() вызывается, после который время initialStateMarked() должен возвратиться false. Кроме того, в течение времени, когда экземпляр возвращается true от initialStateMarked(), реализация должна возвратить только состояние, которое изменилось в его реализации StateHolder#saveState.

Определенный:

markInitialState в интерфейсе PartialStateHolder

initialStateMarked

public boolean initialStateMarked()

Описание скопировало с интерфейса: PartialStateHolder

Возвратиться true если изменения состояния дельты прослеживаются, иначе false

Определенный:

initialStateMarked в интерфейсе PartialStateHolder

clearInitialState

public void clearInitialState()

Описание скопировало с интерфейса: PartialStateHolder

Сбросьте PartialStateHolder к состоянию отслеживания недельты.

Определенный:

clearInitialState в интерфейсе PartialStateHolder