Description
If your tested Java application is an executable .jar file, use the JarFileName property to specify the fully-qualified path to the .jar file. This is the same value you specify in the Specify application’s .jar file option in the TestedApps editor.
Declaration
JavaTestedAppObj.JarFileName
| Read-Write Property | String |
| JavaTestedAppObj | An expression, variable or parameter that specifies a reference to a JavaTestedApp object | |||
Applies To
The property is applied to the following object:
Property Value
A string value containing the fully-qualified path to the executable .jar file of the tested application.
Remarks
If you assign a value to this property, TestComplete will treat your project as modified. So, you will need to save or cancel changes when closing the project. The specified value will be displayed in the TestedApps editor.
To specify the property value, you can use project and project suite variables as well as the operating system’s environment variables.
The project or project suite variables must be of the string type. To refer to them, use the following syntax --
--for example, “$(MyVar1)”.
| Note: | When evaluating the value of the property, TestComplete first searches for the specified variable in the project variables, then in the project suite variables. Please keep this in mind if you have project and project suite variables with the same names. |
To refer to environment variables, use the following syntax --
-- for example, %Path%.
Note that variables can refer to each other, for instance, a project variable may include a reference to an environment variable. TestComplete will recursively analyze the variables and form the resulting value that does not contain variable names.
Example
The following example adds a new Java application to a project, specifies its launch parameters and then launches the application:
JavaScript, JScript
function Test()
{
// Add a Java application to the project
var ind = TestedApps.AddJavaApp();
var app = TestedApps.Items(ind);
// Specify Java application's launch parameters
app.RunAsJar = true;
app.JVMExecutable = "C:\\Program Files\\Java\\jre7\\Bin\\java.exe";
app.JarFileName = "C:\\JavaApps\\SampleApp.jar";
app.WorkFolder = "C:\\JavaApps";
app.ApplicationArguments = "in data.txt";
app.Options = "-verbose:class";
// Launches the Java application
app.Run();
// Test the application
…
app.Close();
}
Python
def Test():
# Add a Java application to the project
ind = TestedApps.AddJavaApp();
app = TestedApps.Items(ind);
# Specify Java application's launch parameters
app.RunAsJar = True;
app.JVMExecutable = "C:\\Program Files\\Java\\jre7\\Bin\\java.exe";
app.JarFileName = "C:\\JavaApps\\SampleApp.jar";
app.WorkFolder = "C:\\JavaApps";
app.ApplicationArguments = "in data.txt";
app.Options = "-verbose:class";
# Launches the Java application
app.Run();
# Test the application
# ...
app.Close();VBScript
Sub Test
' Add a Java application to the project
ind = TestedApps.AddJavaApp
Set app = TestedApps.Items(ind)
' Specify Java application's launch parameters
app.RunAsJar = true
app.JVMExecutable = "C:\Program Files\Java\jre7\Bin\java.exe"
app.JarFileName = "C:\JavaApps\SampleApp.jar"
app.WorkFolder = "C:\JavaApps"
app.ApplicationArguments = "in data.txt"
app.Options = "-verbose:class"
' Launches the Java application
app.Run
' Test the application
…
app.Close
End Sub
DelphiScript
procedure Test();
var ind, app;
begin
// Add a Java application to the project
ind := TestedApps.AddJavaApp();
app := TestedApps.Items(ind);
// Specify Java application's launch parameters
app.RunAsJar := true;
app.JVMExecutable := 'C:\Program Files\Java\jre7\Bin\java.exe';
app.JarFileName := 'C:\JavaApps\SampleApp.jar';
app.WorkFolder := 'C:\JavaApps';
app.ApplicationArguments := 'in data.txt';
app.Options := '-verbose:class';
// Launches the Java application
app.Run;
// Test the application
…
app.Close;
end;
C++Script, C#Script
function Test()
{
// Add a Java application to the project
var ind = TestedApps["AddJavaApp"]();
var app = TestedApps["Items"](ind);
// Specify Java application's launch parameters
app["RunAsJar"] = true;
app["JVMExecutable"] = "C:\\Program Files\\Java\\jre7\\Bin\\java.exe";
app["JarFileName"] = "C:\\JavaApps\\SampleApp.jar";
app["WorkFolder"] = "C:\\JavaApps";
app["ApplicationArguments"] = "in data.txt";
app["Options"] = "-verbose:class";
// Launches the Java application
app["Run"]();
// Test the application
…
app["Close"]();
}
See Also
JavaTestedApp Object
Testing Java Applications
Java Application Parameters
RunAsJar Property