Customize the SDK Wrapper Layer

The SDK installation contains build and project files that are required to build the Java wrappers and the sample site. This enables changes to be made to the wrappers to further customize the SOAP interface and the sample site.

The project files are available for the following Java platforms:

• Jakarta EE 9
• Java EE 8

SDK wrapper customization for Java requires the following:

• Java Development Kit (JDK) installed
• JAVA_HOME=jdk_install_dir added to your environment variables
• JAVA_HOME\bin added to your path environment variable
• Apache Maven 3.5 installed
• The Apache Maven installation path added to your path environment variable

The main build and project files are located in sdk_install_dir/java_platform/, where java_platform denotes the respective Java platform, i.e. either Jakarta or Java. Each of these folders contain the following subfolders:

• bin. Contains the generated sample site (Java only) and compiled libraries provided by OneSpan.
• doc. Contains generated JavaDoc help files, with details of wrapper commands and their formats.
• src. Contains the SOAP client and wrapper source and project files. It further contains a sample site implementation using the SDK (Java only).

Source Samples

While customizing the wrapper layer, you may need to refer to source code samples.

OneSpan Authentication Server SDK provides useful source code samples in the src/SampleSite/ folder (Java only). This folder contains further subfolders (within src/main/webapp/jsp) with names corresponding to specific wrapper commands, e.g. administration, authentication, or provisioning.

To build the customized wrapper layer

1. Open a terminal window (in Linux) or Command Prompt window (in Windows).
2. Go to the location of the Java source files, i.e. sdk_install_dir/java_platform/src/.

3. Run the Maven build command in each subfolder as required:

   mvn install

   • src/SoapClient. Run the command here to build the SOAP client (required).
   • src/SoapWrapper. Run the command here to build the customized SOAP wrapper (required).
   • src/SampleSite. Java only. Run the command here to make a custom build of the sample website (optionally).