org.jboss.weld.experimental

Interface BeanBuilder<T>

Type Parameters:

T - the class of the bean instance

public interface BeanBuilder<T>

This API is experimental and may be subject of incompatible changes. TODO Clarify reusability

Author:

Martin Kouba

Issue tracker:

• WELD-1795

Method Summary

Modifier and Type	Method and Description
BeanBuilder<T>	addInjectionPoint(javax.enterprise.inject.spi.InjectionPoint injectionPoint)
BeanBuilder<T>	addInjectionPoints(javax.enterprise.inject.spi.InjectionPoint... injectionPoints)
BeanBuilder<T>	addInjectionPoints(Set<javax.enterprise.inject.spi.InjectionPoint> injectionPoints)
BeanBuilder<T>	addQualifier(Annotation qualifier) If the builder declares the Default qualifier, it's automatically removed.
BeanBuilder<T>	addQualifiers(Annotation... qualifiers) If the builder declares the Default qualifier, it's automatically removed.
BeanBuilder<T>	addQualifiers(Set<Annotation> qualifiers) If the builder declares the Default qualifier, it's automatically removed.
BeanBuilder<T>	addStereotype(Class<? extends Annotation> stereotype)
BeanBuilder<T>	addStereotypes(Set<Class<? extends Annotation>> stereotypes)
BeanBuilder<T>	addTransitiveTypeClosure(Type type) Adds an unrestricted set of bean types for the given type as if it represented a bean class of a managed bean.
BeanBuilder<T>	addType(Type type)
BeanBuilder<T>	addType(javax.enterprise.util.TypeLiteral<?> typeLiteral)
BeanBuilder<T>	addTypes(Set<Type> types)
BeanBuilder<T>	addTypes(Type... types)
BeanBuilder<T>	alternative() The bean is an alternative.
BeanBuilder<T>	alternative(boolean value)
BeanBuilder<T>	beanClass(Class<?> beanClass) If not set, the extension class is used.
javax.enterprise.inject.spi.Bean<T>	build()
<U extends T> BeanBuilder<U>	createWith(java.util.function.Function<javax.enterprise.context.spi.CreationalContext<U>,U> callback)
BeanBuilder<T>	destroyWith(java.util.function.BiConsumer<T,javax.enterprise.context.spi.CreationalContext<T>> callback)
BeanBuilder<T>	disposeWith(java.util.function.Consumer<T> callback)
BeanBuilder<T>	id(String id)
BeanBuilder<T>	injectionPoints(javax.enterprise.inject.spi.InjectionPoint... injectionPoints)
BeanBuilder<T>	injectionPoints(Set<javax.enterprise.inject.spi.InjectionPoint> injectionPoints)
BeanBuilder<T>	name(String name)
<U extends T> BeanBuilder<U>	produceWith(java.util.function.Function<javax.enterprise.inject.Instance<Object>,U> callback) If no destroy callback is specified, a NOOP dispose callback is automatically set.
<U extends T> BeanBuilder<U>	produceWith(java.util.function.Supplier<U> callback) If no destroy callback is specified, a NOOP dispose callback is automatically set.
<U extends T> BeanBuilder<U>	producing(U instance) A shortcut for produceWith(() -> existing where existing represents an instance whose lifecycle is not managed by CDI.
BeanBuilder<T>	qualifiers(Annotation... qualifiers) Replace all qualifiers.
BeanBuilder<T>	qualifiers(Set<Annotation> qualifiers) Replace all qualifiers.
<U extends T> BeanBuilder<U>	read(javax.enterprise.inject.spi.AnnotatedType<U> type) Read the information from the given annotated type.
BeanBuilder<T>	read(javax.enterprise.inject.spi.BeanAttributes<?> beanAttributes) Read the information from the given bean attributes.
BeanBuilder<T>	scope(Class<? extends Annotation> scope)
BeanBuilder<T>	stereotypes(Set<Class<? extends Annotation>> stereotypes)
BeanBuilder<T>	types(Set<Type> types)
BeanBuilder<T>	types(Type... types)

Method Detail

read

<U extends T> BeanBuilder<U> read(javax.enterprise.inject.spi.AnnotatedType<U> type)

Read the information from the given annotated type. This operation is deferred until build() is invoked. At that time, the information is merged with existing values. Values set manually have higher priority than read values.

Parameters:

type -

Returns:

self

read

BeanBuilder<T> read(javax.enterprise.inject.spi.BeanAttributes<?> beanAttributes)

Read the information from the given bean attributes. All relevant information is overwritten.

Parameters:

beanAttributes -

Returns:

self

beanClass

BeanBuilder<T> beanClass(Class<?> beanClass)

If not set, the extension class is used.

Parameters:

beanClass -

Returns:

self

addType

BeanBuilder<T> addType(Type type)

Parameters:

type -

Returns:

self

addType

BeanBuilder<T> addType(javax.enterprise.util.TypeLiteral<?> typeLiteral)

Parameters:

typeLiteral -

Returns:

self

addTypes

BeanBuilder<T> addTypes(Type... types)

Parameters:

types -

Returns:

self

addTypes

BeanBuilder<T> addTypes(Set<Type> types)

Parameters:

types -

Returns:

self

addTransitiveTypeClosure

BeanBuilder<T> addTransitiveTypeClosure(Type type)

Adds an unrestricted set of bean types for the given type as if it represented a bean class of a managed bean. Illegal bean types are omitted. See also 3.1.2. Bean types of a managed bean.

Parameters:

type -

Returns:

self

types

BeanBuilder<T> types(Type... types)

Parameters:

types -

Returns:

self

types

BeanBuilder<T> types(Set<Type> types)

Parameters:

types -

Returns:

self

scope

BeanBuilder<T> scope(Class<? extends Annotation> scope)

Parameters:

scope -

Returns:

self

addQualifier

BeanBuilder<T> addQualifier(Annotation qualifier)

If the builder declares the Default qualifier, it's automatically removed.

Parameters:

qualifier -

Returns:

self

addQualifiers

BeanBuilder<T> addQualifiers(Annotation... qualifiers)

If the builder declares the Default qualifier, it's automatically removed.

Parameters:

qualifiers -

Returns:

self

addQualifiers

BeanBuilder<T> addQualifiers(Set<Annotation> qualifiers)

If the builder declares the Default qualifier, it's automatically removed.

Parameters:

qualifiers -

Returns:

self

qualifiers

BeanBuilder<T> qualifiers(Annotation... qualifiers)

Replace all qualifiers.

Parameters:

qualifiers -

Returns:

self

qualifiers

BeanBuilder<T> qualifiers(Set<Annotation> qualifiers)

Replace all qualifiers.

Parameters:

qualifiers -

Returns:

self

addStereotype

BeanBuilder<T> addStereotype(Class<? extends Annotation> stereotype)

Parameters:

stereotype -

Returns:

self

addStereotypes

BeanBuilder<T> addStereotypes(Set<Class<? extends Annotation>> stereotypes)

Parameters:

stereotypes -

Returns:

self

stereotypes

BeanBuilder<T> stereotypes(Set<Class<? extends Annotation>> stereotypes)

Parameters:

stereotypes -

Returns:

self

name

BeanBuilder<T> name(String name)

Parameters:

name -

Returns:

self

alternative

BeanBuilder<T> alternative()

The bean is an alternative.

Returns:

self

See Also:

alternative(boolean)

alternative

BeanBuilder<T> alternative(boolean value)

Parameters:

value -

Returns:

self

addInjectionPoint

BeanBuilder<T> addInjectionPoint(javax.enterprise.inject.spi.InjectionPoint injectionPoint)

Parameters:

injectionPoint -

Returns:

self

addInjectionPoints

BeanBuilder<T> addInjectionPoints(javax.enterprise.inject.spi.InjectionPoint... injectionPoints)

Parameters:

injectionPoints -

Returns:

self

addInjectionPoints

BeanBuilder<T> addInjectionPoints(Set<javax.enterprise.inject.spi.InjectionPoint> injectionPoints)

Parameters:

injectionPoints -

Returns:

injectionPoints

BeanBuilder<T> injectionPoints(javax.enterprise.inject.spi.InjectionPoint... injectionPoints)

Parameters:

injectionPoints -

Returns:

self

injectionPoints

BeanBuilder<T> injectionPoints(Set<javax.enterprise.inject.spi.InjectionPoint> injectionPoints)

Parameters:

injectionPoints -

Returns:

id

BeanBuilder<T> id(String id)

Parameters:

id -

Returns:

self

See Also:

PassivationCapable.getId()

createWith

<U extends T> BeanBuilder<U> createWith(java.util.function.Function<javax.enterprise.context.spi.CreationalContext<U>,U> callback)

Parameters:

callback -

Returns:

self

produceWith

<U extends T> BeanBuilder<U> produceWith(java.util.function.Supplier<U> callback)

If no destroy callback is specified, a NOOP dispose callback is automatically set.

Parameters:

callback -

Returns:

self

produceWith

<U extends T> BeanBuilder<U> produceWith(java.util.function.Function<javax.enterprise.inject.Instance<Object>,U> callback)

If no destroy callback is specified, a NOOP dispose callback is automatically set.

Parameters:

callback -

Returns:

self

producing

<U extends T> BeanBuilder<U> producing(U instance)

A shortcut for produceWith(() -> existing where existing represents an instance whose lifecycle is not managed by CDI.

Parameters:

instance -

Returns:

self

destroyWith

BeanBuilder<T> destroyWith(java.util.function.BiConsumer<T,javax.enterprise.context.spi.CreationalContext<T>> callback)

Parameters:

callback -

Returns:

self

disposeWith

BeanBuilder<T> disposeWith(java.util.function.Consumer<T> callback)

Parameters:

callback -

Returns:

self

build

javax.enterprise.inject.spi.Bean<T> build()

Returns:

an immutable bean