javax.enterprise.deploy.spi.factories
Interface DeploymentFactory

All Known Implementing Classes:
DeploymentFactoryImpl (src)

public interface DeploymentFactory

Each application server vendor must provide an implementation of this class in order for the J2EE Deployment API to work with their product. The class implementing this interface should have a public no-argument constructor, and it should be stateless (two instances of the class should always behave the same). It is suggested but not required that the class have a static initializer that registers an instance of the class with the DeploymentFactoryManager class. A connected or disconnected DeploymentManager can be requested. A DeploymentManager that runs connected to the platform can provide access to J2EE resources. A DeploymentManager that runs disconnected only provides module deployment configuration support.


Method Summary
 DeploymentManager (src) getDeploymentManager(java.lang.String uri, java.lang.String userName, java.lang.String password)
          Get a connected deployment manager
 DeploymentManager (src) getDisconnectedDeploymentManager(java.lang.String uri)
          Get a disconnected version of the deployment manager
 java.lang.String getDisplayName()
          The vendor of the deployment manager
 java.lang.String getProductVersion()
          The version of the deployment manager
 boolean handlesURI(java.lang.String uri)
          Tests whether the factory can create a manager for the URI
 

Method Detail

handlesURI

public boolean handlesURI(java.lang.String uri)
Tests whether the factory can create a manager for the URI

Parameters:
uri - the uri
Returns:
true when it can, false otherwise

getDeploymentManager

public DeploymentManager (src)  getDeploymentManager(java.lang.String uri,
                                              java.lang.String userName,
                                              java.lang.String password)
                                       throws DeploymentManagerCreationException (src) 
Get a connected deployment manager

Parameters:
uri - the uri of the deployment manager
userName - the user name
password - the password
Returns:
the deployment manager
Throws:
DeploymentManagerCreationException (src)

getDisconnectedDeploymentManager

public DeploymentManager (src)  getDisconnectedDeploymentManager(java.lang.String uri)
                                                   throws DeploymentManagerCreationException (src) 
Get a disconnected version of the deployment manager

Parameters:
uri - the uri to connect to
Returns:
the disconnected deployment manager
Throws:
DeploymentManagerCreationException (src)

getDisplayName

public java.lang.String getDisplayName()
The vendor of the deployment manager

Returns:
the vendor name

getProductVersion

public java.lang.String getProductVersion()
The version of the deployment manager

Returns:
the version