Deploying a Java archive

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Develop in Java

Deploying a Java archive

Overview

Deploying a Java application (generated by WINDEV)

Running the application

See also

Deploying a Java archive

Overview

Like for any application, WINDEV allows you to create a setup program for a Java application. This setup procedure is available for Windows only. The setup program will be an executable and it will be used to install the necessary files as well as the Java runtime (JRE). For the other platforms, your files will have to be deployed manually.

To start the wizard for setup creation, select "Workshop .. Create the setup procedure".To start the wizard for setup creation, on the "Project" pane, in the "Generation" group, expand "Setup procedure" and select "Create the setup procedure".

Note: From version 19, HFSQL is the new name of HyperFileSQL.

Deploying a Java application (generated by WINDEV)

Install JRE (Java Runtime Environment) on the target computer.
Note: The JRE for Windows, Linux, Apple Mac OS X, Solaris can be downloaded from http://www.oracle.com/technetwork/java/javase/downloads/index.html.
Copy the archive generated by WINDEV onto the target computer.
You must also copy all the files used by the application (images, text files, ...).
If the Java framework of WINDEV was not included in the generated archive:
Copy the wdxxxjava.jar file into the same directory as the archive generated by WINDEV.
If the application is using a JDBC driver that was not included in the generated archive:
Copy the archive (or the class files) of the JDBC driver into the same directory as the archive generated by WINDEV.
If the application is using the HFSQL engine:
Copy into the directory of the archive generated by WINDEV:
- the analysis (.WDD file).
- the data files.
  Reminder: On Linux and Mac, the HFSQL data files must be written in lowercase without any accented characters.
- the native libraries for accessing HFSQL:
  - for an execution in Windows: wdxxxjav.dll, wdxxxhf.dll, wdxxxsql.dll, wdxxxvm.dll. These files are available in the Programs sub-directory of the setup directory of WINDEV.
  - for an execution in Linux: wd240jav.so, wd240hf.so, wd240sql.so, wd240vm.so. These files are available in the "Programs\Data" sub-directory of the setup directory of WINDEV.
    Note: the modules for accessing Hyper File 5 as well as the Native Accesses are not available for Linux in this version. You must use HFSQL Classic or a JDBC access.

Running the application

In most cases, the archive generated by WINDEV is a self-executable archive (the manifest of the archive contains the information required for its execution).

A double click performed on the archive starts its execution.

However, the double click may not operated in some cases.

List of known cases where the double click does not operate:

the "Java" executable is not associated with the JAR extension.
the name of the JDBC driver is too long and it was not copied properly into the manifest.mf file generated by the tool for creating jar.exe archives, which makes the manifest unusable.

In this case, the archive can be run by using the command line copied into the <Archive Name>.bat file.

This file is automatically generated by WINDEV when generating the archive of the application.

CAUTION: This command line was generated for the compilation computer. This line may have to be adapted for the target computer.

Example of command line:

"C:\j2sdk1.4.2_04\bin\java.exe" -classpath MyProject.jar;
WD220java.jar;mysql-connector-java-3.0.14-production-bin.jar GWDPMyProject

Details of the command line:


`"C:\j2sdk1.4.2_04\bin\java.exe"`	Full path of the Java executable to run the generated archive.
`classpath MyProject.jar;WD220java.jar;mysql-connector-java-3.0.14-production-bin.jar`	List of archives (.JAR) required to run the application. MyProject.jar is the name of the archive generated by WINDEV. In this example, neither the framework nor the JDBC driver of MySQL have been included in the generated archive: they are added into the classpath, separated by ';' (semicolons).
`GWDPMyProject`	This is the name of the Java class containing the "main" method, start point for the execution of the application. This name is automatically generated by WINDEV from the name of the project. See the documentation of the "java" executable for more details.