DeploymentFactoryManager (Java EE 5 SDK)

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.

getInstance

public static DeploymentFactoryManager getInstance()

Retrieve the Singleton DeploymentFactoryManager

返回:

DeploymentFactoryManager instance

getDeploymentFactories

public DeploymentFactory[] getDeploymentFactories()

Retrieve the lists of currently registered DeploymentFactories.

返回:

the list of DeploymentFactory objects or an empty array if there are none.

getDeploymentManager

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

Retrieves a DeploymentManager instance to use for deployment. The caller provides a URI and optional username and password, and all registered DeploymentFactories will be checked. The first one to understand the URI provided will attempt to initiate a server connection and return a ready DeploymentManager instance.

参数:

uri - The uri to check

username - An optional username (may be null if no authentication is required for this platform).

password - An optional password (may be null if no authentication is required for this platform).

返回:

A ready DeploymentManager instance.

抛出异常:

DeploymentManagerCreationException - Occurs when the factory appropriate to the specified URI was unable to initialize a DeploymentManager instance (server down, unable to authenticate, etc.).

registerDeploymentFactory

public void registerDeploymentFactory(DeploymentFactory factory)

Registers a DeploymentFactory so it will be able to handle requests.

getDisconnectedDeploymentManager

public DeploymentManager getDisconnectedDeploymentManager(String uri)
                                                   throws DeploymentManagerCreationException

Return a disconnected DeploymentManager instance.

参数:

uri - identifier of the disconnected DeploymentManager to return.

返回:

A DeploymentManager instance.

抛出异常:

DeploymentDriverException - occurs if the DeploymentManager could not be created.

DeploymentManagerCreationException

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.