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

Пакет javax.enterprise.context

Аннотации и интерфейсы, касающиеся контекстов и контекстов.

См.:
Описание

Сводка интерфейса

Разговор

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

Сводка исключения

BusyConversationException	Указывает, что контейнер отклонил запрос, потому что параллельный запрос связывается с тем же самым контекстом разговора.
ContextException	Указывает на проблему, касающуюся управления контекстом.
ContextNotActiveException	Указывает, что контекст не является активным.
NonexistentConversationException	Указывает, что контекст разговора не мог быть восстановлен.

Аннотация Вводит Сводку

ApplicationScoped	Определяет, что боб является определяющим контекст приложением.
ConversationScoped	Определяет, что боб является определяющим контекст разговором.
Зависимый	Определяет, что боб принадлежит зависимому псевдоконтексту.
NormalScope	Определяет, что тип аннотации является нормальным типом контекста.
RequestScoped	Определяет, что боб является определяющим контекст запросом.
SessionScoped	Определяет, что боб является определяющим контекст сеансом.

Пакет javax.enterprise.context Описание

Аннотации и интерфейсы, касающиеся контекстов и контекстов.

Тип контекста является аннотируемой аннотацией Java @Scope или @NormalScope. Контекст боба определяет жизненный цикл и видимость его экземпляров. В частности контекст определяет:

• Когда новый экземпляр боба создается
• Когда существующий экземпляр боба уничтожается
• Какие введенные ссылки обращаются к любому экземпляру боба

Встроенные контексты

Следующие встроенные контексты обеспечиваются: @Dependent, @RequestScoped, @ConversationScoped, @SessionScoped, @ApplicationScoped, @Singleton.

Контейнер обеспечивает реализацию интерфейса Context для каждого из встроенных контекстов. Встроенный запрос, сеанс, и контексты приложения поддерживают сервлет, веб-сервис и вызовы EJB. Встроенный контекст разговора поддерживает запросы JSF.

Для других видов вызовов переносимое расширение может определить пользовательский объект контекста для любых из встроенных контекстов. Например, сторонняя платформа веб-приложений могла бы обеспечить объект контекста разговора для встроенного контекста разговора.

Контекст, связанный со встроенным контекстом, распространяет через локальные, синхронные вызовы метода Java, включая вызов локальных бизнес-методов EJB. Контекст не распространяет через удаленные вызовы метода, или к асинхронным процессам, таким как JMS передают слушателей или тайм-ауты службы таймера EJB.

Нормальные контексты и псевдоконтексты

Большинство контекстов является нормальными контекстами. Нормальные контексты объявляются, используя @NormalScope. Если у боба есть нормальный контекст, каждый клиент, выполняющийся в определенном потоке, видит тот же самый контекстный экземпляр боба. Этот экземпляр вызывают текущим экземпляром боба. Работа Context.get(Contextual) из объекта контекста для нормального типа контекста всегда возвращает текущий экземпляр данного боба.

Любой контекст, который не является нормальным контекстом, вызывают псевдоконтекстом. Псевдоконтексты объявляются, используя @Scope. Понятие текущего экземпляра не четко определено в случае псевдоконтекста. Различные клиенты, выполняющиеся в том же самом потоке, могут видеть различные экземпляры боба. В крайнем случае @Dependent псевдоконтекст, у каждого клиента есть его собственный частный экземпляр боба.

Все встроенные контексты являются нормальными контекстами, за исключением @Dependent и @Singleton псевдоконтексты.

Контекстная и введенная ссылочная законность

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

Законность контекстной ссылки для боба зависит от того, является ли контекст боба нормальным контекстом или псевдоконтекстом:

• Любая ссылка на боб с нормальным контекстом допустима, пока приложение поддерживает твердую ссылку на нее. Однако, это может только быть вызвано, когда контекст, связанный с нормальным контекстом, активный. Если это вызывается, когда контекст неактивен, a ContextNotActiveException бросается контейнером.
• Любая ссылка на боб с псевдоконтекстом допустима до бобового экземпляра, к которому она обращается, уничтожается. Это может быть вызвано, даже если контекст, связанный с псевдоконтекстом, не активный. Если приложение вызывает метод ссылки на экземпляр, который был уже уничтожен, поведение неопределено.

Ссылка на боб, полученный из контейнера через внедрение зависимости, является специальным видом контекстной ссылки, названной введенной ссылкой. Дополнительные ограничения применяются к законности введенной ссылки:

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

См. Также:

javax.enterprise.inject