org.jboss.as.weld

Interface WeldCapability

public interface WeldCapability

API exposed by the Weld capability.

Author:

Yeray Borges

Method Summary

Modifier and Type	Method and Description
Supplier<javax.enterprise.inject.spi.BeanManager>	addBeanManagerService(org.jboss.as.server.deployment.DeploymentUnit unit, org.jboss.msc.service.ServiceBuilder<?> serviceBuilder) Adds the Bean Manager service associated to the DeploymentUnit to ServiceBuilder passed as argument.
org.jboss.msc.service.ServiceBuilder<?>	addBeanManagerService(org.jboss.as.server.deployment.DeploymentUnit unit, org.jboss.msc.service.ServiceBuilder<?> serviceBuilder, org.jboss.msc.inject.Injector<javax.enterprise.inject.spi.BeanManager> targetInjector) Adds the Bean Manager service associated to the DeploymentUnit to ServiceBuilder passed as argument.
boolean	isPartOfWeldDeployment(org.jboss.as.server.deployment.DeploymentUnit unit) Returns true if the DeploymentUnit is part of a weld deployment.
boolean	isWeldDeployment(org.jboss.as.server.deployment.DeploymentUnit unit) Returns true if the DeploymentUnit has a beans.xml in any of it's resource roots, or is a top level deployment that contains sub-deployments that are weld deployments.
void	registerExtensionInstance(javax.enterprise.inject.spi.Extension extension, org.jboss.as.server.deployment.DeploymentUnit unit) Registers a CDI Portable Extension for the DeploymentUnit passed as argument to this method.

Method Detail

registerExtensionInstance

void registerExtensionInstance(javax.enterprise.inject.spi.Extension extension,
                               org.jboss.as.server.deployment.DeploymentUnit unit)

Registers a CDI Portable Extension for the DeploymentUnit passed as argument to this method.

The extension is registered if only if the DeploymentUnit is part of a Weld Deployment. Specifically, if a call to isPartOfWeldDeployment(DeploymentUnit) using the DeploymentUnit argument returns true. Otherwise this method will return immediately.

Parameters:

extension - An instance of the CDI portable extension to add.

unit - The deployment unit where the extension will be registered.

addBeanManagerService

Supplier<javax.enterprise.inject.spi.BeanManager> addBeanManagerService(org.jboss.as.server.deployment.DeploymentUnit unit,
                                                                        org.jboss.msc.service.ServiceBuilder<?> serviceBuilder)

Adds the Bean Manager service associated to the DeploymentUnit to ServiceBuilder passed as argument.

The Bean Manager service is added if only if the DeploymentUnit is part of a Weld Deployment. Specifically, if a call to isPartOfWeldDeployment(DeploymentUnit) using the DeploymentUnit argument returns true. Otherwise this method will return null.

Parameters:

unit - DeploymentUnit used to get the Bean Manager service name. Cannot be null.

serviceBuilder - The service builder used to add the dependency. Cannot be null.

Returns:

A supplier that contains the BeanManager instance if the DeploymentUnit is part of a Weld Deployment, otherwise returns null.

Throws:

IllegalStateException - if this method have been called after ServiceBuilder.setInstance(org.jboss.msc.Service) method.

UnsupportedOperationException - if this service builder wasn't created via ServiceTarget.addService(ServiceName) method.

addBeanManagerService

org.jboss.msc.service.ServiceBuilder<?> addBeanManagerService(org.jboss.as.server.deployment.DeploymentUnit unit,
                                                              org.jboss.msc.service.ServiceBuilder<?> serviceBuilder,
                                                              org.jboss.msc.inject.Injector<javax.enterprise.inject.spi.BeanManager> targetInjector)

Adds the Bean Manager service associated to the DeploymentUnit to ServiceBuilder passed as argument. Use this method to add the service dependency for legacy msc services.

The Bean Manager service is added if only if the DeploymentUnit is part of a Weld Deployment. Specifically, if a call to isPartOfWeldDeployment(DeploymentUnit) using the DeploymentUnit argument returns true. Otherwise this method will return immediately without applying any modification to the serviceBuilder.

Parameters:

unit - DeploymentUnit used to get the Bean Manager service name. Cannot be null.

serviceBuilder - The service builder used to add the dependency. Cannot be null.

targetInjector - the injector into which the dependency should be stored. Cannot be null.

Returns:

the ServiceBuilder with the Bean Manager service added.

Throws:

UnsupportedOperationException - if the service builder was created via ServiceTarget.addService(ServiceName) method.

isPartOfWeldDeployment

boolean isPartOfWeldDeployment(org.jboss.as.server.deployment.DeploymentUnit unit)

Returns true if the DeploymentUnit is part of a weld deployment.

Parameters:

unit - DeploymentUnit to check.

Returns:

true if the DeploymentUnit is part of a weld deployment.

isWeldDeployment

boolean isWeldDeployment(org.jboss.as.server.deployment.DeploymentUnit unit)

Returns true if the DeploymentUnit has a beans.xml in any of it's resource roots, or is a top level deployment that contains sub-deployments that are weld deployments.

Parameters:

unit - DeploymentUnit to check.

Returns:

true if the DeploymentUnit has a beans.xml in any of it's resource roots, or is a top level deployment that contains sub-deployments that are weld deployments.