public interface DeploymentFactory
Each application server vendor must provide an implementation of this class in order for the Jakarta Deployment 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 Jakarta EE resources. A DeploymentManager that runs disconnected only provides module deployment configuration support.
DeploymentFactoryManager
Modifier and Type | Method and Description |
---|---|
DeploymentManager |
getDeploymentManager(java.lang.String uri,
java.lang.String username,
java.lang.String password)
Return a connected DeploymentManager instance.
|
DeploymentManager |
getDisconnectedDeploymentManager(java.lang.String uri)
Return a disconnected DeploymentManager instance.
|
java.lang.String |
getDisplayName()
Provide a string with the name of this vendor's DeploymentManager.
|
java.lang.String |
getProductVersion()
Provide a string identifying version of this vendor's
DeploymentManager.
|
boolean |
handlesURI(java.lang.String uri)
Tests whether this factory can create a DeploymentManager
object based on the specificed URI.
|
boolean handlesURI(java.lang.String uri)
uri
- The uri to checkDeploymentManager getDeploymentManager(java.lang.String uri, java.lang.String username, java.lang.String password) throws DeploymentManagerCreationException
uri
- The URI that specifies the connection parametersusername
- 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).DeploymentManagerCreationException
- occurs when a
DeploymentManager could not be returned (server down,
unable to authenticate, etc).DeploymentManager getDisconnectedDeploymentManager(java.lang.String uri) throws DeploymentManagerCreationException
uri
- the uri of the DeploymentManager to return.DeploymentManagerCreationException
- occurs if the
DeploymentManager could not be created.java.lang.String getDisplayName()
java.lang.String getProductVersion()