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


javax.faces.application
Приложение класса

java.lang.Object
  расширенный javax.faces.application.Application
Прямые Известные Подклассы:
ApplicationWrapper

public abstract class Application
расширяет java.lang. Объект

Приложение представляет одноэлементный объект на веб-приложение, где приложения, основанные на Поверхностях 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)
          

Зарегистрируйте блок проверки допустимости его идентификатором, который применяется ко всем UIInput компоненты в представлении.

 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 экземпляр от параметра Resource.

 UIComponent createComponent(FacesContext context, java.lang.String componentType, java.lang.String rendererType)
          

Как createComponent(String) кроме Renderer для компонента, который будет возвращен, должен быть осмотрен для аннотаций, упомянутых в createComponent(ValueExpression, FacesContext, String) как определено в документации для того метода.

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)
          

Как createComponent(ValueExpression, FacesContext, String) кроме Renderer для компонента, который будет возвращен, должен быть осмотрен для аннотаций, упомянутых в createComponent(ValueExpression, FacesContext, String) как определено в документации для того метода.

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.
<T> T
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()
          

Возвратите неизменное Map по набору в настоящий момент зарегистрированных ID блока проверки допустимости значения по умолчанию и их class называют для этого Application.

 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()
          

Возвратите одиночный элемент, не сохраняющий состояние, ориентированный на многопотоковое исполнение ResourceHandler для этого приложения.

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)
          

Этот метод функционирует точно как publishEvent(FacesContext,Class,Object), кроме времени выполнения должен использовать параметр sourceBaseType найти соответствующего слушателя вместо того, чтобы использовать Class из source параметр.

 void publishEvent(FacesContext context, java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Object source)
          

Если FacesContext.isProcessingEvents() true и есть один или более слушателей для событий типа, представленного systemEventClass, вызовите тех слушателей, передавая 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)
          

Установите 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)
          

Установите экземпляр слушателя, на который ссылается параметр listener в приложение как слушатель для событий типа systemEventClass это происходит из объектов типа sourceClass.

 void subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
          

Установите экземпляр слушателя, на который ссылается параметр listener в приложение как слушатель для событий типа systemEventClass.

 void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceClass, SystemEventListener listener)
          

Удалите экземпляр слушателя, на который ссылается параметр listener из приложения как слушатель для событий типа systemEventClass это происходит из объектов типа sourceClass.

 void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
          

Удалите экземпляр слушателя, на который ссылается параметр listener из приложения как слушатель для событий типа systemEventClass.

 
Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

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

Приложение

public Application()
Деталь метода

getActionListener

public abstract ActionListener getActionListener()

Возвратите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты в этом appication. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет следующие функции:

Отметьте что спецификация значением по умолчанию ActionListener contiues, чтобы призвать к использованию осуждаемого свойства (action) и class (MethodBinding). К сожалению, это необходимо потому что значение по умолчанию ActionListener должен продолжать работать с компонентами, которые не реализуют ActionSource2, и только реализация ActionSource.


setActionListener

public abstract void setActionListener(ActionListener listener)

Установите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты.

Параметры:
listener - Новое значение по умолчанию ActionListener
Броски:
java.lang.NullPointerException - если listener null

getDefaultLocale

public abstract java.util.Locale getDefaultLocale()

Возвратите значение по умолчанию Locale для этого приложения. Если явно не установлено, null возвращается.


setDefaultLocale

public abstract void setDefaultLocale(java.util.Locale locale)

Установите значение по умолчанию Locale для этого приложения.

Параметры:
locale - Новое значение по умолчанию Locale
Броски:
java.lang.NullPointerException - если locale null

getDefaultRenderKitId

public abstract java.lang.String getDefaultRenderKitId()

Возвратитесь renderKitId использоваться для того, чтобы представить это приложение. Если явно не установлено, null возвращается.


setDefaultRenderKitId

public abstract void setDefaultRenderKitId(java.lang.String renderKitId)

Установите renderKitId использоваться, чтобы представить это приложение. Если клиент не обеспечил пользовательское ViewHandler это поддерживает использование многократных RenderKit экземпляры в том же самом приложении, этот метод нужно только вызвать при запуске приложения, прежде, чем любые запросы Поверхностей были обработаны. Это - ограничение текущей Спецификации, и может быть снято в будущем выпуске.


getMessageBundle

public abstract java.lang.String getMessageBundle()

Возвратите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. Если явно не установлено, null возвращается.


setMessageBundle

public abstract void setMessageBundle(java.lang.String bundle)

Определите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. См. JavaDocs для java.util.ResourceBundle class для получения дополнительной информации о синтаксисе для ресурса связывает имена.

Параметры:
bundle - Базовое имя ресурса связывается, чтобы использоваться
Броски:
java.lang.NullPointerException - если bundle null

getNavigationHandler

public abstract NavigationHandler getNavigationHandler()

Возвратитесь NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в NavigationHandler Описание class.


setNavigationHandler

public abstract void setNavigationHandler(NavigationHandler handler)

Установите NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения.

Параметры:
handler - Новое NavigationHandler экземпляр
Броски:
java.lang.NullPointerException - если handler null

getResourceHandler

public ResourceHandler getResourceHandler()

Возвратите одиночный элемент, не сохраняющий состояние, ориентированный на многопотоковое исполнение ResourceHandler для этого приложения. Реализация JSF должна поддерживать следующие методы для того, чтобы объявить альтернативную реализацию ResourceHandler.

  • ResourceHandler реализация объявляется в ресурсах конфигурации приложения, давая полностью определенное имя class как значение <resource-handler> элемент в пределах <application> элемент.

Во всех вышеупомянутых случаях время выполнения должно использовать шаблон "декоратор" что касается любого сменного артефакта в JSF.

Реализация по умолчанию то, при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application может продолжать функционировать

.

С тех пор:
2.0

setResourceHandler

public void setResourceHandler(ResourceHandler resourceHandler)

Установите ResourceHandler экземпляр, который будет использоваться для того, чтобы представить разметку для ресурсов, и для того, чтобы удовлетворить клиентские запросы, чтобы подать ресурсы.

Параметры:
resourceHandler - Новое ResourceHandler экземпляр
Броски:
IllegalStateException - если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle экземпляр для этого приложения.
java.lang.NullPointerException - если resourceHandler null
С тех пор:
2.0

getPropertyResolver

public abstract PropertyResolver getPropertyResolver()
Осуждаемый. Это было заменено getELResolver().

Возвратите a PropertyResolver экземпляр, который переносится ELResolver экземпляр, который Поверхности обеспечивают для объединенного ЭЛЬ для разрешения выражений, которые появляются программно в приложении.

Отметьте, что это больше не возвращает значение по умолчанию PropertyResolver с тех пор, что class теперь не, который помогает в разрешении пользовательского PropertyResolvers, чтобы влиять на ЭЛЬ процесс разрешения.


setPropertyResolver

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 был обслужен.

getResourceBundle

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 == нуль || называют == нуль
С тех пор:
1.2

getProjectStage

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 может продолжать функционировать

.

С тех пор:
2.0

getVariableResolver

public abstract VariableResolver getVariableResolver()
Осуждаемый. Это было заменено getELResolver().

Возвратитесь VariableResolver это переносится ELResolver экземпляр, который Поверхности обеспечивают для объединенного ЭЛЬ для разрешения выражений, которые появляются программно в приложении. Реализация VariableResolverдолжен передать null поскольку основной параметр за любые методы вызывается на базовое ELResolver.

Отметьте, что этот метод больше не возвращает значение по умолчанию VariableResolver, с тех пор, что class теперь не, который помогает в разрешении пользовательского VariableResolvers, чтобы влиять на ЭЛЬ процесс разрешения.


setVariableResolver

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 был обслужен.

addELResolver

public void addELResolver(ELResolver resolver)

Вызовите параметр resolver быть добавленным к цепочке преобразователя как определено в разделе JSF.5.5.1 Спецификации Поверхностей JavaServer.

Не возможно удалить ELResolver зарегистрированный в этом методе, как только это было зарегистрировано.

Это недопустимо, чтобы зарегистрироваться ELResolver после того, как приложение получило любые запросы от клиента. Если попытка предпринимается, чтобы зарегистрировать слушателя после того времени, IllegalStateException должен быть брошен. Это ограничение должно на месте позволить контейнеру JSP оптимизировать для общего падежа где не дополнительный ELResolvers находятся в цепочке кроме стандартных. Допустимо добавить ELResolvers прежде или после инициализации к a CompositeELResolver это уже находится в цепочке.

Броски реализации по умолчанию UnsupportedOperationException и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяются Application.

Броски:
IllegalStateException - если вызвано после первого запроса к FacesServlet был обслужен.
С тех пор:
1.2

getELResolver

public ELResolver getELResolver()

Возвратите одиночный элемент ELResolver экземпляр, который будет использоваться для всего ЭЛЬ разрешения. Это - фактически экземпляр CompositeELResolver это должно содержать следующий ELResolver экземпляры в следующем порядке:

  1. ELResolver экземпляры объявили использование <эль преобразователь> элемент в ресурсах конфигурации приложения.

  2. implementation это обертывает главу наследства VariableResolver цепочка, согласно разделу VariableResolver ChainWrapper в Главе JSF.5 в документе спецификации.

  3. implementation это обертывает главу наследства PropertyResolver цепочка, согласно разделу PropertyResolver ChainWrapper в Главе JSF.5 в документе спецификации.

  4. Любой ELResolver экземпляры добавили звонками addELResolver(javax.el.ELResolver).

Броски реализации по умолчанию UnsupportedOperationException и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяются Application.

С тех пор:
1.2

getViewHandler

public abstract ViewHandler getViewHandler()

Возвратитесь ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в ViewHandler описание в Спецификации Поверхностей JavaServer.


setViewHandler

public abstract void setViewHandler(ViewHandler handler)

Установите ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов.

Параметры:
handler - Новое ViewHandler экземпляр
Броски:
IllegalStateException - если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle экземпляр для этого приложения.
java.lang.NullPointerException - если handler null

getStateManager

public abstract StateManager getStateManager()

Возвратитесь StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в StateManager описание в Спецификации Поверхностей JavaServer.


setStateManager

public abstract void setStateManager(StateManager manager)

Установите StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов.

Параметры:
manager - Новое StateManager экземпляр
Броски:
IllegalStateException - если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle экземпляр для этого приложения.
java.lang.NullPointerException - если manager null

addBehavior

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
С тех пор:
2.0

createBehavior

public Behavior createBehavior(java.lang.String behaviorId)
                        throws FacesException

Инстанцируйте и возвратите новое Behavior экземпляр class определяется предыдущим звонком addBehavior() для указанного идентификатора поведения.

Параметры:
behaviorId - Идентификатор поведения, для которого можно создать и возвратить новое Behavior экземпляр
Броски:
FacesException - если Behavior не может быть создан
java.lang.NullPointerException - если behaviorId null

getBehaviorIds

public java.util.Iterator<java.lang.String> getBehaviorIds()

Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов поведения для этого Application.


addComponent

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

createComponent

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

createComponent

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

createComponent

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 может продолжать функционировать.

С тех пор:
1.2

createComponent

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
С тех пор:
2.0

createComponent

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
С тех пор:
2.0

createComponent

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 экземпляр как описано выше.
С тех пор:
2.0

getComponentTypes

public abstract java.util.Iterator<java.lang.String> getComponentTypes()

Возвратитесь Iterator по набору в настоящий момент определенного компонента вводит для этого Application.


addConverter

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

addConverter

public abstract void addConverter(java.lang.Class<?> targetClass,
                                  java.lang.String converterClass)

Зарегистрируйте новый преобразователь class, который способен к выполнению преобразований для указанного целевого class.

Параметры:
targetClass - class, для которого регистрируется этот преобразователь
converterClass - Полностью определенное имя class соответствия Converter реализация
Броски:
java.lang.NullPointerException - если targetClass или converterClass null

createConverter

public 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 null

createConverter

public abstract Converter createConverter(java.lang.Class<?> targetClass)

Инстанцируйте и возвратите новое Converter экземпляр class, который зарегистрировал себя как способный к выполнению преобразований для объектов указанного типа. Если не такой Converter class может быть идентифицирован, возвратиться null.

Определять местоположение соответствующего 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 null

getConverterIds

public abstract java.util.Iterator<java.lang.String> getConverterIds()

Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов преобразователя для этого Application.


getConverterTypes

public abstract java.util.Iterator<java.lang.Class<?>> getConverterTypes()

Возвратитесь Iterator по набору Class экземпляры те, для который Converter классы были явно зарегистрированы.


addDefaultValidatorId

public void addDefaultValidatorId(java.lang.String validatorId)

Зарегистрируйте блок проверки допустимости его идентификатором, который применяется ко всем UIInput компоненты в представлении. Блок проверки допустимости, чтобы чаще всего служить этой роли BeanValidator. Контракт использования для этого метода предполагает, что блок проверки допустимости был зарегистрирован, используя нормальный регистрационный механизм идентификатором".

Реализация состоит в том при условии, что не предпринимает мер так, чтобы пользователи, которые украшают Application продолжайте работать.

С тех пор:
2.0

getDefaultValidatorInfo

public java.util.Map<java.lang.String,java.lang.String> getDefaultValidatorInfo()

Возвратите неизменное Map по набору в настоящий момент зарегистрированных ID блока проверки допустимости значения по умолчанию и их class называют для этого Application.

Реализация состоит в том при условии, что возвраты Collections.emptyMap так, чтобы пользователи, которые украшают Application продолжайте работать.

С тех пор:
2.0

getExpressionFactory

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 продолжайте работать.

С тех пор:
1.2

evaluateExpressionGet

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

createMethodBinding

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 имеет недопустимый синтаксис

getSupportedLocales

public abstract java.util.Iterator<java.util.Locale> getSupportedLocales()

Возвратитесь Iterator по поддерживаемому Locales для этого appication.


setSupportedLocales

public abstract void setSupportedLocales(java.util.Collection<java.util.Locale> locales)

Установите Locale экземпляры, представляющие поддерживаемый Locales для этого приложения.

Параметры:
locales - Набор поддерживаемых Locales для этого приложения
Броски:
java.lang.NullPointerException - если параметр newLocales null.

addELContextListener

public void addELContextListener(ELContextListener listener)

Обеспечьте путь к приложениям Поверхностей, чтобы зарегистрироваться ELContextListener это будет уведомлено относительно создания ELContext экземпляры. Однажды этот слушатель вызовут на запрос.

Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.

С тех пор:
1.2

removeELContextListener

public void removeELContextListener(ELContextListener listener)

Удалите параметр listener от списка ELContextListeners. Если listener нуль, никакое исключение не выдается, и никакое действие не выполняется. Если listener не находится в списке, никакое исключение не выдается, и никакое действие не выполняется.

Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.

С тех пор:
1.2

getELContextListeners

public ELContextListener[] getELContextListeners()

Если никакие вызовы не были выполнены к addELContextListener(javax.el.ELContextListener), этот метод должен возвратить пустой массив.

Иначе, возвратите массив, представляющий список слушателей, добавленных звонками addELContextListener(javax.el.ELContextListener).

Реализация состоит в том при условии, что броски UnsupportedOperationException так, чтобы пользователи, которые украшают Application продолжайте работать.

С тех пор:
1.2

addValidator

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

createValidator

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 null

getValidatorIds

public abstract java.util.Iterator<java.lang.String> getValidatorIds()

Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов блока проверки допустимости для этого Application.


createValueBinding

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 имеет недопустимый синтаксис

publishEvent

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 используемый, чтобы выполнить поиск слушателя и соответствие.

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

Если действие вызова 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
С тех пор:
2.0

publishEvent

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
С тех пор:
2.0

subscribeToEvent

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.
С тех пор:
2.0

subscribeToEvent

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.
С тех пор:
2.0

unsubscribeFromEvent

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.
С тех пор:
2.0

unsubscribeFromEvent

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
С тех пор:
2.0


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41

free hit counter