org.jboss.weld.bootstrap.spi
Interface BeanDeploymentArchive

All Known Implementing Classes:
ForwardingBeanDeploymentArchive

public interface BeanDeploymentArchive

Represents a CDI bean deployment archive. A deployment archive is any library jar, library directory, EJB jar, rar archive or any war WEB-INF/classes directory contained in the Java EE deployment (as defined in the Java Platform, Enterprise Edition (Java EE) Specification, v6, Section 8.1.2). TODO Java SE definition of a deployment archive A bean deployment archive is any deployment archive with a META-INF/beans.xml file, or for a war, with a WEB-INF/beans.xml. The container is allowed to specify a deployment archive as BeanDeploymentArchive even if no beans.xml is present (for example, a container could define a deployment archive with container specific metadata to be a bean deployment archive).

Author:
Pete Muir
See Also:
Deployment

Method Summary
 java.util.Collection<java.lang.Class<?>> getBeanClasses()
          Gets all classes in the bean deployment archive
 java.util.Collection<BeanDeploymentArchive> getBeanDeploymentArchives()
          Get the bean deployment archives which are accessible to this bean deployment archive and adjacent to it in the deployment archive graph.
 java.util.Collection<java.net.URL> getBeansXml()
          Get any deployment descriptors in the bean deployment archive.
 java.util.Collection<EjbDescriptor<?>> getEjbs()
          Get all the EJBs in the deployment archive
 java.lang.String getId()
          Get a string which uniquely identifies the BeanDeploymentArchive within the Deployment.
 ServiceRegistry getServices()
          Get the Bean Deployment Archive scoped services
 

Method Detail

getBeanDeploymentArchives

java.util.Collection<BeanDeploymentArchive> getBeanDeploymentArchives()
Get the bean deployment archives which are accessible to this bean deployment archive and adjacent to it in the deployment archive graph. Cycles in the accessible BeanDeploymentArchive graph are allowed. If a cycle is detected by Weld, it will be automatically removed by Web Beans. This means any implementor of this interface don't need to worry about circularities.

Returns:
the accessible bean deployment archives

getBeanClasses

java.util.Collection<java.lang.Class<?>> getBeanClasses()
Gets all classes in the bean deployment archive

Returns:
the classes, empty if no classes are present

getBeansXml

java.util.Collection<java.net.URL> getBeansXml()
Get any deployment descriptors in the bean deployment archive. The container will normally return a single deployment descriptor per bean deployment archive (the physical META-INF/beans.xml or WEB-INF/beans.xml), however it is permitted to return other deployment descriptors defined using other methods.

Returns:
the URLs pointing to the deployment descriptor, or an empty set if none are present

getEjbs

java.util.Collection<EjbDescriptor<?>> getEjbs()
Get all the EJBs in the deployment archive

Returns:
the EJBs, or empty if no EJBs are present or if this is not an EJB archive

getServices

ServiceRegistry getServices()
Get the Bean Deployment Archive scoped services

Returns:

getId

java.lang.String getId()
Get a string which uniquely identifies the BeanDeploymentArchive within the Deployment. The identifier must be consistent between multiple occurrences of this deployment.

Returns:


Copyright © 2008-2009 Seam Framework. All Rights Reserved.