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

javax.faces.convert
Класс DateTimeConverter

java.lang.Object
  javax.faces.convert.DateTimeConverter

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

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

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

Converter реализация для java.util.Date значения.

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

• Если указанная Строка является нулем, возвратите a null. Иначе, обрежьте ведущий и запаздывающий пробел перед продолжением.
• Если у указанной Строки - после обрезки - есть нулевая длина, возвратиться null.
• Если locale свойство не является нулем, используйте это Locale для того, чтобы управлять парсингом. Иначе, используйте Locale от UIViewRoot.
• Если a pattern был определен, его синтаксис должен приспособить правилам, определенным java.text.SimpleDateFormat. Такой образец будет использоваться, чтобы проанализировать, и type, dateStyle, и timeStyle свойства будут проигнорированы.
• Если a pattern не был определен, парсинг будет основан на type свойство, которое ожидает значение даты, временную стоимость, или обоих. Любая дата и включенные временные стоимости будут проанализированы в соответствии со стилями, определенными dateStyle и timeStyle, соответственно.
• Если a timezone был определен, это нужно передать к базовому DateFormat экземпляр. Иначе часовой пояс "GMT" используется.
• Во всех случаях парсинг должен быть неснисходительным; данная строка должна строго придерживаться формата парсинга.

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

• Если указанное значение является нулем, возвратите Строку нулевую длиной.
• Если указанным значением является Строка, возвратите неизмененное.
• Если locale свойство не является нулем, используйте это Locale для того, чтобы управлять форматированием. Иначе, используйте Locale от UIViewRoot.
• Если a timezone был определен, это нужно передать к базовому DateFormat экземпляр. Иначе часовой пояс "GMT" используется.
• Если a pattern был определен, его синтаксис должен приспособить правилам, определенным java.text.SimpleDateFormat. Такой образец будет использоваться, чтобы отформатировать, и type, dateStyle, и timeStyle свойства будут проигнорированы.
• Если a pattern не был определен, форматирование будет основано на type свойство, которое включает значение даты, временную стоимость, или обоих в отформатированную Строку. Любая дата и включенные временные стоимости будут отформатированы в соответствии со стилями, определенными dateStyle и timeStyle, соответственно.

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

static java.lang.String	CONVERTER_ID Стандартный идентификатор преобразователя для этого преобразователя.
static java.lang.String	DATE_ID Идентификатор сообщения FacesMessage создаваться если преобразование в Date сбои.
static java.lang.String	DATETIME_ID Идентификатор сообщения FacesMessage создаваться если преобразование в DateTime сбои.
static java.lang.String	STRING_ID Идентификатор сообщения FacesMessage создаваться если преобразование DateTime значение к String сбои.
static java.lang.String	TIME_ID Идентификатор сообщения FacesMessage создаваться если преобразование в Time сбои.

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

DateTimeConverter()

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

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	getDateStyle() Возвратите стиль, который будет использоваться, чтобы отформатировать или проанализировать даты.
java.util.Locale	getLocale() Возвратитесь Locale использоваться, анализируя или форматируя даты и времена.
java.lang.String	getPattern() Возвратите образец формата, который будет использоваться, форматируя и анализируя даты и времена.
java.lang.String	getTimeStyle() Возвратите стиль, который будет использоваться, чтобы отформатировать или проанализировать времена.
java.util.TimeZone	getTimeZone() Возвратитесь TimeZone используемый, чтобы интерпретировать временную стоимость.
java.lang.String	getType() Возвратите тип имеющий значение, который будет отформатирован или проанализирован.
boolean	initialStateMarked() Возвратиться true если изменения состояния дельты прослеживаются, иначе false
boolean	isTransient() Если это правда, Объект, реализовывая этот интерфейс не должен участвовать в сохранении состояния или восстановлении.
void	markInitialState() Время выполнения должно гарантировать что PartialStateHolder.markInitialState() метод вызывают на каждом экземпляре этого интерфейса в представлении в подходящее время, чтобы указать, что компонент находится в своем начальном состоянии.
void	restoreState(FacesContext context, java.lang.Object state) Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния.
java.lang.Object	saveState(FacesContext context) Получает состояние экземпляра как a Serializable Объект.
void	setDateStyle(java.lang.String dateStyle) Установите стиль, который будет использоваться, чтобы отформатировать или проанализировать даты.
void	setLocale(java.util.Locale locale) Установите Locale использоваться, анализируя или форматируя даты и времена.
void	setPattern(java.lang.String pattern) Установите образец формата, который будет использоваться, форматируя и анализируя даты и времена.
void	setTimeStyle(java.lang.String timeStyle) Установите стиль, который будет использоваться, чтобы отформатировать или проанализировать времена.
void	setTimeZone(java.util.TimeZone timeZone) Установите TimeZone используемый, чтобы интерпретировать временную стоимость.
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

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

См. Также:

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

DATE_ID

public static final java.lang.String DATE_ID

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

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

См. Также:

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

TIME_ID

public static final java.lang.String TIME_ID

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

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

См. Также:

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

DATETIME_ID

public static final java.lang.String DATETIME_ID

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

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

См. Также:

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

STRING_ID

public static final java.lang.String STRING_ID

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

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

См. Также:

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

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

DateTimeConverter

public DateTimeConverter()

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

getDateStyle

public java.lang.String getDateStyle()

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

setDateStyle

public void setDateStyle(java.lang.String dateStyle)

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

Параметры:

dateStyle - Модернизированный код

getLocale

public java.util.Locale getLocale()

Возвратитесь Locale использоваться, анализируя или форматируя даты и времена. Если явно не установлено, 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.SimpleDateFormat. Недопустимое значение вызовет a ConverterException когда getAsObject() или getAsString() вызывается.

Параметры:

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

getTimeStyle

public java.lang.String getTimeStyle()

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

setTimeStyle

public void setTimeStyle(java.lang.String timeStyle)

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

Параметры:

timeStyle - Модернизированный код

getTimeZone

public java.util.TimeZone getTimeZone()

Возвратитесь TimeZone используемый, чтобы интерпретировать временную стоимость. Если явно не установлено, часовой пояс значения по умолчанию GMT возвращенный.

setTimeZone

public void setTimeZone(java.util.TimeZone timeZone)

Установите TimeZone используемый, чтобы интерпретировать временную стоимость.

Параметры:

timeZone - Новый часовой пояс

getType

public java.lang.String getType()

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

setType

public void setType(java.lang.String type)

Установите тип имеющий значение, который будет отформатирован или проанализирован. Допустимые значения both, date, или time. Недопустимое значение вызовет 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