javax.enterprise.deploy.shared.factories

Class DeploymentFactoryManager

java.lang.Object

javax.enterprise.deploy.shared.factories.DeploymentFactoryManager

public final class DeploymentFactoryManager
extends Object

The DeploymentFactoryManager class is a central registry for J2EE DeploymentFactory objects. The DeploymentFactoryManager retains references to DeploymentFactory objects loaded by a tool. A DeploymentFactory object provides a reference to a DeploymentManager. The DeploymentFactoryManager has been implemented as a singleton. A tool gets a reference to the DeploymentFactoryManager via the getInstance method. The DeploymentFactoryManager can return two types of DeploymentManagers, a connected DeploymentManager and a disconnected DeploymentManager. The connected DeploymentManager provides access to any product resources that may be required for configurations and deployment. The method to retrieve a connected DeploymentManager is getDeploymentManager. This method provides parameters for user name and password that the product may require for user authentication. A disconnected DeploymentManager does not provide access to a running J2EE product. The method to retrieve a disconnected DeploymentManager is getDisconnectedDeploymentManager. A disconnected DeploymentManager does not need user authentication information.

Version:

$Revision$

Author:

Adrian Brock, Thomas.Diesler@jboss.org

Method Summary

Methods

Modifier and Type	Method and Description
DeploymentFactory[]	getDeploymentFactories() Retrieve the deployment factories
DeploymentManager	getDeploymentManager(String uri, String userName, String password) Get a connected deployment manager
DeploymentManager	getDisconnectedDeploymentManager(String uri) Get a disconnected version of the deployment manager
static DeploymentFactoryManager	getInstance() Retrieve the instance of the deployment factory manager
void	registerDeploymentFactory(DeploymentFactory factory) Register a deployment factory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static DeploymentFactoryManager getInstance()

Retrieve the instance of the deployment factory manager

Returns:

the deployment factory manager

getDeploymentFactories

public DeploymentFactory[] getDeploymentFactories()

Retrieve the deployment factories

Returns:

an array of deployment factories

getDeploymentManager

public DeploymentManager getDeploymentManager(String uri,
                                     String userName,
                                     String password)
                                       throws DeploymentManagerCreationException

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

registerDeploymentFactory

public void registerDeploymentFactory(DeploymentFactory factory)

Register a deployment factory

Parameters:

factory - the deployment factory

getDisconnectedDeploymentManager

public DeploymentManager getDisconnectedDeploymentManager(String uri)
                                                   throws DeploymentManagerCreationException

Get a disconnected version of the deployment manager

Parameters:

uri - the uri to connect to

Returns:

the disconnected deployment manager

Throws:

DeploymentManagerCreationException