Package com.sun.ts.lib.porting
Interface TSDeploymentInterface
public interface TSDeploymentInterface
An implementation of the TSDeploymentInterface can be provided by a Jakarta EE implementation, to support their own
deploy/undeploy semantics.
Jakarta EE implementations that previously depended on Pruned Jakarta Deployment, should also use
TSDeploymentInterface instead of com.sun.ts.lib.porting.TSDeploymentInterface2.
- Author:
- Kyle Grucci
-
Method Summary
Modifier and TypeMethodDescriptiondeploy
(DeploymentInfo info) This method is called by the test harness to deploy an .ear file into your Java EE implementation.void
This method is called to deploy a connector (.rar file) to your Java EE implementation.This method is called by the test harness to get any additional test specific arguments that must be passed to the application client container class, which is specified in the ts.jte file in the given environment (command.testExecuteAppClient property).getInteropJNDINames
(DeploymentInfo[] infoArray) This method is called by the test harness to get the corba JNDI names to use in an interop scenario.void
init
(PrintWriter writer) Initializes a new TSDeployment instance.boolean
This method is called to check to see if a given connector (.rar file) is deployed on your Java EE implementation.boolean
This method is called by the test harness to check whether or not an application ear is deployed.void
This method is called by test harness to undeploy an .ear file from your Java EE implementation.void
This method is called to undeploy a connector (.rar file) from your Java EE implementation.
-
Method Details
-
init
Initializes a new TSDeployment instance. All output should be printed to this PrintWriter. All properties in the ts.jte file are accessible to this porting implementation class only via the TSPropertyManager class. Please see Sun's implementation of this method for an example.- Parameters:
writer
- The PrintWriter that should be used to log output.
-
deploy
This method is called by the test harness to deploy an .ear file into your Java EE implementation. We extract such info as the app earfile from the provided deployment information. The following properties are available for this method's use: generateSQL - "true" if SQL is to be generated for CMP beans deployment_host - the host where this app is to be deployed All additional information is queryable from the DeploymentInfo interface.- Parameters:
info
- Object containing necessary deployment info.- Returns:
- This method should return a string which is formatted such that it can be appended to the classpath. your Java EE implementation returns the fully qualified path to a jar file, which contains the generated ejb stub classes, which are used by any appclient tests (tests whose client directly uses an ejb).
- Throws:
TSDeploymentException
-
undeploy
This method is called by test harness to undeploy an .ear file from your Java EE implementation. We extract such info as host and app from these props. The following properties are available for this method 's use: ear_file - the fully qualified application (.ear file) deployment_host - the host to undeploy this app from- Parameters:
p
- Properties specific to the currently running test- Throws:
TSDeploymentException
-
isDeployed
This method is called by the test harness to check whether or not an application ear is deployed. This information is used to determine whether or not the harness needs to undeploy it. The following properties are available for this method's use: ear_file - the fully qualified application (.ear file) deployment_host - the host where this app is deployed- Parameters:
p
- Properties specific to the currently running test- Returns:
- True if the app is deployed. False if not.
- Throws:
TSDeploymentException
-
deployConnector
This method is called to deploy a connector (.rar file) to your Java EE implementation. We extract such info as deployment_host and rar_file from these props. The following properties are available for this method's use: rar_file - the fully qualified connector file (.rar file) deployment_host - the host name of the machine to deploy it to- Parameters:
p
- Properties specific to the currently running test- Throws:
TSDeploymentException
-
undeployConnector
This method is called to undeploy a connector (.rar file) from your Java EE implementation. We extract such info as deployment_host and rar_file from these props. The following properties are available for this method's use: rar_file - the fully qualified connector file (.rar file) deployment_host - the host name of the machine to undeploy it from- Parameters:
p
- Properties specific to the currently running test- Throws:
TSDeploymentException
-
isConnectorDeployed
This method is called to check to see if a given connector (.rar file) is deployed on your Java EE implementation. We extract such info as deployment_host and rar_file from these props. The following properties are available for this method's use: rar_file - the fully qualified connector file (.rar file) deployment_host - the host name of the machine to deploy it to- Parameters:
p
- Properties specific to the currently running test- Returns:
- True if the app is deployed. False if not.
- Throws:
TSDeploymentException
-
getAppClientArgs
This method is called by the test harness to get any additional test specific arguments that must be passed to the application client container class, which is specified in the ts.jte file in the given environment (command.testExecuteAppClient property). The additional args should be appended to the value of (p.getProperty("executeArgs");), and returned. The following properties are available for this method's use: executeArgs - the current executeArgs as specified in the jte file- Parameters:
p
- Properties specific to the currently running test- Returns:
- This method should return a string which represents all executeArgs to be used.
-
getInteropJNDINames
This method is called by the test harness to get the corba JNDI names to use in an interop scenario. This method should return a hashtable of mappings for any EJB references in the array of DeploymentInfo objects where: key = original corbaname JNDI name in the RI format value = vendor corbaname JNDI name in the Vendor format- Parameters:
infoArray
- Array of DeploymentInfo objects for the ear files associated with a particular directory- Returns:
- Hashtable This method should return a Hashtable of mappings (see above)
-