javax.faces.view
Класс ViewDeclarationLanguage

java.lang.Object
  расширенный javax.faces.view.ViewDeclarationLanguage

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

Контракт, который язык объявления представления должен реализовать, чтобы взаимодействовать со временем выполнения JSF. Реализация этого class должна быть ориентирована на многопотоковое исполнение.

Экземпляры этого class являются определяющим контекст приложением и должны быть получены из ViewDeclarationLanguageFactory.

С тех пор:
2.0

Полевая Сводка
static java.lang.String FACELETS_VIEW_DECLARATION_LANGUAGE_ID
          

Идентификатор для Facelets просматривает язык объявления.

static java.lang.String JSP_VIEW_DECLARATION_LANGUAGE_ID
          

Идентификатор для JSP просматривает язык объявления.

 
Сводка конструктора
ViewDeclarationLanguage()
           
 
Сводка метода
abstract  void buildView(FacesContext context, UIViewRoot root)
          

Предпримите любые меры, определенные для этой реализации VDL, чтобы вызвать параметр UIViewRoot который, должно быть, был создан через звонок createView(javax.faces.context.FacesContext, java.lang.String), быть заполненным с дочерними элементами.

abstract  UIViewRoot createView(FacesContext context, java.lang.String viewId)
          

Создайте a UIViewRoot от VDL, содержавшегося в артефакте, ссылается параметром viewId.

abstract  java.beans.BeanInfo getComponentMetadata(FacesContext context, Resource componentResource)
          

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

 java.lang.String getId()
          

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

abstract  Resource getScriptComponentResource(FacesContext context, Resource componentResource)
          

Возьмите реализацию определенное действие, чтобы обнаружить a Resource учитывая параметр componentResource.

abstract  StateManagementStrategy getStateManagementStrategy(FacesContext context, java.lang.String viewId)
          

Для реализаций, которые хотят управлять реализацией сохранения состояния и восстановления, StateManagementStrategy позволяет им делать так.

abstract  ViewMetadata getViewMetadata(FacesContext context, java.lang.String viewId)
          

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

abstract  void renderView(FacesContext context, UIViewRoot view)
          

Представьте представление, базированное в параметреview.

abstract  UIViewRoot restoreView(FacesContext context, java.lang.String viewId)
          

Восстановление a UIViewRoot от ранее создаваемого представления.

 void retargetAttachedObjects(FacesContext context, UIComponent topLevelComponent, java.util.List<AttachedObjectHandler> handlers)
          

Принятие компонентных метаданных для параметра topLevelComponent был сделан доступным более ранним звонком ViewDeclarationLanguage#getComponentMetadata, усильте компонентные метаданные с целью перенастройки присоединенных объектов от высокоуровневого компонента составного объекта до человека AttachedObjectTarget экземпляры в составном компоненте.

 void retargetMethodExpressions(FacesContext context, UIComponent topLevelComponent)
          

Принятие компонентных метаданных для параметра topLevelComponent был сделан доступным более ранним звонком ViewDeclarationLanguage#getComponentMetadata, усильте компонентные метаданные с целью перенастройки любых выражений метода от высокоуровневого компонента до соответствующего внутреннего компонента.

 boolean viewExists(FacesContext context, java.lang.String viewId)
          

Тесты, существует ли физический ресурс, соответствующий указанному viewId.

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

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

JSP_VIEW_DECLARATION_LANGUAGE_ID

public static final java.lang.String JSP_VIEW_DECLARATION_LANGUAGE_ID

Идентификатор для JSP просматривает язык объявления.

С тех пор:
2.1
См. Также:
Постоянные Значения полей

FACELETS_VIEW_DECLARATION_LANGUAGE_ID

public static final java.lang.String FACELETS_VIEW_DECLARATION_LANGUAGE_ID

Идентификатор для Facelets просматривает язык объявления.

С тех пор:
2.1
См. Также:
Постоянные Значения полей
Деталь конструктора

ViewDeclarationLanguage

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

getComponentMetadata

public abstract java.beans.BeanInfo getComponentMetadata(FacesContext context,
                                                         Resource componentResource)

Возвратите ссылку на компонентные метаданные для составного компонента, представленного параметром componentResource, или null если метаданные не могут быть найдены. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию. Реализации JSP должны бросить UnsupportedOperationException.

Параметры:
context - FacesContext для этого запроса.
componentResource - Resource это представляет компонент.
Броски:
java.lang.NullPointerException - если какой-либо из параметров null.
FacesException - если есть ошибка в получении метаданных
UnsupportedOperationException - если это - JSP VDL реализация.
С тех пор:
2.0

getViewMetadata

public abstract ViewMetadata getViewMetadata(FacesContext context,
                                             java.lang.String viewId)

Возвратите ссылку на метаданные представления для представления, представленного параметром viewId, или null если метаданные не могут быть найдены. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию. Facelets для JSF 2 реализации должен возвратиться не -null. Реализации JSP должны возвратиться null.

Параметры:
context - FacesContext для этого запроса.
viewId - идентификатор представления от whith, чтобы извлечь метаданные
Броски:
java.lang.NullPointerException - если какой-либо из параметров null.
FacesException - если есть ошибка в получении метаданных
С тех пор:
2.0

getScriptComponentResource

public abstract Resource getScriptComponentResource(FacesContext context,
                                                    Resource componentResource)

Возьмите реализацию определенное действие, чтобы обнаружить a Resource учитывая параметр componentResource. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию. Реализации JSP должны бросить UnsupportedOperationException.

Параметры:
context - FacesContext для этого запроса.
componentResource - Resource это представляет компонент.
Броски:
java.lang.NullPointerException - если какой-либо из параметров null.
FacesException - если есть ошибка в получении компонентного ресурса сценария
UnsupportedOperationException - если это - JSP VDL реализация.
С тех пор:
2.0

createView

public abstract UIViewRoot createView(FacesContext context,
                                      java.lang.String viewId)

Создайте a UIViewRoot от VDL, содержавшегося в артефакте, ссылается параметром viewId. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию.

Параметры:
context - FacesContext для этого запроса.
viewId - идентификатор артефакта, который содержит синтаксис VDL, который описывает это представление.
Броски:
java.lang.NullPointerException - если какой-либо из параметров null
С тех пор:
2.0

restoreView

public abstract UIViewRoot restoreView(FacesContext context,
                                       java.lang.String viewId)

Восстановление a UIViewRoot от ранее создаваемого представления. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию.

Параметры:
context - FacesContext для этого запроса.
viewId - идентификатор для ранее представленного представления.
Броски:
java.lang.NullPointerException - если какой-либо из параметров null

retargetAttachedObjects

public void retargetAttachedObjects(FacesContext context,
                                    UIComponent topLevelComponent,
                                    java.util.List<AttachedObjectHandler> handlers)

Принятие компонентных метаданных для параметра topLevelComponent был сделан доступным более ранним звонком ViewDeclarationLanguage#getComponentMetadata, усильте компонентные метаданные с целью перенастройки присоединенных объектов от высокоуровневого компонента составного объекта до человека AttachedObjectTarget экземпляры в составном компоненте. Этот метод нужно вызвать ViewDeclarationLanguage реализация, создавая UIComponent дерево, когда с составным компонентным использованием встречаются.

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

  • Получите метаданные для составного компонента. В настоящий момент это влечет за собой получение значения UIComponent#BEANINFO_KEY компонентный атрибут, который будет экземпляром BeanInfo. Если метаданные не могут быть найдены, зарегистрируйте сообщение об ошибке и возврат.

  • Доберитесь BeanDescriptor от BeanInfo.

  • Получите значение AttachedObjectTarget#ATTACHED_OBJECT_TARGETS_KEY от BeanDescriptor's getValue() метод. Это будет a List<AttachedObjectTarget>. Позвольте этому быть targetList.

  • Для каждой curHandler записи в параметре handlers

    • Позвольте forAttributeValue быть возвратом из AttachedObjectHandler#getFor.

    • Для каждой curTarget записи в targetList первый из следующих элементов, который вызывает соответствие, предпримет эти меры:

      Для каждого UIComponent в списке, возвращенном из curTarget.getTargets (), вызовите curHandler.applyAttachedObject (), передавая FacesContext и UIComponent.

      и заставьте этот внутренний цикл завершаться.

      • Если curHandler является экземпляром ActionSource2AttachedObjectHandler и curTarget является экземпляром ActionSource2AttachedObjectTarget, и curTarget.getName () равен curTargetName, считайте это соответствием.

      • Если curHandler является экземпляром EditableValueHolderAttachedObjectHandler и curTarget является экземпляром EditableValueHolderAttachedObjectTarget, и curTarget.getName () равен curTargetName, считайте это соответствием.

      • Если curHandler является экземпляром ValueHolderAttachedObjectHandler и curTarget является экземпляром ValueHolderAttachedObjectTarget, и curTarget.getName () равен curTargetName, считайте это соответствием.

      • Если curHandler является экземпляром BehaviorHolderAttachedObjectHandler и curTarget является экземпляром BehaviorHolderAttachedObjectTarget, и любое из следующих условий является истиной,

        • curHandler.getEventName () не null и равно curTargetName.
        • curHandler.getEventName () null и curTarget.isDefaultEvent () true.

        считайте это соответствием.

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

Реализация состоит в том при условии, что бросит UnsupportedOperationException. Реализация Поверхностей, совместимая с версией 2.0 и вне спецификации, должна переопределить этот метод.

Параметры:
context - FacesContext для этого запроса.
topLevelComponent - UIComponent в представлении, к которому должны быть присоединены присоединенные объекты. У этого UIComponent должны быть свои компонентные метаданные, уже связанные и доступные от через API JavaBeans.
Броски:
java.lang.NullPointerException - если какой-либо из параметров null.
С тех пор:
2.0

retargetMethodExpressions

public void retargetMethodExpressions(FacesContext context,
                                      UIComponent topLevelComponent)

Принятие компонентных метаданных для параметра topLevelComponent был сделан доступным более ранним звонком ViewDeclarationLanguage#getComponentMetadata, усильте компонентные метаданные с целью перенастройки любых выражений метода от высокоуровневого компонента до соответствующего внутреннего компонента. Для каждого атрибута, который является a MethodExpression (как обозначено присутствием"method-signature"атрибут и отсутствие"type"атрибут), следующие меры должны быть предприняты:

  • Получите значение целевого атрибута. Если значение является a ValueExpression оцените это. Если нет никакого целевого атрибута, позвольте имени элемента метаданных быть оцененным значением целевого атрибута.

  • Интерпретируйте цели как пространство (не, снабжают вкладками), разделенный список идентификаторов. Для каждой записи в списке:

    • Сочтите внутренний компонент topLevelComponent с идентификатором равным текущей записи списка. Для обсуждения этот компонент вызывают целью. Если не найденный, журнал и ошибка и продолжаются к следующему атрибуту.

    • Для обсуждения объявленное имя атрибута вызывают именем.

    • В карте атрибутов topLevelComponent ищите запись под ключевым именем. Предположите, что результатом является a ValueExpression. Для обсуждения это - attributeValueExpression. Если не найденный, зарегистрируйте ошибку и продолжайте к следующему атрибуту.

    • Если имя равно строке "действие", или "actionListener" без кавычек, предположите, что цель ActionSource2.

    • Если имя равно строке "блок проверки допустимости", или "valueChangeListener" без кавычек, предположите, что цель EditableValueHolder.

    • Вызвать getExpressionString() на attributeValueExpression и использовании, которые представляют в виде строки, чтобы создать a MethodExpression из соответствующей подписи для имени.

    • Если имя не равно какой-либо из ранее перечисленных строк, вызвать getExpressionString() на attributeValueExpression и использовании, которые представляют в виде строки, чтобы создать a MethodExpression где подпись создается основанная на значении"method-signature"атрибут <composite:attribute /> тег.

    • Позвольте результанту MethodExpression вызовите attributeMethodExpression для обсуждения.

    • Если имя равно строке "действие" без кавычек, вызвать ActionSource2.setActionExpression(javax.el.MethodExpression) на цели, передавая attributeMethodExpression.

    • Если имя равно строке "actionListener" без кавычек, вызвать ActionSource.addActionListener(javax.faces.event.ActionListener) на цели, передавая attributeMethodExpression обернутый в a MethodExpressionActionListener.

    • Если имя равно строке "блок проверки допустимости" без кавычек, вызвать EditableValueHolder.addValidator(javax.faces.validator.Validator) на цели, передавая attributeMethodExpression обернутый в a MethodExpressionValidator.

    • Если имя равно строке "valueChangeListener" без кавычек, вызвать EditableValueHolder.addValueChangeListener(javax.faces.event.ValueChangeListener) на цели, передавая attributeMethodExpression обернутый в a MethodExpressionValueChangeListener.

    • Иначе, предположите что MethodExpression должен быть помещен в компонентный набор атрибута. runtme должен создать MethodExpression экземпляр, основанный на значении"method-signature"атрибут.

Реализация состоит в том при условии, что бросит UnsupportedOperationException. Реализация Поверхностей, совместимая с версией 2.0 и вне спецификации, должна переопределить этот метод.

Параметры:
context - FacesContext для этого запроса.
topLevelComponent - UIComponent в представлении, к которому должны быть присоединены присоединенные объекты. У этого UIComponent должны быть свои компонентные метаданные, уже связанные и доступные от через API JavaBeans.
Броски:
java.lang.NullPointerException - если context или topLevelComponent null.
С тех пор:
2.0

buildView

public abstract void buildView(FacesContext context,
                               UIViewRoot root)
                        throws java.io.IOException

Предпримите любые меры, определенные для этой реализации VDL, чтобы вызвать параметр UIViewRoot который, должно быть, был создан через звонок createView(javax.faces.context.FacesContext, java.lang.String), быть заполненным с дочерними элементами.

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

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

Параметры:
context - FacesContext для этого запроса
root - UIViewRoot заполнить с дочерними элементами, использующими методы, определенные для этой реализации VDL.
Броски:
java.io.IOException

renderView

public abstract void renderView(FacesContext context,
                                UIViewRoot view)
                         throws java.io.IOException

Представьте представление, базированное в параметреview. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию.

Параметры:
context - FacesContext для этого запроса.
view - UIViewRoot от раннего звонка createView(javax.faces.context.FacesContext, java.lang.String) или restoreView(javax.faces.context.FacesContext, java.lang.String).
Броски:
java.lang.NullPointerException - если какой-либо из параметров null
java.io.IOException

getStateManagementStrategy

public abstract StateManagementStrategy getStateManagementStrategy(FacesContext context,
                                                                   java.lang.String viewId)

Для реализаций, которые хотят управлять реализацией сохранения состояния и восстановления, StateManagementStrategy позволяет им делать так. Возврат null указывает, что реализация хочет, чтобы время выполнения обработало сохранение состояния и восстановление. Реализации, которые предоставляют VDL Facelets для JSF 2.0 и позже должны возвратиться не -null от этого метода.

С тех пор:
2.0

viewExists

public boolean viewExists(FacesContext context,
                          java.lang.String viewId)

Тесты, существует ли физический ресурс, соответствующий указанному viewId.

Использование реализации по умолчанию ExternalContext.getResource() определять местоположение физического ресурса.

Параметры:
context - FacesContext для этого запроса.
viewId - идентификатор представления, чтобы протестировать
С тех пор:
2.1

getId

public java.lang.String getId()

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

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

С тех пор:
2.1


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

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

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


Spec-Zone.ru - all specs in one place



free hit counter