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

javax.enterprise.context
Тип аннотации ConversationScoped

@Target(value={TYPE,METHOD,FIELD})
@Retention(value=RUNTIME)
@Documented
@NormalScope(passivating=true)
@Inherited
public @interface ConversationScoped

Определяет, что боб является определяющим контекст разговором.

Контекст разговора является активным:

• во время всех стандартных фаз жизненного цикла любого запроса поверхностей или неповерхностей JSF.

Контекст разговора обеспечивает доступ к состоянию, связанному с определенным разговором. У каждого запроса JSF есть связанный разговор. Этой ассоциацией управляет автоматически контейнер согласно следующим правилам:

• У любого запроса JSF есть точно один связанный разговор.
• Разговор, связанный с запросом JSF, определяется в начале фазы представления восстановления и не изменяется во время запроса.

Любой разговор находится в одном из двух состояний: переходный процесс или продолжительный.

• По умолчанию разговор является переходным процессом
• Переходный разговор может быть отмечен продолжительный, вызывая Conversation.begin()
• Продолжительный разговор может быть отмечен переходный процесс, вызывая Conversation.end()

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

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

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

• Продолжительный контекст разговора, связанный с запросом, который представляет представление JSF, автоматически распространяется к любому запросу поверхностей (представление формы JSF), который происходит из той представленной страницы.
• Продолжительный контекст разговора, связанный с запросом, который приводит к перенаправлению JSF (перенаправление, следующее из правила навигации или NavigationHandler JSF), автоматически распространяется к получающемуся запросу неповерхностей, и к любому другому последующему запросу к тому же самому URL. Это выполняется через использование ПОЛУЧИТЬ параметра запроса под названием cid, содержащий уникальный идентификатор разговора.
• Продолжительный разговор, связанный с запросом, может быть распространен к любому запросу неповерхностей через использование ПОЛУЧИТЬ параметра запроса под названием cid, содержащий уникальный идентификатор разговора. В этом случае приложение должно управлять этим параметром запроса.

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

• Когда сеанс сервлета HTTP лишается законной силы, все продолжительные контексты разговора, создаваемые во время текущего сеанса, уничтожаются, после того, как метод service() сервлета завершается.
• Контейнеру разрешают произвольно уничтожить любой продолжительный разговор, который связывается без текущего запроса JSF, чтобы сохранить ресурсы.

Автор:

Гэвин Кинг, Пит Мюр

См. Также:

Conversation, NonexistentConversationException, BusyConversationException