Flash (EE Java 6)

Понятие Flash берется от Ruby on Rails и обеспечивает способ передать временные объекты между пользовательскими представлениями, сгенерированными жизненным циклом поверхностей. Как в Направляющих, что-либо, что каждый помещает во флэш-память, будет представлено следующему представлению, с которым встречается к тот же самый сеанс пользователя, и затем убрало. Важно отметить, что “затем просматривают”, может иметь тот же самый идентификатор представления как предыдущее представление.

Требования реализации

Флэш-память является сеансом определяющий контекст объект, который должен быть ориентирован на многопотоковое исполнение.

Требования реализации будут описаны с точки зрения времени выполнения, пересекающего жизненный цикл JSF. Флэш-память представляет a Map соедините интерфейсом с более чем двумя логическими картами. Выбор которого к логической карте получают доступ, зависит от текущей фазы жизненного цикла поверхностей. Одна логическая карта для текущего обхода, и другой для следующего обхода. Во время выполнить части жизненного цикла все доступы флэш-памяти отправляются текущей карте обхода. Во время представлять части жизненного цикла все доступы флэш-памяти отправляются следующей карте обхода. На следующем обходе через жизненный цикл реализация должна гарантировать, что текущая карта обхода является следующей картой обхода предыдущего обхода. Вот пример в целях иллюстрации только.

Рассмотрите начальный запрос к жизненному циклу поверхностей

Обход N, выполните фазу: пропущенный по начальному запросу.

Обход N, представьте фазу: доступ флэш-памяти идет, чтобы высветиться [N].

Обход N+1, выполните фазу: доступ флэш-памяти идет, чтобы высветиться [N].

Traversan N+1, представьте фазу: доступ флэш-памяти идет, чтобы высветиться [N+1].

Реализация должна гарантировать, что надлежащее поведение флэш-памяти сохраняется даже в случае a <navigation-case> это содержит a <redirect />. Реализация должна гарантировать, что правильное поведение флэш-памяти сохраняется даже в случае смежного, ПОЛУЧАЮТ запросы на том же самом сеансе. Это позволяет приложениям Поверхностей полностью использовать "Отправить/Перенаправить/Получить" шаблон разработки.

Реализация должна позволить пользователю получать доступ к флэш-памяти через ЭЛЬ неявный объект flash и также через ExternalContext.getFlash(). Реализация должна гарантировать, что флэш-память применима и от JSP и от Facelets для JSF 2. В дополнение к представлению Map интерфейс, есть несколько функций, представленных как методы на Flash непосредственно. К каждой из этих функций можно получить доступ через ЭЛЬ также, как описано в javadocs.

ЭЛЬ Пример Использования

Первая страница

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:c="http://java.sun.com/jsp/jstl/core">
<!-- extra code removed -->
  <c:set target="#{flash}" property="foo" value="fooValue" />

Следующая страница

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:h="http://java.sun.com/jsf/html">
<!-- extra code removed -->
  <h:outputText value="#{flash.foo}" /> will be "fooValue"
  without the quotes.

Тот же самый синтаксис использования должен быть доступным в JSP.

Отметьте, что дополнительные меры должны быть предприняты при использовании флэш-памяти совместно с выходными компонентами, которые вызывают браузер к проблеме a, ПОЛУЧАЮТ запрос когда щелкнуто, такой как h:button и h:link. Следующий пример иллюстрирует один способ использовать флэш-память при таких обстоятельствах.

Первая страница

<h:button id="nextButton" value="Next (button)" outcome="next.xhtml">
  <f:param name="foo" value="bar"/>
</h:button>

Следующая страница

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:f="http://java.sun.com/jsf/core"
      xmlns:h="http://java.sun.com/jsf/html">
<f:metadata>
  <f:viewParam name="foo" id="foo" value="#{flash.now.foo}" />
</f:metadata>
<head /><body>
foo = #{flash.foo}
</body>
</html>

Отметьте, что этот пример использует #{flash.now} на второй странице. Это - то, потому что значение не делает actuall, вводят флэш-память, пока сервер не обрабатывает ПОЛУЧИТЬ запрос, отправленный браузером из-за нажатой кнопки.

Сводка метода
`abstract void`	`doPostPhaseActions(FacesContext ctx)` Вызванный после выполнения каждой фазы жизненного цикла, этот метод позволяет реализациям предпринимать необходимые меры, чтобы обеспечить контракт контекста Flash, поскольку это применяется к запросу procesing жизненный цикл.
`abstract void`	`doPrePhaseActions(FacesContext ctx)` Вызванный перед выполнением каждой фазы жизненного цикла, этот метод позволяет реализациям предпринимать необходимые меры, чтобы обеспечить контракт контекста Flash, поскольку это применяется к запросу procesing жизненный цикл.
`abstract boolean`	`isKeepMessages()` Возвратите значение этого свойства JavaBeans для флэш-памяти для этого сеанса.
`abstract boolean`	`isRedirect()` Возвратите значение этого свойства для флэш-памяти для этого сеанса.
`abstract void`	`keep(java.lang.String key)` Вызывает значение, сохраненное предыдущим звонком `putNow(java.lang.String, java.lang.Object)`, его ЭЛЬ эквивалент, или к запросу `Map`, быть продвинутым на флэш-память так, чтобы было доступно на следующем обходе через жизненный цикл на этом сеансе.
`abstract void`	`putNow(java.lang.String key, java.lang.Object value)` Помещает значение во флэш-память так, чтобы к ней можно было получить доступ на этом обходе жизненного цикла, а не на следующем обходе.
`abstract void`	`setKeepMessages(boolean newValue)` Метод set для `keepMessages` Свойство JavaBeans.
`abstract void`	`setRedirect(boolean newValue)` Установка этого свойства к `true` указывает, что следующий запрос на этом сеансе будет перенаправлением.

javax.faces.context
Flash класса

Flash

isKeepMessages

setKeepMessages

isRedirect

setRedirect

putNow

сохранить

doPrePhaseActions

doPostPhaseActions

javax.faces.context Flash класса