|
Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
| ПРЕДЫДУЩИЙ СЛЕДУЮЩИЙ КЛАСС КЛАССА | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
| СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД | ||||||||
java.lang.Objectjavax.faces.application.Application
public abstract class Application
Приложение представляет одноэлементный объект на веб-приложение, где приложения, основанные на Поверхностях JavaServer (или реализации, желающие обеспечить расширенную функциональность), могут зарегистрировать одиночные элементы всего приложения, которые обеспечивают функциональность, требуемую Поверхностями JavaServer. Реализации по умолчанию каждого объекта обеспечиваются для случаев, где приложение не хочет настраивать поведение.
Экземпляр Application создается, вызывая getApplication() метод ApplicationFactory. Поскольку этот экземпляр совместно используется, он должен быть реализован ориентированным на многопотоковое исполнение способом.
Приложение также действует как фабрика для нескольких типов Объектов, определенных в Конфигурационном файле Поверхностей. Пожалуйста, см. Application#createComponent, Application#createConverter, и Application#createValidator.
| Сводка конструктора | |
|---|---|
Application()
|
|
| Сводка метода | ||
|---|---|---|
void |
addBehavior(java.lang.String behaviorId, java.lang.String behaviorClass)
Зарегистрируйте новое отображение идентификатора поведения к имени соответствия Behavior class. |
|
abstract void |
addComponent(java.lang.String componentType, java.lang.String componentClass)
Зарегистрируйте новое отображение компонентного типа к имени соответствия UIComponent class. |
|
abstract void |
addConverter(java.lang.Class<?> targetClass, java.lang.String converterClass)
Зарегистрируйте новый преобразователь class, который способен к выполнению преобразований для указанного целевого class. |
|
abstract void |
addConverter(java.lang.String converterId, java.lang.String converterClass)
Зарегистрируйте новое отображение идентификатора преобразователя к имени соответствия Converter class. |
|
void |
addDefaultValidatorId(java.lang.String validatorId)
Зарегистрируйте блок проверки допустимости его идентификатором, который применяется ко всем |
|
void |
addELContextListener(ELContextListener listener)
Обеспечьте путь к приложениям Поверхностей, чтобы зарегистрироваться ELContextListener это будет уведомлено относительно создания ELContext экземпляры. |
|
void |
addELResolver(ELResolver resolver)
Вызовите параметр resolver быть добавленным к цепочке преобразователя как определено в разделе JSF.5.5.1 Спецификации Поверхностей JavaServer. |
|
abstract void |
addValidator(java.lang.String validatorId, java.lang.String validatorClass)
Зарегистрируйте новое отображение идентификатора блока проверки допустимости к имени соответствия Validator class. |
|
Поведение |
createBehavior(java.lang.String behaviorId)
Инстанцируйте и возвратите новое Behavior экземпляр class определяется предыдущим звонком addBehavior() для указанного идентификатора поведения. |
|
UIComponent |
createComponent(FacesContext context, Resource componentResource)
Инстанцируйте и возвратите новое |
|
UIComponent |
createComponent(FacesContext context, java.lang.String componentType, java.lang.String rendererType)
Как |
|
abstract UIComponent |
createComponent(java.lang.String componentType)
Инстанцируйте и возвратите новое UIComponent экземпляр class определяется предыдущим звонком addComponent() для указанного компонентного типа. |
|
abstract UIComponent |
createComponent(ValueBinding componentBinding, FacesContext context, java.lang.String componentType)
Осуждаемый. Это было заменено createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String). |
|
UIComponent |
createComponent(ValueExpression componentExpression, FacesContext context, java.lang.String componentType)
Вызовите getValue() метод на указанном ValueExpression. |
|
UIComponent |
createComponent(ValueExpression componentExpression, FacesContext context, java.lang.String componentType, java.lang.String rendererType)
Как |
|
abstract Converter |
createConverter(java.lang.Class<?> targetClass)
Инстанцируйте и возвратите новое Converter экземпляр class, который зарегистрировал себя как способный к выполнению преобразований для объектов указанного типа. |
|
abstract Converter |
createConverter(java.lang.String converterId)
Инстанцируйте и возвратите новое Converter экземпляр class определяется предыдущим звонком addConverter() для указанного идентификатора преобразователя. |
|
abstract MethodBinding |
createMethodBinding(java.lang.String ref, java.lang.Class<?>[] params)
Осуждаемый. Это было заменено, вызывая getExpressionFactory() тогда ExpressionFactory#createMethodExpression. |
|
abstract Validator |
createValidator(java.lang.String validatorId)
Инстанцируйте и возвратите новое Validator экземпляр class определяется предыдущим звонком addValidator() для указанного идентификатора блока проверки допустимости. |
|
abstract ValueBinding |
createValueBinding(java.lang.String ref)
Осуждаемый. Это было заменено, вызывая getExpressionFactory() тогда ExpressionFactory#createValueExpression. |
|
|
evaluateExpressionGet(FacesContext context, java.lang.String expression, java.lang.Class<? extends T> expectedType)
Получите значение, оценивая выражение. |
|
abstract ActionListener |
getActionListener()
Возвратите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты в этом appication. |
|
java.util.Iterator<java.lang.String> |
getBehaviorIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов поведения для этого Application. |
|
abstract java.util.Iterator<java.lang.String> |
getComponentTypes()
Возвратитесь Iterator по набору в настоящий момент определенного компонента вводит для этого Application. |
|
abstract java.util.Iterator<java.lang.String> |
getConverterIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов преобразователя для этого Application. |
|
abstract java.util.Iterator<java.lang.Class<?>> |
getConverterTypes()
Возвратитесь Iterator по набору Class экземпляры те, для который Converter классы были явно зарегистрированы. |
|
abstract java.util.Locale |
getDefaultLocale()
Возвратите значение по умолчанию Locale для этого приложения. |
|
abstract java.lang.String |
getDefaultRenderKitId()
Возвратитесь renderKitId использоваться для того, чтобы представить это приложение. |
|
java.util.Map<java.lang.String,java.lang.String> |
getDefaultValidatorInfo()
Возвратите неизменное |
|
ELContextListener[] |
getELContextListeners()
Если никакие вызовы не были выполнены к addELContextListener(javax.el.ELContextListener), этот метод должен возвратить пустой массив. |
|
ELResolver |
getELResolver()
Возвратите одиночный элемент ELResolver экземпляр, который будет использоваться для всего ЭЛЬ разрешения. |
|
ExpressionFactory |
getExpressionFactory()
Возвратитесь ExpressionFactory экземпляр для этого приложения. |
|
abstract java.lang.String |
getMessageBundle()
Возвратите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. |
|
abstract NavigationHandler |
getNavigationHandler()
Возвратитесь NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения. |
|
ProjectStage |
getProjectStage()
Возвратите этап проекта для в настоящий момент рабочего экземпляра приложения. |
|
abstract PropertyResolver |
getPropertyResolver()
Осуждаемый. Это было заменено getELResolver(). |
|
java.util.ResourceBundle |
getResourceBundle(FacesContext ctx, java.lang.String name)
Найдите a ResourceBundle как определено в ресурсах конфигурации приложения под указанным именем. |
|
ResourceHandler |
getResourceHandler()
Возвратите одиночный элемент, не сохраняющий состояние, ориентированный на многопотоковое исполнение |
|
abstract StateManager |
getStateManager()
Возвратитесь StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
abstract java.util.Iterator<java.util.Locale> |
getSupportedLocales()
Возвратитесь Iterator по поддерживаемому Locales для этого appication. |
|
abstract java.util.Iterator<java.lang.String> |
getValidatorIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов блока проверки допустимости для этого Application. |
|
abstract VariableResolver |
getVariableResolver()
Осуждаемый. Это было заменено getELResolver(). |
|
abstract ViewHandler |
getViewHandler()
Возвратитесь ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
void |
publishEvent(FacesContext context, java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceBaseType, java.lang.Object source)
Этот метод функционирует точно как |
|
void |
publishEvent(FacesContext context, java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Object source)
Если |
|
void |
removeELContextListener(ELContextListener listener)
Удалите параметр listener от списка ELContextListeners. |
|
abstract void |
setActionListener(ActionListener listener)
Установите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты. |
|
abstract void |
setDefaultLocale(java.util.Locale locale)
Установите значение по умолчанию Locale для этого приложения. |
|
abstract void |
setDefaultRenderKitId(java.lang.String renderKitId)
Установите renderKitId использоваться, чтобы представить это приложение. |
|
abstract void |
setMessageBundle(java.lang.String bundle)
Определите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. |
|
abstract void |
setNavigationHandler(NavigationHandler handler)
Установите NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения. |
|
abstract void |
setPropertyResolver(PropertyResolver resolver)
Осуждаемый. Рекомендуемый способ влиять на выполнение ЭЛЬ состоит в том, чтобы обеспечить <el-resolver> элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver быть обернутым в реализации ELResolver и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver). |
|
void |
setResourceHandler(ResourceHandler resourceHandler)
Установите |
|
abstract void |
setStateManager(StateManager manager)
Установите StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
abstract void |
setSupportedLocales(java.util.Collection<java.util.Locale> locales)
Установите Locale экземпляры, представляющие поддерживаемый Locales для этого приложения. |
|
abstract void |
setVariableResolver(VariableResolver resolver)
Осуждаемый. Рекомендуемый способ влиять на выполнение ЭЛЬ состоит в том, чтобы обеспечить <el-resolver> элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver быть обернутым в реализации ELResolver и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver). |
|
abstract void |
setViewHandler(ViewHandler handler)
Установите ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
void |
subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceClass, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр |
|
void |
subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр |
|
void |
unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceClass, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр |
|
void |
unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр |
|
| Методы, наследованные от class java.lang. Объект |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Деталь конструктора |
|---|
public Application()
| Деталь метода |
|---|
public abstract ActionListener getActionListener()
Возвратите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты в этом appication. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет следующие функции:
processAction() метод должен сначала вызвать FacesContext.renderResponse() чтобы обойти любые прошедшие фазы жизненного цикла, когда-то метод возвращается.processAction() метод должен затем определить логический результат этого события, следующим образом: null
action свойство, получите MethodBinding от свойства, и вызова invoke() на этом. Преобразуйте возвращенное значение (если любой) к Строке, и используйте его в качестве логического результата.null.processAction() метод должен наконец получить NavigationHandler экземпляр для этого приложения и вызова NavigationHandler#handleNavigation передача: FacesContext для текущего запросаMethodBinding экземпляр для action свойство этого компонента, результат вызова MethodBinding#getExpressionString на этом, нуль иначеОтметьте что спецификация значением по умолчанию ActionListener contiues, чтобы призвать к использованию осуждаемого свойства (action) и class (MethodBinding). К сожалению, это необходимо потому что значение по умолчанию ActionListener должен продолжать работать с компонентами, которые не реализуют ActionSource2, и только реализация ActionSource.
public abstract void setActionListener(ActionListener listener)
Установите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты.
listener - Новое значение по умолчанию ActionListener
java.lang.NullPointerException - если listener nullpublic abstract java.util.Locale getDefaultLocale()
Возвратите значение по умолчанию Locale для этого приложения. Если явно не установлено, null возвращается.
public abstract void setDefaultLocale(java.util.Locale locale)
Установите значение по умолчанию Locale для этого приложения.
locale - Новое значение по умолчанию Locale
java.lang.NullPointerException - если locale nullpublic abstract java.lang.String getDefaultRenderKitId()
Возвратитесь renderKitId использоваться для того, чтобы представить это приложение. Если явно не установлено, null возвращается.
public abstract void setDefaultRenderKitId(java.lang.String renderKitId)
Установите renderKitId использоваться, чтобы представить это приложение. Если клиент не обеспечил пользовательское ViewHandler это поддерживает использование многократных RenderKit экземпляры в том же самом приложении, этот метод нужно только вызвать при запуске приложения, прежде, чем любые запросы Поверхностей были обработаны. Это - ограничение текущей Спецификации, и может быть снято в будущем выпуске.
public abstract java.lang.String getMessageBundle()
Возвратите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. Если явно не установлено, null возвращается.
public abstract void setMessageBundle(java.lang.String bundle)
Определите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. См. JavaDocs для java.util.ResourceBundle class для получения дополнительной информации о синтаксисе для ресурса связывает имена.
bundle - Базовое имя ресурса связывается, чтобы использоваться java.lang.NullPointerException - если bundle nullpublic abstract NavigationHandler getNavigationHandler()
Возвратитесь NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в NavigationHandler Описание class.
public abstract void setNavigationHandler(NavigationHandler handler)
Установите NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения.
handler - Новое NavigationHandler экземпляр java.lang.NullPointerException - если handler nullpublic ResourceHandler getResourceHandler()
Возвратите одиночный элемент, не сохраняющий состояние, ориентированный на многопотоковое исполнение ResourceHandler для этого приложения. Реализация JSF должна поддерживать следующие методы для того, чтобы объявить альтернативную реализацию ResourceHandler.
ResourceHandler реализация объявляется в ресурсах конфигурации приложения, давая полностью определенное имя class как значение <resource-handler> элемент в пределах <application> элемент.
Во всех вышеупомянутых случаях время выполнения должно использовать шаблон "декоратор" что касается любого сменного артефакта в JSF.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать
public void setResourceHandler(ResourceHandler resourceHandler)
Установите ResourceHandler экземпляр, который будет использоваться для того, чтобы представить разметку для ресурсов, и для того, чтобы удовлетворить клиентские запросы, чтобы подать ресурсы.
resourceHandler - Новое ResourceHandler экземпляр IllegalStateException - если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle экземпляр для этого приложения. java.lang.NullPointerException - если resourceHandler null
public abstract PropertyResolver getPropertyResolver()
getELResolver().
Возвратите a PropertyResolver экземпляр, который переносится ELResolver экземпляр, который Поверхности обеспечивают для объединенного ЭЛЬ для разрешения выражений, которые появляются программно в приложении.
Отметьте, что это больше не возвращает значение по умолчанию PropertyResolver с тех пор, что class теперь не, который помогает в разрешении пользовательского PropertyResolvers, чтобы влиять на ЭЛЬ процесс разрешения.
public abstract void setPropertyResolver(PropertyResolver resolver)
<el-resolver> элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver быть обернутым в реализации ELResolver и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver).
Установите PropertyResolver экземпляр, который будет использоваться, чтобы разрешить привязка значения и метод.
Этот метод теперь осуждается, но реализация должна заставить параметр быть установленным как глава наследства PropertyResolver цепочка, заменяя любое существующее значение, которое было установлено от ресурсов конфигурации приложения.
Это недопустимо, чтобы вызвать этот метод после того, как приложение получило любые запросы от клиента. Если попытка предпринимается, чтобы зарегистрировать слушателя после того времени, это не должно иметь никакого эффекта.
resolver - Новое PropertyResolver экземпляр java.lang.NullPointerException - если resolver null
IllegalStateException - если вызвано после первого запроса к FacesServlet был обслужен.
public java.util.ResourceBundle getResourceBundle(FacesContext ctx,
java.lang.String name)
Найдите a ResourceBundle как определено в ресурсах конфигурации приложения под указанным именем. Если a ResourceBundle был определен для имени, возвратите экземпляр, который использует локаль тока UIViewRoot.
Броски реализации по умолчанию UnsupportedOperationException и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class.
ResourceBundle для текущего UIViewRoot, иначе нуль FacesException - если пакет был определен, но не разрешимый java.lang.NullPointerException - если ctx == нуль || называют == нульpublic ProjectStage getProjectStage()
Возвратите этап проекта для в настоящий момент рабочего экземпляра приложения. Значение по умолчанию ProjectStage#Production
Реализация этого метода должна выполнить следующий алгоритм или эквивалент с тем же самым конечным результатом, чтобы определить значение, чтобы возвратиться.
Если значение было уже определено предыдущим звонком в этот метод, просто возвратите то значение.
Ищите a JNDI запись среды под ключом, данным значением ProjectStage#PROJECT_STAGE_JNDI_NAME (возвратите тип java.lang.String). Если найдено, продолжайте с алгоритмом ниже, иначе, ищите запись в initParamMap из ExternalContext от тока FacesContext с ключом, данным значением ProjectStage#PROJECT_STAGE_PARAM_NAME
Если значение находится, см., может ли перечислимая константа быть получена, вызывая ProjectStage.valueOf(), передача значения от initParamMap. Если это успешно выполняется без исключения, сохраните значение и возвратите его.
Если не найденный, или какая-либо из предыдущих попыток обнаружить перечислимую постоянную величину перестали работать, зарегистрируйте дескриптивное сообщение об ошибке, присвойте значение как ProjectStage.Production и возвратите это.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать
public abstract VariableResolver getVariableResolver()
getELResolver().
Возвратитесь VariableResolver это переносится ELResolver экземпляр, который Поверхности обеспечивают для объединенного ЭЛЬ для разрешения выражений, которые появляются программно в приложении. Реализация VariableResolverдолжен передать null поскольку основной параметр за любые методы вызывается на базовое ELResolver.
Отметьте, что этот метод больше не возвращает значение по умолчанию VariableResolver, с тех пор, что class теперь не, который помогает в разрешении пользовательского VariableResolvers, чтобы влиять на ЭЛЬ процесс разрешения.
public abstract void setVariableResolver(VariableResolver resolver)
<el-resolver> элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver быть обернутым в реализации ELResolver и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver).
Установите VariableResolver экземпляр, с которым будут консультироваться, чтобы разрешить привязка значения и метод.
Этот метод теперь осуждается, но реализация должна заставить параметр быть установленным как глава наследства VariableResolver цепочка, заменяя любое существующее значение, которое было установлено от ресурсов конфигурации приложения.
Это недопустимо, чтобы вызвать этот метод после того, как приложение получило любые запросы от клиента. Если попытка предпринимается, чтобы зарегистрировать слушателя после того времени, это не должно иметь никакого эффекта.
resolver - Новое VariableResolver экземпляр java.lang.NullPointerException - если resolver null
IllegalStateException - если вызвано после первого запроса к FacesServlet был обслужен.public void addELResolver(ELResolver resolver)
Вызовите параметр resolver быть добавленным к цепочке преобразователя как определено в разделе JSF.5.5.1 Спецификации Поверхностей JavaServer.
Не возможно удалить ELResolver зарегистрированный в этом методе, как только это было зарегистрировано.
Это недопустимо, чтобы зарегистрироваться ELResolver после того, как приложение получило любые запросы от клиента. Если попытка предпринимается, чтобы зарегистрировать слушателя после того времени, IllegalStateException должен быть брошен. Это ограничение должно на месте позволить контейнеру JSP оптимизировать для общего падежа где не дополнительный ELResolvers находятся в цепочке кроме стандартных. Допустимо добавить ELResolvers прежде или после инициализации к a CompositeELResolver это уже находится в цепочке.
Броски реализации по умолчанию UnsupportedOperationException и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяются Application.
IllegalStateException - если вызвано после первого запроса к FacesServlet был обслужен.public ELResolver getELResolver()
Возвратите одиночный элемент ELResolver экземпляр, который будет использоваться для всего ЭЛЬ разрешения. Это - фактически экземпляр CompositeELResolver это должно содержать следующий ELResolver экземпляры в следующем порядке:
ELResolver экземпляры объявили использование <эль преобразователь> элемент в ресурсах конфигурации приложения.
implementation это обертывает главу наследства VariableResolver цепочка, согласно разделу VariableResolver ChainWrapper в Главе JSF.5 в документе спецификации.
implementation это обертывает главу наследства PropertyResolver цепочка, согласно разделу PropertyResolver ChainWrapper в Главе JSF.5 в документе спецификации.
Любой ELResolver экземпляры добавили звонками addELResolver(javax.el.ELResolver).
Броски реализации по умолчанию UnsupportedOperationException и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяются Application.
public abstract ViewHandler getViewHandler()
Возвратитесь ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в ViewHandler описание в Спецификации Поверхностей JavaServer.
public abstract void setViewHandler(ViewHandler handler)
Установите ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов.
handler - Новое ViewHandler экземпляр IllegalStateException - если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle экземпляр для этого приложения. java.lang.NullPointerException - если handler nullpublic abstract StateManager getStateManager()
Возвратитесь StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в StateManager описание в Спецификации Поверхностей JavaServer.
public abstract void setStateManager(StateManager manager)
Установите StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов.
manager - Новое StateManager экземпляр IllegalStateException - если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle экземпляр для этого приложения. java.lang.NullPointerException - если manager null
public void addBehavior(java.lang.String behaviorId,
java.lang.String behaviorClass)
Зарегистрируйте новое отображение идентификатора поведения к имени соответствия Behavior class. Это позволяет последующие звонки createBehavior() служить фабрикой для Behavior экземпляры.
behaviorId - Идентификатор поведения, который будет зарегистрированbehaviorClass - Полностью определенное имя class соответствия Behavior реализация java.lang.NullPointerException - если behaviorId или behaviorClass null
public Behavior createBehavior(java.lang.String behaviorId)
throws FacesException
Инстанцируйте и возвратите новое Behavior экземпляр class определяется предыдущим звонком addBehavior() для указанного идентификатора поведения.
behaviorId - Идентификатор поведения, для которого можно создать и возвратить новое Behavior экземпляр FacesException - если Behavior не может быть создан java.lang.NullPointerException - если behaviorId nullpublic java.util.Iterator<java.lang.String> getBehaviorIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов поведения для этого Application.
public abstract void addComponent(java.lang.String componentType,
java.lang.String componentClass)
Зарегистрируйте новое отображение компонентного типа к имени соответствия UIComponent class. Это позволяет последующие звонки createComponent() служить фабрикой для UIComponent экземпляры.
componentType - Компонентный тип, который будет зарегистрированcomponentClass - Полностью определенное имя class соответствия UIComponent реализация java.lang.NullPointerException - если componentType или componentClass null
public abstract UIComponent createComponent(java.lang.String componentType)
throws FacesException
Инстанцируйте и возвратите новое UIComponent экземпляр class определяется предыдущим звонком addComponent() для указанного компонентного типа.
Прежде, чем компонентный экземпляр возвращается, он должен быть осмотрен для присутствия a ListenerFor (или ListenersFor) или ResourceDependency (или ResourceDependencies) аннотация. Если какая-либо из этих аннотаций присутствует, действие, перечисленное в ListenerFor или ResourceDependency должен быть взят на компоненте, прежде, чем он будет возвращен из этого метода. Эта разновидность createComponent не должен осмотреть Renderer для компонента, который будет возвращен для любого из перед упомянутыми аннотациями. Такой контроль является областью createComponent(ValueExpression, FacesContext, String, String) или createComponent(FacesContext, String, String).
componentType - Компонентный тип, для которого можно создать и возвратить новое UIComponent экземпляр FacesException - если a UIComponent из указанного типа не может быть создан java.lang.NullPointerException - если componentType null
public abstract UIComponent createComponent(ValueBinding componentBinding,
FacesContext context,
java.lang.String componentType)
throws FacesException
createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String).
Оберните параметр componentBinding в реализации ValueExpression и вызовите через к createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String).
componentBinding - ValueBinding представление компонентного значения обязательное выражение (обычно определяемый component атрибут пользовательского тега)context - FacesContext для текущего запросаcomponentType - Компонентный тип, чтобы создать, если ValueBinding не возвращает компонентный экземпляр FacesException - если a UIComponent не может быть создан java.lang.NullPointerException - если какой-либо параметр null
public UIComponent createComponent(ValueExpression componentExpression,
FacesContext context,
java.lang.String componentType)
throws FacesException
Вызовите getValue() метод на указанном ValueExpression. Если это возвращает a UIComponent экземпляр, возвратите это как значение этого метода. Если это не делает, инстанцируйте нового UIComponent экземпляр указанного компонентного типа, передайте новый компонент к setValue() метод указанного ValueExpression, и возвратите это.
Прежде, чем компонентный экземпляр возвращается, он должен быть осмотрен для присутствия a ListenerFor (или ListenersFor) или ResourceDependency (или ResourceDependencies) аннотация. Если какая-либо из этих аннотаций присутствует, действие, перечисленное в ListenerFor или ResourceDependency должен быть взят на компоненте, прежде, чем он будет возвращен из этого метода. Эта разновидность createComponent не должен осмотреть Renderer для компонента, который будет возвращен для любого из перед упомянутыми аннотациями. Такой контроль является областью createComponent(ValueExpression, FacesContext, String, String) или createComponent(FacesContext, String, String).
componentExpression - ValueExpression представление компонентного выражения (обычно определяемый component атрибут пользовательского тега)context - FacesContext для текущего запросаcomponentType - Компонентный тип, чтобы создать, если ValueExpression не возвращает компонентный экземпляр FacesException - если a UIComponent не может быть создан java.lang.NullPointerException - если какой-либо параметр null
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать.
public UIComponent createComponent(ValueExpression componentExpression,
FacesContext context,
java.lang.String componentType,
java.lang.String rendererType)
Как createComponent(ValueExpression, FacesContext, String) кроме Renderer для компонента, который будет возвращен, должен быть осмотрен для аннотаций, упомянутых в createComponent(ValueExpression, FacesContext, String) как определено в документации для того метода. Renderer экземпляр, чтобы осмотреть должен быть получен, вызывая FacesContext#getRenderKit и вызов RenderKit.getRenderer(java.lang.String, java.lang.String) на результате, передавая параметр componentType как первый параметр и результат вызова UIComponent#getFamily на недавно создаваемом компоненте как второй параметр. Если не такой Renderer может быть найден, сообщение должно быть зарегистрировано с полезным сообщением об ошибке. Иначе, UIComponent#setRendererType должен быть обращен недавно создаваемый UIComponent экземпляр, передавая параметр rendererType как параметр.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать.
componentExpression - ValueExpression представление компонентного выражения (обычно определяемый component атрибут пользовательского тега)context - FacesContext для текущего запросаcomponentType - Компонентный тип, чтобы создать, если ValueExpression не возвращает компонентный экземплярrendererType - Тип средства рендеринга Renderer это представит этот компонент. A null значение должно быть принято для этого параметра. FacesException - если a UIComponent не может быть создан java.lang.NullPointerException - если любой из параметров componentExpression, context, или componentType null
public UIComponent createComponent(FacesContext context,
java.lang.String componentType,
java.lang.String rendererType)
Как createComponent(String) кроме Renderer для компонента, который будет возвращен, должен быть осмотрен для аннотаций, упомянутых в createComponent(ValueExpression, FacesContext, String) как определено в документации для того метода. Renderer экземпляр, чтобы осмотреть должен быть получен, вызывая FacesContext#getRenderKit и вызов RenderKit.getRenderer(java.lang.String, java.lang.String) на результате, передавая параметр componentType как первый параметр и результат вызова UIComponent#getFamily на недавно создаваемом компоненте как второй параметр. Если не такой Renderer может быть найден, сообщение должно быть зарегистрировано с полезным сообщением об ошибке. Иначе, UIComponent#setRendererType должен быть обращен недавно создаваемый UIComponent экземпляр, передавая параметр rendererType как параметр.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать
context - FacesContext для текущего запросаcomponentType - Компонентный тип, чтобы создатьrendererType - Тип средства рендеринга Renderer это представит этот компонент. A null значение должно быть принято для этого параметра. FacesException - если a UIComponent не может быть создан java.lang.NullPointerException - если любой из параметров context, или componentType null
public UIComponent createComponent(FacesContext context,
Resource componentResource)
Инстанцируйте и возвратите новое UIComponent экземпляр от параметра Resource. Алгоритм, семантически эквивалентный следующему, должен сопровождаться, чтобы инстанцировать UIComponent возвратиться.
Получите ссылку на ViewDeclarationLanguage для этого Application экземпляр, вызывая ViewHandler#getViewDeclarationLanguage, передача viewId найденный, вызывая UIViewRoot.getViewId() на UIViewRoot в параметре FacesContext.
Получите ссылку на составные компонентные метаданные для этого составного компонента, вызывая ViewDeclarationLanguage#getComponentMetadata, передача facesContext и componentResource параметры этому методу. Эта версия спецификации JSF использует JavaBeans в качестве API к компонентным метаданным.
Определите если компонентный автор, объявленный a componentType для этого компонентного экземпляра, получая BeanDescriptor от компонентных метаданных и вызова getValue() метод, передавая UIComponent#COMPOSITE_COMPONENT_TYPE_KEY как параметр. Если не -null, результатом должен быть a ValueExpression чье значение component-type из UIComponent создаваться для этого Resource компонент. Вызовите через к createComponent(java.lang.String) создать компонент.
Иначе, определите если сценарий базируемый компонент для этого Resource может быть найден, вызывая ViewDeclarationLanguage#getScriptComponentResource. Если результат не -null, и сценарий, записанный на одном из языков, перечисленных в JSF.4.3 документа прозы спецификации, создайте a UIComponent экземпляр от ресурса сценария.
Иначе, позвольте имени библиотеки быть возвратом из вызова Resource#getLibraryName на параметре componentResource и имя ресурса быть возвратом из вызова Resource#getResourceName на параметре componentResource. Создайте полностью определенный Java имя class, удаляя любое расширение файла из имени ресурса и позвольте fqcn быть library-name + "." + resource-name. Если class с именем fqcn не может быть найден, не предпринять меры и продолжаться к следующему шагу. Если любой из InstantiationException, IllegalAccessException, или ClassCastException бросаются, обертывают исключение в a FacesException и повторно бросьте это. Если какое-либо другое исключение выдается, зарегистрируйте исключение и продолжайте к следующему шагу.
Если ни один из предыдущих шагов не привел к a UIComponent экземпляр, вызвать createComponent(java.lang.String) передача"javax.faces.NamingContainer"как параметр.
Вызвать UIComponent#setRendererType на UIComponent экземпляр, передавая"javax.faces.Composite"как параметр.
Сохраните параметр Resource в атрибутах Map из UIComponent под ключом, Resource#COMPONENT_RESOURCE_KEY.
Компонентные метаданные составного объекта хранилища в атрибутах Map из UIComponent под ключом, UIComponent#BEANINFO_KEY.
Прежде, чем компонентный экземпляр возвращается, он должен быть осмотрен для присутствия a ListenerFor аннотация. Если эта аннотация присутствует, действие, перечисленное в ListenerFor должен быть взят на компоненте, прежде, чем он будет возвращен из этого метода.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать.
context - FacesContext для текущего запросаcomponentResource - A Resource это указывает на исходный файл, который обеспечивает реализацию компонента. FacesException - если a UIComponent от Resource не может быть создан NullPointerException - если какой-либо параметр null
java.lang.NullPointerException - если неспособный, по любой причине, чтобы получить a ViewDeclarationLanguage экземпляр как описано выше.public abstract java.util.Iterator<java.lang.String> getComponentTypes()
Возвратитесь Iterator по набору в настоящий момент определенного компонента вводит для этого Application.
public abstract void addConverter(java.lang.String converterId,
java.lang.String converterClass)
Зарегистрируйте новое отображение идентификатора преобразователя к имени соответствия Converter class. Это позволяет последующие звонки createConverter() служить фабрикой для Converter экземпляры.
converterId - Идентификатор преобразователя, который будет зарегистрированconverterClass - Полностью определенное имя class соответствия Converter реализация java.lang.NullPointerException - если converterId или converterClass null
public abstract void addConverter(java.lang.Class<?> targetClass,
java.lang.String converterClass)
Зарегистрируйте новый преобразователь class, который способен к выполнению преобразований для указанного целевого class.
targetClass - class, для которого регистрируется этот преобразовательconverterClass - Полностью определенное имя class соответствия Converter реализация java.lang.NullPointerException - если targetClass или converterClass nullpublic abstract Converter createConverter(java.lang.String converterId)
Инстанцируйте и возвратите новое Converter экземпляр class определяется предыдущим звонком addConverter() для указанного идентификатора преобразователя.
Если toLowerCase() из String represenation значения"javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE"параметр конфигурации приложения"true"(без кавычек) и Converter экземпляр, который будет возвращен, является экземпляром DateTimeConverter, DateTimeConverter.setTimeZone(java.util.TimeZone) должен быть вызван, передавая возврат из TimeZone.getDefault().
Параметр converter должен быть осмотрен для присутствия ResourceDependency аннотация. Если ResourceDependency аннотация присутствует, действие, описанное в ResourceDependency должен быть взят. Если ResourceDependency аннотация не присутствует, параметр converter должен быть осмотрен для присутствия ResourceDependencies аннотация. Если ResourceDependencies аннотация присутствует, действие, описанное в ResourceDependencies должен быть взят.
converterId - Идентификатор преобразователя, для которого можно создать и возвратить новое Converter экземпляр FacesException - если Converter не может быть создан java.lang.NullPointerException - если converterId nullpublic abstract Converter createConverter(java.lang.Class<?> targetClass)
Инстанцируйте и возвратите новое Converter экземпляр class, который зарегистрировал себя как способный к выполнению преобразований для объектов указанного типа. Если не такой Converter class может быть идентифицирован, возвратиться null.
Определять местоположение соответствующего Converter class, следующий алгоритм выполняется, останавливаясь как только соответствующее Converter class находится:
Converter зарегистрированный для целевого class непосредственно. Converter зарегистрированный для интерфейсов, которые реализуются целевым class (прямо или косвенно).Converter зарегистрированный для суперкласса (если любой) целевого class, рекурсивно обрабатывая иерархию наследования.Если Converter имеет единственного конструктора параметра, который принимает a Class, инстанцируйте Converter использование того конструктора, передача параметра targetClass как единственный параметр. Иначе, просто используйте конструктора нулевого параметра.
Если toLowerCase() из String represenation значения"javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE"параметр конфигурации приложения"true"(без кавычек) и Converter экземпляр, который будет возвращен, является экземпляром DateTimeConverter, DateTimeConverter.setTimeZone(java.util.TimeZone) должен быть вызван, передавая возврат из TimeZone.getDefault().
targetClass - Предназначайтесь для class, для которого можно возвратить a Converter
FacesException - если Converter не может быть создан java.lang.NullPointerException - если targetClass nullpublic abstract java.util.Iterator<java.lang.String> getConverterIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов преобразователя для этого Application.
public abstract java.util.Iterator<java.lang.Class<?>> getConverterTypes()
Возвратитесь Iterator по набору Class экземпляры те, для который Converter классы были явно зарегистрированы.
public void addDefaultValidatorId(java.lang.String validatorId)
Зарегистрируйте блок проверки допустимости его идентификатором, который применяется ко всем UIInput компоненты в представлении. Блок проверки допустимости, чтобы чаще всего служить этой роли BeanValidator. Контракт использования для этого метода предполагает, что блок проверки допустимости был зарегистрирован, используя нормальный регистрационный механизм идентификатором".
Реализация состоит в том при условии, что не предпринимает мер так, чтобы пользователи, которые украшают Application продолжайте работать.
public java.util.Map<java.lang.String,java.lang.String> getDefaultValidatorInfo()
Возвратите неизменное Map по набору в настоящий момент зарегистрированных ID блока проверки допустимости значения по умолчанию и их class называют для этого Application.
Реализация состоит в том при условии, что возвраты Collections.emptyMap так, чтобы пользователи, которые украшают Application продолжайте работать.
public ExpressionFactory getExpressionFactory()
Возвратитесь ExpressionFactory экземпляр для этого приложения. Этот экземпляр используется методом удобства evaluateExpressionGet(javax.faces.context.FacesContext, java.lang.String, java.lang.Class<? extends T>).
Реализация должна возвратиться ExpressionFactory от контейнера JSP, вызывая JspFactory.getDefaultFactory().getJspApplicationContext(servletContext).getExpressionFactory().
Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.
public <T> T evaluateExpressionGet(FacesContext context,
java.lang.String expression,
java.lang.Class<? extends T> expectedType)
throws ELException
Получите значение, оценивая выражение.
Вызвать getExpressionFactory() тогда вызовите ExpressionFactory#createValueExpression передача параметра expression и expectedType. Вызвать FacesContext#getELContext и передайте это к ValueExpression#getValue, возврат результата.
Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.
ELException
public abstract MethodBinding createMethodBinding(java.lang.String ref,
java.lang.Class<?>[] params)
throws ReferenceSyntaxException
getExpressionFactory() тогда ExpressionFactory#createMethodExpression.
Вызвать getExpressionFactory() тогда вызовите ExpressionFactory#createMethodExpression, передача данных параметров, и обертки результат в a MethodBinding реализация, возвращая это.
ref - Обязательное выражение метода, для которого можно возвратить a MethodBinding экземплярparams - Подписи параметра, которые должны быть совместимыми с таковыми из метода, который будет вызван, или массив нулевой длиной или null для метода, который не берет параметров java.lang.NullPointerException - если ref null
ReferenceSyntaxException - если указанное ref имеет недопустимый синтаксисpublic abstract java.util.Iterator<java.util.Locale> getSupportedLocales()
Возвратитесь Iterator по поддерживаемому Locales для этого appication.
public abstract void setSupportedLocales(java.util.Collection<java.util.Locale> locales)
Установите Locale экземпляры, представляющие поддерживаемый Locales для этого приложения.
locales - Набор поддерживаемых Locales для этого приложения java.lang.NullPointerException - если параметр newLocales null.public void addELContextListener(ELContextListener listener)
Обеспечьте путь к приложениям Поверхностей, чтобы зарегистрироваться ELContextListener это будет уведомлено относительно создания ELContext экземпляры. Однажды этот слушатель вызовут на запрос.
Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.
public void removeELContextListener(ELContextListener listener)
Удалите параметр listener от списка ELContextListeners. Если listener нуль, никакое исключение не выдается, и никакое действие не выполняется. Если listener не находится в списке, никакое исключение не выдается, и никакое действие не выполняется.
Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.
public ELContextListener[] getELContextListeners()
Если никакие вызовы не были выполнены к addELContextListener(javax.el.ELContextListener), этот метод должен возвратить пустой массив.
Иначе, возвратите массив, представляющий список слушателей, добавленных звонками addELContextListener(javax.el.ELContextListener).
Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.
public abstract void addValidator(java.lang.String validatorId,
java.lang.String validatorClass)
Зарегистрируйте новое отображение идентификатора блока проверки допустимости к имени соответствия Validator class. Это позволяет последующие звонки createValidator() служить фабрикой для Validator экземпляры.
validatorId - Идентификатор блока проверки допустимости, который будет зарегистрированvalidatorClass - Полностью определенное имя class соответствия Validator реализация java.lang.NullPointerException - если validatorId или validatorClass null
public abstract Validator createValidator(java.lang.String validatorId)
throws FacesException
Инстанцируйте и возвратите новое Validator экземпляр class определяется предыдущим звонком addValidator() для указанного идентификатора блока проверки допустимости.
Параметр validator должен быть осмотрен для присутствия ResourceDependency аннотация. Если ResourceDependency аннотация присутствует, действие, описанное в ResourceDependency должен быть взят. Если ResourceDependency аннотация не присутствует, параметр validator должен быть осмотрен для присутствия ResourceDependencies аннотация. Если ResourceDependencies аннотация присутствует, действие, описанное в ResourceDependencies должен быть взят.
validatorId - Идентификатор блока проверки допустимости, для которого можно создать и возвратить новое Validator экземпляр FacesException - если a Validator из указанного идентификатора не может быть создан java.lang.NullPointerException - если validatorId nullpublic abstract java.util.Iterator<java.lang.String> getValidatorIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов блока проверки допустимости для этого Application.
public abstract ValueBinding createValueBinding(java.lang.String ref)
throws ReferenceSyntaxException
getExpressionFactory() тогда ExpressionFactory#createValueExpression.
Вызвать getExpressionFactory() тогда вызовите ExpressionFactory#createValueExpression, передача параметра ref, Object.class для expectedType, и null, для fnMapper.
ref - Обязательное выражение значения, для которого можно возвратить a ValueBinding экземпляр java.lang.NullPointerException - если ref null
ReferenceSyntaxException - если указанное ref имеет недопустимый синтаксис
public void publishEvent(FacesContext context,
java.lang.Class<? extends SystemEvent> systemEventClass,
java.lang.Object source)
Если FacesContext.isProcessingEvents() true и есть один или более слушателей для событий типа, представленного systemEventClass, вызовите тех слушателей, передавая source как источник события. Реализация должна быть с такой скоростью, как возможный в определении действительно ли слушатель для данного systemEventClass и source был установлен, и должен сразу возвратиться, как только такое определение было сделано. Реализация publishEvent должен соблюдать требования, утвержденные в subscribeToEvent(java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Class<?>, javax.faces.event.SystemEventListener) относительно хранения и извлечения экземпляров слушателя. Определенно, если subscribeToEvent(Class,Class,SystemEventListener) был вызван, sourceClass параметр должен соответствовать точно Class из source параметр в звонке publishEvent(). Реализация не должна сделать никакого наследования hierarachy контроль, ища соответствие между sourceClass переданный к subscribeToEvent(Class,Class,SystemEventListener) и sourceClass переданный к publishEvent() чтобы найти любых слушателей, к которым должно быть опубликовано событие. В случае, где Class из source параметр не соответствует Class из sourceClass используемый, когда слушатель был подписан, используя subscribeToEvent(), publishEvent(FacesContext,Class,Class,Object) может использоваться, чтобы обеспечить Class используемый, чтобы выполнить поиск слушателя и соответствие.
Реализация по умолчанию должна реализовать алгоритм, семантически эквивалентный следующему, чтобы определить местоположение экземпляров слушателя и вызвать их.
Если source реализации параметра SystemEventListenerHolder, вызвать SystemEventListenerHolder.getListenersForEventClass(java.lang.Class<? extends javax.faces.event.SystemEvent>) на этом, передавая systemEventClass параметр. Если список не пуст, выполните алгоритм traverseListenerList в списке.
Если какие-либо слушатели уровня представления были установлены предыдущими звонками subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener) на UIViewRoot, выполните алгоритм traverseListenerList в списке слушателей для того события, установленного на UIViewRoot.
Если любой Application слушатели уровня были установлены предыдущими звонками subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener), выполните алгоритм traverseListenerList в списке.
Если любой Application слушатели уровня были установлены предыдущими звонками subscribeToEvent(Class, javax.faces.event.SystemEventListener), выполните алгоритм traverseListenerList в списке.
Если действие вызова processListener метод вызывает AbortProcessingException чтобы быть брошенной, обработка слушателей должна быть прервана, никакая дальнейшая обработка слушателей для этого события не должна иметь место, и исключение должно быть зарегистрировано с Level.SEVERE.
Алгоритм traverseListenerList: Для каждого слушателя в списке,
Вызвать SystemEventListener.isListenerForSource(java.lang.Object), передача source параметр. Если это возвращается false, не предпримите меры на слушателе.
Иначе, если событие, которое передадут к экземплярам слушателя, еще не было создано, создайте событие, передавая source как параметр конструктору с одним параметром, который берет Object. Этот тот же самый экземпляр события нужно передать ко всем экземплярам слушателя.
Вызвать SystemEvent.isAppropriateListener(javax.faces.event.FacesListener), передача экземпляра слушателя как параметр. Если это возвращается false, не предпримите меры на слушателе.
Вызвать SystemEvent.processListener(javax.faces.event.FacesListener), передача экземпляра слушателя.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать
context - FacesContext для текущего запросаsystemEventClass - Class из события, которое публикуется.source - Источник для события типа systemEventClass. java.lang.NullPointerException - если также context, systemEventClass или source null
public void publishEvent(FacesContext context,
java.lang.Class<? extends SystemEvent> systemEventClass,
java.lang.Class<?> sourceBaseType,
java.lang.Object source)
Этот метод функционирует точно как publishEvent(FacesContext,Class,Object), кроме времени выполнения должен использовать параметр sourceBaseType найти соответствующего слушателя вместо того, чтобы использовать Class из source параметр.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать
context - FacesContext для текущего запросаsystemEventClass - Class из события, которое публикуется.sourceBaseType - Class из исходного события, которое должно привыкнуть к поиску слушатель, к которому должно быть опубликовано это событие. Если этот параметр null возврат из source.getClass() должен использоваться в качестве sourceBaseType.source - Источник для события типа systemEventClass. java.lang.NullPointerException - если любые параметры за исключением sourceBaseType null
public void subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass,
java.lang.Class<?> sourceClass,
SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр listener в приложение как слушатель для событий типа systemEventClass это происходит из объектов типа sourceClass.
Если параметр sourceClass не -null, sourceClass и systemEventClass должен использоваться, чтобы сохранить параметр listener в приложении таким способом, который listener может быстро искаться реализацией publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object) данный systemEventClass и экземпляр Class ссылаемый sourceClass. Если параметр sourceClass null, listener должно быть поддающимся обнаружению реализацией publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object) учитывая только systemEventClass.
systemEventClass - Class из того, события, для который listener должен быть запущен.sourceClass - Class из экземпляра, который вызывает события типа systemEventClass быть запущенным. Может быть null.listener - реализация SystemEventListener чей SystemEventListener.processEvent(javax.faces.event.SystemEvent) метод нужно вызвать когда события типа systemEventClass запускаются. NullPointerException - если любая комбинация systemEventClass, или listener null.
public void subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass,
SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр listener в приложение как слушатель для событий типа systemEventClass. Реализация по умолчанию просто вызывает через к subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener) передача null как sourceClass параметр
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать
systemEventClass - Class из того, события, для который listener должен быть запущен.listener - реализация SystemEventListener чей SystemEventListener.processEvent(javax.faces.event.SystemEvent) метод нужно вызвать когда события типа systemEventClass запускаются. NullPointerException - если любая комбинация systemEventClass, или listener null.
public void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass,
java.lang.Class<?> sourceClass,
SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр listener из приложения как слушатель для событий типа systemEventClass это происходит из объектов типа sourceClass. См. subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener) для спецификации того, как слушатель сохранен, и поэтому, как она должна быть удалена.
systemEventClass - Class из того, события, для который listener должен быть запущен.sourceClass - Class из экземпляра, который вызывает события типа systemEventClass быть запущенным. Может быть null.listener - реализация SystemEventListener удалить из внутренней структуры данных. NullPointerException - если любая комбинация context, systemEventClass, или listener null.
public void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass,
SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр listener из приложения как слушатель для событий типа systemEventClass. Реализация по умолчанию просто вызывает через к unsubscribeFromEvent(Class, javax.faces.event.SystemEventListener) передача null как sourceClass параметр
systemEventClass - Class из того, события, для который listener должен быть запущен.listener - реализация SystemEventListener удалить из внутренней структуры данных. NullPointerException - если любая комбинация context, systemEventClass, или listener null. http://java.sun.com/javaee/javaserverfaces/reference/api/index.html
|
|||||||||
| ПРЕДЫДУЩИЙ СЛЕДУЮЩИЙ КЛАСС КЛАССА | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
| СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД | ||||||||
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41