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

javax.enterprise.inject.spi
Интерфейс BeanManager

public interface BeanManager

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

Любой боб может получить экземпляр BeanManager, вводя это:

 @Inject BeanManager manager;
 

Компоненты EE Java могут получить экземпляр BeanManager от JNDI, ища имя java:comp/BeanManager.

Любую работу BeanManager можно вызвать в любое время во время выполнения приложения.

Автор:

Гэвин Кинг, Пит Мюр, Клинт Попец, Дэвид Аллен

Сводка метода

<T> AnnotatedType<T>	createAnnotatedType(java.lang.Class<T> type) Получите AnnotatedType это может использоваться, чтобы считать аннотации данного class или интерфейса.
<T> CreationalContext<T>	createCreationalContext(Contextual<T> contextual) Получите экземпляр a CreationalContext для данного контекстного типа, или для неконтекстного объекта.
<T> InjectionTarget<T>	createInjectionTarget(AnnotatedType<T> type) Получает InjectionTarget для данного AnnotatedType.
void	fireEvent(java.lang.Object event, java.lang.annotation.Annotation... qualifiers) Запустите событие и уведомьте наблюдателей.
java.util.Set<Bean<?>>	getBeans(java.lang.String name) Возвратите набор бобов, которые имеют данное ЭЛЬ имя и доступны для инжекции в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI BeanManager был получен согласно правилам ЭЛЬ разрешения имени.
java.util.Set<Bean<?>>	getBeans(java.lang.reflect.Type beanType, java.lang.annotation.Annotation... qualifiers) Возвратите набор бобов, которые имеют данный требуемый тип и спецификаторы и доступны для инжекции в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI BeanManager был получен согласно правилам безопасного с точки зрения типов разрешения.
Контекст	getContext(java.lang.Class<? extends java.lang.annotation.Annotation> scopeType) Получает активный объект контекста для данного контекста.
ELResolver	getELResolver() Возвраты a ELResolver это разрешает бобы ЭЛЬ именем.
java.lang.Object	getInjectableReference(InjectionPoint ij, CreationalContext<?> ctx) Получает вводимую ссылку для определенной инжекционной точки.
java.util.Set<java.lang.annotation.Annotation>	getInterceptorBindingDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> bindingType) Получает набор метааннотаций для определенного типа привязки перехватчика.
Bean<?>	getPassivationCapableBean(java.lang.String id) Возвраты PassivationCapable боб с данным идентификатором.
java.lang.Object	getReference(Bean<?> bean, java.lang.reflect.Type beanType, CreationalContext<?> ctx) Получает контекстную ссылку для определенного боба и определенного бобового типа боба.
java.util.Set<java.lang.annotation.Annotation>	getStereotypeDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> stereotype) Получает метааннотации для определенного стереотипа.
boolean	isInterceptorBinding(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Протестируйте данный тип аннотации, чтобы определить, является ли это тип привязки перехватчика.
boolean	isNormalScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Протестируйте данный тип аннотации, чтобы определить, является ли это нормальный тип контекста.
boolean	isPassivatingScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Протестируйте данный тип аннотации, чтобы определить, является ли это пассивирующий тип контекста.
boolean	isQualifier(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Протестируйте данный тип аннотации, чтобы определить, является ли это тип спецификатора.
boolean	isScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Протестируйте данный тип аннотации, чтобы определить, является ли это тип контекста.
boolean	isStereotype(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType) Протестируйте данный тип аннотации, чтобы определить, является ли это стереотип.
<X> Bean<? extends X>	resolve(java.util.Set<Bean<? extends X>> beans) Примените неоднозначные правила разрешения зависимости к ряду бобов.
java.util.List<Decorator<?>>	resolveDecorators(java.util.Set<java.lang.reflect.Type> types, java.lang.annotation.Annotation... qualifiers) Возвратите упорядоченный список декораторов для ряда бобовых типов и ряда спецификаторов и которые включаются в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI был получен BeanManager.
java.util.List<Interceptor<?>>	resolveInterceptors(InterceptionType type, java.lang.annotation.Annotation... interceptorBindings) Возвратите упорядоченный список включенных перехватчиков для ряда привязки перехватчика и типа перехвата и которые включаются в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI был получен BeanManager.
<T> java.util.Set<ObserverMethod<? super T>>	resolveObserverMethods(T event, java.lang.annotation.Annotation... qualifiers) Возвратите группу наблюдателей для события.
void	validate(InjectionPoint injectionPoint) Проверьте определенной инжекционной точки.
ExpressionFactory	wrapExpressionFactory(ExpressionFactory expressionFactory) Возвращает обертку ExpressionFactory это делегирует MethodExpression и ValueExpression создание к данному ExpressionFactory.

Деталь метода

getReference

java.lang.Object getReference(Bean<?> bean,
                              java.lang.reflect.Type beanType,
                              CreationalContext<?> ctx)

Получает контекстную ссылку для определенного боба и определенного бобового типа боба.

Параметры:

bean - Bean объект, представляющий боб

beanType - бобовый тип, который должен быть реализован любым клиентским прокси, который возвращается

ctx - a CreationalContext это может использоваться, чтобы уничтожить любой объект с контекстом {javax.enterprise.context. Зависимый}, который создается

Возвраты:

контекстная ссылка, представляющая боб

Броски:

IllegalArgumentException - если данный тип не является бобовым типом данного боба

getInjectableReference

java.lang.Object getInjectableReference(InjectionPoint ij,
                                        CreationalContext<?> ctx)

Получает вводимую ссылку для определенной инжекционной точки.

Параметры:

ij - целевая инжекционная точка

ctx - a CreationalContext это может использоваться, чтобы уничтожить любой объект с контекстом {javax.enterprise.context. Зависимый}, который создается

Возвраты:

вводимая ссылка

Броски:

UnsatisfiedResolutionException - если безопасное с точки зрения типов разрешение приводит к неудовлетворенной зависимости

AmbiguousResolutionException - безопасное с точки зрения типов разрешение приводит к неразрешимой неоднозначной зависимости

createCreationalContext

<T> CreationalContext<T> createCreationalContext(Contextual<T> contextual)

Получите экземпляр a CreationalContext для данного контекстного типа, или для неконтекстного объекта.

Параметры:

contextual - Contextual, или нулевое значение в случае неконтекстного объекта

Возвраты:

новое CreationalContext

getBeans

java.util.Set<Bean<?>> getBeans(java.lang.reflect.Type beanType,
                                java.lang.annotation.Annotation... qualifiers)

Возвратите набор бобов, которые имеют данный требуемый тип и спецификаторы и доступны для инжекции в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI BeanManager был получен согласно правилам безопасного с точки зрения типов разрешения. Если никакие спецификаторы не даются, спецификатор значения по умолчанию принимается.

Параметры:

beanType - необходимый бобовый тип

qualifiers - необходимые спецификаторы

Возвраты:

получающийся набор бобов

Броски:

IllegalArgumentException - если данный тип представляет переменную типа

IllegalArgumentException - если два примера того же самого типа спецификатора приводятся

IllegalArgumentException - если пример аннотации, которая не является типом спецификатора, приводится

getBeans

java.util.Set<Bean<?>> getBeans(java.lang.String name)

Возвратите набор бобов, которые имеют данное ЭЛЬ имя и доступны для инжекции в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI BeanManager был получен согласно правилам ЭЛЬ разрешения имени.

Параметры:

name - ЭЛЬ имя

Возвраты:

получающийся набор бобов

getPassivationCapableBean

Bean<?> getPassivationCapableBean(java.lang.String id)

Возвраты PassivationCapable боб с данным идентификатором.

Параметры:

id - идентификатор

Возвраты:

a Bean это реализует PassivationCapable и имеет данный идентификатор, или нулевое значение, если нет такого боба

решение

<X> Bean<? extends X> resolve(java.util.Set<Bean<? extends X>> beans)

Примените неоднозначные правила разрешения зависимости к ряду бобов.

Введите Параметры:

X - общий тип бобов

Параметры:

beans - ряд бобов данного типа

Броски:

AmbiguousResolutionException - если неоднозначное разрешение зависимости управляет сбоем

проверить

void validate(InjectionPoint injectionPoint)

Проверьте определенной инжекционной точки.

Параметры:

injectionPoint - инжекционная точка, чтобы проверить

Броски:

InjectionException - если есть проблема развертывания (например, неудовлетворенная или неразрешимая неоднозначная зависимость) связана с инжекционной точкой

fireEvent

void fireEvent(java.lang.Object event,
               java.lang.annotation.Annotation... qualifiers)

Запустите событие и уведомьте наблюдателей.

Параметры:

event - объект-событие

qualifiers - спецификаторы события

Броски:

IllegalArgumentException - если тип времени выполнения объекта-события содержит переменную типа

IllegalArgumentException - если два примера того же самого типа спецификатора приводятся

IllegalArgumentException - если пример аннотации, которая не является типом спецификатора, приводится

resolveObserverMethods

<T> java.util.Set<ObserverMethod<? super T>> resolveObserverMethods(T event,
                                                                    java.lang.annotation.Annotation... qualifiers)

Возвратите группу наблюдателей для события.

Введите Параметры:

T - тип события

Параметры:

event - объект-событие

qualifiers - спецификаторы события

Броски:

IllegalArgumentException - если тип времени выполнения объекта-события содержит переменную типа

IllegalArgumentException - если два примера того же самого типа спецификатора приводятся

IllegalArgumentException - если пример аннотации, которая не является типом спецификатора, приводится

resolveDecorators

java.util.List<Decorator<?>> resolveDecorators(java.util.Set<java.lang.reflect.Type> types,
                                               java.lang.annotation.Annotation... qualifiers)

Возвратите упорядоченный список декораторов для ряда бобовых типов и ряда спецификаторов и которые включаются в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI был получен BeanManager.

Параметры:

types - набор бобовых типов украшенного боба

qualifiers - спецификаторы объявляются украшенным бобом

Возвраты:

получающаяся группа декораторов

Броски:

IllegalArgumentException - если набор бобовых типов пуст

IllegalArgumentException - если аннотацию, которая не является обязательным типом, передают

IllegalArgumentException - если два экземпляра того же самого обязательного типа передают

resolveInterceptors

java.util.List<Interceptor<?>> resolveInterceptors(InterceptionType type,
                                                   java.lang.annotation.Annotation... interceptorBindings)

Возвратите упорядоченный список включенных перехватчиков для ряда привязки перехватчика и типа перехвата и которые включаются в модуле или библиотеке, содержащей class, в который BeanManager был введен или компонент EE Java, из чьего пространства имен среды JNDI был получен BeanManager.

Параметры:

type - тип перехвата

interceptorBindings - привязка перехватчика

Возвраты:

получающийся набор перехватчиков

Броски:

IllegalArgumentException - если никакой тип привязки перехватчика не дается

IllegalArgumentException - если два примера того же самого типа привязки перехватчика приводятся

IllegalArgumentException - если пример аннотации, которая не является типом привязки перехватчика, приводится

isScope

boolean isScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Протестируйте данный тип аннотации, чтобы определить, является ли это тип контекста.

Параметры:

annotationType - тип аннотации

Возвраты:

истина, если тип аннотации является типом контекста

isNormalScope

boolean isNormalScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

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

Параметры:

annotationType - тип аннотации

Возвраты:

true, если тип аннотации является нормальным типом контекста

isPassivatingScope

boolean isPassivatingScope(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Протестируйте данный тип аннотации, чтобы определить, является ли это пассивирующий тип контекста.

Параметры:

annotationType - тип аннотации

Возвраты:

true, если тип аннотации является пассивирующим типом контекста

isQualifier

boolean isQualifier(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Протестируйте данный тип аннотации, чтобы определить, является ли это тип спецификатора.

Параметры:

annotationType - тип аннотации

Возвраты:

true, если тип аннотации является типом спецификатора

isInterceptorBinding

boolean isInterceptorBinding(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Протестируйте данный тип аннотации, чтобы определить, является ли это тип привязки перехватчика.

Параметры:

annotationType - аннотация, чтобы протестировать

Возвраты:

true, если тип аннотации является типом привязки перехватчика

isStereotype

boolean isStereotype(java.lang.Class<? extends java.lang.annotation.Annotation> annotationType)

Протестируйте данный тип аннотации, чтобы определить, является ли это стереотип.

Параметры:

annotationType - тип аннотации

Возвраты:

true, если тип аннотации является стереотипом

getInterceptorBindingDefinition

java.util.Set<java.lang.annotation.Annotation> getInterceptorBindingDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> bindingType)

Получает набор метааннотаций для определенного типа привязки перехватчика.

Параметры:

bindingType - тип привязки перехватчика

Возвраты:

набор метааннотаций

getStereotypeDefinition

java.util.Set<java.lang.annotation.Annotation> getStereotypeDefinition(java.lang.Class<? extends java.lang.annotation.Annotation> stereotype)

Получает метааннотации для определенного стереотипа.

Параметры:

stereotype - стереотип

Возвраты:

набор метааннотаций

getContext

Context getContext(java.lang.Class<? extends java.lang.annotation.Annotation> scopeType)

Получает активный объект контекста для данного контекста.

Параметры:

scopeType - контекст

Возвраты:

объект контекста

Броски:

ContextNotActiveException - если нет никакого активного объекта контекста для данного контекста

IllegalArgumentException - если есть больше чем один активный объект контекста для данного контекста

getELResolver

ELResolver getELResolver()

Возвраты a ELResolver это разрешает бобы ЭЛЬ именем.

wrapExpressionFactory

ExpressionFactory wrapExpressionFactory(ExpressionFactory expressionFactory)

Возвращает обертку ExpressionFactory это делегирует MethodExpression и ValueExpression создание к данному ExpressionFactory. Когда Объединенное ЭЛЬ выражение оценивается, используя a MethodExpression или ValueExpression возвращенный оберткой ExpressionFactory, контейнер обрабатывает разрушение объектов с контекстом Dependent.

Параметры:

expressionFactory - ExpressionFactory переноситься

Возвраты:

обернутый ExpressionFactory

createAnnotatedType

<T> AnnotatedType<T> createAnnotatedType(java.lang.Class<T> type)

Получите AnnotatedType это может использоваться, чтобы считать аннотации данного class или интерфейса.

Введите Параметры:

T - class или интерфейс

Параметры:

type - Class объект

Возвраты:

AnnotatedType

createInjectionTarget

<T> InjectionTarget<T> createInjectionTarget(AnnotatedType<T> type)

Получает InjectionTarget для данного AnnotatedType. Контейнер игнорирует аннотации и вводит объявленный элементами фактического Java class и использует метаданные, обеспеченные через Annotated интерфейс вместо этого.

Введите Параметры:

T - тип

Параметры:

type - AnnotatedType

Броски:

IllegalArgumentException - если есть ошибка определения, связанная с какой-либо инжекционной точкой типа